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

Options¶

• --scope <scope>: config、config+creds+sessions 或 full
• --yes: 跳过确认提示
• --non-interactive: 禁用提示。需要 --scope 和 --yes。
• --dry-run: 仅打印操作，不删除文件

Scopes¶

config+creds+sessions 和 full 会在删除状态之前停止正在运行的受管网关服务。

会话范围会删除当前和已归档的会话、保留的转录代际、冷历史，以及来自已配置和发现的代理存储的会话拥有的工件，包括不再位于配置中的代理。它会保留每个代理的数据库文件，因为这些文件还包含身份验证配置、记忆和其他代理状态。工作区文件和身份验证配置会保留。没有独立的 --scope sessions 选项。

--dry-run 会列出所选用于删除的数据库、会话键、转录/归档数量以及拥有的归档文件，而不会写入 SQLite 状态。遗留 JSON/JSONL 导入仍由 Doctor 拥有；reset 不会递归删除会话目录。

Notes¶

• 在删除本地状态之前，先运行 openclaw backup create 以创建可恢复的快照。
• 两个删除会话的范围都需要独占的状态所有权。如果未受管或外部监督的 Gateway 仍在运行，reset 会拒绝并要求你先停止它。
• 工作区设置状态和证明是共享 SQLite 数据库中的行。full 会随状态目录一起删除它们。当前没有需要单独删除的证明 sidecar 文件。
• 如果在会话行删除后归档文件删除失败，reset 会报告确切的剩余文件以便手动清理。它绝不会仅因为文件名看起来像会话归档就删除无关文件。
• 会话清理失败不会跳过其他代理存储，也不会跳过独立的配置和 OAuth 目录清理。失败的存储会保留任何被拒绝删除的历史。
• 如果没有 --scope，openclaw reset 会交互式提示要删除的范围。
• --non-interactive 仅在同时设置 --scope 和 --yes 时有效。
• config+creds+sessions 和 full 完成时会打印 Next: openclaw onboard --install-daemon。
• 删除失败或会话目录检查会以非零状态退出。解决报告的错误，然后重试 reset；不完整的 reset 不会打印 onboarding 完成提示。

Related¶

• CLI 参考
• openclaw backup — 在重置前归档状态
• openclaw onboard — 在重置后重新设置安装
• openclaw uninstall — 卸载安装而不是重置它