macOS 卸载教程
删除配置目录会清除所有配置、会话、记忆、飞书连接。卸载前建议备份：
cp -r ~/.openclaw ~/.openclaw.bak
第一步：停止并卸载 Gateway 服务
# 停止网关（必须加 --force，否则会以"这是线上服务"为由拒绝执行）
openclaw gateway stop --force
# 卸载守护进程
openclaw gateway uninstall
第二步：卸载全局 npm 包
# 卸载 OpenClaw
npm uninstall -g openclaw
# 清理 npm 缓存
npm cache clean --force
第三步：删除配置文件和数据
# 删除 OpenClaw 配置目录
rm -rf ~/.openclaw
# 删除可能残留的日志
rm -rf ~/.openclaw_logs 2>/dev/null
第四步：清理环境变量
检查并删除 ~/.zshrc 或 ~/.bash_profile 中的 OpenClaw 相关配置：
# 查看是否有残留
grep -i openclaw ~/.zshrc
grep -i openclaw ~/.bash_profile
如果有，编辑删除类似这样的行：
# OpenClaw Completion
source ~/.openclaw/completions/openclaw.bash
保存后重新加载：
source ~/.zshrc
第五步：验证卸载完成
# 确认命令已不存在
which openclaw # 应该输出空或提示 not found
# 确认配置目录已删除
ls ~/.openclaw # 应该提示 No such file or directory
卸载完成。如需重装，请参考 OpenClaw macOS 安装与配置完全指南。
Windows 卸载教程
删除配置目录会清除所有配置、会话、记忆、飞书连接。卸载前建议备份：
cp -r ~/.openclaw ~/.openclaw.bak
第一步：停止并卸载 Gateway 服务
# 停止网关（必须加 --force，否则会以"这是线上服务"为由拒绝执行）
openclaw gateway stop --force
# 卸载守护进程
openclaw gateway uninstall
第二步：卸载全局 npm 包
# 卸载 OpenClaw
npm uninstall -g openclaw
# 清理 npm 缓存
npm cache clean --force
第三步：删除配置文件和数据
# 删除 OpenClaw 配置目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
# 删除可能残留的日志
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw_logs" -ErrorAction SilentlyContinue
第四步：清理环境变量
- 按
Win + R，输入sysdm.cpl，回车 - 点击 高级 → 环境变量
- 在 用户变量 中检查是否有 OpenClaw 相关的 PATH 条目
- 如果有，选中并删除
- 点击确定保存
第五步：验证卸载完成
# 确认命令已不存在
where openclaw # 应该提示找不到文件
# 确认配置目录已删除
Test-Path "$env:USERPROFILE\.openclaw" # 应该输出 False
卸载完成。如需重装，请参考 OpenClaw Windows 安装与配置完全指南。
Linux 卸载教程（Ubuntu / Debian）
删除配置目录会清除所有配置、会话、记忆、飞书连接。卸载前建议备份：
cp -r ~/.openclaw ~/.openclaw.bak
第一步：停止 OpenClaw 网关进程
# 优雅停止网关（必须加 --force，否则会以"这是线上服务"为由拒绝执行）
openclaw gateway stop --force 2>&1 || true
# 等待 2 秒让进程完全停止
sleep 2
# 验证进程已停止
ps aux | grep -i openclaw | grep -v grep
# 如果没有输出，表示进程已停止
装了 Gateway 服务的注意：如果安装时跑过
openclaw gateway install（systemd 用户服务），光杀进程没用——systemd 会把服务自动拉活（已实测：杀完 5 秒新进程就起来了）。必须先停服务：
bash systemctl --user stop openclaw-gateway.service服务的彻底移除在第四步，做完进程才真正断根。
如果 gateway stop 命令卡住或失败，强制终止：
pkill -9 -f "openclaw" 2>&1 || true
sleep 1
pkill之后也要确认服务已停（见上方提示），否则进程会被 systemd 重新拉起。
第二步：卸载 npm 全局包
# 卸载飞书插件（可能输出 up to date，见下方说明）
npm uninstall -g @openclaw/feishu 2>&1
# 卸载 OpenClaw main package
# 安装时用过 sudo 的（NodeSource 装的 Node），这里也要加 sudo，否则报 EACCES
npm uninstall -g openclaw 2>&1 || sudo npm uninstall -g openclaw
# 清理 npm 缓存（已实测：卸载后残留约 130MB）
npm cache clean --force 2>/dev/null
# 验证卸载
npm list -g openclaw 2>&1
npm list -g @openclaw/feishu 2>&1
两个已实测的坑：
①
npm uninstall -g @openclaw/feishu可能输出up to date—— 飞书插件是通过openclaw plugins install装在~/.openclaw/npm/下的，并不在 npm 全局目录，这条只是扫一遍；插件会随第五步删除配置目录一起清掉。② 如果安装时按安装教程用了
sudo（NodeSource 安装的 Node，全局目录/usr/lib/node_modules归 root 所有），这里不加 sudo 会报EACCES: permission denied—— 上面命令已带|| sudo ...兜底。
预期输出：
/usr/lib # 或 /home/你的用户名/.npm-global/lib（取决于当时怎么装的） └── (empty)
第三步：验证命令已删除
# 检查命令是否还存在
which openclaw
# 尝试执行命令
openclaw --version 2>/dev/null
# 检查二进制文件
ls -la ~/.npm-global/bin/openclaw 2>/dev/null
预期输出：
（无输出，表示命令已不存在）
第四步：禁用并删除 systemd 服务
# 禁用用户级 systemd 服务
systemctl --user disable openclaw-gateway.service 2>&1
# 输出: Removed ...wants/openclaw-gateway.service
# 停止服务（如果还在运行）
systemctl --user stop openclaw-gateway.service 2>&1 || true
# 删除 systemd 服务文件
rm -f ~/.config/systemd/user/openclaw-gateway.service
# 删除可能存在的覆盖配置
rm -rf ~/.config/systemd/user/openclaw-gateway.service.d/ 2>/dev/null
# 重新加载 systemd
systemctl --user daemon-reload 2>&1
# 验证服务已清理
systemctl --user list-unit-files | grep -i openclaw
第五步：删除配置目录
# 查看配置目录大小
du -sh ~/.openclaw/ 2>&1
# 已实测：500MB～1GB+（含插件项目和状态库，体积大是正常的）
# 删除配置目录
rm -rf ~/.openclaw/
# 验证删除
ls -la ~/.openclaw 2>/dev/null
预期输出：
ls: 无法访问 '/home/your-username/.openclaw': 没有那个文件或目录
第六步：最终全面检查
运行以下命令验证卸载是否完整：
# 1. 检查命令
command -v openclaw &>/dev/null && echo "FAIL: openclaw command still exists" || echo "OK: openclaw command removed"
# 2. 检查 npm 全局包
npm list -g openclaw 2>&1 | grep -q "openclaw" && echo "FAIL: openclaw still in npm global" || echo "OK: openclaw removed from npm global"
# 3. 检查配置目录
[ -d ~/.openclaw ] && echo "FAIL: ~/.openclaw directory still exists" || echo "OK: ~/.openclaw directory removed"
# 4. 检查 systemd 服务
[ -f ~/.config/systemd/user/openclaw-gateway.service ] && echo "FAIL: systemd service file still exists" || echo "OK: systemd service file removed"
# 5. 检查运行进程
ps aux | grep "[o]penclaw" | grep -v grep > /dev/null && echo "FAIL: OpenClaw process still running" || echo "OK: no OpenClaw process running"
# 6. 检查端口
ss -tlnp | grep -q "18789" && echo "FAIL: port 18789 still in use" || echo "OK: port 18789 released"
预期输出：
OK: openclaw command removed OK: openclaw removed from npm global OK: ~/.openclaw directory removed OK: systemd service file removed OK: no OpenClaw process running OK: port 18789 released
全部显示 OK 表示已完全卸载。
补充：容易遗漏的残留
以下位置主流程不覆盖，已实测卸载后仍然存在，需要的话手动清理：
# 运行时日志和状态锁（重启也会自动清）
rm -rf /tmp/openclaw*
# 卸载前做的备份（里面可能有 API Key 和飞书凭证，确认不用了再删）
rm -rf ~/.openclaw.bak
# 恢复 linger 默认值（安装教程里为服务器开过的话；不开也无害）
sudo loginctl disable-linger <你的用户名>
附加：Node.js 要不要一起删？
如果这台机器是专为 OpenClaw 装的 Node.js，卸完可以一并删除。先 which node 确认安装方式，再选对应命令：
NodeSource（apt）安装的 Node（安装教程 Linux 线用的就是这种）：
sudo apt remove -y nodejs
nvm 安装，或装在 ~/.local/opt 的 Node：
rm -rf ~/.local/opt/node-*
# nvm 用户还要删 ~/.nvm：
rm -rf ~/.nvm
Homebrew 安装的 Node（macOS）：
brew uninstall node@24
如果机器上还有别的项目在用 Node，请不要删。删除前用
which node确认路径，避免误删系统自带的那个。
常用管理命令
| 命令 | 作用 |
|---|---|
openclaw gateway stop --force |
停止 Gateway（必须加 --force） |
openclaw gateway uninstall |
卸载守护进程 |
openclaw status |
查看运行状态 |
openclaw logs --follow |
查看实时日志 |
评论 (0)