卸载

有两种方式:

  • 简单方式:如果 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. 删除 Workspace(可选,会删除 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

注意事项:

  • 如果你用了 profile(--profile / OPENCLAW_PROFILE),要对每个状态目录重复步骤 3(默认是 ~/.openclaw-<profile>)。
  • 在远程模式下,状态目录在 Gateway 主机上,所以要在那边运行步骤 1-4。

手动移除服务(CLI 不在了)

如果 Gateway 服务还在运行但 openclaw 命令找不到了,用这个方法。

macOS (launchd)

默认标签是 bot.molt.gateway(或 bot.molt.<profile>;旧版的 com.openclaw.* 可能还存在):

launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

如果你用了 profile,把标签和 plist 名称替换成 bot.molt.<profile>。如果有旧版的 com.openclaw.* plist 文件也要删掉。

Linux (systemd user unit)

默认单元名是 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 (Scheduled Task)

默认任务名是 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.shinstall.ps1,CLI 是通过 npm install -g openclaw@latest 安装的。 用 npm rm -g openclaw 移除(如果你用的是 pnpm 或 bun,就用 pnpm remove -g / bun remove -g)。

源码安装(git clone)

如果你是从仓库运行的(git clone + openclaw ... / bun run openclaw ...):

  1. 卸载 Gateway 服务,删除仓库(用上面的简单方式或手动移除服务)。
  2. 删除仓库目录。
  3. 按上面说的移除状态和 Workspace。