乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 卸载完全指南

OpenClaw 卸载完全指南

当前时间： 2026-03-12 08:56:32 分类：办公文件 评论(0)
OpenClaw 卸载完全指南

macOS、Windows、Linux 三个平台完整清理流程

不是删掉程序就算卸载完成，这篇一次讲清后台服务、配置文件、API Key 和消息平台的完整清理方法。

很多人卸载 OpenClaw，只删了程序目录，结果后台服务还在跑、配置文件还留着、API Key 也没有撤销。这样做其实不算真正卸载干净。

📍开始前先确认这几件事

正式删除前，建议先做 3 件事：

1. 确认 OpenClaw 现在还在不在

2. 确认自己接过哪些模型平台、哪些消息平台

3. 记下对应的 API Key、Bot、应用名或回调配置

先确认再删除，是为了避免本地配置删掉以后，反而忘了自己到底接过哪些平台。

可以先跑两条命令看看当前状态：

openclaw --versionopenclaw gateway status

如果命令还能执行，优先走自动卸载；如果命令已经找不到，就直接走手动清理。

还要注意 3 个特殊情况：

1. 如果你设置过 OPENCLAW_STATE_DIR，配置目录可能不在默认位置

2. 如果你设置过 OPENCLAW_CONFIG_PATH，这个单独的配置文件也要删

3. 如果你装的是旧版本，目录名可能还是 ~/.clawdbot 或 ~/.moltbot

🍎macOS 卸载

方法一：自动卸载

如果 openclaw 命令还能用，优先执行：

openclaw uninstall

如果你是在脚本里执行，或者不想交互确认，可以用：

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

方法二：手动卸载

第一步：停止网关并移除服务

openclaw gateway stop # 停止服务openclaw gateway uninstall # 移除服务

如果这里提示命令找不到，说明 CLI 可能已经被删了，可以直接继续后面的步骤。

第二步：删除开机自启项

OpenClaw 在 macOS 上通常会用 launchd 管理自启动，残留文件一般在 ~/Library/LaunchAgents。

launchctl bootout gui/$UID/bot.molt.gateway 2>/dev/nullrm -f ~/Library/LaunchAgents/bot.molt.gateway.plistrm -f ~/Library/LaunchAgents/com.openclaw.gateway.plist

如果遇到权限报错，可以加 sudo 再试一次；如果还是删不掉，重启后再执行通常就能处理。

第三步：删除本地配置和旧版本目录

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"rm -f "$OPENCLAW_CONFIG_PATH"rm -rf ~/.clawdbotrm -rf ~/.moltbot

第四步：卸载 CLI 包

按你自己的安装方式执行：

npm uninstall -g openclaw

或者：

pnpm remove -g openclaw

或者：

bun remove -g openclaw

第五步：检查命令残留

which openclaw

如果还能看到路径，去对应位置手动删除。常见位置是：

  1. /usr/local/bin/openclaw

  2. /opt/homebrew/bin/openclaw

🪟 Windows 卸载

方法一：自动卸载

如果命令还能用，先执行：

openclaw uninstall

不想交互确认的话，用：

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

方法二：手动卸载

第一步：停止网关并卸载服务

openclaw gateway stopopenclaw gateway uninstall

第二步：删除计划任务

Windows 上 OpenClaw 可能通过计划任务实现自启动。这里建议直接用管理员身份打开 PowerShell。

schtasks /Delete /F /TN "OpenClaw Gateway"

第三步：删除本地配置和残留脚本

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinueRemove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot" -ErrorAction SilentlyContinueRemove-Item -Recurse -Force "$env:USERPROFILE\.moltbot" -ErrorAction SilentlyContinue

第四步：卸载 CLI 包

npm uninstall -g openclaw

如果你不是用 npm 装的，也可以改用自己的包管理器处理。

第五步：处理“文件正在使用”问题

如果删除目录时报“文件正在使用”，通常是后台还有 Node 进程没有退出：

Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force

执行完再重新删除一次。

🐧 Linux 卸载

方法一：自动卸载

openclaw uninstall

无交互场景可以用：

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

方法二：手动卸载

第一步：停止网关并卸载服务

openclaw gateway stopopenclaw gateway uninstall

