卸载这类带后台服务的 AI 代理工具最恼人的不是卸载本身而是卸载完总觉得哪儿不对劲——端口还在监听开机又弹出日志报错翻遍系统目录还有一堆.json、.db、.log残留。OpenClaw 尤其典型它既有 CLI 主程序又有常驻服务、会话仓库、模型缓存、身份凭据等多套独立数据常规卸载只删了主程序外壳真正的肉都留在系统里。这篇就按我的实际操作顺序把 OpenClaw 的服务、配置、缓存三块讲透全流程压缩在 3 分钟左右Windows 和 Linux 两边我都写照着抄作业就行。1. 卸载前先搞清楚 OpenClaw 到底把东西装在哪了1.1 不同安装方式决定不同的清理范围OpenClaw 的安装方式很杂有人用官方脚本装有人走 Docker有人直接拉源码跑还有人通过包管理器装。安装方式不一样残留物的分布天差地别。我见过最离谱的情况是同一台机器上同时存在三种安装方式的残留互相抢端口排查起来极其痛苦。先按常见安装路径做个归类安装方式主程序位置配置目录服务注册方式官方脚本/二进制/usr/local/bin/openclaw或~/.openclaw/bin~/.openclaw/systemd 用户服务或手动进程Docker 部署镜像内宿主机无实体程序挂载的卷目录docker 容器自启源码运行克隆的源码目录源码目录下或~/.openclaw/无靠终端或进程守护Windows 安装包%LOCALAPPDATA%\Programs\OpenClaw或C:\Program Files\OpenClaw%APPDATA%\OpenClawWindows 服务、计划任务或启动项动手卸载前先花 10 秒确认自己属于哪种。最直接的办法在终端里执行openclaw --version能输出版本号说明主程序还在再执行which openclawLinux或where openclawWindows拿到完整路径。路径指向/usr/local/bin说明是脚本装的指向家目录说明是用户级安装啥都查不到也别急着高兴服务可能还在后台跑着。1.2 卸载前的信息备份与确认清单这里我必须先泼一盆冷水OpenClaw 的配置目录里存的不只是配置还有会话历史、Channel 接入凭据、模型 API Key。如果之后还想重新部署或者需要在另一台机器上恢复环境直接删干净等于把这些全扔了。我的建议是卸载前先做两件事第一导出配置。OpenClaw 如果提供了openclaw config export之类的命令优先用它导出没有的话直接把配置目录整个复制一份到 U 盘或其它磁盘。配置目录里通常包含config.json、channels/、credentials/这些子目录都是明文或半明文存储复制出来就能用。第二停掉所有正在运行的实例。别带着运行中的进程卸载否则文件占用删不掉服务注册项也会反复重建。可以用ps aux | grep openclawLinux或任务管理器Windows确认一下有没有常驻进程。注意如果你确定这辈子不会再碰 OpenClaw那备份这步可以跳过。但如果你只是“暂时不用”强烈建议备份credentials/目录——重新接入 Channel 时重新走一遍 OAuth 授权非常烦。2. 第一刀停服、禁用服务与守护进程2.1 Windows 下服务与计划任务的双重清理Windows 上 OpenClaw 装完通常会做三件事注册一个 Windows 服务、创建一个开机启动的计划任务、往启动文件夹塞快捷方式。很多人只删了程序目录结果每次开机服务报错事件查看器里刷几百条错误日志。先处理 Windows 服务。管理员权限打开 PowerShell执行Get-Service | Where-Object { $_.DisplayName -like *OpenClaw* -or $_.Name -like *openclaw* }确认服务名后先停掉再删除Stop-Service -Name OpenClawService -Force sc.exe delete OpenClawService这里我坚持用sc.exe delete而不是Remove-Service因为Remove-Service在某些旧版 PowerShell 里不存在而sc.exe是系统自带的老牌命令兼容性最好。删完记得刷新一下服务列表确认服务已经从列表里消失。然后是计划任务。OpenClaw 有时候会注册一个名为OpenClaw AutoStart或类似的计划任务用来实现开机自启和自动更新。用管理员 PowerShell 执行schtasks /query | findstr /i openclaw schtasks /delete /tn OpenClaw AutoStart /f如果第一步查询没结果但你在任务计划程序里肉眼看到了相关任务直接右键禁用再删除也行。这里有个容易踩的坑有些安装版本会在用户级任务和系统级任务各注册一份查询时别只看系统级用schtasks /query /fo list /v | findstr /i openclaw全量查一遍更稳妥。2.2 Linux 下 systemd 服务与用户级守护进程清理Linux 这边情况类似OpenClaw 可能以系统级 systemd 服务运行也可能以用户级 systemd 服务运行有些甚至只是nohup拉起的裸进程。三种情况处理方式完全不同。如果是系统级服务sudo systemctl stop openclaw sudo systemctl disable openclaw sudo rm /etc/systemd/system/openclaw.service sudo systemctl daemon-reload sudo systemctl reset-failed如果是用户级服务不需要 sudosystemctl --user stop openclaw systemctl --user disable openclaw rm ~/.config/systemd/user/openclaw.service systemctl --user daemon-reload这里有个细节很多人忽略disable只是取消开机自启服务单元文件还在下次手动systemctl start openclaw还能起来。所以rm删除单元文件这步不能省。reset-failed的作用是把服务异常退出的状态标记清掉不执行的话系统日志里一直挂着 failed 状态看着碍眼某些监控工具还会误报。如果服务不在 systemd 里用ps aux | grep openclaw找到裸进程kill掉即可。稳妥一点的写法是先pkill -f openclaw再确认一次进程列表防止有残留子进程。2.3 启动项与用户级自启配置的排查做完上面两步还要检查用户级自启。Linux 下检查~/.bashrc、~/.zshrc、~/.profile里有没有自动拉起 openclaw 的 alias 或后台启动命令。我碰到过一次安装脚本往~/.bashrc里塞了一行openclaw serve 结果每次开终端都静默拉起一个服务进程光停 systemd 根本拦不住。Windows 下则检查注册表启动项和启动文件夹reg query HKCU\Software\Microsoft\Windows\CurrentVersion\Run | findstr /i openclaw reg query HKLM\Software\Microsoft\Windows\CurrentVersion\Run | findstr /i openclaw查到对应键值后reg delete删掉。启动文件夹的位置在shell:startup打开资源管理器地址栏输入这个命令就能跳到里面如果有 openclaw 的快捷方式或脚本一并删除。经验之谈服务清理这步最忌讳“只停不删”。只要注册项还在某些版本的 OpenClaw 会在下次重启时通过 watchdog 机制自动拉回主程序造成“我明明卸载了但程序又活了”的灵异现象。3. 第二刀删除配置与数据目录3.1 用户级配置目录的位置与内容拆解配置目录是残留的大头。OpenClaw 的配置目录在不同系统下的默认位置如下系统配置目录典型内容Linux~/.openclaw/config.json、channels/、credentials/、sessions/Linux (XDG)~/.config/openclaw/部分新版本遵循 XDG 规范Windows%APPDATA%\OpenClawconfig.json、credentials.json、logs/macOS~/Library/Application Support/OpenClaw同上删除方法很简单rm -rf ~/.openclaw ~/.config/openclawWindows 下在 PowerShell 里执行Remove-Item -Recurse -Force $env:APPDATA\OpenClaw但我要提醒一句直接rm -rf会把所有数据一次性带走如果你按我第 1 节的建议做了备份这会很干净。如果没备份至少先把credentials/或credentials.json拖出来留个底。3.2 环境变量与 PATH 残留处理OpenClaw 安装时通常会在PATH里加上可执行文件目录卸载后 PATH 里那条记录还留着虽然不影响系统运行但终端里输openclaw会提示命令找不到每次打开 shell 还会多一次路径解析属于纯垃圾残留。Linux 下检查这几个文件grep -n openclaw ~/.bashrc ~/.zshrc ~/.profile /etc/environment把含 openclaw 的 export 行删掉即可。注意/etc/environment是全局的改它需要 sudo而且格式要求严格别多删了别的行。Windows 下在“系统属性 - 环境变量”里把 openclaw 相关的 PATH 条目删掉。这里有个技巧在 PowerShell 里执行$env:Path -split ; | Where-Object { $_ -like *openclaw* }就能把当前 PATH 中所有指向 openclaw 的路径列出来然后去系统设置里精准删除。另外一个隐蔽的位置是~/.npmrc或.npm全局目录——如果 OpenClaw 是通过 npm 安装的npm i -g openclaw/cli卸载时应该用npm uninstall -g openclaw/cli而不是手动删文件否则 npm 的全局链路里会留下坏引用。不确定的话执行npm ls -g --depth0看一眼有没有 openclaw 相关包。3.3 密钥、令牌与凭据数据的彻底清除这步最容易被忽视也最重要。OpenClaw 接入各种 Channel比如 Teams、SMS、邮箱等时会把访问令牌、刷新令牌、OAuth Client ID 等凭据存在配置目录或系统的凭据管理器中。直接删文件只是把平铺的数据清了系统凭据管理器里可能还有残留。Linux/macOS 下检查系统的 keyring# 查看密钥环中是否还有 openclaw 条目 secret-tool search service openclawWindows 下检查凭据管理器cmdkey /list | findstr /i openclaw查到后逐个删除Windows 下是cmdkey /delete:目标名。为什么这个要单独说因为如果你只是删了配置文件但凭据管理器里还留着 token重新安装 OpenClaw 后它可能意外恢复旧会话安全角度上也存在凭据泄漏风险。还有一个隐蔽点OpenClaw 的会话文件session files会记录对话历史和中间状态。网上有人报过agent failed before reply: session file locked (timeout 60000ms)这个错误本质就是会话文件被另一个进程锁住。这类.session或.db文件通常在~/.openclaw/sessions/或~/.local/share/openclaw/下删除配置目录时会一并清掉。如果发现删除时提示文件被占用多半是第 2 节的服务没停干净回去再查一遍进程。4. 第三刀缓存、日志与临时文件清理4.1 缓存目录的定位方法OpenClaw 作为 AI 代理框架缓存体系比普通 CLI 工具复杂。它至少包括三类缓存第一类是模型响应缓存。OpenClaw 调用大模型 API 时本地会缓存部分响应结果用于重复请求命中时减少 API 调用。这类缓存通常放在~/.cache/openclaw/Linux或%LOCALAPPDATA%\OpenClaw\CacheWindows。第二类是会话状态缓存包含会话消息、上下文窗口数据等位置在~/.local/share/openclaw/或配置目录下的sessions/。第三类是依赖缓存。如果是源码部署Node.js 或 Python 的依赖安装会有独立的缓存目录比如node_modules或 Python 的__pycache__——这些在你删除源码目录时通常一并处理但如果用的是全局虚拟环境可能还残留在~/.venvs/或 conda 环境里。删除命令示例# Linux rm -rf ~/.cache/openclaw ~/.local/share/openclaw # Windows PowerShell Remove-Item -Recurse -Force $env:LOCALAPPDATA\OpenClaw4.2 日志文件与崩溃转储的清理日志这东西平时没人看卸载时全冒出来了。OpenClaw 的日志目录在 Linux 下通常是~/.openclaw/logs/或/var/log/openclaw/Windows 下在%APPDATA%\OpenClaw\logs或C:\ProgramData\OpenClaw\logs。ProgramData 这个位置特别容易被漏因为很多用户卸载时只翻 APPDATA不去翻 ProgramData。还有一个容易被忽略的是系统日志里的大量 openclaw 条目。比如 Linux 的 journald 日志sudo journalctl --vacuum-time1d # 不建议全清 # 更精准的做法是查看并清理 openclaw 相关日志段但说实话journald 的日志清不清对用户体验影响不大除非你有洁癖或者磁盘空间紧张。我更推荐把精力花在确认/var/log/openclaw/目录是否被删掉sudo rm -rf /var/log/openclawWindows 下的事件日志没法针对单个程序清理除非用 wevtutil 清全量所以这块检查到没有对应日志目录即可。4.3 Docker 部署形态的差异化清理如果你是 Docker 方式部署的 OpenClaw前面所有服务、配置的清理路径全都不一样。Docker 的隔离特性决定了主程序不在宿主机上但数据卷、镜像、容器照样占空间。先看有哪些相关容器和镜像docker ps -a | grep openclaw docker images | grep openclaw docker volume ls | grep openclaw清理顺序有讲究先删容器再删镜像最后删数据卷。顺序反了会出现“悬空镜像”或“无主数据卷”。docker stop openclaw-container docker rm openclaw-container docker rmi openclaw-image docker volume rm openclaw-data这里最要命的是数据卷。很多 Docker 部署的 OpenClaw 会把配置和会话全存在一个命名卷里比如openclaw_data。你删了容器和镜像卷还在磁盘空间一分没省。而且数据卷是独立于容器的不执行docker volume rm它就一直在那儿躺着。还有一个细节如果用了 docker-composedocker-compose down默认不会删除命名卷。扩散一下docker-compose down -v才会连卷一起删。但-v是全局删卷如果有同一个 compose 文件里其它服务的数据卷也会被牵连需要自己权衡。实操建议清理完 Docker 相关资源后执行docker system df看一下空间释放情况。如果显示 RECLAIMABLE 还有大量数据说明还有悬空镜像或未删除的卷继续用docker image prune和docker volume prune收尾。5. 验证清理成果三步确认法5.1 命令行与端口层面的验证清理动作都做完了怎么确认真的干净了我一般按三层验证。第一层二进制与命令残留which openclaw # Linux/macOS应该无输出 where openclaw # Windows应该报错找不到第二层进程与服务ps aux | grep openclaw # Linux应该只有 grep 自身 sc.exe query OpenClawService # Windows应该报服务不存在 systemctl status openclaw # Linux应该提示 unit 未找到第三层端口监听。OpenClaw 默认或者配置里设置的监听端口卸载后应该不再监听。你可以回顾一下自己配过哪些端口用ss -tlnp | grep 端口或netstat -ano | findstr 端口检查。如果端口还在监听说明有个进程没死透用lsof -i:端口找到 PID 再处理。5.2 安装目录与数据目录的二次排查第二层验证是文件系统层面。我习惯在清理完成后用一条命令全盘检索# Linux find ~ /tmp /var/tmp -name *openclaw* 2/dev/null # Windows PowerShell Get-ChildItem -Path $env:USERPROFILE, $env:APPDATA, $env:LOCALAPPDATA -Recurse -Filter *openclaw* -ErrorAction SilentlyContinue | Select-Object FullName有输出就继续删没输出基本就干净了。实际执行时可能会卡在权限不足的目录上Windows 下建议部分关键目录以管理员身份再跑一次。我自己的经验是重点复查这几个位置~/.config/openclaw/Linux 用户配置~/.cache/openclaw/Linux 缓存%APPDATA%\OpenClawWindows 配置%LOCALAPPDATA%\OpenClawWindows 缓存C:\ProgramData\OpenClawWindows 全局数据/var/log/openclaw/Linux 日志5.3 注册表、计划任务与 Docker 残留的终检Windows 用户还要做注册表和计划任务的终检。在管理员终端执行reg query HKCU\Software /f openclaw /s reg query HKLM\Software /f openclaw /s schtasks /query /fo csv | findstr /i openclaw注册表里有残留就reg delete对应键。注意 HKLM 下的查询可能需要较长时间耐心等它跑完。Linux 的终检重点是 systemd 的残留单元systemctl list-unit-files | grep openclaw有输出说明有个服务的 enable 状态还没清干净回头检查~/.config/systemd/user/和/etc/systemd/system/。docker images | grep openclaw docker volume ls | grep openclaw如果之前是 Docker 部署这两条命令的输出如果是空的才算真正收官。6. 常见问题与踩坑记录6.1 服务删不掉或提示正在被占用这是最高频的问题。Windows 下sc.exe delete提示“服务正在运行或标记为删除”多半是服务进程没停干净。先Stop-Service -Force再等一下让进程完全退出然后重新 delete。如果还不行服务可能被别的进程以句柄形式持有重启一次系统再删基本能解决。Linux 下最常见的坑是 systemd 服务的ExecStart脚本拉起了子进程systemctl stop只杀了主进程子进程变成孤儿进程继续跑配置目录和缓存目录被锁导致rm -rf时提示 “Text file busy” 或 “Device or resource busy”。处理方式是先pkill -f openclaw扫一遍所有相关进程再执行删除。6.2 环境变量改了但终端里还是能启动这个问题我也遇到过好几次。明明把~/.bashrc里的 export 行删了但新开终端执行openclaw居然还能跑。原因通常是 bash 缓存了命令路径——终端里的 hash 表记住了上次命令的完整路径直接执行hash -r清除一下就好了。如果清完还能跑检查一下是不是有另一个程序叫 openclaw比如 npm 全局包或者某个 Python entry point。Windows 下类似现象的原因是 PATH 环境变量修改后已打开的终端不会刷新。重新开一个新的 PowerShell 窗口再验证而不是在旧窗口里敲。6.3 清理后系统盘空间没明显变化有人删了一堆东西发现空间没释放第一反应是没删干净。实际上Windows 的回收站、Linux 的 trash 目录会把删除的文件先收纳进去rm -rf虽然不走回收站但 Docker 的数据卷、系统日志等占用大户往往排在后面。建议按顺序排查排查对象命令/位置备注Docker 数据卷docker system df悬空卷是最常见的隐形占用系统日志/var/log/、C:\ProgramData\OpenClaw\logs日志文件可能膨胀到数百 MB会话数据库~/.openclaw/sessions/或%APPDATA%\OpenClaw\sessions长期使用的会话库可能占几百 MB回收站回收站/trash手动清空6.4 重新安装时发现原有会话还在这算是个“反向坑”。明明卸载重装了OpenClaw 一启动居然还能看到旧的会话记录。原因就是我前面反复强调的——配置文件删了但会话数据存在另一个目录比如~/.local/share/openclaw/重装时程序用默认配置路径找不到新配置却读到了残留的会话目录。遇到这种情况不用慌回头把第 4 节里的~/.local/share/openclaw、~/.cache/openclaw以及 Windows 对应的%LOCALAPPDATA%目录再清一遍重装后就是真正的白纸状态了。写在最后的个人体会坦白说OpenClaw 这种工具的卸载难度不在于技术门槛而在于它的数据散布面太广。我前后帮人清理过不下十台机器几乎每次都能在想不到的角落翻出残留——有时候是 Docker 卷里的旧配置有时候是 bashrc 里的一行自启命令有时候是 Windows 凭据管理器里静默存着的 token。养成一个习惯会省很多事卸载任何带后台服务的应用前先花 10 秒查一下它的部署方式再翻一眼进程列表最后动手。顺序对了3 分钟就够顺序乱了可能折腾一下午。上面这套流程我实测过很多遍照着走一遍基本能还你一个干净的系统和一份安心。