Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

有两条路径：
  • 简单路径：如果 openclaw 仍然安装着。
  • 手动移除服务：如果 CLI 已经没了，但服务仍在运行。

​
简单路径（CLI 仍已安装）

推荐：使用内置卸载程序： 
openclaw uninstall
非交互式（自动化 / npx）： 
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive
手动步骤（结果相同）：
  1. 停止 gateway 服务：
openclaw gateway stop
  1. 卸载 gateway 服务（launchd/systemd/schtasks）：
openclaw gateway uninstall
  1. 删除状态 + 配置：
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
如果你把 OPENCLAW_CONFIG_PATH 设置到了状态目录之外的自定义位置，也要删除那个文件。
  1. 删除你的工作区（可选，会移除 agent 文件）：
rm -rf ~/.openclaw/workspace
  1. 移除 CLI 安装（选择你使用的方式）：
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
  1. 如果你安装了 macOS 应用：
rm -rf /Applications/OpenClaw.app
注意：
  • 如果你使用了 profiles（--profile / OPENCLAW_PROFILE），请为每个状态目录重复步骤 3（默认值是 ~/.openclaw-<profile>）。
  • 在远程模式下，状态目录位于gateway 主机上，所以也要在那里执行步骤 1-4。

​
手动移除服务（CLI 未安装）

当 gateway 服务还在运行，但 openclaw 已经不存在时使用此方法。

​
macOS（launchd）

默认标签是 ai.openclaw.gateway（或 ai.openclaw.<profile>；旧版 com.openclaw.* 可能仍然存在）： 
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
如果你使用了 profile，请将标签和 plist 名称替换为 ai.openclaw.<profile>。如果存在任何旧版 com.openclaw.* 的 plist，也一并移除。

​
Linux（systemd 用户单元）

默认单元名称是 openclaw-gateway.service（或 openclaw-gateway-<profile>.service）： 
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

​
Windows（计划任务）

默认任务名称是 OpenClaw Gateway（或 OpenClaw Gateway (<profile>)）。 任务脚本位于你的状态目录下。 
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
如果你使用了 profile，请删除对应的任务名称和 ~\.openclaw-<profile>\gateway.cmd。

​
正常安装 vs 源码检出

​
正常安装（install.sh / npm / pnpm / bun）

如果你使用了 https://openclaw.ai/install.sh 或 install.ps1，CLI 是通过 npm install -g openclaw@latest 安装的。 使用 npm rm -g openclaw 移除它（如果你是用 pnpm remove -g / bun remove -g 安装的，则使用相应命令）。

​
源码检出（git clone）

如果你是从仓库检出中运行的（git clone + openclaw ... / bun run openclaw ...）：
  1. 在删除仓库之前先卸载 gateway 服务（使用上面的简单路径或手动移除服务）。
  2. 删除仓库目录。
  3. 按上面所示删除状态 + 工作区。

​
相关