OpenClaw 卸载教程

发布时间: 2026-03-13 New Article 热度: 1951

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_PATHOPENCLAW_PROFILE,需同步清理对应路径。

  3. 移除CLI与GUI

    • 包管理器安装
      npm rm -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. 系统任务与缓存

    • 查看crontabsystemd或计划任务中的残留项。
    • 清理npm缓存(若通过npm安装):
      npm cache clean --force
  3. Docker环境

    • 直接删除容器与镜像即可,无宿主机残留:
      docker rm -f openclaw_container
      docker rmi openclaw_image
      适用于容器化部署用户

五、注意事项与扩展建议

  1. 多环境与远程模式

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

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

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

常见问题补充

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

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

在下方留下您的评论.加入TG群.打赏🍗