OpenClaw 卸载干净的完整方法：配置文件、缓存、守护进程一起删

大多数人卸载 OpenClaw 时只跑了一条命令：

npm uninstall -g openclaw

然后发现重新安装时报奇怪的错，或者某些配置莫名其妙还在，或者 macOS 的菜单栏里还有那个图标……

原因是 OpenClaw 不只是一个 npm 包。它安装时在多个位置留下了文件：守护进程服务、配置目录、日志、凭证、缓存——仅卸载 npm 包只是去掉了可执行文件，其他东西都还在。

本文给出在 macOS 和 Linux 上彻底卸载 OpenClaw 的完整步骤，以及想保留数据时的选择性清理方法。更多资源请访问 OpenClaw 中文版官网。

一、卸载前的决定：要不要保留数据

在动手之前，先确认你的目的：

• 完全卸载，什么都不留：重装系统、彻底放弃使用、换到别的工具
• 清理后重装：遇到配置问题想从头来过，但想保留对话历史和记忆文件
• 只停止服务，不删数据：暂时不用但以后可能回来

OpenClaw 的数据主要在 ~/.openclaw/ 目录里，包含：

二、macOS 完整卸载步骤

第一步：停止 Gateway 并移除 launchd 服务

# 停止当前运行的 Gateway
openclaw gateway stop

# 移除 launchd LaunchAgent（开机自启服务）
launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/null
launchctl bootout gui/$UID/ai.openclaw.node 2>/dev/null

# 删除 plist 文件
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
rm -f ~/Library/LaunchAgents/ai.openclaw.node.plist

# 如果有旧版 Clawdbot / Moltbot 的服务残留，一并清理
launchctl bootout gui/$UID/com.clawdbot.gateway 2>/dev/null
launchctl bootout gui/$UID/ai.moltbot.gateway 2>/dev/null
rm -f ~/Library/LaunchAgents/com.clawdbot.gateway.plist
rm -f ~/Library/LaunchAgents/ai.moltbot.gateway.plist

第二步：卸载 macOS App（如果通过 Homebrew 安装了桌面 App）

# 查看是否安装了 cask
brew list --cask | grep openclaw

# 如果有，卸载
brew uninstall --cask openclaw

# 清理 Application Support 里的残留
rm -rf ~/Library/Application\ Support/OpenClaw
rm -rf ~/Library/Application\ Support/Clawdbot
rm -rf ~/Library/Application\ Support/Moltbot

第三步：卸载 npm 全局包

# 卸载 openclaw npm 包
npm uninstall -g openclaw

# 验证已删除
which openclaw
# 应该输出：openclaw not found 或者空白

第四步：删除配置和数据目录

⚠️ 在执行这步之前，确认你不需要保留任何数据。这步删除的是你所有的 OpenClaw 配置、对话历史和记忆文件，无法恢复。

# 如果想备份配置和历史，先备份
cp -r ~/.openclaw ~/openclaw_backup_$(date +%Y%m%d)

# 删除主数据目录
rm -rf ~/.openclaw

# 如果曾经用过 Clawdbot 或 Moltbot 名称时期的版本，也清理旧目录
rm -rf ~/.clawdbot
rm -rf ~/.moltbot

第五步：清理 macOS 偏好设置和缓存（彻底版）

# 清理偏好设置文件
rm -f ~/Library/Preferences/ai.openclaw.plist
rm -f ~/Library/Preferences/com.clawdbot.plist

# 清理缓存
rm -rf ~/Library/Caches/OpenClaw
rm -rf ~/Library/Caches/Clawdbot

# 清理日志
rm -rf ~/Library/Logs/OpenClaw

第六步：验证清理结果

# 确认命令已不可用
which openclaw

# 确认 launchd 服务已移除
launchctl list | grep openclaw
# 应无输出

# 确认数据目录已删除
ls ~/.openclaw
# 应提示 No such file or directory

三、Linux 完整卸载步骤

第一步：停止 Gateway 并移除 systemd 服务

# 停止并禁用 systemd 用户服务
systemctl --user stop openclaw-gateway 2>/dev/null
systemctl --user disable openclaw-gateway 2>/dev/null
systemctl --user stop openclaw-node 2>/dev/null
systemctl --user disable openclaw-node 2>/dev/null

# 删除 service 文件
rm -f ~/.config/systemd/user/openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-node.service

# 重载 systemd（让它知道文件已删除）
systemctl --user daemon-reload

第二步：卸载 npm 全局包

npm uninstall -g openclaw

# 如果用的是 pnpm
pnpm remove -g openclaw

