像我这种喜欢把工具链塞进命令行的人卸载软件自然也是先从命令行下手的。今天说的 OpenClaw群里都管它叫“龙虾”是个开源 AI 智能体助手框架很多人按官方文档用一行 curl 脚本或者 Docker compose 就把服务跑起来了。等你想换方案、回滚版本或者只是磁盘吃紧时才发现删掉主程序根本不算完配置目录、自启动服务、缓存、session 锁文件都还留在系统里端口可能还被占着。这篇就专门讲怎么用命令行把它卸载干净并且把残留清理这套标准流程完整走一遍。适合那些用 CLI/Docker 部署过 OpenClaw、现在想把它彻底移出系统的朋友也顺便把几个卸载时的经典报错一并说清楚。1. 动手卸载之前先确认这台机器上的“龙虾”是哪一种形态很多人上来就rm二进制结果回头发现openclaw命令照样能用——多半是因为系统里有多个安装路径或者核心根本不放在默认位置。OpenClaw 这类部署形态比较灵活的项目卸载前先搞清楚它是怎么装进去的比啥都重要。1.1 四种常见部署方式的特征以我目前接触到的部署场景来看绝大多数人的 OpenClaw 属于以下四种形态之一部署形态典型特征卸载时需要额外处理的对象官方脚本 / 二进制直装/usr/local/bin或~/.local/bin下有openclaw可执行文件systemd 服务、配置文件、PATH 导出Docker 容器部署docker ps能看到 openclaw 容器或 compose 项目容器、镜像、命名卷、自定义网络Homebrew 安装brew list里有 openclawbrew 自身的 formula 记录源码编译安装/opt/openclaw或~/openclaw这类源码目录编译产物、环境变量、manual 链接为什么先区分形态因为卸载的本质不是“删文件”而是“撤销当初安装时做过的每一个动作”。脚本安装写了 systemd unit那你卸载就要删 unit 并daemon-reloadDocker 部署创建了数据卷那你就要连卷一起清掉否则下次docker volume ls还能看到一坨几十 GB 的 openclaw 数据。这些动作看起来不起眼恰恰是残留大户。1.2 用三组命令做一次“安装痕迹扫描”在你执行任何删除操作之前先在终端里跑一遍下面这些命令把现场摸清楚。我习惯把输出复制到临时文件里存着删完之后再对比一次不容易漏。# 1. 查可执行文件在哪 command -v openclaw which openclaw type -a openclaw # 2. 查正在跑的进程和端口 ps aux | grep -i openclaw pgrep -af openclaw ss -tunlp | grep -i openclaw # 3. 查系统服务和容器 systemctl list-units | grep -i openclaw docker ps -a --format table {{.Names}}\t{{.Image}}\t{{.Status}} | grep -i openclaw # 4. 查常见数据目录 ls -ld ~/.openclaw ~/.claw ~/.config/openclaw ~/.cache/openclaw 2/dev/null这里头几个命令很容易被忽略type -a openclaw能同时列出 PATH 里的别名和真实路径能避免“明明删了还能执行”这种灵异事件ss -tunlp能确认 4000 或你想查的端口是否被 openclaw 占着。如果你之前是通过curl ... | bash方式装的大概率还会看到/etc/systemd/system/openclaw.service或~/.config/systemd/user/openclaw.service这个东西记得重点记下来。1.3 卸载前先备份不是怂是返工成本太高彻底卸载有个悖论清理越干净将来想找回数据就越难。OpenClaw 的配置文件里不只放着 API key还有你的会话历史、人设 prompt、mcp 配置这些一旦rm -rf就真没了。我的建议是用一条 tar 命令把整个数据目录打压缩包扔到系统盘以外的地方确认新方案没问题之后再删包。mkdir -p ~/openclaw-backup tar czf ~/openclaw-backup/openclaw-data-$(date %Y%m%d).tar.gz \ ~/.openclaw ~/.claw 2/dev/null备份完了也别急着走下一步先看压缩包大小和里面有多少个文件确认它真的包含数据。提示如果里面某份配置包含明文敏感信息备份包不要往公开仓库、云盘这类地方传本地目录放几天验证不需要了就物理删除。2. 命令行卸载按部署方式逐一击破扫描完现场接下来就是正式卸载。这一步的优先级是先停进程、再禁服务、最后删二进制顺序反了容易出现“文件被占用删不掉”或者“服务又自动拉起来”的尴尬。2.1 官方脚本 / 二进制直装Stop → Disable → Delete我见过最稳妥的卸载路径其实只有三步。第一步停掉所有相关进程。直接强杀进程组不是不行但最好是走一次正常的退出流程让服务把正在写的 session 文件保存好。# 如果有 systemd 服务先停服务 sudo systemctl stop openclaw.service sudo systemctl disable openclaw.service # 如果只是普通前台进程用 TERM 信号优雅退出 pkill -TERM -f openclaw # 等 2 秒确认进程还在不在 pgrep -af openclaw第二步删除 systemd service 文件和二进制本体。这里注意不要只删/usr/local/bin/openclaw也要看看有没有同目录下的claw别名或者/opt/openclaw整个安装目录。# 删除服务定义然后重载守护进程 sudo rm -f /etc/systemd/system/openclaw.service sudo systemctl daemon-reload # 删除可执行文件按前面扫描到的路径删 sudo rm -f /usr/local/bin/openclaw sudo rm -rf /opt/openclaw ~/.local/bin/openclaw 2/dev/null # 检查命令是否已经不存在 command -v openclaw如果command -v openclaw还有输出回到 1.2 节用type -a查一下是不是 PATH 里还有另一个副本。这一步经常翻车的是删了/usr/local/bin下的文件忘了用户目录里还有个~/.local/bin的版本shell的hash缓存还会让当前会话继续“以为”命令存在。遇到这种情况执行一下hash -r刷新当前 shell 的命令缓存。2.2 Docker 部署容器、镜像、卷一步都不能少Docker 方式卸载的核心坑在于容器删了镜像和卷还在。很多人docker rm完就觉得完事了过段时间docker system df一查几个 GB 的空间就这么白白躺着。先停容器再删容器然后删镜像和数据卷# 停容器如果有的话 docker stop openclaw # 删除容器 docker rm openclaw # 删除镜像 docker rmi ghcr.io/openclaw/openclaw # 查看是否有 openclaw 相关的数据卷 docker volume ls | grep -i openclaw # 确认卷名后删除 docker volume rm volume名称如果你当初是用docker compose up -d起的那整个项目目录一般叫openclaw或类似名字里通常还留着.env、docker-compose.yml里面可能包含端口映射、API key 等配置。这部分不属于 Docker 管要手动删掉整个目录。docker compose down --volumes --rmi all # 在 compose 项目目录里执行 rm -rf ~/openclaw-docker # 举例以你实际 compose 目录为准docker compose down --volumes --rmi all这条命令会把容器、网络、镜像和卷一次性清掉比手动docker rm更省事。但如果你 compose 文件里还挂载了宿主机目录比如./data:/root/.openclaw那宿主机的data目录也要单独清理否则残留还在。2.3 Homebrew / npm 等包管理器安装反着装一遍用包管理器装的 OpenClaw卸载本身很简单问题是卸载完之后 brew 的缓存和 npm 的 cache 不一定跟着清。# Homebrew brew uninstall openclaw brew autoremove # npm如果之前是 npm 全局装的 npm uninstall -g openclaw/cli # 清理缓存 brew cleanup这里我多说一句如果你记不清当初是不是用 brew 装的直接跑brew list --formula | grep openclaw查一下就行。有输出就是 brew 装的没输出就别硬用 brew 卸否则容易把 brew 的数据库搞乱。2.4 源码编译安装多处理两处编译残留源码编译装的 OpenClaw 是最容易被忽略的。二进制可能放在~/go/bin、~/openclaw/bin配置文件可能放在项目根目录的config/下还可能有.env文件。而且很多人编译完之后会把项目目录顺手留在桌面或 home 下卸载时完全不记得它的存在。# 如果项目里有 make 的 uninstall 目标先跑这个 make uninstall # 删除源码目录和编译产物 rm -rf ~/openclaw ~/go/bin/openclaw /tmp/openclaw-build 2/dev/null如果没有make uninstall就按 1.2 节扫描到的路径手工删。源码编译的卸载原则其实和前面一致凡是编译过程中写进了系统目录的内容尽量原路径撤销。3. 残留清理比卸载更值钱的部分二进制删完了OpenClaw 的主体就算没了。但“彻底卸载”从我的标准来看才走完一半。真正让系统变干净你要对付的是那些藏在用户目录、服务配置和 shell 环境里的残留。3.1 配置文件目录按这些路径挨个过OpenClaw 的配置文件不算集中不同版本可能落在这几个位置。清理时不要只删一个请把下面这些路径都过一遍rm -rf ~/.openclaw rm -rf ~/.claw rm -rf ~/.config/openclaw rm -rf ~/.local/share/openclaw rm -rf ~/.local/state/openclaw有人会问为什么一个工具要有这么多目录因为程序习惯不一样。~/.config/openclaw一般放主配置~/.local/share/openclaw放会话和日志之类的状态数据~/.cache/openclaw放缓存。如果你发现自己机器上的路径跟上面不完全一样也正常以实际为准。3.2 缓存、日志、临时文件与会话锁删就完事但要注意状态缓存路径通常是rm -rf ~/.cache/openclaw rm -rf /tmp/openclaw* 2/dev/null日志我之前遇到过放在/var/log/openclaw的这个要看权限。如果在 systemd 服务里配了StandardOutputfile:/var/log/openclaw.log那对应日志文件也要删掉否则日志目录里留着一个不断增长的大文件占磁盘不说还容易让人误以为服务还在跑。会话锁文件比较微妙。热词里有人搜过这个报错agent failed before reply: session file locked (timeout 60000ms)。这个本质上是 OpenClaw 的 session 文件被锁住了通常是进程非正常退出留下的.lock文件。你卸载前如果还打算抢救一下数据可以把锁文件先手动删掉再启动如果已经决心卸载那这个文件就属于“必清残留”find ~/.openclaw ~/.claw -name *.lock -delete 2/dev/null3.3 Shell 环境变量、别名和 PATH 导出最容易被漏的一环我这个人和很多人一样早期图省事会把openclaw的目录写进.bashrc或.zshrc。卸载 OpenClaw 之后虽然命令没了但export PATH...和alias claw...这类配置还留在 shell 配置里。每次打开新终端都报找不到命令特别影响心情。正确做法是手动编辑这几个文件把 openclaw 相关的行删掉# 先看看哪些 shell 配置文件里有 OpenClaw 痕迹 grep -n -i openclaw ~/.bashrc ~/.bash_profile ~/.zshrc ~/.profile /etc/profile 2/dev/null我自己还会检查环境变量本身env | grep -i openclaw如果发现OPENCLAW_API_KEY、OPENCLAW_PROFILE这类环境变量需要从 shell 配置里把对应的export行删掉。有些安装脚本还会在/etc/profile.d/openclaw.sh里写全局配置这个也要一并清理sudo rm -f /etc/profile.d/openclaw.sh清理完成后执行source ~/.bashrc或重启终端验证一下。3.4 systemd 服务、Docker 网络等系统级残留二进制删了但服务定义文件可能还在。这是留得最深的残留之一因为普通用户很难一眼看到/etc/systemd/system下的文件。# 列出所有包含 openclaw 的 unit systemctl list-unit-files | grep -i openclaw # 删除 user 级和 system 级服务 sudo rm -f /etc/systemd/system/openclaw.service rm -f ~/.config/systemd/user/openclaw.service # 重新加载 systemd sudo systemctl daemon-reload sudo systemctl reset-failed如果之前用 Docker 起过服务和网络删除镜像后最好也顺手检查一下自定义网络。常规docker network ls里如果有openclaw_default这种名字直接删掉docker network rm openclaw_default3.5 macOS 用户别忘了 LaunchAgent 和 LaunchDaemon在 macOS 上跑的 OpenClaw 如果通过脚本设置了开机自启很大概率会留下~/Library/LaunchAgents/com.openclaw.plist这类文件。这类 plist 不会因为你删了二进制就自动消失开机时 launchd 还试图拉起服务一直报错。# 查看是否有 openclaw 相关的 launchd 任务 launchctl list | grep -i openclaw # 删除 plist 文件 rm -f ~/Library/LaunchAgents/com.openclaw.plist rm -f /Library/LaunchDaemons/com.openclaw.plist # 从 launchd 中卸载如果还挂着 launchctl remove com.openclaw.launchd 2/dev/nullWindows 上如果你曾经用 PowerShell 脚本或工具包跑过它重点检查%USERPROFILE%\.openclaw、%APPDATA%\openclaw、%LOCALAPPDATA%\openclaw这几个目录删除方式和上面大同小异。4. 常见问题与排查技巧实录卸载 OpenClaw 的过程中几乎每个人都会碰到几个典型问题。以下是我这几年处理同类 CLI 工具卸载时积累下来的一些经验原样分享给你。4.1 卸载时报错agent failed before reply: session file locked (timeout 60000ms)这个报错表面上是“agent 回复失败”本质是 session 文件被锁住了最典型的情况是上次进程没有正常退出残留了.lock文件后续的新进程在 60 秒内等不到锁释放就直接超时。如果你卸载前想保留数据再跑一次先把锁文件删掉find ~/.openclaw ~/.claw -name *.lock -delete 2/dev/null但如果你已经要走卸载流程这个报错反而是个明确信号说明进程或服务没有真正停干净。不要急着删二进制先回头执行 2.1 节的 stop 和pgrep -af openclaw检查。真正干净的环境里不应该还能找到任何 openclaw 进程。4.2 删除二进制时报 “text file busy”text file busy在 Linux 上很常见尤其是运行中的可执行文件被删除时。这个时候不要一上来就rm -f硬干先找到占用进程并结束它。# 查看谁在运行 openclaw lsof /usr/local/bin/openclaw pgrep -af openclaw # 结束进程后再删 pkill -TERM -f openclaw sleep 2 rm -f /usr/local/bin/openclaw如果pkill之后文件还在被占用可能是某个守护进程自动拉起子进程你需要先按 2.1 的顺序停掉 systemd 服务再处理进程和文件。4.3 卸载后端口仍被监听OpenClaw 默认会监听一个本地端口比如4000卸载完你可能会发现端口还开着。这种情况通常有两个来源一是容器没删干净Docker 的端口映射还占着二是残留进程还在后台跑。# 确认端口占用情况 lsof -i :4000 ss -tunlp | grep 4000 # 如果是 PID 还在查看是什么进程 ps -fp PID如果是 Docker 起的回到 2.2 节执行完整清理。如果是本地进程结束掉之后再检查一遍端口。有时候刚杀完进程端口不会立刻释放等几秒再查一次就行。4.4 明明删了配置文件磁盘空间却没降下来这种情况十有八九是日志文件或容器卷占的地方你没找到。日志在/var/log下可能有Docker 卷也可能还留在/var/lib/docker/volumes/下。先定位大文件# 找出整个用户目录下和 openclaw 相关的所有文件 find ~ -iname *openclaw* 2/dev/null # 看 Docker 卷的大小 docker system dffind的时候注意区分权限目录权限不够就加sudo再跑一遍。元凶往往是一个巨大的.db、.log或者/var/lib/docker/volumes里的数据库文件。4.5 “彻底卸载”和“降级回退”之间我建议你先想清楚有的朋友卸载 OpenClaw 是因为新版 bug 太多其实只是想回到旧版并不是不打算再用。这种情况下我不建议你去执行本指南第 3 节的内容。正确做法是先把会话锁文件清掉再备份~/.openclaw和~/.claw然后安装旧版本二进制让旧版直接复用原配置。这样人设、API Key、会话历史全都在省去重新配置一轮的麻烦。4.6 快速自查卸载完成后的十个检查点如果你想知道自己到底清没清干净可以对照下面这个清单逐项打勾检查项命令/路径期望结果可执行文件command -v openclaw无输出运行进程pgrep -af openclaw无输出系统服务systemctl list-unit-filesgrep openclawDocker 容器docker ps -agrep openclawDocker 镜像docker imagesgrep openclawDocker 卷docker volume lsgrep openclaw配置文件ls -ld ~/.openclaw ~/.claw不存在缓存文件ls -ld ~/.cache/openclaw不存在shell 配置grep -n openclaw ~/.bashrc ~/.zshrc无输出环境变量envgrep -i openclaw监听端口lsof -i :4000无 openclaw 进程每个检查项都过一遍基本就能保证系统里没有活着的 OpenClaw 残留了。5. 最后再分享一点我的操作习惯我在实际处理这类卸载任务时最深的体会是不要迷信某个单一命令也不要一上来就rm -rf。你先花五分钟扫描、备份再按部就班地停服务、删二进制、清残留整个过程通常稳定不返工。反倒是急着“一把梭”的人最后不是漏了 Docker 卷就是把 shell 环境变量留着继续报错。另外一个小建议是如果你在团队内部或者多台机器上部署过 OpenClaw别忘了把团队文档里“一键安装”之后的 PATH 导出语句也同步删掉或者至少把卸载步骤补充到文档里。真到朋友同事问起来“OpenClaw 怎么卸载干净”把这篇指南转发过去比再教一遍命令要快得多。