OpenClaw运行变慢、响应延迟或配置异常通常由缓存文件堆积导致，需按四步清理：一、停止Gateway服务及残留进程；二、删除用户级、历史版本、系统级和临时缓存目录；三、清理npm/pnpm全局缓存与CLI残留；四、全盘扫描并验证端口与配置状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您发现OpenClaw运行变慢、响应延迟或出现配置异常，很可能是缓存文件堆积导致。OpenClaw在运行过程中会自动生成多层级缓存，包括会话快照、模型推理中间结果、技能缓存（.molthub）、API响应缓存等，这些文件默认不随卸载命令清除。以下是清理OpenClaw缓存文件的具体方法：
一、停止相关进程与服务
缓存文件可能被正在运行的OpenClaw组件占用，直接删除会导致权限拒绝或文件损坏。必须先终止所有关联进程和服务，确保缓存目录处于可写状态。
1、以管理员身份打开PowerShell（Windows）或终端（macOS/Linux）
2、执行命令停止Gateway服务：openclaw gateway stop
3、若服务已失效或命令不可用，强制终止残留进程：pkill -f openclaw（macOS/Linux）或taskkill /F /IM openclaw.exe（Windows）
4、检查计划任务（Windows）或LaunchAgent（macOS）是否仍在后台激活，如有则先行禁用或卸载
二、定位并删除核心缓存目录
OpenClaw缓存分散在多个系统路径中，不同安装方式和历史版本（Clawdbot→Moltbot→OpenClaw）可能导致多套缓存共存。必须逐一排查并清除全部匹配项，否则将残留“幽灵缓存”。
1、删除用户级主缓存目录：rm -rf ~/.openclaw（macOS/Linux）或rd /s /q "%USERPROFILE%\.openclaw"（Windows）
2、清除历史版本缓存（关键！易遗漏）：rm -rf ~/.clawdbot ~/.moltbot ~/.molthub
3、清理系统级应用支持目录：rm -rf ~/Library/Application\ Support/openclaw（macOS）；rd /s /q "%LOCALAPPDATA%\OpenClaw"（Windows）
使用聊天补全、重试、结构化输出和明确的 User-Agent 标头运行 AIMLAPI LLM 与推理工作流，适用于 Codex 对 AIMLAPI 模型进行脚本化提示/推理调用的场景。
4、删除临时缓存文件夹：rm -rf ~/Library/Caches/ai.openclaw.* /tmp/openclaw*
三、清理npm与CLI运行时缓存
通过npm/pnpm/bun全局安装的OpenClaw CLI会在Node.js缓存层生成副本与依赖快照，这些不属于用户配置目录，但会持续干扰重装或版本切换。
1、卸载全局包并清空npm缓存：npm uninstall -g openclaw-cn && npm cache clean --force
2、若使用pnpm：pnpm uninstall -g openclaw-cn && pnpm store prune
3、检查并删除残留bin链接：which openclaw（macOS/Linux）或where openclaw（Windows），对输出路径执行手动删除
四、验证缓存是否清空
仅删除目录不代表缓存完全消失，部分缓存可能已写入注册表键值、环境变量或数据库文件中，需通过主动探测确认无残留。
1、执行全盘关键词扫描（Windows）：dir /s /b "%USERPROFILE%" | findstr /i "openclaw"
2、macOS/Linux执行：find ~ -name "*openclaw*" -type d 2>/dev/null
3、检查端口占用（127.0.0.1:18789）：netstat -ano | findstr :18789（Windows）或lsof -i :18789（macOS/Linux），若返回结果则说明Gateway仍在监听
4、启动新会话后运行openclaw config list，如报错“no config found”且无自动重建提示，则缓存层已清空
