ContextQMD
Back to Openclaw

Reset

docs/cli/reset.md

2026.7.11.8 KB
Original Source

openclaw reset

Reset local config/state (keeps the CLI installed).

bash
openclaw reset
openclaw reset --dry-run
openclaw reset --scope config --yes --non-interactive
openclaw reset --scope config+creds+sessions --yes --non-interactive
openclaw reset --scope full --yes --non-interactive

Options

  • --scope <scope>: config, config+creds+sessions, or full
  • --yes: skip confirmation prompts
  • --non-interactive: disable prompts; requires --scope and --yes
  • --dry-run: print actions without removing files

Scopes

ScopeRemovesStops gateway first
configconfig file onlyno
config+creds+sessionsconfig file, OAuth/credentials dir, per-agent session directoriesyes
fullstate dir (including config/creds if nested inside it) plus workspace dirs and workspace attestationsyes

config+creds+sessions and full stop a running managed gateway service before deleting state.

Notes

  • Run openclaw backup create first for a restorable snapshot before removing local state.
  • Without --scope, openclaw reset prompts interactively for the scope to remove.
  • --non-interactive is only valid when both --scope and --yes are set.
  • config+creds+sessions and full print Next: openclaw onboard --install-daemon when done.