彻底清理• 不留残留 • 小白友好

手把手教你完全卸载 OpenClaw

⚠️ 警告：卸载将删除所有配置和数据

第一章：卸载前准备

1.1 为什么要完全卸载？

以下情况建议完全卸载 OpenClaw：

•配置文件损坏，无法正常启动

•版本升级出现问题，需要全新安装

•不再使用 OpenClaw，想要彻底清理

•磁盘空间不足，需要释放空间

1.2 卸载前必读 ⚠️

⚠️ 重要警告：

完全卸载将永久删除以下内容，请确认后再操作：

•所有 AI 模型配置和 API Key

•所有聊天平台接入配置（飞书、企微、QQ等）

•所有已安装的 Skills 插件

•所有对话历史和记忆数据

•Gateway 网关服务

1.3 备份重要数据（可选）

如果以后还想恢复使用，建议先备份配置文件：

# 备份配置文件

cp -r ~/.openclaw ~/openclaw-backup

# 以后恢复时

cp -r ~/openclaw-backup ~/.openclaw

第二章：一键卸载（推荐方式）

最简单的方法是使用 OpenClaw 自带的卸载命令，会自动清理所有相关文件。

2.1 检查当前状态

首先检查 OpenClaw 是否正在运行：

openclaw status

图 2-1：检查 OpenClaw 运行状态

2.2 执行一键卸载

在终端中执行卸载命令：

openclaw uninstall

系统会询问是否继续，输入 y 确认即可。

图 2-2：执行一键卸载命令

2.3 非交互式卸载（自动化）

如果想在脚本中自动执行，使用以下命令：

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

第三章：手动卸载步骤

如果一键卸载命令无法执行，可以按以下步骤手动卸载：

步骤 1：停止 Gateway 服务

首先停止正在运行的网关服务：

openclaw gateway stop

图 3-1：停止 Gateway 服务

步骤 2：卸载 Gateway 服务

从系统中移除 Gateway 服务：

openclaw gateway uninstall

图 3-2：卸载 Gateway 服务

步骤 3：删除配置目录

删除 OpenClaw 的所有配置和数据文件：

rm -rf ~/.openclaw

图 3-3：删除配置目录

步骤 4：卸载 CLI 命令行工具

根据你使用的包管理器选择对应命令：

npm 安装的：

npm rm -g openclaw

图 3-4：卸载 npm 全局包

pnpm 安装的：

pnpm remove -g openclaw

图 3-5：卸载 pnpm 全局包

第四章：系统服务清理

不同操作系统需要清理的系统服务不同，请根据你的系统选择对应方法。

4.1 macOS 系统清理

清理 launchd 服务和启动项：

launchctl bootout gui/$UID/ai.openclaw.gateway

rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

图 4-1：macOS 系统服务清理

4.2 Linux 系统清理

清理 systemd 用户服务：

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

rm -f ~/.config/systemd/user/openclaw-gateway.service

systemctl --user daemon-reload

图 4-2：Linux 系统服务清理

4.3 Windows 系统清理

以管理员身份运行 PowerShell，执行：

schtasks /Delete /F /TN "OpenClaw Gateway"

Remove-Item -Force "$env:USERPROFILE\.openclaw"

图 4-3：Windows 系统服务清理

第五章：验证卸载完成

执行以下命令验证 OpenClaw 已完全卸载：

5.1 检查命令是否删除

which openclaw

如果没有输出，表示命令已删除。

5.2 检查配置目录是否删除

ls ~/.openclaw

如果显示 "No such file or directory"，表示配置目录已删除。

5.3 检查系统服务是否移除

# macOS

ls ~/Library/LaunchAgents/ | grep openclaw

# Linux

ls ~/.config/systemd/user/ | grep openclaw

图 5-1：检查残留文件

5.4 最终验证

图 5-2：验证卸载完成

如果以上检查都没有输出，说明 OpenClaw 已完全卸载！

第六章：常见问题

Q1：卸载后还能恢复数据吗？

不能。完全卸载会永久删除所有数据，如果需要恢复，请在卸载前备份 ~/.openclaw 目录。

Q2：卸载命令执行失败怎么办？

如果 openclaw uninstall 命令失败，请按照第三章手动卸载步骤操作。

Q3：如何检查是否有残留文件？

执行以下命令检查：

# 检查配置目录

ls -la ~ | grep openclaw

# 检查全局包

npm list -g | grep openclaw

Q4：使用了 Profile 如何卸载？

如果使用了 --profile 参数，需要额外删除对应的目录：

rm -rf ~/.openclaw-<profile名>

附录：卸载命令速查表

恭喜！OpenClaw 已完全卸载！