卸载与删除

约 1965 字大约 7 分钟

2026-03-04

本指南将帮助你完整卸载 OpenClaw 及其相关数据。根据你的安装方式，选择对应的卸载方法。

方式一：使用内置卸载命令（推荐）

如果 OpenClaw CLI 仍然安装着，可以使用内置卸载器：

openclaw uninstall

非交互式卸载（自动化脚本）

# 一键完全卸载
openclaw uninstall --all --yes --non-interactive

# 或者使用 npx
npx -y openclaw uninstall --all --yes --non-interactive

手动步骤（与上述命令效果相同）

1. 停止 Gateway 服务

openclaw gateway stop

2. 卸载 Gateway 服务

openclaw gateway uninstall

3. 删除配置和数据

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

如果自定义了 OPENCLAW_CONFIG_PATH 且路径在状态目录外，也需要删除。

4. 删除工作区（可选）

rm -rf ~/.openclaw/workspace

5. 删除 CLI

根据你使用的包管理器选择：

# npm
npm rm -g openclaw

# pnpm
pnpm remove -g openclaw

# bun
bun remove -g openclaw

6. 如果安装了 macOS 应用

rm -rf /Applications/OpenClaw.app

使用了 profile 的用户

如果使用了 profile（--profile 或 OPENCLAW_PROFILE），需要为每个 profile 重复步骤 3（默认目录是 ~/.openclaw-<profile>）。

远程模式

在远程模式下，状态目录位于 Gateway 主机上，所以也需要在远程主机上执行步骤 1-4。

方式二：手动服务移除（CLI 已丢失）

如果 Gateway 服务仍在运行但 openclaw 命令已不存在，使用以下方法：

macOS (launchd)

默认标签是 ai.openclaw.gateway（或 ai.openclaw.<profile>；旧的 com.openclaw.* 可能仍然存在）：

# 停止服务
launchctl bootout gui/$UID/ai.openclaw.gateway

# 删除服务文件
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

如果使用了 profile，将标签和 plist 名称替换为 ai.openclaw.<profile>。如果存在旧的 com.openclaw.* plist 文件也需要删除。

Linux (systemd 用户单元)

默认单元名称是 openclaw-gateway.service（或 openclaw-gateway-<profile>.service）：

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

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

# 重新加载
systemctl --user daemon-reload

Windows (计划任务)

默认任务名称是 OpenClaw Gateway（或 OpenClaw Gateway (<profile>)）。

# 删除计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"

# 删除网关脚本
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

如果使用了 profile，删除匹配的任务名称和 ~\.openclaw-<profile>\gateway.cmd。

Docker 部署卸载

停止并删除容器

# 停止容器
docker stop openclaw

# 删除容器
docker rm openclaw

# 删除镜像
docker rmi ghcr.io/openclaw/openclaw:latest

# 删除所有相关镜像（包括旧版本）
docker images | grep openclaw | awk '{print $3}' | xargs docker rmi

删除数据卷

# 查看数据卷
docker volume ls | grep openclaw

# 删除指定数据卷
docker volume rm openclaw_data

# 或删除所有未使用的数据卷
docker volume prune

使用 Docker Compose 卸载

# 停止并删除容器、网络、数据卷
docker-compose down -v

# 删除镜像
docker-compose down --rmi all

完全清理 Docker 资源

# 删除所有停止的容器
docker container prune

# 删除所有未使用的镜像
docker image prune -a

# 删除所有未使用的数据卷
docker volume prune

# 删除所有未使用的网络
docker network prune

云端部署卸载

腾讯云轻量应用服务器

方法一：删除应用（保留服务器）

登录腾讯云控制台
进入轻量应用服务器管理页面
选择 OpenClaw 实例
点击「重置应用」或「重装系统」
选择新的镜像或系统

方法二：销毁服务器（彻底删除）

登录腾讯云控制台
进入轻量应用服务器管理页面
选择 OpenClaw 实例
点击「更多」→「销毁/退还」
确认销毁（注意：数据将无法恢复）

注意事项：

销毁前请确保已备份重要数据
已付费的服务器可能无法全额退款
绑定的域名和 IP 将被释放

阿里云 ECS

停止实例

# 使用阿里云 CLI
aliyun ecs StopInstance --InstanceId i-xxxxx

释放实例

# 释放按量付费实例
aliyun ecs DeleteInstance --InstanceId i-xxxxx --Force true

删除快照和镜像

