卸载
首先移除服务及选定的本地数据,然后移除任何剩余的 CLI 安装。删除 state 目录时,也会移除嵌套在该目录中的安装文件。请选择:
- 简易路径:如果
openclaw仍然已安装。 - 手动移除服务:如果 CLI 已不存在但服务仍在运行。
简易路径(CLI 仍已安装)¶
该命令会分别尝试所请求的各个清理范围,如果任一范围失败或被阻止,则返回非零状态。服务卸载仍是 state 和工作区删除的安全门;如果该门失败,则这些数据范围会被保留,同时仍会尝试应用清理。部分清理会被明确报告,并且绝不会随之给出无条件的完成结果。
交互式提示默认只预选 Gateway 服务。为了完整移除本地安装,还需在提示中选择 state、workspace 和应用,或运行 openclaw uninstall --all。除非同时选择 --workspace,否则 state 移除会保留已配置的工作区目录。
预览将要移除的内容(安全操作):
非交互式(自动化 / npx)。请谨慎使用,并仅在确认范围后使用:
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive
标志:--service、--state、--workspace、--app 分别选择各个范围;--all 选择全部四项。
与 openclaw uninstall --state 不同,手动删除 state 不会保留工作区。请先成功停止并卸载服务,然后再删除文件。在手动删除 state 或 prefix 之前,将任何你想保留的配置移到该目录之外。
- 停止 gateway 服务:
- 卸载 gateway 服务(launchd/systemd/schtasks):
- 决定是否保留工作区。
在手动删除之前,将所有你想保留的已配置工作区(包括 ~/.openclaw/workspace)移到 state 目录之外。否则,该目录内的工作区将随其一起被删除;它们无需单独删除。
- 删除 state 和配置:
如果你将 OPENCLAW_CONFIG_PATH 设置为 state 目录之外的自定义位置,请一并删除该文件。在重新创建其父目录后恢复保留的工作区,或在重新安装时配置它们的新路径。
- 仅当你还想删除其 agent 文件时,才删除外部工作区:
-
使用下面的安装所有者移除 CLI。
-
如果你安装了 macOS 应用:
- 如果你使用了 profile(
--profile/OPENCLAW_PROFILE),请对每个 state 目录重复步骤 3-4(默认是~/.openclaw-<profile>)。 - 在远程模式下,state 目录位于 gateway 主机上,因此也需在该主机上运行步骤 1-4。
手动移除服务(CLI 未安装)¶
如果 gateway 服务仍在运行但 openclaw 已不存在,请使用此方法。
macOS(launchd)¶
默认标签为 ai.openclaw.gateway(使用 profile 时为 ai.openclaw.<profile>):
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
如果你使用了 profile,请将标签和 plist 名称替换为 ai.openclaw.<profile>。
Linux(systemd 用户单元)¶
默认单元名称为 openclaw-gateway.service(使用 profile 时为 openclaw-gateway-<profile>.service)。在从非常旧的安装升级而来的机器上,可能仍然存在重命名前的 clawdbot-gateway.service 单元;openclaw uninstall / openclaw gateway uninstall 会自动检测并移除它。
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service{,.bak}
systemctl --user daemon-reload
Windows(计划任务)¶
默认任务名称为 OpenClaw Gateway(使用 profile 时为 OpenClaw Gateway (<profile>))。
该任务会在你的 state 目录下启动一个无窗口的 gateway.vbs 脚本,该脚本进而运行 gateway.cmd;两者都要移除。
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.vbs" -ErrorAction SilentlyContinue
如果你使用了 profile,请删除对应的任务名称以及 ~\.openclaw-<profile> 下的 gateway.cmd / gateway.vbs 文件。
移除 CLI¶
在删除 checkout、启动器或 prefix 之前,先移除 Gateway 服务。请先检查解析出的命令及其目标;如果所有权不明确,请保持原样。有关自定义 checkout 和 prefix 选项,请参阅 Installer internals。
| 安装方式 | CLI 所有者及移除方式 |
|---|---|
全局 npm(install.sh / install.ps1 默认) |
使用拥有此安装的 npm/prefix 运行 npm rm -g openclaw。 |
| 全局 pnpm 或 Bun | 仅运行对应的命令:pnpm remove -g openclaw 或 bun remove -g openclaw。对于仅由 Bun 创建的 shell 启动器,先检查 $(bun pm bin -g)/openclaw 中的 OpenClaw Bun launcher 标头和预期的包路径;在移除包之后再移除该启动器;Bun 可能会留下常规启动器文件。 |
install.sh --install-method git |
检查 ~/.local/bin/openclaw;仅当该启动器指向预期的检出目录时移除它,然后移除该检出目录。 |
install.ps1 -InstallMethod git |
检查 %USERPROFILE%\.local\bin\openclaw.cmd;仅当该启动器指向预期的检出目录时移除它,然后移除该检出目录。 |
install-cli.sh(npm 或 Git) |
检查 <prefix>/bin/openclaw。前缀默认为 ~/.openclaw;--prefix / OPENCLAW_PREFIX 可覆盖它。仅在保留所需数据后移除专用前缀;Git 模式还需要移除其单独的检出目录。 |
| 直接源码检出 | 仅移除你自己的包装器/符号链接,然后移除检出目录。保留属于其他安装的 shim。 |
Git 检出目录默认位于 ~/openclaw(Windows 上为 %USERPROFILE%\openclaw);请使用启动器的实际目标,包括自定义的 --git-dir / -GitDir 或 OPENCLAW_GIT_DIR。在 POSIX 系统上,OPENCLAW_HOME 可以更改默认检出目录。仅按上文所述移除状态/工作区。
在删除前缀之前,将你想要保留的任何状态、配置和工作区移动到其外部。切勿整体删除共享前缀:只移除经过验证的 OpenClaw 文件,同时保留共享的 Node 运行时、包和工具。
如果已安装补全,请仅从选定的 shell 配置文件中移除其 # OpenClaw Completion 块和 OpenClaw source 行。仅当旧版 openclaw completion 的 source/eval 行不包含其他命令时,才移除它;保留周围内容。
仅当没有其他命令使用安装程序添加的 PATH 条目时,才移除它。保留共享的 bin 目录,例如 ~/.local/bin。在 Windows 上,同样的规则适用于便携式 Node/MinGit 及其位于 %LOCALAPPDATA%\OpenClaw\deps 下的 PATH 条目。
打开一个新的 shell,然后检查 command -v openclaw(PowerShell:Get-Command openclaw -ErrorAction SilentlyContinue)。如果命令仍然解析成功,请检查它:可能残留了另一个安装或外部包装器。
相关¶
- 安装概览
- 迁移指南
openclaw uninstall— 命令参考与标志
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw