OpenClaw 完整卸载#

本教程涵盖在不同操作系统和不同安装方式下完整卸载 OpenClaw 的方法。

Docker Compose 容器化部署卸载#

停止并删除容器和卷#

PRTCL // BASH

1
# 进入 OpenClaw 项目目录
2
cd ~/openclaw
3

4
# 停止并删除容器、网络
5
docker compose down
6

7
# 停止并删除容器、网络、数据卷（彻底删除数据）
8
docker compose down -v
9

10
# 删除项目目录
11
cd ~
12
rm -rf ~/openclaw

删除 Docker 镜像（可选）#

PRTCL // BASH

1
# 删除 OpenClaw 镜像
2
docker rmi openclaw/openclaw:latest
3

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

7
# 查看所有镜像
8
docker images

清理 Docker 系统（可选）#

PRTCL // BASH

1
# 删除所有未使用的资源
2
docker system prune -a --volumes
3

4
# 警告：这将删除所有未使用的容器、网络、镜像和卷

Windows 卸载#

WSL2 + Docker 部署卸载#

卸载 OpenClaw#

PRTCL // BASH

1
# 进入 WSL2 Ubuntu
2
wsl -d Ubuntu-24.04
3

4
# 停止并删除容器
5
cd ~/openclaw
6
docker compose down -v
7

8
# 删除项目目录
9
cd ~
10
rm -rf ~/openclaw
11

12
# 退出 WSL2
13
exit

卸载 WSL2 Ubuntu 发行版（可选）#

PRTCL // POWERSHELL

1
# 列出所有 WSL 发行版
2
wsl --list --verbose
3

4
# 删除 Ubuntu 发行版
5
wsl --unregister Ubuntu-24.04
6

7
# 卸载 WSL 功能（完全卸载）
8
wsl --shutdown
9
dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
10
dism.exe /online /disable-feature /featurename:VirtualMachinePlatform /all /norestart

Docker Desktop 部署卸载#

卸载 OpenClaw#

PRTCL // POWERSHELL

1
# 进入项目目录
2
cd C:\Users\%USERNAME%\openclaw
3

4
# 停止并删除容器
5
docker compose down -v
6

7
# 删除项目目录
8
cd C:\Users\%USERNAME%\
9
rmdir /s /q openclaw

卸载 Docker Desktop（可选）#

PRTCL // POWERSHELL

1
# 使用控制面板卸载
2
# 设置 > 应用 > 应用和功能 > Docker Desktop > 卸载
3

4
# 或使用命令行
5
winget uninstall Docker.DockerDesktop

原生 Node.js 安装卸载#

卸载 OpenClaw#

PRTCL // POWERSHELL

1
# 停止 PM2 进程（如果使用）
2
pm2 stop openclaw
3
pm2 delete openclaw
4
pm2 save
5

6
# 删除项目目录
7
rmdir /s /q C:\Users\%USERNAME%\.openclaw
8

9
# 删除 PM2 数据（可选）
10
rmdir /s /q %APPDATA%\pm2

清理系统残留#

PRTCL // POWERSHELL

1
# 删除 npm 缓存
2
npm cache clean --force
3

4
# 删除环境变量（如果手动添加）
5
# 系统属性 > 高级 > 环境变量

macOS 卸载#

Docker Desktop 部署卸载#

卸载 OpenClaw#

PRTCL // BASH

1
# 停止并删除容器
2
cd ~/openclaw
3
docker compose down -v
4

5
# 删除项目目录
6
cd ~
7
rm -rf ~/openclaw

卸载 Docker Desktop（可选）#

PRTCL // BASH

1
# 停止 Docker Desktop
2
osascript -e 'quit app "Docker"'
3

4
# 删除 Docker Desktop
5
brew uninstall --cask docker
6

7
# 删除 Docker 相关文件
8
sudo rm -rf /Applications/Docker.app
9
rm -rf ~/Library/Containers/com.docker.docker
10
rm -rf ~/Library/Application\ Support/Docker\ Desktop
11
rm -rf ~/.docker

原生 Node.js 安装卸载#

卸载 OpenClaw#

PRTCL // BASH

1
# 停止 LaunchAgent 服务
2
launchctl unload ~/Library/LaunchAgents/com.user.openclaw.plist
3

4
# 删除 LaunchAgent 配置
5
rm ~/Library/LaunchAgents/com.user.openclaw.plist
6

7
# 停止 PM2 进程（如果使用）
8
pm2 stop openclaw
9
pm2 delete openclaw
10
pm2 save
11

12
# 删除项目目录
13
rm -rf ~/.openclaw
14

15
# 删除 PM2 数据（可选）
16
rm -rf ~/.pm2

清理系统残留#

PRTCL // BASH

1
# 删除 npm 缓存
2
npm cache clean --force
3

4
# 删除全局 npm 包（可选）
5
npm list -g --depth=0
6
npm uninstall -g pm2

Ubuntu 24.04 卸载#

Docker Compose 部署卸载#

卸载 OpenClaw#

PRTCL // BASH

