OpenClaw 命令行彻底卸载指南：残留清理与典型报错排查

像我这种喜欢把工具链塞进命令行的人，卸载软件自然也是先从命令行下手的。今天说的 OpenClaw，群里都管它叫“龙虾”，是个开源 AI 智能体助手框架，很多人按官方文档用一行 curl 脚本或者 Docker compose 就把服务跑起来了。等你想换方案、回滚版本，或者只是磁盘吃紧时才发现：删掉主程序根本不算完，配置目录、自启动服务、缓存、session 锁文件都还留在系统里，端口可能还被占着。这篇就专门讲怎么用命令行把它卸载干净，并且把残留清理这套标准流程完整走一遍。适合那些用 CLI/Docker 部署过 OpenClaw、现在想把它彻底移出系统的朋友，也顺便把几个卸载时的经典报错一并说清楚。

1. 动手卸载之前：先确认这台机器上的“龙虾”是哪一种形态

很多人上来就rm二进制，结果回头发现openclaw命令照样能用——多半是因为系统里有多个安装路径，或者核心根本不放在默认位置。OpenClaw 这类部署形态比较灵活的项目，卸载前先搞清楚它是怎么装进去的，比啥都重要。

1.1 四种常见部署方式的特征

以我目前接触到的部署场景来看，绝大多数人的 OpenClaw 属于以下四种形态之一：

为什么先区分形态？因为卸载的本质不是“删文件”，而是“撤销当初安装时做过的每一个动作”。脚本安装写了 systemd unit，那你卸载就要删 unit 并daemon-reload；Docker 部署创建了数据卷，那你就要连卷一起清掉，否则下次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 服务里配了StandardOutput=file:/var/log/openclaw.log，那对应日志文件也要删掉，否则日志目录里留着一个不断增长的大文件，占磁盘不说，还容易让人误以为服务还在跑。

会话锁文件比较微妙。热词里有人搜过这个报错：agent failed before reply: session file locked (timeout 60000ms)。这个本质上是 OpenClaw 的 session 文件被锁住了，通常是进程非正常退出留下的.lock文件。你卸载前如果还打算抢救一下数据，可以把锁文件先手动删掉再启动；如果已经决心卸载，那这个文件就属于“必清残留”：

find ~/.openclaw ~/.claw -name "*.lock" -delete 2>/dev/null

3.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_default

3.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/null

Windows 上如果你曾经用 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 df

find的时候注意区分权限目录，权限不够就加sudo再跑一遍。元凶往往是一个巨大的.db、.log或者/var/lib/docker/volumes里的数据库文件。

4.5 “彻底卸载”和“降级回退”之间，我建议你先想清楚

有的朋友卸载 OpenClaw 是因为新版 bug 太多，其实只是想回到旧版，并不是不打算再用。这种情况下我不建议你去执行本指南第 3 节的内容。正确做法是：先把会话锁文件清掉，再备份~/.openclaw和~/.claw，然后安装旧版本二进制，让旧版直接复用原配置。这样人设、API Key、会话历史全都在，省去重新配置一轮的麻烦。

4.6 快速自查：卸载完成后的十个检查点

如果你想知道自己到底清没清干净，可以对照下面这个清单逐项打勾：

每个检查项都过一遍，基本就能保证系统里没有活着的 OpenClaw 残留了。

5. 最后再分享一点我的操作习惯

我在实际处理这类卸载任务时，最深的体会是不要迷信某个单一命令，也不要一上来就rm -rf。你先花五分钟扫描、备份，再按部就班地停服务、删二进制、清残留，整个过程通常稳定不返工。反倒是急着“一把梭”的人，最后不是漏了 Docker 卷，就是把 shell 环境变量留着继续报错。

另外一个小建议是：如果你在团队内部或者多台机器上部署过 OpenClaw，别忘了把团队文档里“一键安装”之后的 PATH 导出语句也同步删掉，或者至少把卸载步骤补充到文档里。真到朋友同事问起来“OpenClaw 怎么卸载干净”，把这篇指南转发过去，比再教一遍命令要快得多。