OpenClaw 卸载教程

一、官方卸载方式（推荐优先使用）

1. 自动卸载命令

• 若CLI仍可用，直接运行以下命令（覆盖服务、配置、工作区等核心组件）：

  openclaw uninstall --all --yes --non-interactive

  或通过npx临时调用：

  npx -y openclaw uninstall --all --yes --non-interactive

  注：此操作可能仍需手动检查残留文件，如多Profile或远程模式下的配置。

2. 扫尾检查

• 验证是否删除干净：

  openclaw --version  # 应提示“命令未找到”
  ls ~/.openclaw*     # 检查配置目录是否残留

二、分步骤卸载（适用于CLI不可用或需精准控制）

1. 停止并卸载服务

   openclaw gateway stop
   openclaw gateway uninstall

   若命令失效，需按系统手动清理服务（见下文第三部分）。

2. 删除配置与工作区

   rm -rf ~/.openclaw ~/.openclaw-* ~/.openclaw/workspace

   注意：若自定义过OPENCLAW_CONFIG_PATH或OPENCLAW_PROFILE，需同步清理对应路径。

3. 移除CLI与GUI

• 包管理器安装
  ：

  npmrm -g openclaw       # npm
  pnpm remove -g openclaw  # pnpm
  brew uninstall openclaw  # macOS Homebrew

• 源码安装
  ：需先卸载服务，再删除源码目录，避免服务引用失效路径。

三、强制卸载（服务残留时）

1. macOS

• 清理launchd服务及配置文件：

  launchctl bootout gui/$UID/ai.openclaw.gateway
  rm -f ~/Library/LaunchAgents/ai.openclaw.*.plist

  旧版本可能使用com.openclaw.*命名，需检查。

2. Linux

• 移除systemd服务：

  systemctl --user disable --now openclaw-gateway.service
  rm -f ~/.config/systemd/user/openclaw-gateway.service

  若为系统级安装，需使用sudo删除/etc/systemd/system/下的文件

3. Windows

• 删除计划任务与脚本：

  schtasks /Delete /F /TN "OpenClaw Gateway"
  Remove-Item-Force "$env:USERPROFILE\.openclaw\gateway.cmd"

  若使用PowerShell，可替换为Unregister-ScheduledTask

四、深度清理与验证

1. 检查进程与端口

   ps aux |grep -i openclaw          # 查找残留进程
   lsof -i :端口号 |grep openclaw    # 检查监听端口

2. 系统任务与缓存

• 查看crontab、systemd或计划任务中的残留项。
• 清理npm缓存（若通过npm安装）：

  npm cache clean --force

3. Docker环境

• 直接删除容器与镜像即可，无宿主机残留：

  dockerrm -f openclaw_container
  docker rmi openclaw_image

  适用于容器化部署用户

五、注意事项与扩展建议

1. 多环境与远程模式

• 若使用--profile或远程网关，需在对应主机重复卸载步骤
• 检查\~/.openclaw-<profile>和远程服务器配置。

2. 安全与备份

• API Key
  ：删除未使用的模型API Key，避免泄露
• 配置备份
  ：如需保留设置，备份\~/.openclaw目录或导出聊天记录。

3. 云服务器

• 若为临时使用，及时释放云资源，避免持续计费

常见问题补充

• 权限不足
  ：在Linux/macOS中，对系统目录操作需加sudo
• 残留检测
  ：Windows用户可使用[脚本之家](提供的检测工具一键验证
• 旧版本兼容
  ：早期版本可能使用clawdbot等命名，需调整命令关键词

通过以上步骤，可确保OpenClaw卸载彻底，避免残留文件或服务占用资源。