跳转至

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 完成提示。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw