☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
图：openclaw 卸载干净的完整方法：配置文件、缓存、守护进程一起删
大多数人卸载 OpenClaw 时只跑了一条命令：
<code>npm uninstall -g openclaw</code>
然后发现重新安装时报奇怪的错，或者某些配置莫名其妙还在，或者 macOS 的菜单栏里还有那个图标……
原因是 OpenClaw 不只是一个 npm 包。它安装时在多个位置留下了文件：守护进程服务、配置目录、日志、凭证、缓存——仅卸载 npm 包只是去掉了可执行文件，其他东西都还在。
本文给出在 macOS 和 Linux 上彻底卸载 OpenClaw 的完整步骤，以及想保留数据时的选择性清理方法。更多资源请访问 OpenClaw 中文版官网。
一、卸载前的决定：要不要保留数据
在动手之前，先确认你的目的：
- 完全卸载，什么都不留：重装系统、彻底放弃使用、换到别的工具
- 清理后重装：遇到配置问题想从头来过，但想保留对话历史和记忆文件
- 只停止服务，不删数据：暂时不用但以后可能回来
OpenClaw 的数据主要在 ~/.openclaw/ 目录里，包含：
| 目录/文件 | 内容 | 是否建议保留 |
|---|---|---|
~/.openclaw/openclaw.json |
主配置文件（模型、渠道、工具权限等） | 想重装的话可以备份 |
~/.openclaw/agents/ |
智能体数据、对话历史（JSONL）、记忆文件 | 想保留历史可以保留 |
~/.openclaw/credentials/ |
API Key、OAuth Token 等凭证 | 卸载时建议删除 |
~/.openclaw/logs/ |
运行日志 | 通常可以直接删 |
~/.openclaw/workspace/ |
智能体工作区文件（你让 AI 创建的文件） | 检查一下再决定 |
二、macOS 完整卸载步骤
第一步：停止 Gateway 并移除 launchd 服务
<code># 停止当前运行的 Gatewayopenclaw gateway stop# 移除 launchd LaunchAgent（开机自启服务）launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/nulllaunchctl bootout gui/$UID/ai.openclaw.node 2>/dev/null# 删除 plist 文件rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plistrm -f ~/Library/LaunchAgents/ai.openclaw.node.plist# 如果有旧版 Clawdbot / Moltbot 的服务残留，一并清理launchctl bootout gui/$UID/com.clawdbot.gateway 2>/dev/nulllaunchctl bootout gui/$UID/ai.moltbot.gateway 2>/dev/nullrm -f ~/Library/LaunchAgents/com.clawdbot.gateway.plistrm -f ~/Library/LaunchAgents/ai.moltbot.gateway.plist</code>
第二步：卸载 macOS App（如果通过 Homebrew 安装了桌面 App）
<code># 查看是否安装了 caskbrew list --cask | grep openclaw# 如果有，卸载brew uninstall --cask openclaw# 清理 Application Support 里的残留rm -rf ~/Library/Application\ Support/OpenClawrm -rf ~/Library/Application\ Support/Clawdbotrm -rf ~/Library/Application\ Support/Moltbot</code>
第三步：卸载 npm 全局包
<code># 卸载 openclaw npm 包npm uninstall -g openclaw# 验证已删除which openclaw# 应该输出：openclaw not found 或者空白</code>
第四步：删除配置和数据目录
⚠️ 在执行这步之前，确认你不需要保留任何数据。这步删除的是你所有的 OpenClaw 配置、对话历史和记忆文件，无法恢复。
<code># 如果想备份配置和历史，先备份cp -r ~/.openclaw ~/openclaw_backup_$(date +%Y%m%d)# 删除主数据目录rm -rf ~/.openclaw# 如果曾经用过 Clawdbot 或 Moltbot 名称时期的版本，也清理旧目录rm -rf ~/.clawdbotrm -rf ~/.moltbot</code>
第五步：清理 macOS 偏好设置和缓存（彻底版）
<code># 清理偏好设置文件rm -f ~/Library/Preferences/ai.openclaw.plistrm -f ~/Library/Preferences/com.clawdbot.plist# 清理缓存rm -rf ~/Library/Caches/OpenClawrm -rf ~/Library/Caches/Clawdbot# 清理日志rm -rf ~/Library/Logs/OpenClaw</code>
第六步：验证清理结果
<code># 确认命令已不可用which openclaw# 确认 launchd 服务已移除launchctl list | grep openclaw# 应无输出# 确认数据目录已删除ls ~/.openclaw# 应提示 No such file or directory</code>
三、Linux 完整卸载步骤
第一步：停止 Gateway 并移除 systemd 服务
<code># 停止并禁用 systemd 用户服务systemctl --user stop openclaw-gateway 2>/dev/nullsystemctl --user disable openclaw-gateway 2>/dev/nullsystemctl --user stop openclaw-node 2>/dev/nullsystemctl --user disable openclaw-node 2>/dev/null# 删除 service 文件rm -f ~/.config/systemd/user/openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-node.service# 重载 systemd（让它知道文件已删除）systemctl --user daemon-reload</code>
第二步：卸载 npm 全局包
<code>npm uninstall -g openclaw# 如果用的是 pnpmpnpm remove -g openclaw</code>
第三步：删除数据目录
<code># 可选：先备份cp -r ~/.openclaw ~/openclaw_backup_$(date +%Y%m%d)# 删除主目录rm -rf ~/.openclawrm -rf ~/.clawdbotrm -rf ~/.moltbot</code>
第四步：清理 XDG 配置（如果有）
部分配置可能在 XDG 标准路径下：
<code>rm -rf ~/.config/openclawrm -rf ~/.local/share/openclawrm -rf ~/.cache/openclaw</code>
第五步：验证
<code>which openclawsystemctl --user status openclaw-gatewayls ~/.openclaw</code>
三条命令都应该显示”不存在/未找到”。
四、Docker 部署的卸载
如果你用 Docker Compose 方式部署 OpenClaw：
<code># 停止并删除容器docker compose down# 删除镜像（可选，节省磁盘空间）docker rmi openclaw/openclaw# 删除数据卷（如果配置了持久化卷）docker compose down -v # 同时删除挂载的 volumes# 删除项目目录（包含 docker-compose.yml 和挂载的数据目录）rm -rf ~/openclaw-docker/ # 换成你实际的项目目录</code>
五、只想重装，不想丢数据怎么办
如果你的目标不是彻底卸载，而是”出了问题想重装干净一点”，可以只清理配置文件，保留历史数据：
<code># 只删配置文件，保留 agents 和 workspacerm ~/.openclaw/openclaw.jsonrm -rf ~/.openclaw/credentials/ # 凭证建议重新获取# 保留：# ~/.openclaw/agents/ ← 对话历史# ~/.openclaw/workspace/← 工作区文件# 然后重新安装npm install -g openclaw@latest# 重新运行引导向导openclaw onboard</code>
这样新安装的 OpenClaw 会自动发现 agents/ 目录里的旧数据，对话历史和记忆文件都还在。
六、一键脚本（谨慎使用）
如果确认要完全卸载，可以把上面的步骤合成一个脚本，一次性执行：
<code>#!/bin/bash# OpenClaw 完全卸载脚本（macOS 版本）# ⚠️ 执行前请确认已备份需要保留的数据echo "停止 Gateway 服务..."openclaw gateway stop 2>/dev/nullecho "移除 launchd 服务..."launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/nulllaunchctl bootout gui/$UID/ai.openclaw.node 2>/dev/nullrm -f ~/Library/LaunchAgents/ai.openclaw.*.plistecho "卸载 npm 包..."npm uninstall -g openclaw 2>/dev/nullecho "删除数据目录..."rm -rf ~/.openclawrm -rf ~/.clawdbotrm -rf ~/.moltbotecho "清理系统文件..."rm -rf ~/Library/Application\ Support/OpenClaw 2>/dev/nullrm -rf ~/Library/Caches/OpenClaw 2>/dev/nullrm -f ~/Library/Preferences/ai.openclaw.plist 2>/dev/nullecho "完成。验证结果："which openclaw && echo "⚠️ openclaw 命令仍然存在" || echo "✅ openclaw 命令已删除"ls ~/.openclaw 2>/dev/null && echo "⚠️ 数据目录仍然存在" || echo "✅ 数据目录已删除"launchctl list | grep openclaw && echo "⚠️ launchd 服务仍然存在" || echo "✅ launchd 服务已删除"</code>
把上面内容保存为 uninstall-openclaw.sh，然后：
<code>chmod +x uninstall-openclaw.sh./uninstall-openclaw.sh</code>
七、卸载后重装：避免踩同一个坑
如果你是因为某个问题卸载再重装，重装前值得先想清楚当初遇到了什么问题，避免重蹈覆辙：
- 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 的核心就是三件事：
- 停止并移除系统服务（launchd / systemd）——否则服务进程还在后台跑
- 卸载 npm 全局包——删除可执行文件
- 删除
~/.openclaw/目录——清理配置、凭证、历史数据
三步全做完，才算真正卸载干净。
想了解 OpenClaw 的安装和配置，欢迎访问 OpenClaw 中文版官网。
