一、卸载场景分类与前置判断

OpenClaw的卸载过程需根据系统状态分为两种典型场景：

完整CLI环境：当openclaw命令可正常执行时，可直接调用官方卸载工具
残留服务环境：当CLI工具被误删但后台服务仍在运行时，需手动清理系统服务

建议先通过终端执行which openclaw（Linux/macOS）或where openclaw（Windows）确认工具路径，再通过ps aux | grep openclaw（Linux/macOS）或Get-Process openclaw*（Windows PowerShell）检查后台服务状态。

二、官方推荐卸载方案（首选方法）

1. 基础卸载命令

在具备完整CLI环境的系统中，执行以下命令可触发标准卸载流程：

openclaw uninstall

该命令会依次执行：

停止所有运行中的服务实例
注销系统服务注册信息
清理临时缓存文件
保留用户配置文件（如需彻底删除需手动操作）

2. 自动化批量卸载

对于需要无人值守部署的场景，可使用非交互模式参数：

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

参数说明：

--all：强制删除所有关联组件
--yes：跳过确认提示
--non-interactive：禁用交互式界面

通过包管理器安装的版本（如npm/pnpm），建议使用对应生态的卸载命令：

# npm生态
npm uninstall -g openclaw
# pnpm生态
pnpm remove -g openclaw
# 现代包管理器
bun remove -g openclaw

三、手动清理方案（残留服务场景）

当CLI工具不可用但服务仍在运行时，需按操作系统类型执行针对性清理：

1. 服务停止与注销

macOS系统

# 停止服务
launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist
# 注销服务
launchctl remove com.openclaw.gateway

Linux系统（systemd）

# 停止用户级服务
systemctl --user stop openclaw-gateway.service
# 禁用并注销服务
systemctl --user disable openclaw-gateway.service
systemctl --user daemon-reload

Windows系统

# 停止服务（管理员权限）
Stop-Service -Name "OpenClawGateway" -Force
# 删除计划任务
Unregister-ScheduledTask -TaskName "OpenClawMaintenance" -Confirm:$false

2. 文件系统清理

状态目录删除

# 默认状态目录
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
# 自定义配置处理
if [ -n "$OPENCLAW_CONFIG_PATH" ]; then
    rm -f "$OPENCLAW_CONFIG_PATH"
fi

工作区清理（可选）

# 删除工作目录（包含agent运行数据）
rm -rf ~/.openclaw/workspace
# 彻底清理示例（谨慎操作）
find ~/.openclaw -type f -name "*.log" -delete

3. 环境变量清理

检查并移除以下可能存在的环境变量：

OPENCLAW_HOME
OPENCLAW_CONFIG_PATH
PATH中的工具目录（如/usr/local/openclaw/bin）

可通过env | grep OPENCLAW（Linux/macOS）或Get-ChildItem Env: | Where-Object { $_.Name -like "*OPENCLAW*" }（Windows）进行快速检查。

四、验证卸载完整性

完成上述操作后，建议执行以下验证步骤：

服务状态检查：

# Linux/macOS
ps aux | grep openclaw
# Windows
Get-Process | Where-Object { $_.ProcessName -like "*openclaw*" }

端口占用检查：

# 检查8080等常见端口（根据实际配置调整）
lsof -i :8080  # Linux/macOS
netstat -ano | findstr :8080  # Windows

残留文件扫描：

# 查找隐藏文件
find / -name "*openclaw*" 2>/dev/null | grep -v "/proc/"
# Windows文件搜索
dir /s /b "C:\*openclaw*"

五、常见问题处理

1. 权限不足错误

当遇到Permission denied或Access is denied错误时：

macOS/Linux：使用sudo提权或切换root用户
Windows：以管理员身份运行终端

2. 服务重启问题

若服务在卸载后自动重启，需检查：

系统启动项（如~/.config/autostart/）
定时任务（cron jobs或Task Scheduler）
守护进程管理器配置

3. 依赖冲突处理

当其他软件依赖OpenClaw组件时：

建议先迁移依赖关系
使用容器化方案隔离环境
记录当前版本信息以便后续恢复

六、最佳实践建议

备份配置：卸载前建议备份~/.openclaw/config.json等重要文件
日志分析：通过~/.openclaw/logs/目录下的日志文件定位卸载问题
系统快照：在关键操作前创建系统还原点（Windows）或Time Machine备份（macOS）
版本管理：记录卸载的软件版本号，便于后续重新安装或问题排查

通过本文提供的系统化方案，开发者可针对不同场景选择最优卸载路径，确保OpenClaw组件被彻底清理而不影响系统稳定性。对于企业级部署环境，建议将卸载流程纳入基础设施即代码（IaC）管理体系，通过自动化脚本实现标准化操作。

OpenClaw 完整卸载指南：覆盖全操作系统的清理方案