Back to Blog
BlogMarch 16, 2026

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

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 社区获取最新动态和安全建议。

恭喜!你已成功告别“龙虾”,电脑恢复清爽~

Share this article