彻底卸载OpenClaw需五步:一、停止并禁用守护进程;二、运行openclaw uninstall --all --yes --non-interactive;三、按npm/pnpm/bun方式卸载CLI;四、删除~/.openclaw等全部配置数据目录;五、清理npm缓存及Docker组件(如适用)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您已完成本地部署的 OpenClaw 项目,但希望彻底移除其全部组件(包括服务、配置、数据及命令行工具),则需执行多层清理操作。以下是针对本地部署环境的完整卸载步骤:
一、停止并禁用后台守护进程
OpenClaw 在本地部署后通常会启用 Gateway 守护进程,持续监听 127.0.0.1:18789 端口。若未先终止该服务,后续文件删除可能失败或引发端口占用冲突。
1、检查当前运行的 openclaw 进程:
macOS/Linux 执行 ps aux | grep openclaw;Windows 执行 Get-Process | Where-Object {$_.Name -like "*openclaw*"}。
2、强制终止所有相关进程:
macOS/Linux 执行 pkill -f openclaw;Windows PowerShell 执行 Stop-Process -Name "openclaw" -Force。
3、禁用并卸载系统级服务:
macOS 执行 launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist 并删除对应 plist 文件;
Linux 执行 systemctl --user stop openclaw && systemctl --user disable openclaw;
Windows 执行 schtasks /Delete /TN "OpenClaw Gateway" /F。
二、执行官方内置卸载命令
OpenClaw 提供了集成式卸载指令,可一次性清除网关服务、状态数据与工作区配置,避免手动遗漏关键模块。
1、在终端中运行完整卸载命令:
openclaw uninstall --all --yes --non-interactive。
2、该命令将自动勾选并移除以下三项:
Gateway service、State + config、Workspace。
3、若提示 command not found,说明 CLI 工具已不可用,需跳至第三步使用包管理器卸载。
三、卸载全局 CLI 工具(按安装方式选择)
CLI 工具是 OpenClaw 的入口命令,其残留会导致终端仍识别 openclaw 命令,必须根据原始安装方式精准清除。
1、若通过 npm 安装:
npm uninstall -g openclaw 或 npm rm -g openclaw。
2、若通过 pnpm 安装:
pnpm remove -g openclaw。
3、若通过 bun 安装:
bun remove -g openclaw。
4、验证 CLI 是否消失:
macOS/Linux 执行 which openclaw;Windows 执行 where openclaw;均应无输出。
四、删除全部配置与数据目录
官方卸载命令不自动清理用户数据目录,而 ~/.openclaw/ 及其历史别名目录中存储着 API 密钥、对话记忆、技能插件与日志等敏感信息,必须主动清除。
1、删除主配置目录:
macOS/Linux 执行 rm -rf ~/.openclaw;
Windows PowerShell 执行 Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"。
2、清理历史残留目录(如曾安装过 Clawdbot/Moltbot):
执行 rm -rf ~/.clawdbot ~/.moltbot ~/.molthub ~/.config/openclaw;
Windows 执行 rmdir /s /q "%USERPROFILE%\.clawdbot" "%USERPROFILE%\.moltbot" "%APPDATA%\OpenClaw"。
3、macOS 额外清理应用支持目录:
rm -rf ~/Library/Application\ Support/openclaw ~/Library/Preferences/ai.openclaw.* ~/Library/Caches/ai.openclaw.*。
五、清理 npm 缓存与 Docker 组件(如适用)
若曾通过 npm 安装且长期使用,全局缓存中可能残留 openclaw 相关元数据;若采用 Docker 部署,则镜像与数据卷亦需手动释放。
1、清理 npm 全局缓存:
npm cache clean --force;
或仅定位并清除 openclaw 条目:npm cache ls | grep openclaw | xargs -r npm cache rm。
2、删除 Docker 容器与镜像(如使用):
docker stop $(docker ps -aq --filter name=openclaw) 2>/dev/null;
docker rm $(docker ps -aq --filter name=openclaw) 2>/dev/null;
docker rmi $(docker images -q --filter reference="*openclaw*") 2>/dev/null;
docker volume rm $(docker volume ls -q --filter name=openclaw) 2>/dev/null。










