彻底卸载OpenClaw需依次执行:一、运行openclaw uninstall并全选选项;二、npm rm -g openclaw;三、手动删除~/.openclaw、~/openclaw、~/.local/bin/openclaw;四、which openclaw和openclaw --version验证无输出;五、systemctl --user停用并删除openclaw-gateway.service。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您在 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
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










