openclaw reset CLI reference: reset local state and config
This page documents the openclaw reset command, which clears local configuration and state without uninstalling the CLI. It is intended for users who need to reset their CLI environment or troubleshoot issues.
Read this when
- You want to wipe local state while keeping the CLI installed
- You want a dry-run of what would be removed
openclaw reset
Resets local configuration and state without uninstalling the CLI.
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, orfull--yes: bypasses confirmation prompts--non-interactive: disables prompts; requires--scopeand--yes--dry-run: shows what would be done without deleting files
Scopes
| Scope | Removes | Stops gateway first |
|---|---|---|
config | only the config file | no |
config+creds+sessions | config file, OAuth and credentials directory, per-agent session directories | yes |
full | state directory (including the shared SQLite database) and workspace directories | yes |
config+creds+sessions and full halt a running managed gateway service before removing state.
Notes
- Run
openclaw backup createfirst to create a restorable snapshot before removing local state. - Workspace setup state and attestations live as rows in the shared SQLite database, so
fulldeletes them along with the state directory; there are no separate attestation sidecar files to remove. - Without
--scope,openclaw resetinteractively asks which scope to remove. --non-interactiveworks only when both--scopeand--yesare provided.config+creds+sessionsandfulloutputNext: openclaw onboard --install-daemonwhen finished.