1
#!/bin/bash
2
# 停止并删除容器
3
cd ~/openclaw
4
docker compose down -v
5

6
# 删除项目目录
7
cd ~
8
rm -rf ~/openclaw
9

10
# 删除 Docker 镜像（可选）
11
docker rmi openclaw/openclaw:latest
12
docker rmi postgres:16-alpine
13
docker rmi redis:7-alpine

卸载 Docker（可选）#

PRTCL // BASH

1
#!/bin/bash
2
# 停止 Docker 服务
3
sudo systemctl stop docker
4
sudo systemctl disable docker
5

6
# 卸载 Docker 软件包
7
sudo apt purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
8

9
# 删除 Docker 数据目录
10
sudo rm -rf /var/lib/docker
11
sudo rm -rf /var/lib/containerd
12

13
# 删除 Docker 用户组
14
sudo groupdel docker
15

16
# 删除 Docker 仓库配置
17
sudo rm -rf /etc/apt/sources.list.d/docker.list
18
sudo rm -rf /etc/apt/keyrings/docker.gpg
19

20
# 清理残留软件包
21
sudo apt autoremove -y
22
sudo apt autoclean

原生 Node.js 安装卸载#

卸载 OpenClaw#

PRTCL // BASH

1
#!/bin/bash
2
# 停止并禁用 systemd 服务
3
sudo systemctl stop openclaw.service
4
sudo systemctl disable openclaw.service
5

6
# 删除 systemd 服务文件
7
sudo rm /etc/systemd/system/openclaw.service
8

9
# 重载 systemd 配置
10
sudo systemctl daemon-reload
11

12
# 删除项目目录
13
rm -rf ~/.openclaw
14

15
# 删除 PM2 进程（如果使用）
16
pm2 stop openclaw
17
pm2 delete openclaw
18
pm2 save
19
pm2 uninstall

卸载 Node.js（可选）#

PRTCL // BASH

1
#!/bin/bash
2
# 卸载 Node.js
3
sudo apt purge -y nodejs npm
4

5
# 删除 NodeSource 仓库
6
sudo rm -rf /etc/apt/sources.list.d/nodesource.list
7
sudo rm -rf /usr/share/keyrings/nodesource.gpg
8

9
# 清理残留
10
sudo apt autoremove -y
11
sudo apt autoclean
12

13
# 或使用 nvm 卸载（如果使用 nvm 安装）
14
nvm uninstall 20
15
nvm deactivate
16
rm -rf ~/.nvm

清理残留配置和数据#

检查残留文件#

查找 OpenClaw 相关文件#

PRTCL // BASH

1
# Linux/macOS
2
find ~ -name "*openclaw*" -type f 2>/dev/null
3
find ~ -name "*openclaw*" -type d 2>/dev/null
4

5
# Windows PowerShell
6
Get-ChildItem -Path C:\Users\$env:USERNAME -Recurse -Filter "*openclaw*" -ErrorAction SilentlyContinue

查找 Docker 相关文件#

PRTCL // BASH

1
# Linux/macOS
2
find ~/.docker -name "*openclaw*" 2>/dev/null
3

4
# Windows PowerShell
5
Get-ChildItem -Path $env:USERPROFILE\.docker -Recurse -Filter "*openclaw*" -ErrorAction SilentlyContinue

删除配置文件#

删除全局配置（如果存在）#

PRTCL // BASH

1
# Linux/macOS
2
rm -rf ~/.config/openclaw
3
rm -rf ~/.local/share/openclaw
4

5
# Windows
6
rmdir /s /q %APPDATA%\openclaw
7
rmdir /s /q %LOCALAPPDATA%\openclaw

删除日志文件#

PRTCL // BASH

1
# Linux
2
sudo rm /var/log/openclaw.log
3
sudo journalctl --rotate --vacuum-time=1s
4

5
# macOS
6
rm -f /tmp/openclaw.log
7
rm -f /tmp/openclaw.error.log
8

9
# Windows
10
del %TEMP%\openclaw.log

验证卸载#

检查容器和服务#

PRTCL // BASH

1
# Docker 检查
2
docker ps -a | grep openclaw
3
docker images | grep openclaw
4
docker volume ls | grep openclaw
5

6
# systemd 检查（Ubuntu）
7
sudo systemctl status openclaw.service
8

9
# LaunchAgent 检查（macOS）
10
launchctl list | grep openclaw
11

12
# PM2 检查
13
pm2 list

检查端口占用#

PRTCL // BASH

1
# Linux/macOS
2
sudo netstat -tlnp | grep :3000
3
sudo lsof -i :3000
4

5
# Windows PowerShell
6
netstat -ano | findstr :3000

检查文件残留#

PRTCL // BASH

1
# Linux/macOS
2
ls -la ~/.openclaw
3
ls -la ~/openclaw
4

5
# Windows PowerShell
6
Test-Path $env:USERPROFILE\.openclaw
7
Test-Path $env:USERPROFILE\openclaw

卸载前注意事项#

备份重要数据#

在卸载前，建议备份以下数据：

PRTCL // BASH

