步骤:

  1. 打开 终端(Terminal / PowerShell / CMD):

    • macOS/Linux:直接打开 Terminal。
    • Windows:推荐用 PowerShellGit Bash
  2. 执行内置卸载命令(推荐一键彻底删除):

    openclaw uninstall --all --yes --non-interactive
    
    • --all:清理所有配置、数据库、会话历史等。
    • --yes / --non-interactive:跳过所有确认提示(适合不想手动勾选的用户)。

    如果想逐步确认(更安全,可选择保留部分配置),直接运行:

    openclaw uninstall
    

    然后按提示用空格键勾选要删除的选项,按回车确认。

  3. 如果上面命令不可用(CLI 已部分损坏),先尝试:

    openclaw gateway stop
    openclaw gateway uninstall
    

手动彻底清理步骤(适用于所有情况,推荐结合使用)

按以下顺序执行,确保不留残留:

  1. 停止并卸载 Gateway 服务(后台守护进程):

    openclaw gateway stop
    openclaw gateway uninstall
    
  2. 卸载全局 npm 包(根据你的安装方式选择):

    npm uninstall -g openclaw
    
    • 如果用 pnpm:pnpm remove -g openclaw
    • 如果用 bun:bun remove -g openclaw
    • 权限问题时加 sudo(macOS/Linux):sudo npm uninstall -g openclaw
  3. 删除残留数据和配置目录(非常重要!):

    rm -rf ~/.openclaw
    rm -rf ~/.clawdbot   # 旧版本可能有这个目录
    rm -rf ~/clawdbot
    
    • macOS 额外检查:rm -rf ~/Library/Application\ Support/OpenClaw
    • Windows:删除 C:\Users\你的用户名\.openclaw 文件夹(用文件资源管理器或 rmdir /s /q 命令)。
  4. 清理其他可能残留

    • 检查并删除 npm 缓存中相关内容(可选):npm cache clean --force
    • 如果用 Homebrew 安装(macOS):brew uninstall openclaw
    • Linux systemd 用户额外清理:
      systemctl --user stop openclaw-gateway
      systemctl --user disable openclaw-gateway
      rm -f ~/.config/systemd/user/openclaw-gateway.service
      systemctl --user daemon-reload
      

不同系统注意事项

  • macOS:重点清理 ~/Library/ 和 LaunchAgents(内置卸载通常已处理)。
  • Windows:如果通过安装包安装,可先去 设置 > 应用 > 已安装的应用 搜索 “OpenClaw” 卸载,再执行终端命令。
  • Linux:注意用户级 systemd 服务。
  • Docker 安装:直接 docker rm -f openclaw 或对应容器名,然后删除卷(volume)。
  • 源码安装(git clone):删除源码目录即可。

卸载后建议

  • 重启电脑,确保无残留进程。
  • 检查任务管理器/活动监视器,确认无 “openclaw” 或 “gateway” 相关进程。
  • 如果曾连接外部平台(如 WhatsApp、Telegram、飞书等),记得登出账号、删除会话、轮换 API Key,避免安全风险。
  • 验证清理:运行 which openclawopenclaw --version,应提示命令不存在。

提示:卸载前如果有重要数据,建议先备份 ~/.openclaw 目录。OpenClaw 会存储 API 密钥、会话历史等敏感信息,彻底删除能避免隐私泄露。

如果执行中遇到错误(如命令不存在、权限问题),告诉我你的操作系统和具体报错,我可以帮你细调步骤。官方文档参考:https://docs.openclaw.ai/install/uninstall(英文版,中文社区教程很多一致)。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