3.5 卸载指南

本指南介绍 OpenClaw 的两种主要卸载方法。

简单方法（CLI 仍可用）

推荐的方法是使用内置的卸载命令。用户可以交互式运行或非交互式运行以实现自动化。

# 交互式卸载
openclaw uninstall

# 非交互式卸载（自动化）
openclaw uninstall --yes

手动替代方法包含六个顺序步骤：

1. 停止 gateway 服务
2. 卸载服务
3. 删除配置目录
4. （可选）删除工作区文件夹
5. 通过包管理器删除 CLI 包
6. （macOS）删除应用程序包

关键注意事项：

• 处理具有单独状态目录的多个配置文件
• 确保在各自主机上清理远程 gateway 服务

手动服务删除（CLI 缺失）

对于 CLI 删除后服务仍然存在的情况，提供特定平台的说明：

macOS

用户应使用 launchctl bootout 禁用 launchd 服务，并"从 ~/Library/LaunchAgents 删除相应的 plist 文件"以完全卸载持久代理。

# 停止并禁用 launchd 服务
launchctl bootout gui/$UID/bot.molt.gateway

# 删除 plist 文件
rm ~/Library/LaunchAgents/bot.molt.gateway.plist

Linux

systemd 用户单元需要使用 systemctl --user disable --now 禁用并删除服务配置文件。

# 禁用并停止服务
systemctl --user disable --now openclaw-gateway.service

# 删除服务文件
rm ~/.config/systemd/user/openclaw-gateway.service

Windows

通过 schtasks /Delete 管理计划任务以删除持久 gateway 任务。

schtasks /Delete /TN "OpenClaw Gateway" /F

安装上下文

文档区分标准安装（npm/pnpm/bun 全局包）和来自 Git 仓库的源码检出，后者需要在删除目录之前先删除服务。

npm 全局安装卸载

npm uninstall -g openclaw

pnpm 全局安装卸载

pnpm remove -g openclaw

删除配置和数据

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

# 删除工作区（可选，包含您的数据）
rm -rf ~/openclaw-workspace