openclaw reset¶
重置本地配置/状态(保留已安装的 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
选项¶
--scope <scope>:config、config+creds+sessions或full--yes:跳过确认提示--non-interactive:禁用提示。需要--scope和--yes。--dry-run:仅打印操作,不删除文件
范围¶
| 范围 | 删除内容 | 是否先停止 gateway |
|---|---|---|
config |
仅配置文件 | 否 |
config+creds+sessions |
配置文件、OAuth/凭据目录、标准 SQLite 会话历史及其归档文件 | 是 |
full |
状态目录(包括共享 SQLite 数据库)以及工作区目录 | 是 |
config+creds+sessions 和 full 会在删除状态之前停止正在运行的受管 gateway 服务。
会话范围会从已配置和发现的 agent 存储中删除当前会话和已归档会话、保留的 transcript 生成版本、
冷历史,以及会话拥有的产物,包括不再位于配置中的 agent。它会保留每个 agent 的数据库文件,因为其中
还包含 auth profiles、memory 和其他 agent 状态。工作区文件和 auth
profiles 会保留。没有独立的 --scope sessions 选项。
--dry-run 会列出选定用于删除的数据库、会话键、transcript/归档数量以及拥有的
归档文件,而不会写入 SQLite 状态。旧版 JSON/JSONL
导入仍由 Doctor 拥有;reset 不会递归删除会话目录。
说明¶
- 在删除本地状态之前,先运行
openclaw backup create以创建可恢复的快照。 - 两种会删除会话的范围都需要独占的状态所有权。如果未受管或外部监督的 Gateway 仍在运行,reset 会拒绝并要求你先停止它。
- 工作区设置状态和 attestations 是共享 SQLite 数据库中的行。
full会随状态目录一起删除它们。当前没有需要单独删除的 attestation sidecar 文件。 - 如果在删除会话行之后归档文件删除失败,reset 会报告确切剩余的文件以便手动清理。它绝不会仅因为文件名看起来像会话归档就删除无关文件。
- 会话清理失败不会跳过其他 agent 存储或独立的配置和 OAuth 目录清理。失败的存储会保留任何被拒绝删除的历史。
- 如果没有
--scope,openclaw reset会交互式提示要删除的范围。 - 只有同时设置
--scope和--yes时,--non-interactive才有效。 config+creds+sessions和full完成时会打印Next: openclaw onboard --install-daemon。- 删除失败或会话目录检查会以非零状态退出。解决报告的错误后,再重试 reset;未完成的重置不会打印 onboarding 完成提示。
相关¶
- CLI 参考
openclaw backup— 在重置状态之前归档状态openclaw onboard— 在重置后重新配置安装openclaw uninstall— 卸载安装而不是重置它
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw