如何彻底卸载 OpenClaw – 完整指南

前言

OpenClaw 是一款强大的个人 AI 助手工具，支持多种消息渠道和自动化功能。但有时候你可能需要卸载它——无论是要清理系统空间、更换设备，还是暂时不需要使用。本文将详细介绍如何正确、彻底地卸载 OpenClaw。

卸载前的准备工作

• 备份重要数据：如果你在工作目录（~/.openclaw/workspace）中有重要文件，请先备份
• 停止 Gateway 服务：确保 OpenClaw 的 Gateway 服务已停止运行
• 记录配置信息：如需保留某些配置，可先导出保存

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

OpenClaw 提供了官方的卸载命令，可以方便地移除不同级别的组件。

1. 查看卸载选项

openclaw uninstall --help

2. 常用卸载场景

场景 A：仅移除 Gateway 服务（保留配置和数据）

openclaw uninstall --service

适用于：暂时不需要后台服务，但保留配置以便快速恢复。

场景 B：移除服务和配置（保留工作目录）

openclaw uninstall --service --state

适用于：重置配置但保留工作文件。

场景 C：完全卸载（保留 CLI）

openclaw uninstall --service --state --workspace

适用于：清理所有 OpenClaw 相关数据，但保留命令行工具本身。

场景 D：彻底卸载（包括 macOS App）

openclaw uninstall --all

适用于：完全移除所有 OpenClaw 组件。

3. 使用 –dry-run 预览操作

openclaw uninstall --all --dry-run

这样可以确保不会误删重要文件。

4. 非交互式卸载

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

方法二：手动卸载

1. 停止 Gateway 服务

macOS：

launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist

Linux（systemd）：

systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway

2. 删除 Gateway 服务文件

macOS：

rm ~/Library/LaunchAgents/com.openclaw.gateway.plist

Linux：

rm ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

3. 删除配置文件和状态数据

rm -rf ~/.openclaw

4. 删除 CLI 工具

npm 安装：

npm uninstall -g openclaw

pnpm 安装：

pnpm remove -g openclaw

bun 安装：

bun remove -g openclaw

5. 清理残留文件

# 检查全局 bin 目录
which openclaw

# 清理缓存
npm cache clean --force
pnpm store prune

# 删除日志和应用数据（macOS）
rm -rf ~/Library/Logs/openclaw
rm -rf ~/Library/Application\ Support/openclaw

方法三：Docker 安装方式的卸载

# 停止并删除容器
docker stop openclaw-gateway
docker rm openclaw-gateway

# 删除镜像
docker rmi openclaw/gateway:latest

# 删除数据卷（谨慎操作）
docker volume rm openclaw-data

卸载后的检查清单

• 运行 openclaw --version 应提示命令不存在
• 检查 ~/.openclaw 目录是否已删除
• 确认 Gateway 服务不再运行
• 检查系统启动项中是否还有 OpenClaw 相关条目
• 确认端口 18789 未被占用

常见问题解答

Q1: 卸载后想重新安装，之前的配置还在吗？

如果使用了 --state 或 --all 选项，配置会被删除。建议卸载前备份 ~/.openclaw/config 目录。

Q2: 卸载 CLI 后，Gateway 还在运行怎么办？

ps aux | grep openclaw
kill -9 

Q3: 如何仅重置配置而不卸载？

openclaw reset

Q4: macOS 上如何完全删除菜单栏应用？

openclaw uninstall --app
rm -rf /Applications/OpenClaw.app

总结

OpenClaw 提供了灵活的卸载选项，从仅停止服务到完全清理都可以轻松完成。建议优先使用官方 openclaw uninstall 命令，它更安全、更完整。

相关链接：

• 官方文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• Discord：https://discord.gg/clawd

---

本文基于 OpenClaw 2026.3.2 版本编写。