如何卸载openclaw？

一、推荐方法：使用官方卸载命令

一键完全卸载命令：

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

这条命令会自动：

• 停止网关服务

• 删除配置文件和数据

• 移除工作区

• 无需手动确认

二、详细分步卸载流程

第一步：停止运行中的服务

在卸载前，必须先停止后台运行的网关服务：

openclaw gateway stop
# 或
openclaw daemon stop

第二步：执行官方卸载命令

# 基础卸载（交互式，需要手动确认）
openclaw uninstall

# 全自动卸载（推荐）
openclaw uninstall --all --yes --non-interactive

执行后会出现选择界面，用空格键勾选所有选项（Gateway service、State + config、Workspace），然后回车确认。

第三步：卸载CLI命令行工具

根据你当时的安装方式选择对应的命令：

npm安装：

npm uninstall -g openclaw
# 或简写
npm rm -g openclaw

pnpm安装：

pnpm remove -g openclaw

bun安装：

bun remove -g openclaw

Homebrew安装（macOS）：

brew uninstall openclaw

第四步：清理残留配置文件（关键步骤）

官方卸载命令不会自动删除配置目录，必须手动清理：

macOS / Linux：

# 删除主配置目录
rm -rf ~/.openclaw

# 删除旧版本可能遗留的目录
rm -rf ~/.clawdbot ~/.moltbot ~/.molthub ~/.config/openclaw

Windows（PowerShell）：

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot"
Remove-Item -Recurse -Force "$env:APPDATA\OpenClaw"

Windows（CMD）：

rmdir /s /q "%USERPROFILE%\.openclaw"

第五步：清理系统启动项（按需）

macOS：

rm ~/Library/LaunchAgents/bot.molt.gateway.plist
rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Linux：

systemctl --user disable --now openclaw-gateway.service

Windows：

打开"任务计划程序"，删除名为"OpenClaw Gateway"的定时任务。

第六步：验证卸载

openclaw --version

如果提示"command not found"或"不是内部或外部命令"，说明卸载成功。

三、特殊情况处理

Docker安装用户：

docker compose down --volumes --remove-orphans
docker image prune -f

使用了profile的用户：

如果使用了profile（--profile或OPENCLAW_PROFILE），需要为每个profile重复清理配置目录的步骤（默认目录是~/.openclaw-<profile>）。

远程模式：

在远程模式下，状态目录位于Gateway主机上，所以也需要在远程主机上执行步骤1-4。

四、重要安全提醒

1. 撤销API Key：如果你在OpenClaw中配置过OpenAI、Claude、Gemini等平台的API Key，强烈建议去对应官网废除旧Key并重新生成，以防密钥泄露。

2. 权限问题：如果在删除时遇到权限错误，在命令前加sudo（macOS/Linux）或以管理员身份运行终端（Windows）。

3. 重启电脑：完成以上步骤后，建议重启电脑确保所有后台进程彻底关闭。

4. 移除第三方通讯渠道插件：如果前期为OpenClaw配置了外部交互渠道，需解除插件依赖并回收权限。

五、验证卸载是否彻底

1. 检查命令是否存在：which openclaw（macOS/Linux）或where openclaw（Windows）

2. 检查npm全局包：npm list -g openclaw --depth=0

3. 检查配置文件目录是否已删除

© 本文著作权归作者所有。转载请联系授权，禁止商用。

🔗 系列文章

1. openclaw能做什么？