openclaw reset CLI Reference

`openclaw reset`

Reset 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>: choose config, config+creds+sessions, or full
--yes: proceed without confirmation dialogs
--non-interactive: turn off all prompts; needs --scope and --yes to be present
--dry-run: show what would happen, but leave files untouched

Scopes

Scope	What gets deleted	Gateway stopped first
`config`	only the config file	no
`config+creds+sessions`	config file, OAuth/credentials folder, session directories for each agent	yes
`full`	state folder (the shared SQLite database included) and workspace folders	yes

A managed gateway service that is currently running gets shut down by config+creds+sessions and full before any state removal happens.

Notes

Run openclaw backup create beforehand to create a snapshot you can restore from before deleting local state.
Exclusive ownership of the state is mandatory for full prior to deleting the state folder. If an unmanaged or externally controlled Gateway is active, reset will decline and instruct you to halt it first.
Since workspace setup state and attestations live as rows inside the shared SQLite database, full wipes them along with the state folder; no separate attestation sidecar files exist to clean up.
When --scope is absent, openclaw reset asks interactively which scope to delete.
--non-interactive works only if both --scope and --yes are supplied.
Upon completion, config+creds+sessions and full output Next: openclaw onboard --install-daemon.

CLI reference