OpenClaw 卸载与清理指南
OpenClaw 卸载与清理指南
上一篇文章整理了 OpenClaw 的安装、基础配置、飞书接入等内容。
如果后续不再使用 OpenClaw，或者升级失败需要重新安装，应该如何比较干净地卸载和清理相关文件。
本文仍然以 Ubuntu 22.04.5 LTS 服务器环境为例。
一、卸载前说明
卸载前建议先确认两件事：
- 是否还需要保留
OpenClaw的配置文件 - 是否还需要保留
token、飞书配对信息和大模型配置
如果只是想重装 OpenClaw，建议先停止正在运行的服务，再备份配置文件，避免备份到运行中正在变化的状态。
二、停止正在运行的 OpenClaw
卸载前，建议先停止正在运行的 OpenClaw 网关。
如果你是前台运行的：
openclaw gateway可以直接在终端里按：
Ctrl + C如果已经放到后台运行，可以先查看进程：
pgrep -af "openclaw gateway"如果能看到类似下面的内容：
12345 node /home/claw/nodejs/bin/openclaw gateway说明当前还有进程在运行。
停止进程：
kill 12345这里的 12345 换成你自己服务器上查到的进程 ID。
如果进程没有正常退出，可以再确认一次：
pgrep -af "openclaw gateway"没有输出就说明已经停止。
三、备份 OpenClaw 配置文件
停止 OpenClaw 后，再备份配置文件会更稳妥。
常见配置目录一般在：
~/.openclaw可以先查看一下：
ls -la ~/.openclaw如果目录存在，可以先备份：
cp -r ~/.openclaw ~/.openclaw.bak这样后面即使误删，也还能从备份里找回配置。
四、卸载 OpenClaw 全局包
如果上一篇文章是通过下面这种方式安装的：
npm install -g openclaw那么卸载时可以执行：
npm uninstall -g openclaw或者写成：
npm rm -g openclaw卸载完成后，可以检查命令是否还存在：
which openclaw如果没有输出，通常说明 openclaw 命令已经被移除。
也可以再执行：
openclaw --version如果提示命令不存在，说明全局包已经卸载成功。
五、清理 OpenClaw 配置文件
如果你只是想卸载程序，但后续可能还要继续使用原来的配置，可以跳过这一节。
如果你确定不再需要配置文件，可以删除：
rm -rf ~/.openclaw删除后检查：
ls -la ~/.openclaw如果提示目录不存在，说明已经清理完成。
需要注意的是，~/.openclaw 里面可能包含：
token- 大模型配置
- 飞书配对信息
- 本地运行相关配置
所以不确定时，不建议直接删除，最好先备份：
cp -r ~/.openclaw ~/.openclaw.bak六、清理 npm 缓存
如果你卸载是为了重新安装，或者之前安装过程有异常，可以顺手清理一下 npm 缓存。
npm cache clean -f然后检查缓存状态：
npm cache verify这一步不是必须的，但遇到安装失败、依赖异常、版本混乱时会比较有用。
七、是否需要卸载 Node.js
如果你的服务器上只有 OpenClaw 使用 Node.js，并且后续不再需要其他 Node 项目，可以考虑继续清理 Node.js。
上一篇文章里是把 Node.js 安装到了：
$HOME/nodejs可以先确认一下：
ls -la $HOME/nodejs如果确认不再需要，可以删除：
rm -rf $HOME/nodejs然后编辑环境变量文件：
nano ~/.bashrc找到类似下面的内容：
export NODE_HOME=$HOME/nodejs
export PATH=$NODE_HOME/bin:$PATH或者：
export PATH=$HOME/nodejs/bin:$PATH把这些和 Node.js 相关的配置删除。
保存后执行：
source ~/.bashrc最后检查：
node -v
npm -v如果提示命令不存在，说明当前用户环境里的 Node.js 已经清理掉了。
八、恢复 npm 官方源
上一篇文章里为了加快安装速度，配置过国内镜像：
npm config set registry https://registry.npmmirror.com如果后续你还会继续使用 npm，可以按自己的情况决定是否恢复官方源。
恢复官方源：
npm config set registry https://registry.npmjs.org查看当前源：
npm config get registry如果输出：
https://registry.npmjs.org/说明已经恢复成功。
如果你后续主要在国内服务器上安装依赖，也可以继续保留国内镜像，不一定非要恢复。
九、检查残留文件
可以用下面几个命令检查是否还有明显残留。
检查 openclaw 命令：
which openclaw检查 OpenClaw 配置目录：
ls -la ~/.openclaw检查是否还有网关进程：
pgrep -af "openclaw"检查 npm 全局包：
npm list -g --depth=0如果没有看到 openclaw，基本就清理完成了。
十、重新安装前建议
如果你卸载 OpenClaw 是为了重新安装，建议按下面这个顺序来：
- 先停止旧进程
- 备份
~/.openclaw - 卸载旧的
openclaw全局包 - 清理
npm缓存 - 重新安装
openclaw - 再执行初始化或恢复配置
重新安装：
npm install -g openclaw如果想重新走初始化流程：
openclaw onboard --install-daemon如果你已经备份了旧配置，也可以根据实际情况从备份目录里恢复。
十一、常见问题
1. 卸载后 openclaw 命令还在
先确认命令位置：
which openclaw如果还能看到路径，说明可能还有残留的全局命令。
可以查看 npm 全局目录：
npm root -g
npm bin -g然后确认 openclaw 是否还在对应目录里。
一般情况下，重新执行一次卸载即可：
npm uninstall -g openclaw2. 删除配置后无法恢复 token
如果没有提前备份 ~/.openclaw，删除后通常无法直接恢复。
所以卸载前最好先执行：
cp -r ~/.openclaw ~/.openclaw.bak尤其是已经接入飞书、配置过大模型服务商的环境，不建议直接删除配置目录。
3. kill 后进程又自动启动
如果你之前安装过 daemon，或者用其他方式做了守护进程，kill 后可能会自动拉起。
可以先检查是否还有相关服务：
systemctl --user list-units | grep -i claw也可以检查当前用户的定时任务：
crontab -l如果你是用 pm2、screen、tmux 等工具启动的，也需要到对应工具里停止。
例如检查 pm2：
pm2 list如果里面有 openclaw，可以停止：
pm2 stop openclaw
pm2 delete openclaw十二、完整卸载命令参考
如果你确定不需要保留任何配置，可以参考下面这组命令。
执行前请确认当前用户就是安装 OpenClaw 的用户。
pgrep -af "openclaw"
npm uninstall -g openclaw
rm -rf ~/.openclaw
npm cache clean -f如果还要删除上一篇文章里手动安装的 Node.js：
rm -rf $HOME/nodejs
nano ~/.bashrc
source ~/.bashrc最后检查：
which openclaw
pgrep -af "openclaw"如果都没有相关输出，基本就卸载干净了。
十三、补充建议
卸载 OpenClaw 时，最重要的是不要急着删配置。
比较稳妥的做法是：
- 先停进程
- 再卸载程序
- 配置目录先备份
- 确认不需要后再删除
- Node.js 是否删除要看服务器上有没有其他项目依赖
这样处理会更安全，也方便后续重新安装或排查问题。