卸载
有两种方式:
- 简单方式:如果
openclaw还在的话 - 手动移除服务:如果 CLI 已经删了但服务还在运行
简单方式(CLI 还在)
推荐用内置的卸载工具:
openclaw uninstall
非交互模式(自动化 / npx):
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive
手动步骤(效果一样):
- 停止 Gateway 服务:
openclaw gateway stop
- 卸载 Gateway 服务(launchd/systemd/schtasks):
openclaw gateway uninstall
- 删除状态和配置文件:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
如果你把 OPENCLAW_CONFIG_PATH 设置到了状态目录之外的自定义位置,也要把那个文件删掉。
- 删除 Workspace(可选,会删除 Agent 文件):
rm -rf ~/.openclaw/workspace
- 移除 CLI 安装(选你用的那个):
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
- 如果你装了 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.sh 或 install.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 ...):
- 先卸载 Gateway 服务,再删除仓库(用上面的简单方式或手动移除服务)。
- 删除仓库目录。
- 按上面说的移除状态和 Workspace。