文档
安装
卸载

卸载

适用范围

使用本页面当：

  • 您想从机器上删除 Clawdbot
  • 卸载后网关服务仍在运行

两条路径：

  • 如果 clawdbot 仍安装，简单路径。
  • 如果 CLI 消失但服务仍在运行，手动服务移除。

简单路径（CLI 仍安装）

推荐：使用内置卸载程序：

clawdbot uninstall

非交互式（自动化 / npx）：

clawdbot uninstall --all --yes --non-interactive
npx -y clawdbot uninstall --all --yes --non-interactive

手动步骤（相同结果）：

  1. 停止网关服务：
clawdbot gateway stop
  1. 卸载网关服务（launchd/systemd/schtasks）：
clawdbot gateway uninstall
  1. 删除状态 + 配置：
rm -rf "${CLAWDBOT_STATE_DIR:-$HOME/.clawdbot}"

如果您将 CLAWDBOT_CONFIG_PATH 设置到状态目录之外的自定义位置，也要删除该文件。

  1. 删除您的工作区（可选，删除 agent 文件）：
rm -rf ~/clawd
  1. 删除 CLI 安装（选择您使用的那个）：
npm rm -g clawdbot
pnpm remove -g clawdbot
bun remove -g clawdbot
  1. 如果您安装了 macOS 应用：
rm -rf /Applications/Clawdbot.app

注意事项：

  • 如果您使用了配置文件（--profile / CLAWDBOT_PROFILE），为每个状态目录重复步骤 3（默认为 ~/.clawdbot-<profile>）。
  • 在远程模式下，状态目录位于网关主机上，因此在那里也运行步骤 1-4。

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

如果网关服务继续运行但 clawdbot 缺失，请使用此方法。

macOS (launchd)

默认标签是 com.clawdbot.gateway（或 com.clawdbot.<profile>）：

launchctl bootout gui/$UID/com.clawdbot.gateway
rm -f ~/Library/LaunchAgents/com.clawdbot.gateway.plist

如果您使用了配置文件，将标签和 plist 名称替换为 com.clawdbot.<profile>。

Linux (systemd 用户单元)

默认单元名称是 clawdbot-gateway.service（或 clawdbot-gateway-<profile>.service）：

systemctl --user disable --now clawdbot-gateway.service
rm -f ~/.config/systemd/user/clawdbot-gateway.service
systemctl --user daemon-reload

Windows (计划任务)

默认任务名称是 Clawdbot Gateway（或 Clawdbot Gateway (<profile>)）。 任务脚本位于您的状态目录下。

schtasks /Delete /F /TN "Clawdbot Gateway"
Remove-Item -Force "$env:USERPROFILE\.clawdbot\gateway.cmd"

如果您使用了配置文件，删除匹配的任务名称和 ~\.clawdbot-<profile>\gateway.cmd。

正常安装 vs 源码副本

正常安装 (install.sh / npm / pnpm / bun)

如果您使用 https://clawd.bot/install.sh 或 install.ps1，CLI 使用 npm install -g clawdbot@latest 安装。 使用 npm rm -g clawdbot 删除它（如果您以这种方式安装，也可以使用 pnpm remove -g / bun remove -g）。

源码副本 (git clone)

如果您从仓库副本运行（git clone + clawdbot ... / bun run clawdbot ...）：

  1. 在删除仓库之前卸载网关服务（使用上面的简单路径或手动服务移除）。
  2. 删除仓库目录。
  3. 如上所示删除状态 + 工作区。
开发频道