mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-19 09:01:39 -06:00
Peter Steinberger
b834477565
* 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
50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
---
|
|
summary: "CLI reference for `openclaw reset` (reset local state/config)"
|
|
read_when:
|
|
- You want to wipe local state while keeping the CLI installed
|
|
- You want a dry-run of what would be removed
|
|
title: "Reset"
|
|
---
|
|
|
|
# `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
|
|
|
|
| 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
|
|
|
|
- [CLI reference](/cli)
|