🦞 OpenClaw(龙虾)完全卸载保姆级教程
适用环境:Linux(Debian/Ubuntu/CentOS等)、Windows、macOS、Docker容器 适用场景:彻底卸载OpenClaw AI助手,解决不同环境下服务残留、端口占用、配置乱码等问题
🤖 什么是OpenClaw(龙虾)?
在开始卸载前,让我们先快速回顾一下这款爆火的AI助手究竟有何魅力——毕竟理解它的功能,也能帮助你更彻底地清理所有相关组件。
OpenClaw(曾用名:ClawdBot、Moltbot)是一款开源、本地优先的自主AI助手,可运行在你的电脑或服务器上(支持Linux、Windows、macOS全系统,也可通过Docker容器部署),被开发者称为"能动手干活的AI智能体",而非只会聊天的"嘴炮AI"。它的核心价值在于连接大模型与现实任务的执行中枢——传统AI(如ChatGPT、Claude)只告诉你"怎么做",它直接替你"做完"。
OpenClaw核心功能全览
📖 写在前面
虽然OpenClaw功能强大,但在测试、更新或不再使用时,很多朋友会遇到"卸载不干净" 的问题,且不同运行环境(Linux/Windows/macOS/Docker)的卸载逻辑差异较大,容易混淆:
系统级安装(Linux/Windows/macOS):易出现后台服务残留、开机自启未清理、配置文件遗留;
Docker容器安装:需单独清理容器和镜像,与系统文件无关联,无需操作系统服务;
多版本安装(如npm、源码、Docker混用):易出现残留文件交叉,导致卸载不彻底。
本篇教程将按环境分类,手把手带你彻底清理,每个环境的步骤独立且专属,避免交叉混淆,确保无论你用哪种方式安装,都能让电脑/服务器恢复如初。
⚠️ 前置准备(所有环境通用,卸载前必看)
在执行任何删除操作前,请完成以下两步,避免"文件被占用"或"删错文件"的尴尬,所有环境均可通用。
步骤1:停止OpenClaw所有运行进程
无论你使用哪种环境、哪种安装方式,先尝试停止OpenClaw相关服务,避免文件被占用导致卸载失败。
Linux/macOS:打开终端,执行命令;
Windows:以管理员身份打开PowerShell,执行命令;
Docker:打开终端,先停止容器(后续有专属步骤)。
# 通用停止网关命令(系统级安装适用)
openclaw gateway stop
# 备用停止守护进程命令(系统级安装适用)
openclaw daemon stop提示:如果提示"命令未找到",说明CLI已被删除,直接跳过,进入对应环境的核心卸载步骤。
步骤2:(可选)备份配置文件
如果你还想保留之前的对话记录、身份文件或技能配置,请先备份(Docker环境无需备份,删除容器后配置会随容器一起删除):
# Linux/macOS(系统级安装)
mkdir -p ~/openclaw-backup && cp -r ~/.openclaw ~/openclaw-backup/
# Windows(系统级安装,PowerShell执行)
mkdir "$HOME\openclaw-backup"
Copy-Item "$HOME\.openclaw" -Destination "$HOME\openclaw-backup\" -Recurse🚀 核心卸载流程(按环境分类,专属操作)
一、系统环境1:Linux系统(Debian/Ubuntu/CentOS等)
Linux系统主要通过systemd --user管理用户级服务,root用户安装的服务需额外执行sudo命令,步骤如下,全程可直接复制命令执行。
1. 停止并禁用系统服务(关键步骤,避免后台残留)
# 1. 停止用户级OpenClaw网关服务(大部分用户的安装方式)
systemctl --user disable --now openclaw-gateway.service 2>/dev/null || true
# 2. 停止root级服务(若以sudo/root身份安装,必执行)
sudo systemctl disable --now openclaw-gateway.service 2>/dev/null || true
# 3. 删除服务配置文件,彻底清除自启设置
rm -f ~/.config/systemd/user/openclaw-gateway.service
sudo rm -f /etc/systemd/system/openclaw-gateway.service 2>/dev/null || true
# 4. 重载systemd配置,使删除生效
systemctl --user daemon-reload
sudo systemctl daemon-reload 2>/dev/null || true2. 清理CLI工具与核心文件
# 卸载全局CLI(按自己的安装方式选择一条执行)
npm rm -g openclaw || pnpm rm -g openclaw || bun rm -g openclaw
# 彻底删除所有配置目录(含旧版本残留,如ClawdBot、Moltbot)
rm -rf ~/.openclaw ~/.clawdbot ~/.moltbot
# 若为源码安装(git clone),删除源码目录
rm -rf ~/openclaw3. 验证卸载结果(确保无残留)
# 检查CLI是否残留(无输出则正常)
which openclaw
# 检查残留进程(无输出则正常)
ps aux | grep -i openclaw | grep -v grep
# 检查默认端口(18789)是否被占用(无输出则正常)
lsof -i:18789 | grep -v grep4. 补充:强制清理残留进程(若有)
# 查找并杀死所有OpenClaw相关进程
ps aux | grep -i openclaw | grep -v grep | awk '{print $2}' | xargs kill -9 2>/dev/null || true
# 强制释放18789端口
lsof -i:18789 | grep -v grep | awk '{print $2}' | xargs kill -9 2>/dev/null || true二、系统环境2:Windows系统
Windows系统需以管理员身份打开PowerShell执行所有命令(否则会提示权限不足),核心是删除计划任务和开机启动项,步骤如下。
1. 删除计划任务与开机启动项(关键步骤)
# 1. 删除OpenClaw网关计划任务(含多配置场景)
schtasks /Delete /F /TN "OpenClaw Gateway" 2>$null || true
schtasks /Delete /F /TN "OpenClaw Gateway (*)" 2>$null || true
# 2. 删除开机启动脚本,避免重启后自动运行
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue2. 卸载CLI工具与核心文件
# 卸载全局CLI(按自己的安装方式选择一条执行)
npm rm -g openclaw || pnpm rm -g openclaw || bun rm -g openclaw
# 彻底删除所有配置目录(含旧版本残留)
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.moltbot" -ErrorAction SilentlyContinue
# 若为源码安装(git clone),删除源码目录
Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw" -ErrorAction SilentlyContinue3. 强制清理残留进程
# 杀死所有OpenClaw相关进程(任务管理器中也可手动查找删除)
Get-Process -Name *openclaw* -ErrorAction SilentlyContinue | Stop-Process -Force
# 强制释放18789端口(若提示端口占用)
netstat -ano | findstr :18789 | foreach { taskkill /F /PID $_.Split()[-1] }4. 验证卸载结果
# PowerShell检查CLI是否残留(无输出则正常)
Get-Command openclaw -ErrorAction SilentlyContinue
# CMD检查CLI是否残留(无输出则正常)
where openclaw
# 手动检查:打开任务管理器,搜索"openclaw",无相关进程则正常三、系统环境3:macOS系统
macOS使用launchd管理后台服务,需重点清理自启配置文件,步骤与Linux类似,但路径有差异,全程可直接复制命令执行。
1. 停止并删除后台服务(关键步骤)
# 1. 停止新版网关服务(优先执行)
launchctl bootout gui/$UID/bot.molt.gateway 2>/dev/null || true
# 2. 停止旧版本服务(兼容ClawdBot、Moltbot历史版本)
launchctl bootout gui/$UID/com.openclaw.gateway 2>/dev/null || true
launchctl bootout gui/$UID/com.clawdbot.gateway 2>/dev/null || true
# 3. 删除服务配置文件,彻底清除自启设置
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
rm -f ~/Library/LaunchAgents/com.openclaw*.plist
rm -f ~/Library/LaunchAgents/com.clawdbot*.plist2. 清理CLI工具与核心文件
# 卸载全局CLI(按自己的安装方式选择一条执行)
npm rm -g openclaw || pnpm rm -g openclaw || bun rm -g openclaw
# 删除源码安装目录(若有)
rm -rf ~/openclaw
rm -f /usr/local/bin/openclaw
# 彻底删除所有配置目录(含旧版本残留)
rm -rf ~/.openclaw ~/.clawdbot ~/.moltbot
# 若安装了桌面应用,删除应用文件
rm -rf /Applications/OpenClaw.app3. 验证卸载结果
# 检查CLI是否残留(无输出则正常)
which openclaw
# 检查残留进程(无输出则正常)
ps aux | grep -i openclaw | grep -v grep
# 检查默认端口(18789)是否被占用(无输出则正常)
lsof -i:18789 | grep -v grep四、容器环境:Docker安装版
Docker安装的OpenClaw与系统文件完全隔离,无需清理系统服务和配置目录,只需删除容器和镜像即可,步骤极简,全程终端执行。
1. 停止并删除OpenClaw容器
# 停止并强制删除所有OpenClaw相关容器(无容器则无输出)
docker rm -f $(docker ps -a | grep openclaw | awk '{print $1}') 2>/dev/null || true2. 删除OpenClaw镜像
# 删除所有OpenClaw相关镜像(无镜像则无输出)
docker rmi $(docker images | grep openclaw | awk '{print $3}') 2>/dev/null || true3. 验证卸载结果
# 检查容器是否残留(无输出则正常)
docker ps -a | grep openclaw
# 检查镜像是否残留(无输出则正常)
docker images | grep openclaw❓ 常见问题与解答 (FAQ)(按环境补充)
Q1: 执行删除命令提示「权限不足」怎么办?
A:按环境区分处理: - Linux/macOS:在命令前加 sudo,输入管理员密码即可; - Windows:必须以「管理员身份」打开PowerShell/CMD,否则无法删除计划任务和系统文件; - Docker:若提示权限不足,在命令前加 sudo(Linux/macOS),或用管理员身份打开终端(Windows)。
Q2: 卸载后仍能收到OpenClaw的IM消息(微信/电报)?
A:分环境排查: - 系统级安装:说明网关服务未彻底停止,重新执行对应环境的「停止服务」步骤; - Docker安装:说明容器未彻底删除,重新执行Docker环境的「删除容器」步骤; - 远程模式:需在运行OpenClaw网关的主机上执行卸载,本地仅需删除CLI即可。
Q3: 重装后出现「配置文件冲突」?
A:系统级安装需彻底删除配置目录(本文对应环境步骤已包含);Docker安装需删除旧容器和镜像后,重新拉取镜像创建容器即可。
Q4: 多环境混用(如同时用npm和Docker安装),如何彻底卸载?
A:分别执行对应环境的卸载步骤:先执行系统级(Linux/Windows/macOS)的卸载步骤,再执行Docker环境的卸载步骤,确保两种安装方式的残留都被清理。
✅ 总结
本文已按「Linux、Windows、macOS、Docker」四大环境,分别提供专属卸载步骤,核心要点:
系统级安装(Linux/Windows/macOS):重点清理「服务自启」「CLI工具」「配置目录」「残留进程」;
Docker安装:仅需清理「容器」和「镜像」,无需操作系统文件;
所有步骤的命令均可直接复制执行,验证步骤可确认是否彻底卸载。
至此,无论你使用哪种环境,OpenClaw都能被100%彻底卸载,无服务残留、无端口占用、无配置遗留。
希望这篇教程能帮你解决问题,欢迎在评论区留言,我会为你提供一对一的疑难解答!
🦞 OpenClaw(龙虾)完全卸载保姆级教程
https://ln8.top/archives/LxxZbMClaw
评论