OpenClaw 怎么卸载？先移除程序，再决定是否删除数据

卸载前先做三件事

1. 确认安装方式：npm、Homebrew、系统安装器还是 Docker。
2. 备份 ~/.openclaw（Windows 为用户目录下的 .openclaw）。
3. 记录正在使用的频道、模型和自定义技能，确认没有仍在执行的任务。

# macOS / Linux 备份示例
cp -a ~/.openclaw ~/.openclaw-backup-2026-07-17

配置目录可能包含 API Key、频道凭据、会话和自定义技能。备份文件同样敏感，不要上传到公开网盘或 Git 仓库。

先卸载网关服务，再删除 CLI

趁 openclaw 命令仍可用，先停止并卸载托管网关。这样会在包管理器删除清理命令前，移除 launchd、systemd 或 Windows 计划任务。也可以参考官方卸载文档使用交互式 openclaw uninstall。

openclaw gateway stop
openclaw gateway uninstall

macOS 卸载

# npm 安装
npm uninstall -g openclaw

# Homebrew 安装
brew uninstall openclaw

# 检查命令是否仍存在
command -v openclaw

如果命令仍存在，运行 which -a openclaw，检查是否通过多个包管理器重复安装。

Windows 卸载

npm 安装可在 PowerShell 执行：

npm uninstall -g openclaw
Get-Command openclaw -ErrorAction SilentlyContinue

若使用图形安装器，打开“设置 → 应用 → 已安装的应用”，搜索 OpenClaw 并卸载。此操作通常不会自动删除用户数据。

Linux 卸载

# npm 安装
npm uninstall -g openclaw

# 然后检查
command -v openclaw
systemctl --user status openclaw 2>/dev/null

如果你自己创建过 systemd 服务，应先停止并禁用对应服务，再删除你创建的服务文件。不要猜测文件名后批量删除。

Docker 卸载

# 先确认准确容器名并记录所有挂载
docker ps -a --filter name=openclaw
OPENCLAW_CONTAINER=openclaw
docker inspect --format '{{range .Mounts}}{{println .Type .Source "->" .Destination}}{{end}}' "$OPENCLAW_CONTAINER"

在删除容器前，备份上一步列出的每个绑定目录。命名卷需要使用单独的卷备份流程；验证备份可读后才能继续。

# 备份并验证一个绑定目录；将路径替换为 inspect 返回的准确 Source
OPENCLAW_DATA_DIR="/来自-docker-inspect-的绝对路径"
test -d "$OPENCLAW_DATA_DIR"
umask 077
OPENCLAW_DOCKER_BACKUP="$HOME/openclaw-docker-backup-$(date +%Y%m%d-%H%M%S).tgz"
tar -czf "$OPENCLAW_DOCKER_BACKUP" -C "$(dirname "$OPENCLAW_DATA_DIR")" "$(basename "$OPENCLAW_DATA_DIR")"
chmod 600 "$OPENCLAW_DOCKER_BACKUP"
tar -tzf "$OPENCLAW_DOCKER_BACKUP" >/dev/null

# 只有在挂载备份验证成功后，才停止并删除明确的目标容器
OPENCLAW_CONTAINER=openclaw
docker stop "$OPENCLAW_CONTAINER"
docker rm "$OPENCLAW_CONTAINER"

# 按你实际使用的固定版本删除镜像
OPENCLAW_VERSION=2026.6.6
docker rmi "ghcr.io/openclaw/openclaw:$OPENCLAW_VERSION"

容器删除后，绑定目录和命名卷通常仍存在。删除持久化数据是可选且不可逆的；只处理已核对并完成备份的准确路径， 不要对猜测的默认目录执行递归删除。

选择性清理配置和数据

# macOS / Linux：先查看，再删除明确目录
ls -la ~/.openclaw
rm -rf ~/.openclaw

# Windows PowerShell
Get-ChildItem "$env:USERPROFILE.openclaw" -Force
Remove-Item -Recurse -Force "$env:USERPROFILE.openclaw"

最后验证

• openclaw --version 应提示命令不存在。
• 确认网关、Docker 容器或 systemd 服务不再运行。
• 若保留备份，确认权限只有当前用户可读。
• 若准备重新安装，先阅读 中文文档，避免恢复导致旧问题的完整配置。

常见问题

继续阅读

• English uninstall guide
• OpenClaw 中文文档
• 网关配对故障排查
• OpenClaw 安全更新