1. 卸载 OpenClaw 为什么总留尾巴OpenClaw 是一个本地 AI 智能体平台用来在你自己电脑上跑自主运行的 AI 代理很多人叫它“龙虾”。它装起来方便但卸载这件事官方命令只做了一半的活。我见过太多人执行完openclaw uninstall就以为完事了结果过几天发现后台还有个网关进程在跑或者~/.openclaw目录里躺着一堆带 API Key 的配置文件。这篇就是给已经装过 OpenClaw、现在想彻底清干净的人写的。核心要解决三件事把正在跑的服务停掉、把 CLI 和配置目录删干净、最后验证环境里确实没有残留。适合 macOS、Linux、Windows 三种系统的用户也覆盖 npm、pnpm、bun、Docker 这几种安装方式。需要提前说清楚一个概念OpenClaw 的“卸载”分两层。第一层是程序本体也就是 CLI 命令和网关服务第二层是数据层包括config.toml、settings.json、工作区目录、日志、启动项。官方卸载命令默认只动第一层第二层得你自己手动清。这就是为什么很多人卸载完还觉得“没干净”。下面按顺序来每一步都给可复制的命令。你不需要全部执行按自己系统的实际情况挑对应的段落就行。2. 卸载前先停服务再确认安装方式动手删之前必须先让 OpenClaw 停下来。如果网关服务还在后台跑着你删文件的时候可能遇到“文件被占用”或者删完又被重新生成的情况。先停网关和守护进程openclaw gateway stop openclaw daemon stop如果这两条命令报“command not found”说明 CLI 可能已经不在 PATH 里了但服务可能还在。这种情况直接跳到后面的进程排查部分。停完服务确认一下你当初是怎么装的。这一步很关键因为卸载 CLI 的命令不一样# 查看全局安装的包管理器来源 npm ls -g openclaw pnpm ls -g openclaw bun pm ls -g | grep openclaw哪个命令能列出 openclaw就说明你是用哪个装的。如果都查不到但openclaw --version还能输出版本号那可能是二进制直接安装或者 Docker 方式后面单独处理。注意如果你在 OpenClaw 里配置过 OpenAI、Claude、Gemini 这类平台的 API Key先别急着删配置。建议先去对应平台把旧 Key 废除并重新生成一个因为配置文件里存的是明文或可解密的内容删之前撤销掉最安全。3. 执行官方卸载与 CLI 移除服务停掉、安装方式确认后先跑官方卸载命令。它会把网关服务、状态数据、工作区这几块勾选清理。交互式卸载openclaw uninstall执行后会出来一个选择界面用空格键把 Gateway service、State config、Workspace 全部勾上然后回车确认。如果你想一步到位、不用手动确认用全自动模式openclaw uninstall --all --yes --non-interactive这一步做完核心服务就没了。但 CLI 命令本体还在接着按安装方式移除# npm 安装 npm uninstall -g openclaw # pnpm 安装 pnpm remove -g openclaw # bun 安装 bun remove -g openclaw移除完再敲一次openclaw --version如果提示 command not found说明 CLI 这层清掉了。如果还能输出版本检查一下是不是有别名的软链接比如/usr/local/bin/openclaw这种手动删掉。Docker 安装的用户走另一条路docker compose down --volumes --remove-orphans docker image prune -f--volumes会把容器关联的数据卷一起删掉--remove-orphans清理掉 compose 文件里已经不存在的服务容器。这两步不做数据卷会一直占着磁盘。4. config.toml 与 settings.json 残留检查清单官方卸载命令不会自动删配置目录这是最容易漏的地方。下面这份清单按系统分逐条对照检查。macOS / Linux 下需要检查的目录ls -la ~/.openclaw ls -la ~/.clawdbot ls -la ~/.moltbot ls -la ~/.molthub ls -la ~/.config/openclaw这几个目录里~/.openclaw是主配置目录通常包含config.toml、settings.json、日志和会话状态。后面几个是旧版本遗留的目录名如果你是从早期版本升级上来的很可能还留着。确认要删就执行rm -rf ~/.openclaw rm -rf ~/.clawdbot ~/.moltbot ~/.molthub ~/.config/openclawWindows PowerShellRemove-Item -Recurse -Force $env:USERPROFILE\.openclaw Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot Remove-Item -Recurse -Force $env:APPDATA\OpenClawWindows CMDrmdir /s /q %USERPROFILE%\.openclaw删之前建议先看一眼config.toml和settings.json里有没有你还想保留的东西比如自定义的模型端点、本地知识库路径。确认不需要了再删。文件/目录作用是否必须删~/.openclaw/config.toml主配置含模型与网关参数是~/.openclaw/settings.json运行时设置与偏好是~/.openclaw/workspace智能体工作区数据按需~/.clawdbot等旧目录历史版本残留是~/.config/openclawLinux 下的配置软链或副本是5. 启动项、进程与端口验证配置删完还要确认系统里没有开机自启的残留以及没有进程还在监听端口。macOS 检查启动代理ls ~/Library/LaunchAgents | grep -i -E openclaw|molt rm ~/Library/LaunchAgents/bot.molt.gateway.plist rm ~/Library/LaunchAgents/ai.openclaw.gateway.plistLinux 检查 systemd 用户服务systemctl --user disable --now openclaw-gateway.service systemctl --user status openclaw-gateway.serviceWindows 打开“任务计划程序”找名为 “OpenClaw Gateway” 的定时任务右键删除。然后验证进程和端口# macOS / Linux 查进程 ps aux | grep -i openclaw | grep -v grep # 查端口占用OpenClaw 默认网关端口常见为 18789 或 3000 附近 lsof -i :18789Windows 用Get-Process | Where-Object {$_.ProcessName -like *openclaw*} netstat -ano | findstr 18789如果进程还在用kill -9 PIDmacOS/Linux或taskkill /F /PID PIDWindows强制结束。端口如果被别的程序占用说明不是 OpenClaw 的残留不用管。最后做一次总验证openclaw --version which openclaw两条都应该报找不到。到这一步程序、配置、启动项、进程四层都清干净了。6. 卸载后常见报错排查报错一openclaw: command not found但目录还在这是正常的说明 CLI 删了但配置目录没删。回到第 4 节手动rm -rf ~/.openclaw。报错二删除时提示Permission deniedmacOS / Linux 在命令前加sudoWindows 用管理员身份打开终端再执行。注意sudo rm -rf要确认路径没错再回车。报错三openclaw uninstall卡在选择界面用方向键和空格勾选别直接回车。如果界面乱码改用--all --yes --non-interactive全自动模式。报错四Docker 卸载后磁盘没释放执行docker system df看占用再跑docker volume prune清理无主数据卷。docker image prune -f只清镜像不清卷。报错五重启后网关又自己起来了说明启动项没删干净。macOS 重点查~/Library/LaunchAgents和~/Library/LaunchDaemonsLinux 查systemctl --user list-units | grep openclawWindows 查任务计划程序和服务列表。报错六API Key 忘了撤销这个不算报错但风险最高。去 OpenAI、Anthropic、Google AI 等平台的控制台找到对应 Key 直接废除。已经删了配置文件也没关系平台侧撤销才是最终保险。如果你在清理过程中需要重新申请或管理 API Key可以到 TaoToken API Keys 页面操作接入细节看 TaoToken 接入文档。想先验证模型连通性用 模型对话 快速试一下如果是长期跑编码或 Agent 任务Coding Plan 更合适。控制台入口在 TaoToken Console。卸载完建议重启一次电脑确保所有后台进程和内存里的服务彻底释放。重启后再跑一遍第 5 节的验证命令全绿就说明这台机器上 OpenClaw 已经清干净了。
如何卸载 OpenClaw：从配置文件到残留清理的完整卸载指南
1. 卸载 OpenClaw 为什么总留尾巴OpenClaw 是一个本地 AI 智能体平台用来在你自己电脑上跑自主运行的 AI 代理很多人叫它“龙虾”。它装起来方便但卸载这件事官方命令只做了一半的活。我见过太多人执行完openclaw uninstall就以为完事了结果过几天发现后台还有个网关进程在跑或者~/.openclaw目录里躺着一堆带 API Key 的配置文件。这篇就是给已经装过 OpenClaw、现在想彻底清干净的人写的。核心要解决三件事把正在跑的服务停掉、把 CLI 和配置目录删干净、最后验证环境里确实没有残留。适合 macOS、Linux、Windows 三种系统的用户也覆盖 npm、pnpm、bun、Docker 这几种安装方式。需要提前说清楚一个概念OpenClaw 的“卸载”分两层。第一层是程序本体也就是 CLI 命令和网关服务第二层是数据层包括config.toml、settings.json、工作区目录、日志、启动项。官方卸载命令默认只动第一层第二层得你自己手动清。这就是为什么很多人卸载完还觉得“没干净”。下面按顺序来每一步都给可复制的命令。你不需要全部执行按自己系统的实际情况挑对应的段落就行。2. 卸载前先停服务再确认安装方式动手删之前必须先让 OpenClaw 停下来。如果网关服务还在后台跑着你删文件的时候可能遇到“文件被占用”或者删完又被重新生成的情况。先停网关和守护进程openclaw gateway stop openclaw daemon stop如果这两条命令报“command not found”说明 CLI 可能已经不在 PATH 里了但服务可能还在。这种情况直接跳到后面的进程排查部分。停完服务确认一下你当初是怎么装的。这一步很关键因为卸载 CLI 的命令不一样# 查看全局安装的包管理器来源 npm ls -g openclaw pnpm ls -g openclaw bun pm ls -g | grep openclaw哪个命令能列出 openclaw就说明你是用哪个装的。如果都查不到但openclaw --version还能输出版本号那可能是二进制直接安装或者 Docker 方式后面单独处理。注意如果你在 OpenClaw 里配置过 OpenAI、Claude、Gemini 这类平台的 API Key先别急着删配置。建议先去对应平台把旧 Key 废除并重新生成一个因为配置文件里存的是明文或可解密的内容删之前撤销掉最安全。3. 执行官方卸载与 CLI 移除服务停掉、安装方式确认后先跑官方卸载命令。它会把网关服务、状态数据、工作区这几块勾选清理。交互式卸载openclaw uninstall执行后会出来一个选择界面用空格键把 Gateway service、State config、Workspace 全部勾上然后回车确认。如果你想一步到位、不用手动确认用全自动模式openclaw uninstall --all --yes --non-interactive这一步做完核心服务就没了。但 CLI 命令本体还在接着按安装方式移除# npm 安装 npm uninstall -g openclaw # pnpm 安装 pnpm remove -g openclaw # bun 安装 bun remove -g openclaw移除完再敲一次openclaw --version如果提示 command not found说明 CLI 这层清掉了。如果还能输出版本检查一下是不是有别名的软链接比如/usr/local/bin/openclaw这种手动删掉。Docker 安装的用户走另一条路docker compose down --volumes --remove-orphans docker image prune -f--volumes会把容器关联的数据卷一起删掉--remove-orphans清理掉 compose 文件里已经不存在的服务容器。这两步不做数据卷会一直占着磁盘。4. config.toml 与 settings.json 残留检查清单官方卸载命令不会自动删配置目录这是最容易漏的地方。下面这份清单按系统分逐条对照检查。macOS / Linux 下需要检查的目录ls -la ~/.openclaw ls -la ~/.clawdbot ls -la ~/.moltbot ls -la ~/.molthub ls -la ~/.config/openclaw这几个目录里~/.openclaw是主配置目录通常包含config.toml、settings.json、日志和会话状态。后面几个是旧版本遗留的目录名如果你是从早期版本升级上来的很可能还留着。确认要删就执行rm -rf ~/.openclaw rm -rf ~/.clawdbot ~/.moltbot ~/.molthub ~/.config/openclawWindows PowerShellRemove-Item -Recurse -Force $env:USERPROFILE\.openclaw Remove-Item -Recurse -Force $env:USERPROFILE\.clawdbot Remove-Item -Recurse -Force $env:APPDATA\OpenClawWindows CMDrmdir /s /q %USERPROFILE%\.openclaw删之前建议先看一眼config.toml和settings.json里有没有你还想保留的东西比如自定义的模型端点、本地知识库路径。确认不需要了再删。文件/目录作用是否必须删~/.openclaw/config.toml主配置含模型与网关参数是~/.openclaw/settings.json运行时设置与偏好是~/.openclaw/workspace智能体工作区数据按需~/.clawdbot等旧目录历史版本残留是~/.config/openclawLinux 下的配置软链或副本是5. 启动项、进程与端口验证配置删完还要确认系统里没有开机自启的残留以及没有进程还在监听端口。macOS 检查启动代理ls ~/Library/LaunchAgents | grep -i -E openclaw|molt rm ~/Library/LaunchAgents/bot.molt.gateway.plist rm ~/Library/LaunchAgents/ai.openclaw.gateway.plistLinux 检查 systemd 用户服务systemctl --user disable --now openclaw-gateway.service systemctl --user status openclaw-gateway.serviceWindows 打开“任务计划程序”找名为 “OpenClaw Gateway” 的定时任务右键删除。然后验证进程和端口# macOS / Linux 查进程 ps aux | grep -i openclaw | grep -v grep # 查端口占用OpenClaw 默认网关端口常见为 18789 或 3000 附近 lsof -i :18789Windows 用Get-Process | Where-Object {$_.ProcessName -like *openclaw*} netstat -ano | findstr 18789如果进程还在用kill -9 PIDmacOS/Linux或taskkill /F /PID PIDWindows强制结束。端口如果被别的程序占用说明不是 OpenClaw 的残留不用管。最后做一次总验证openclaw --version which openclaw两条都应该报找不到。到这一步程序、配置、启动项、进程四层都清干净了。6. 卸载后常见报错排查报错一openclaw: command not found但目录还在这是正常的说明 CLI 删了但配置目录没删。回到第 4 节手动rm -rf ~/.openclaw。报错二删除时提示Permission deniedmacOS / Linux 在命令前加sudoWindows 用管理员身份打开终端再执行。注意sudo rm -rf要确认路径没错再回车。报错三openclaw uninstall卡在选择界面用方向键和空格勾选别直接回车。如果界面乱码改用--all --yes --non-interactive全自动模式。报错四Docker 卸载后磁盘没释放执行docker system df看占用再跑docker volume prune清理无主数据卷。docker image prune -f只清镜像不清卷。报错五重启后网关又自己起来了说明启动项没删干净。macOS 重点查~/Library/LaunchAgents和~/Library/LaunchDaemonsLinux 查systemctl --user list-units | grep openclawWindows 查任务计划程序和服务列表。报错六API Key 忘了撤销这个不算报错但风险最高。去 OpenAI、Anthropic、Google AI 等平台的控制台找到对应 Key 直接废除。已经删了配置文件也没关系平台侧撤销才是最终保险。如果你在清理过程中需要重新申请或管理 API Key可以到 TaoToken API Keys 页面操作接入细节看 TaoToken 接入文档。想先验证模型连通性用 模型对话 快速试一下如果是长期跑编码或 Agent 任务Coding Plan 更合适。控制台入口在 TaoToken Console。卸载完建议重启一次电脑确保所有后台进程和内存里的服务彻底释放。重启后再跑一遍第 5 节的验证命令全绿就说明这台机器上 OpenClaw 已经清干净了。
