vrr/openclaw
2
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-10-03 17:53:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 31
openclaw/docs/cli/reset.md
Vincent Koc 118555858e
docs: STE structural cleanup for gateway, cli and concepts (46 audit findings) (#143931) 
* docs(cli): apply STE structural fixes to small CLI reference pages

* docs(cli): STE structural fixes for cron and browser reference

* docs(cli): STE structural fixes for migrate and triage reference

* docs(concepts): STE structural fixes for architecture, agent, presence, mantis runbook

* docs(concepts): STE structural fixes for session-state and models

* docs(concepts): STE structural fixes for user-model

* docs(concepts): STE structural fixes for mantis

* docs(concepts): STE fixes and person-noun normalization for multi-user

* docs(concepts): STE fixes and failover term normalization for model-failover

* docs(concepts): define Mantis runbook terms

* docs(gateway): STE structural fixes for logging, local-models, tailscale, multiple-gateways

* docs(gateway): normalize Configuration reference naming and STE fixes

* docs(gateway): STE fixes and workspace term normalization for openshell

* docs(gateway): split semicolon-joined sentences in operator-scopes, restart-recovery, heartbeat, cli-backends

* docs(gateway): finish semicolon splits in gateway reference pages

* docs(gateway): normalize Gateway, heartbeat, tombstone and profile terminology

* docs(gateway): split remaining multi-clause sentences in heartbeat and cli-backends

* docs(gateway): split semicolon in heartbeat transcript-markers paragraph from main

---------

Co-authored-by: Vincent Koc <vincent@openclaw.org>
2026-09-10 18:50:32 +08:00

2.5 KiB
Raw Blame History

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. 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