乐于分享
好东西不私藏

OpenClaw 完整卸载指南(自动 + 手动)

OpenClaw 完整卸载指南(自动 + 手动)

两种方式:

  • 自动卸载(推荐):openclaw 命令仍可使用。

  • 手动卸载:CLI 已失效,但服务仍在运行。

一、自动卸载(推荐)

适用于:openclaw 命令仍可执行
1、一键卸载
openclaw uninstall

2、非交互式卸载(openclaw/npx自动卸载)

openclaw uninstall --all --yes --non-interactive

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

二、手动卸载(CLI 可用)

适用于需要精细控制卸载过程的场景
1、停止网关服务
openclaw gateway stop
2、卸载网关服务
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 app,移除它。

rm -rf /Applications/OpenClaw.app

注意:

  • 如果你使用了配置文件(--profile / OPENCLAW_PROFILE),对每个状态目录重复步骤3(默认是 ~/.openclaw-<profile>)

  • 在远程模式下,状态目录位于网关主机上,因此也需要在那里运行步骤1-4。

三、手动服务移除(CLI 已失效)

适用于:

  • 网关服务仍在运行中

  • 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

如果你使用了配置文件

替换 ai.openclaw.<profile> 的标签和 plist 名称。

如果存在任何旧版 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"

如果你使用了配置文件

  • 删除匹配的任务名称

  • ~\.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 克隆)

如果你从一个仓库检出运行

git clone + openclaw ... / bun run openclaw ...):

1.删除仓库以前卸载网关服务(使用上文中的 简单方式或者手动移除服务)

2.删除仓库目录

3.像上文提及的那样,移除状态和工作空间。