1
# Docker 部署
2
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/openclaw
3

4
# 原生部署
5
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw

导出配置#

PRTCL // BASH

1
# 备份配置文件
2
cp -r ~/.openclaw/workspace/config ~/openclaw-config-backup
3
cp ~/.openclaw/workspace/SOUL.md ~/openclaw-soul-backup.md
4
cp ~/.openclaw/workspace/USER.md ~/openclaw-user-backup.md

记录技能配置#

PRTCL // BASH

1
# 导出已安装的技能列表
2
ls ~/.openclaw/workspace/skills > installed-skills.txt

重新安装指南#

如果未来需要重新安装 OpenClaw，可以参考《OpenClaw 搭建教程.md》。

恢复配置#

PRTCL // BASH

1
# 恢复配置文件
2
cp ~/openclaw-config-backup/* ~/.openclaw/workspace/config/
3
cp ~/openclaw-soul-backup.md ~/.openclaw/workspace/SOUL.md
4
cp ~/openclaw-user-backup.md ~/.openclaw/workspace/USER.md

恢复数据#

PRTCL // BASH

1
# Docker 部署
2
docker compose up -d
3
docker compose exec -T postgres psql -U openclaw openclaw < backup.sql
4

5
# 原生部署
6
tar -xzf openclaw-backup-YYYYMMDD.tar.gz -C ~/

常见问题#

端口仍被占用#

PRTCL // BASH

1
# 查找占用进程
2
sudo lsof -i :3000
3

4
# 终止进程
5
sudo kill -9 <PID>
6

7
# 或使用 fuser（Linux）
8
sudo fuser -k 3000/tcp

无法删除文件#

PRTCL // BASH

1
# 检查文件权限
2
ls -la ~/.openclaw
3

4
# 修改权限
5
sudo chmod -R 755 ~/.openclaw
6
sudo chown -R $USER:$USER ~/.openclaw
7

8
# 强制删除
9
sudo rm -rf ~/.openclaw

Docker 卷无法删除#

PRTCL // BASH

1
# 停止所有容器
2
docker stop $(docker ps -aq)
3

4
# 强制删除卷
5
docker volume rm openclaw_postgres_data
6
docker volume rm openclaw_redis_data
7

8
# 或删除所有未使用的卷
9
docker volume prune

systemd 服务无法删除#

PRTCL // BASH

1
# 强制卸载服务
2
sudo systemctl stop openclaw.service
3
sudo systemctl disable openclaw.service
4
sudo rm -f /etc/systemd/system/openclaw.service
5
sudo systemctl daemon-reload
6
sudo systemctl reset-failed

卸载方式总结#

部署方式	卸载难度	数据保留	完全卸载时间
Docker Compose	⭐	易	2-5 分钟
Windows 原生	⭐⭐	中	5-10 分钟
macOS 原生	⭐⭐	中	5-10 分钟
Ubuntu 原生	⭐⭐	中	5-10 分钟

卸载建议#

优先使用 Docker 部署 - 卸载最简单，数据迁移最方便
卸载前备份数据 - 防止意外丢失配置和数据
完全卸载前测试 - 确认不再需要再执行完全卸载
保留配置文件 - 便于将来重新安装时恢复

卸载清单#

使用以下清单确保完全卸载：

最后更新: 2026-03-12 作者: EchoHaoRan

OpenClaw 完整卸载#

Docker Compose 容器化部署卸载#

停止并删除容器和卷#

删除 Docker 镜像（可选）#

清理 Docker 系统（可选）#

Windows 卸载#

WSL2 + Docker 部署卸载#

卸载 OpenClaw#

卸载 WSL2 Ubuntu 发行版（可选）#

Docker Desktop 部署卸载#

卸载 OpenClaw#

卸载 Docker Desktop（可选）#

原生 Node.js 安装卸载#

卸载 OpenClaw#

清理系统残留#

macOS 卸载#

Docker Desktop 部署卸载#

卸载 OpenClaw#

卸载 Docker Desktop（可选）#

原生 Node.js 安装卸载#

卸载 OpenClaw#

清理系统残留#

Ubuntu 24.04 卸载#

Docker Compose 部署卸载#

卸载 OpenClaw#

卸载 Docker（可选）#

原生 Node.js 安装卸载#

卸载 OpenClaw#

卸载 Node.js（可选）#

清理残留配置和数据#

检查残留文件#

查找 OpenClaw 相关文件#

查找 Docker 相关文件#

删除配置文件#

删除全局配置（如果存在）#

删除日志文件#

验证卸载#

检查容器和服务#

检查端口占用#

检查文件残留#

卸载前注意事项#

备份重要数据#

导出配置#

记录技能配置#

重新安装指南#

恢复配置#

恢复数据#

常见问题#

端口仍被占用#

无法删除文件#

Docker 卷无法删除#

systemd 服务无法删除#

卸载方式总结#

卸载建议#

卸载清单#

OpenClaw完整卸载

OpenClaw模型配置完整指南

Dify API集成完整指南

OpenClaw命令行工具速查手册

OpenClaw安全问题注意事项

评论