第二步：清理 systemd 用户服务

Linux 上最常见的是 systemd --user。

systemctl --user disable --now openclaw-gateway.service 2>/dev/nullrm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

第三步：删除配置目录

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"rm -f "$OPENCLAW_CONFIG_PATH"rm -rf ~/.clawdbotrm -rf ~/.moltbot

第四步：卸载 CLI 包

按实际安装方式执行：

npm uninstall -g openclaw

或者：

pnpm remove -g openclaw

或者：

yarn global remove openclaw

或者

bun remove -g openclaw

🔐 别漏掉：撤销 API Key 和消息平台接入

这一步不是可选项，而是“彻底卸干净”的一部分。

卸载 OpenClaw 只会删除本机程序，不会自动帮你做下面这些事：

1. 撤销模型平台里的 API Key

2. 停用消息平台里的机器人或应用

3. 删除 Webhook、回调地址、Token、加解密密钥

如果这些东西还留着，本地虽然卸了，云端接入仍然可能有效。

1）模型平台 API Key

常见国外平台：

  • Google AI（Gemini）：去 AI Studio 删除对应 API Key

  • OpenAI（GPT）：去 API Keys 页面撤销对应密钥

  • Anthropic（Claude）：去 Console 的 Keys 页面删除密钥

常见国内平台：

  • 百度智能云 / 千帆 / 文心：进入模型服务控制台，删除 API Key、应用凭证或相关访问配置

  • 阿里云百炼 / 通义千问：进入 DashScope 或百炼控制台，删除对应 API Key

  • 智谱 AI（ChatGLM）：进入开放平台控制台，删除 API Key

  • 火山引擎 / 豆包：进入方舟或模型服务控制台，删除访问密钥、令牌或应用配置

  • 讯飞星火：进入开放平台控制台，停用或删除应用凭证

  • 腾讯混元：进入腾讯云控制台，删除访问密钥或对应模型应用配置

  • 月之暗面（Kimi）：进入开放平台控制台，删除 API Key

如果你不确定自己到底接过哪几家，最直接的办法是回看 OpenClaw 的配置文件、环境变量，或者直接去自己常用平台的控制台检查密钥列表。

2）消息平台接入

常见国外平台：

Telegram：找 @BotFather，执行 /deletebot

WhatsApp：到 WhatsApp Business 或 Meta 开发者后台删除相关接入

Discord：到 Developer Portal 删除对应 Application 或 Bot

常见国内平台：

钉钉：到开放平台后台删除机器人或应用

企业微信：到管理后台或开发者后台停用并删除自建应用、回调配置

飞书：到开放平台后台删除应用，或关闭事件订阅、回调地址

微信公众号：到公众平台清空或重置服务器配置、消息接口、回调地址

如果你之前用的是 Webhook，不要只删应用本身，回调 URL、Token、EncodingAESKey 这些配置也要一起处理。

✅怎么确认已经卸干净了

macOS / Linux

执行下面几条命令：

openclaw --versionls ~/.openclawps aux | grep -i claw

正常情况下：

openclaw --version 应该提示命令不存在~/.openclaw 应该已经不存在进程列表里不应再有 OpenClaw 相关进程

Windows

执行下面几条命令：

openclaw --versionGet-Process | Where-Object { $_.Name -like "*claw*" -or $_.Name -like "*node*" }schtasks /Query | findstr /I "OpenClaw"

正常情况下：

1. openclaw 命令应不可用2. 不应再有 OpenClaw Gateway 相关计划任务3. 如果还有可疑的 Node 进程，需要再确认是不是 OpenClaw 相关

💡 如果你只是想暂停，不是彻底卸载

那就不用删配置，也不用撤销平台接入，直接停网关就可以：

openclaw gateway stop

后面想恢复时再执行：

openclaw gateway start

📝 最后总结

OpenClaw 要想卸干净，核心就三步：

  1. 停掉网关和自启动服务

  2. 删除本地配置、旧版本目录和 CLI

  3. 回到各个平台撤销 API Key、停用机器人和回调

只删程序，不算完整卸载；把本地和云端一起清掉，才是真的结束。

如果这篇文章对你有帮助，转发给同样在折腾 OpenClaw 的朋友，能少踩不少坑。