ewilliams28/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-08-18 08:31:49 -06:00
Code Issues Packages Projects Releases Wiki Activity
Files
0b75ea3cefcd1e4532f9b5c08d455433debdcba7
openclaw/docs/cli/reset.md
T
Peter Steinberger b834477565 fix(cli): refuse live state reset and uninstall (#125253) 
* fix(cli): guard live state cleanup

* fix(cli): preserve linked paths on cleanup failure

* fix(cli): retain gateway ownership through cleanup

* fix(cli): keep cleanup planning read-only

* fix(cli): skip mutating bootstrap for cleanup

* fix(apple): keep identity locks sandbox-writable

* docs(apple): clarify identity lock domains
2026-08-17 09:44:31 -07:00

2.2 KiB
Raw Blame History

summary, read_when, title
summary read_when title
CLI reference for `openclaw reset` (reset local state/config)
You want to wipe local state while keeping the CLI installed
You want a dry-run of what would be removed
Reset

openclaw reset

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

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

Scope Removes Stops gateway first
config config file only no
config+creds+sessions config file, OAuth/credentials dir, per-agent session directories yes
full state dir (including the shared SQLite database) plus workspace directories yes

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.
  • Before removing the state directory, full requires exclusive state ownership. If an unmanaged or externally supervised Gateway is still running, reset refuses and asks you to stop it first.
  • Workspace setup state and attestations are rows in the shared SQLite database, so full removes them with the state directory; there are no current attestation sidecar files to remove separately.
  • 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.

Related

Reference in New Issue View Git Blame Copy Permalink