mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-07 08:31:58 +08:00
f7d7148cf0
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green. Closes #100141
48 lines
2.0 KiB
Markdown
48 lines
2.0 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 config/creds if nested inside it) plus workspace dirs and workspace attestations | 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.
|
|
- 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)
|