Cli 导读

卸载网关服务但保留 CLI:用 --service 还是 --all?

`openclaw uninstall` 只删网关服务和本地数据,CLI 本身不动。最易搞混的是 `--all` 会一并移除 macOS 应用,而 `--dry-run` 可先预览要删什么。

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

卸载网关服务但保留 CLI:用 --service 还是 --all?

`openclaw uninstall` 只删网关服务和本地数据,CLI 本身不动。最易搞混的是 `--all` 会一并移除 macOS 应用,而 `--dry-run` 可先预览要删什么。

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

第一站

📦 先别急着拆,先看三种最常见的动作

官方给的命令虽然少,但已经足够把这个动作说清楚了。

💾

openclaw backup create

像先把房间拍成照片、把重要东西装进备用箱,再考虑搬走。

🧹

openclaw uninstall

像请搬家工把 Gateway 服务和本地数据先搬走,但 CLI 这个工具本身还留着。

🧨

openclaw uninstall --all --yes

像一次搬空更彻底的房间整理,先把大件小件一起处理掉。

👀

openclaw uninstall --dry-run

像先把搬家清单拿出来看一眼,不真的动手。

第二站

🛠 官方最想你先记住的,不是卸载,而是备份

这一页开头就说得很直接:如果你想要可回头的版本,先做快照。

💾 先做备份

openclaw backup create 像把家里的重要抽屉先拍照封存。这样后面搬走了,还能按图找回来。

🧷 再做卸载

备份做完以后,再动 openclaw uninstall,心里会稳很多。

🔁 为什么顺序重要

因为卸载之后,真正的本地状态可能就没了。先备份,就像先把退路画在纸上。

📌 这节真正的重点

官方不是在卖弄谨慎,而是在提醒你:删之前先留一个可以回家的口袋。

第三站

🚪 普通卸载,像“把服务和本地房间一起清掉,但门口工具箱还在”

这一页最容易误解的地方,就是以为 uninstall 会把所有东西全删没。不是,它有边界。

🏭

Gateway 服务

会被卸掉。像机房里的主机器被带走了。

📁

本地数据

会被清掉。像桌上的记录本、钥匙串、工作痕迹一起收走。

🧰

CLI 本体

还留着。也就是你手里的那把小扳手还在,不等于整套屋子都没了。

一句话先记住

uninstall 不是“把世界删干净”,而是“把服务和状态移走”。

第四站

🧨 --all --yes 像“把车库、仓库、后院一起清空”

这不是轻轻点一下的动作,而是更彻底的版本。官方把它摆出来,是为了给真正想全量清掉的人用。

--all

像不只搬走主屋,还把相关附属空间也一起算上。

--yes

像你已经提前把“我真的要搬走”这句话说死了,不再反复问。

风险更高

这个组合比普通卸载更激进,所以更要先备份。官方这么写不是吓人,是在给你一个明确的刹车点。

📌 这页的真实含义

全量卸载不是玩笑,它是“我真的要从这台机器上离开”的动作。

第五站

👀 --dry-run 像“先把搬家清单念给你听”

这个参数很像把行动放慢半拍,先让你看清楚会删什么,再决定要不要真的按下去。

📝 只预演,不动手

openclaw uninstall --dry-run 会先告诉你将要做什么,但不真的拆门、搬箱、清屋子。

🧠 适合先确认范围

如果你不确定到底会删到哪里,这个参数就是一个很好的暂停键。

🔐 特别适合重要机器

越是上面装了重要数据的机器,越应该先 dry-run 看一眼。

🎈 一句话

dry-run 就是先看剧本,不先真演。

第六站

🏠 卸载之后,你真正需要想的是“这台机器以后还要不要回头装”

这页没有长篇大论,但它其实在提醒你一个很现实的点:卸载和重装,不是同一件事。

🧾

保留备份

如果以后还可能回来,备份文件就是你回家的地图。

🪪

清掉状态

如果你就是要彻底离开,那就把本地状态和服务都收拾干净。

🔁

重装不等于恢复

以后再装回去,也不一定自动回到原来的样子,所以备份很关键。

📌

一句话

卸载是离开,不是忘记。

最后总结

🎈 把 openclaw uninstall 压成一句话

openclaw uninstall 是把 Gateway 服务和本地数据干净拿掉,但官方先提醒你备份,再让你决定是普通卸载还是更彻底的全量卸载。

如果你下一页还想继续看,我建议之后接着整理“更新 / 恢复 / 备份”这条线,因为它和卸载是最常连在一起的。