卸载openclaw后需手动清理残留缓存与配置：一、删除用户级~/.openclaw等目录；二、清除docker容器、镜像及卷；三、卸载全局cli并清理npm/pnpm/bun缓存；四、终止并禁用后台服务；五、验证端口、文件及临时目录无残留。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已卸载 OpenClaw 但发现磁盘空间未释放、日志持续生成或配置异常复现，则很可能是其缓存与临时文件仍驻留在系统中。以下是针对不同安装路径与运行模式的缓存清理步骤：
一、清除用户级配置与缓存目录
OpenClaw 默认将用户配置、会话缓存、任务数据及日志统一存放于用户主目录下的隐藏文件夹中，该目录未随 CLI 卸载自动删除，必须手动定位并移除。
1、Windows 系统：打开文件资源管理器，在地址栏粘贴并回车：%USERPROFILE%\.openclaw，选中整个文件夹，按 Shift + Delete 永久删除。
2、macOS / Linux 系统：打开终端，执行命令：rm -rf ~/.openclaw；若存在备用配置路径，同步执行：rm -rf ~/.config/openclaw。
3、检查是否存在残留子目录：进入用户主目录后，搜索关键词 .logs、.data、.cache，对匹配到的独立文件夹执行强制删除。
二、清理 Docker 运行时缓存与卷数据
若 OpenClaw 以 Docker 容器方式部署（如通过 docker run 或 docker-compose），其临时文件、挂载卷及构建缓存不会被 CLI 卸载命令清除，需单独处理。
1、停止并删除所有相关容器：执行 docker stop $(docker ps -q --filter ancestor=openclaw)，再执行 docker rm $(docker ps -aq --filter ancestor=openclaw)。
2、删除关联镜像：运行 docker rmi $(docker images --filter reference="*openclaw*" -q)，确保包括 claw-agent、moltbot 等衍生镜像一并清除。
3、清理匿名与命名卷：执行 docker volume ls -q --filter dangling=true | xargs -r docker volume rm；再手动检查命名卷：docker volume ls，对含 openclaw、claw、agent 字样的卷执行 docker volume rm [VOLUME_NAME]。
三、清除 Node.js 全局模块缓存与 CLI 残留
当 OpenClaw 通过 npm/pnpm/bun 全局安装时，其 CLI 可执行文件、依赖包及 npm 缓存可能残留，导致命令仍可调用或占用大量磁盘空间。
1、卸载全局 CLI 包：根据安装方式选择对应命令：npm rm -g openclaw 或 pnpm remove -g openclaw 或 bun remove -g openclaw。
此技能为 OpenClaw 安装并配置 Tablestore Mem0 插件。Tablestore Mem0使用阿里云表格存储作为向量存储后端。
2、清理 npm 缓存：执行 npm cache clean --force；若使用 pnpm，执行 pnpm store prune；若使用 bun，执行 bun pm prune。
3、删除全局 node_modules 中残留文件夹：Windows 路径为 %APPDATA%\npm\node_modules\openclaw，macOS/Linux 路径为 $(npm root -g)/openclaw，直接删除该目录。
四、终止并清理后台服务残留进程与自启项
OpenClaw 的 gateway 服务或 daemon 守护进程可能注册为系统服务或启动项，即使 CLI 已删，其仍在后台写入日志或缓存文件，必须主动终止并卸载服务定义。
1、Windows 系统：以管理员身份运行 PowerShell，执行 Get-Service | Where-Object {$_.Name -like "*openclaw*"} | Stop-Service -PassThru | Set-Service -StartupType Disabled，再执行 sc delete "openclaw-gateway"（若存在）。
2、macOS 系统：在终端中执行 launchctl list | grep openclaw，查到对应 plist 名称后，执行 launchctl unload ~/Library/LaunchAgents/xxx.openclaw.plist 并删除该 plist 文件。
3、Linux 系统：执行 sudo systemctl list-unit-files | grep openclaw，对匹配项依次执行 sudo systemctl stop [UNIT] 和 sudo systemctl disable [UNIT]，最后删除 /etc/systemd/system/openclaw* 文件。
五、验证缓存文件是否已清空
完成上述操作后，需确认无活跃进程正在访问 OpenClaw 相关路径，避免误删或清理不彻底。
1、检查端口监听状态：Windows 执行 netstat -ano | findstr :3000，macOS/Linux 执行 lsof -i :3000,8080,11434，确认输出为空或无 openclaw 相关 PID。
2、搜索残留文件：Windows 使用 PowerShell 命令 Get-ChildItem -Path $env:USERPROFILE -Recurse -Force -ErrorAction SilentlyContinue | Where-Object {$_.Name -match "openclaw|claw|agent"}；macOS/Linux 执行 find ~ -maxdepth 4 -type d -name "*openclaw*" 2>/dev/null，对结果目录逐一核查并删除。
3、检查临时目录：Windows 进入 %TEMP%，macOS 进入 /tmp，Linux 进入 /var/tmp，查找含 openclaw、claw、molt 字样的临时文件或文件夹并删除。
