OpenClaw 卸载教程:彻底清理不留残留

Prerequisites
在开始卸载前,请确保:
- 你有终端(Terminal / PowerShell / CMD)的访问权限
- OpenClaw CLI 命令仍可用(如果已提前运行 npm uninstall -g openclaw,请跳到手动清理部分)
- 了解你的安装方式(npm / pnpm / bun / Docker / 源码)
- 备份重要数据(尤其是 ~/.openclaw 中的 API 密钥、记忆文件等)
警告:卸载会删除本地配置、记忆和凭证,请提前备份需要的内容。
Step 1: 停止 OpenClaw 服务
先停止后台运行的 Gateway 服务,避免卸载过程中冲突。
在终端执行: bash openclaw gateway stop
预期输出:
Gateway service stopped successfully.
如果命令不存在,跳到 Step 3 手动停止服务。
Step 2: 卸载 Gateway 服务(开机自启项)
使用官方命令移除系统服务: bash openclaw gateway uninstall
这会根据你的系统自动处理:
- macOS:移除 launchd plist
- Linux:移除 systemd user unit
- Windows:移除 schtasks 任务
预期输出示例(macOS):
Unloaded and removed launchd service: ai.openclaw.gateway
Step 3: 删除状态和配置目录
彻底清除本地数据(此步会永久删除所有配置、记忆和密钥): bash rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
常见残留目录也建议清理: bash rm -rf ~/.openclaw rm -rf ~/.clawdbot rm -rf ~/clawdbot rm -rf ~/.moltbot
Step 4: 卸载 OpenClaw CLI 工具
根据你的安装方式选择对应命令:
npm 安装(最常见): bash npm uninstall -g openclaw
pnpm 安装: bash pnpm remove -g openclaw
bun 安装: bash bun remove -g openclaw
源码安装(git clone 方式): 直接删除克隆的文件夹即可,例如: bash rm -rf ~/path/to/openclaw-repo
Step 5: 清理 Docker(如果使用 Docker 部署)
如果你通过 Docker 运行:
列出相关容器和镜像: bash docker ps -a | grep openclaw docker images | grep openclaw
停止并删除: bash docker stop <container_id> docker rm <container_id> docker rmi <image_id>
彻底清理(可选): bash docker system prune -f --volumes
Step 6: 验证是否卸载干净
运行以下命令检查:
bash which openclaw # 应该无输出 openclaw --version # 应该提示 command not found launchctl list | grep claw # macOS 检查(应无输出) systemctl --user list-units | grep claw # Linux 检查 schtasks /query | findstr claw # Windows 检查
同时检查 ~/.openclaw 是否已删除: bash ls ~/.openclaw
无输出或目录不存在即表示成功。
Common Issues & Troubleshooting
- openclaw: command not found:说明 CLI 已卸载,先手动停止服务(macOS: launchctl remove ai.openclaw.gateway;Linux: systemctl --user disable --now openclaw-gateway),再删除目录。
- 权限问题:在 Linux/macOS 加 sudo 或用管理员 PowerShell。
- 残留后台进程:用 ps aux | grep openclaw 查找并 kill 进程。
- Token 泄露担忧:卸载后建议去对应 AI 平台(如 OpenAI/Anthropic)撤销 API Key。
- 仍看到龙虾图标:检查是否安装了 macOS App,拖到废纸篓并清空。
Next Steps
- 如果改变主意想重新安装:访问 docs.openclaw.ai 查看最新安装指南。
- 考虑更轻量的本地 AI 替代方案,如 Ollama + Open WebUI。
- 加入 OpenClaw Discord 社区获取最新动态和安全建议。
恭喜!你已成功告别“龙虾”,电脑恢复清爽~