Cli 导读

重置本地配置,但保留 CLI 本体

openclaw reset 会清除本地配置、凭据或会话,但不会卸载 CLI。最该先看 --scope 参数:选 config 只清配置,选 full 则连凭据和会话一起清。非交互模式必须同时指定 --scope 和 --yes,否则会报错。

先讲这一页到底在解决什么

重置本地配置,但保留 CLI 本体

openclaw reset 会清除本地配置、凭据或会话,但不会卸载 CLI。最该先看 --scope 参数:选 config 只清配置,选 full 则连凭据和会话一起清。非交互模式必须同时指定 --scope 和 --yes,否则会报错。

原文共 2 节,先看 Start Here 路径:/cli/reset 查看官方原文

第一站

🧹 它会清什么?像把桌上的三只抽屉重新归零

官方的核心意思很短:重置本地 config 和 state,但 CLI 还留着。也就是说,它清的是里面的东西,不是把整栋楼推倒。

🧾

config

像墙上的总规则表,reset 会把它带回干净状态。

🔐

creds

像抽屉里的门卡和钥匙,旧的先收走。

💬

sessions

像聊天记录的小故事页,旧会话先清掉。

🧱

CLI 还在

房子不拆。工具箱还在。只是屋里的东西重新摆。

第二站

🎒 为什么官方先让你备份?因为清桌子前,先拍张照片最稳

这就是官方那句“先 backup create”的真正意思。先留底,再动手。这样哪怕后面想反悔,也有机会把东西找回来。

openclaw backup create

像先拍一张全家福,把现在这套家当留个底。

openclaw reset

像把桌面清空,开始重新摆。

先拍照再收拾

这样你不是盲目清理,而是带着退路清理。

一句话

reset 前先 backup,像搬家前先拍照存档。

第三站

🪞 `--dry-run`、`--scope`、`--yes`、`--non-interactive`,是在决定“先演一遍、擦哪几格、要不要再问你一句”

这些参数看起来像墙上贴了很多标签,其实都在控制重置这把扫帚的力度。

🎭

--dry-run

像先把清理动作走一遍,不真的把东西扔掉。

🧺

--scope config+creds+sessions

像告诉它:“这次只擦这三只抽屉,别碰别的地方。”

--yes

像你提前点头,说“我确定要清”。

🤫

--non-interactive

像机器人默默干活,不再每一步都抬头问你。

第四站

🧠 `scope` 这个词最像“清哪几层抽屉”

官方示例把 scope 写得很明确。这里最关键的是不要误会成“把整个系统都推平”。它只是按范围收拾。

config

像把墙上的规则表擦一遍,重新贴新的。

creds

像把旧门卡和旧钥匙收回。

sessions

像把旧聊天抽屉清空,避免旧内容一直拖着你走。

重置不是拆家

你只是按范围清理。房子还在,工具也还在。

第五站

🧯 它最适合什么时候用?像卡住了、乱了、想重开一局的时候

重置不是日常动作,它更像“系统已经有点乱了,我们先把这桌清掉再来”的那一步。

🔁

重新开始

你想从头再来,干净地重新配一次。

🧹

排掉旧状态

一些旧配置、旧凭据、旧会话一直在干扰你,就先清掉。

🧰

准备修复

有时候你不是要结束,而是要为下一轮修复腾空间。

📌

一句话

reset 是“清理重来”的按钮,不是“永久删除工具”的按钮。

最后总结

🎈 把 openclaw reset 压成一句话

openclaw reset 就像把 OpenClaw 的桌面清干净:先备份,再按范围清掉本地配置、钥匙和会话,让你从一个更整洁的起点重新开始,而不是把整台工具拆掉。