第三步：删除数据目录

# 可选：先备份
cp -r ~/.openclaw ~/openclaw_backup_$(date +%Y%m%d)

# 删除主目录
rm -rf ~/.openclaw
rm -rf ~/.clawdbot
rm -rf ~/.moltbot

第四步：清理 XDG 配置（如果有）

部分配置可能在 XDG 标准路径下：

rm -rf ~/.config/openclaw
rm -rf ~/.local/share/openclaw
rm -rf ~/.cache/openclaw

第五步：验证

which openclaw
systemctl --user status openclaw-gateway
ls ~/.openclaw

三条命令都应该显示”不存在/未找到”。

四、Docker 部署的卸载

如果你用 Docker Compose 方式部署 OpenClaw：

# 停止并删除容器
docker compose down

# 删除镜像（可选，节省磁盘空间）
docker rmi openclaw/openclaw

# 删除数据卷（如果配置了持久化卷）
docker compose down -v   # 同时删除挂载的 volumes

# 删除项目目录（包含 docker-compose.yml 和挂载的数据目录）
rm -rf ~/openclaw-docker/   # 换成你实际的项目目录

五、只想重装，不想丢数据怎么办

如果你的目标不是彻底卸载，而是”出了问题想重装干净一点”，可以只清理配置文件，保留历史数据：

# 只删配置文件，保留 agents 和 workspace
rm ~/.openclaw/openclaw.json
rm -rf ~/.openclaw/credentials/   # 凭证建议重新获取

# 保留：
# ~/.openclaw/agents/     ← 对话历史
# ~/.openclaw/workspace/  ← 工作区文件

# 然后重新安装
npm install -g openclaw@latest

# 重新运行引导向导
openclaw onboard

这样新安装的 OpenClaw 会自动发现 agents/ 目录里的旧数据，对话历史和记忆文件都还在。

六、一键脚本（谨慎使用）

如果确认要完全卸载，可以把上面的步骤合成一个脚本，一次性执行：

#!/bin/bash
# OpenClaw 完全卸载脚本（macOS 版本）
# ⚠️ 执行前请确认已备份需要保留的数据

echo "停止 Gateway 服务..."
openclaw gateway stop 2>/dev/null

echo "移除 launchd 服务..."
launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/null
launchctl bootout gui/$UID/ai.openclaw.node 2>/dev/null
rm -f ~/Library/LaunchAgents/ai.openclaw.*.plist

echo "卸载 npm 包..."
npm uninstall -g openclaw 2>/dev/null

echo "删除数据目录..."
rm -rf ~/.openclaw
rm -rf ~/.clawdbot
rm -rf ~/.moltbot

echo "清理系统文件..."
rm -rf ~/Library/Application\ Support/OpenClaw 2>/dev/null
rm -rf ~/Library/Caches/OpenClaw 2>/dev/null
rm -f ~/Library/Preferences/ai.openclaw.plist 2>/dev/null

echo "完成。验证结果："
which openclaw && echo "⚠️ openclaw 命令仍然存在" || echo "✅ openclaw 命令已删除"
ls ~/.openclaw 2>/dev/null && echo "⚠️ 数据目录仍然存在" || echo "✅ 数据目录已删除"
launchctl list | grep openclaw && echo "⚠️ launchd 服务仍然存在" || echo "✅ launchd 服务已删除"

把上面内容保存为 uninstall-openclaw.sh，然后：

chmod +x uninstall-openclaw.sh
./uninstall-openclaw.sh

七、卸载后重装：避免踩同一个坑

如果你是因为某个问题卸载再重装，重装前值得先想清楚当初遇到了什么问题，避免重蹈覆辙：

• Token 问题：重装后运行 openclaw gateway install 之后，立刻查看并记录 Token：openclaw config get gateway.auth.token
• 重启后 Gateway 消失：安装完先跑 openclaw gateway install 注册系统服务，不要只运行临时进程
• 只能聊天不能干活：安装后立刻配置 tools.exec.allow 打开执行权限
• 速度慢：重装前先换 npm 源：npm config set registry https://registry.npmmirror.com

总结：卸载三步核心

不管 macOS 还是 Linux，彻底卸载 OpenClaw 的核心就是三件事：

1. 停止并移除系统服务（launchd / systemd）——否则服务进程还在后台跑
2. 卸载 npm 全局包——删除可执行文件
3. 删除 ~/.openclaw/ 目录——清理配置、凭证、历史数据

三步全做完，才算真正卸载干净。

想了解 OpenClaw 的安装和配置，欢迎访问 OpenClaw 中文版官网。