# 删除快照
aliyun ecs DeleteSnapshot --SnapshotId s-xxxxx

# 删除自定义镜像
aliyun ecs DeleteImage --ImageId m-xxxxx

AWS EC2

终止实例

# 使用 AWS CLI
aws ec2 terminate-instances --instance-ids i-xxxxx

删除相关资源

# 删除 EBS 卷
aws ec2 delete-volume --volume-id vol-xxxxx

# 删除安全组
aws ec2 delete-security-group --group-id sg-xxxxx

# 删除密钥对
aws ec2 delete-key-pair --key-name openclaw-key

# 释放弹性 IP
aws ec2 release-address --allocation-id eipalloc-xxxxx

常见安装类型说明

正常安装（install.sh / npm / pnpm / bun）

如果使用 https://openclaw.ai/install.sh 或 install.ps1 安装，CLI 通过 npm install -g openclaw@latest 安装。使用 npm rm -g openclaw（或 pnpm remove -g / bun remove -g）删除。

源码检出（git clone）

如果从仓库检出运行（git clone + openclaw ... / bun run openclaw ...）：

先卸载 Gateway 服务（删除仓库前执行），使用上面的方式一或手动服务移除
删除仓库目录
按上面说明删除状态目录和工作区

彻底清理检查清单

完成卸载后，使用以下清单确认是否彻底删除：

1. 检查程序是否已删除

# 检查命令是否存在
openclaw --version
# 应该显示 "command not found"

# 检查进程
ps aux | grep openclaw  # Linux/macOS
tasklist | findstr openclaw  # Windows
# 应该没有相关进程

2. 检查配置文件是否已删除

# Linux/macOS
ls -la ~/.openclaw
ls -la ~/.config/openclaw
ls -la ~/.local/share/openclaw

# Windows
dir %USERPROFILE%\.openclaw
dir %APPDATA%\openclaw
dir %LOCALAPPDATA%\openclaw

3. 检查系统服务是否已删除

# Linux
systemctl status openclaw-gateway.service

# macOS
launchctl list | grep openclaw

# Windows
schtasks /Query /TN "OpenClaw Gateway"

4. 检查端口占用

# 检查默认端口 18789 是否被占用
# Linux/macOS
lsof -i :18789
netstat -an | grep 18789

# Windows
netstat -ano | findstr 18789

5. 检查 Docker 资源

# 检查容器
docker ps -a | grep openclaw

# 检查镜像
docker images | grep openclaw

# 检查数据卷
docker volume ls | grep openclaw

常见问题

Q: 卸载后仍然有进程在运行？

A: 强制终止所有相关进程：

# Linux/macOS
pkill -9 openclaw

# Windows
taskkill /F /IM openclaw.exe

Q: 无法删除配置目录（权限不足）？

A: 使用管理员权限：

# Linux/macOS
sudo rm -rf ~/.openclaw

# Windows（以管理员身份运行 PowerShell）
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

Q: npm 卸载失败？

A: 尝试以下方法：

# 清理 npm 缓存
npm cache clean --force

# 使用 sudo（Linux/macOS）
sudo npm uninstall -g openclaw

# 手动删除
rm -rf $(npm root -g)/openclaw

Q: Docker 容器无法删除？

A: 强制删除：

# 强制停止
docker kill openclaw

# 强制删除
docker rm -f openclaw

# 如果仍然失败，重启 Docker 服务
sudo systemctl restart docker  # Linux
# 或在 Docker Desktop 中重启

Q: 如何保留配置但卸载程序？

A: 只卸载程序，不删除配置：

# 只卸载 npm 包
npm uninstall -g openclaw

# 保留 ~/.openclaw 目录
# 下次重新安装时会自动使用现有配置

Q: 卸载后如何重新安装？

A: 参考安装指南：

# 重新安装
npm install -g openclaw@latest

# 如果保留了配置，直接启动即可
openclaw gateway --port 18789

Q: 云服务器销毁后数据能恢复吗？

如果提前创建了快照/镜像，可以恢复
如果没有备份，数据将永久丢失
建议在销毁前：
1. 导出配置文件
2. 备份重要数据
3. 创建服务器快照

Q: 如何只删除某个技能？

A: 使用技能管理命令：

# 列出已安装的技能
openclaw skill list

# 删除指定技能
openclaw skill uninstall <skill-name>

# 或手动删除
rm -rf ~/.openclaw/skills/<skill-name>