彻底卸载OpenClaw需依次执行：一、运行openclaw uninstall并全选选项；二、npm rm -g openclaw；三、手动删除~/.openclaw、~/openclaw、~/.local/bin/openclaw；四、which openclaw和openclaw --version验证无输出；五、systemctl --user停用并删除openclaw-gateway.service。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 Linux 系统上安装了 OpenClaw，但当前需要完全移除该工具及其全部残留文件，则可能是由于官方卸载命令未覆盖配置目录或全局二进制路径。以下是针对 Linux 平台的多种彻底卸载方法：
一、执行官方卸载命令
OpenClaw 提供内置的 uninstall 子命令，可自动清理服务、配置与工作区。该方法优先推荐，因其能识别安装方式并协调各组件卸载流程。
1、打开终端，输入：openclaw uninstall
2、使用方向键上下移动，按空格键勾选以下全部选项：Gateway service、State + config (~/.openclaw)、Workspace (agent files)
3、按回车确认选择后，系统将提示 Proceed with uninstall? ● Yes / ○ No，直接回车（默认选择 Yes）开始执行。
4、等待输出显示：✓ Gateway service removed ✓ State + config deleted ✓ Workspace cleaned OpenClaw has been uninstalled.
二、手动卸载 npm 全局包
若 OpenClaw 是通过 npm 安装的（包括使用 npm install -g openclaw 或脚本自动调用 npm），则需显式执行全局卸载命令以清除可执行文件入口。
1、在终端中运行：npm rm -g openclaw
2、如遇权限错误，改用：sudo npm rm -g openclaw，随后输入当前用户密码
3、验证是否已从 npm 命令路径中移除：npm list -g openclaw，若返回空或提示 empty，表示卸载成功
三、删除残留配置与本地安装目录
OpenClaw 不会自动删除用户主目录下的隐藏配置目录及可能存在的 git 克隆副本，这些必须手动清除，否则重装时仍会复用旧状态。
1、删除主配置目录：rm -rf ~/.openclaw
OpenClaw 基础设施心跳监控与自动恢复：部署/卸载心跳守护进程，配置主机监控（Gateway、磁盘、内存、CPU、进程），设置飞书告警，自动重启故障Gateway。适用关键词：心跳监控、heartbeat daemon、服务器告警、自动重启、健康检查、auto recovery。
2、删除可能存在的 git 克隆目录：rm -rf ~/openclaw
3、检查并清除 ~/.local/bin/ 中的包装脚本：rm -f ~/.local/bin/openclaw
4、若使用 pnpm 安装过，同步执行：pnpm remove -g openclaw
四、验证命令行残留
即使完成前述步骤，仍需确认系统是否彻底遗忘 openclaw 命令，避免 PATH 中存在孤立二进制文件干扰后续操作。
1、运行：which openclaw，若无任何输出，说明命令已不可见
2、运行：openclaw --version，若返回 command not found，表明卸载完成
3、检查全局 bin 目录常见位置：ls -l $(npm config get prefix)/bin/openclaw，若提示 No such file or directory，则该路径下无残留
五、清除 systemd 用户服务（如曾启用）
若曾通过 OpenClaw 启用后台网关服务（例如运行过 openclaw gateway start），其生成的 systemd 用户级服务文件可能仍驻留在系统中，需主动停用并卸载。
1、停止正在运行的服务：systemctl --user stop openclaw-gateway.service
2、禁用开机自启：systemctl --user disable openclaw-gateway.service
3、删除服务定义文件：rm -f ~/.config/systemd/user/openclaw-gateway.service
4、重新加载用户级 systemd 配置：systemctl --user daemon-reload
