乐于分享
好东西不私藏

OpenClaw 卸载指南

OpenClaw 卸载指南

OpenClaw 卸载指南

本文档根据 OpenClaw 官方文档 整理。


选择卸载方式

情况
推荐方式
openclaw
CLI 仍已安装
简单方式
CLI 已删除但服务仍在运行
手动服务移除

简单方式(CLI 仍已安装)

一键卸载(推荐)

openclaw uninstall

非交互式(适用于自动化脚本):

openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactive

手动步骤(效果相同)

1. 停止 Gateway 网关服务

openclaw gateway stop

2. 卸载 Gateway 网关服务

openclaw gateway uninstall

3. 删除状态和配置

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

如果你将 OPENCLAW_CONFIG_PATH 设置为状态目录外的自定义位置,也需要一并删除该文件。

4. 删除工作区(可选)

rm -rf ~/.openclaw/workspace

5. 移除 CLI

根据你的安装方式选择对应命令:

npm rm -g openclaw# 或pnpm remove -g openclaw# 或bun remove -g openclaw

6. 如果安装了 macOS 应用

rm -rf /Applications/OpenClaw.app

注意事项

  • • 如果你使用了配置文件(--profile / OPENCLAW_PROFILE),需要对每个状态目录重复步骤 3,默认路径为 ~/.openclaw-<profile>
  • • 在远程模式下,状态目录位于 Gateway 网关主机上,需要在那里同样执行步骤 1-4。

手动服务移除(CLI 未安装)

如果 Gateway 网关服务仍在运行但 openclaw 已缺失,使用以下方式按平台手动移除。

macOS(launchd)

默认标签为 bot.molt.gateway(旧版可能为 com.openclaw.*):

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

如果使用了配置文件,将标签和 plist 名称替换为 bot.molt.<profile>,并移除所有旧版 com.openclaw.* plist。

Linux(systemd 用户单元)

默认单元名称为 openclaw-gateway.service

systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

如果使用了配置文件,单元名称为 openclaw-gateway-<profile>.service

Windows(计划任务)

默认任务名称为 OpenClaw Gateway

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

如果使用了配置文件,删除对应的任务名称和 ~\.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 openclaw# 或bun remove -g openclaw

源码检出(git clone)

如果是通过 git clone 方式运行的:

  1. 1. 在删除仓库之前,先卸载 Gateway 网关服务(使用上方的简单方式或手动服务移除)。
  2. 2. 删除仓库目录。
  3. 3. 按上述方式移除状态目录和工作区。