OpenClaw 性能调优实战：让个人AI助手从慢到快的3个关键动作

OpenClaw 性能调优实战：让个人AI助手从慢到快的3个关键动作

【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw

OpenClaw（也就是 clawdbot 仓库维护的开源项目）是一个跑在自己设备上的个人 AI 助手网关，把模型、工具和 Telegram、Slack 等聊天渠道接进同一个 Gateway。用得越久，响应变慢、内存和磁盘持续上涨是绕不开的问题。好消息是，慢的原因通常就三个：上下文膨胀、状态积压、健康检查缺失。下面按场景逐个拆解。

响应变慢怎么查：先盯上下文膨胀

长会话里，工具输出（exec 结果、文件读取、搜索返回）会不断堆积进上下文窗口，每次都带着越来越大的前缀去请求模型，延迟自然水涨船高。📈

开启上下文修剪（contextPruning）

OpenClaw 内置的 session pruning 会在每次 LLM 调用前裁掉旧工具结果，但不改写磁盘上的完整历史。它的工作方式很克制：等缓存 TTL 过期后才动手，上下文占用低于 30% 直接跳过；超过 4000 字符的工具结果先软裁剪（保留首尾各 1500 字符），占用仍高于 50% 且可清理内容超过 5 万字符时再硬清空。对 Anthropic 系模型，插件首次识别到认证后会自动帮你配好cache-ttl模式，其他提供商默认关闭，建议手动打开：

# 在 ~/.openclaw/openclaw.json 中加入 agents: { defaults: { contextPruning: { mode: "cache-ttl", ttl: "5m" } } }

开启后，同样的长会话请求前缀通常能缩小 20%~40%，首字延迟下降立竿见影。详见docs/concepts/session-pruning.md。

保持模型与思考级别稳定

提示词缓存（prompt caching）的前提是请求前缀不变。换模型、调 thinking 或 reasoning-effort，都会让缓存失效，下一轮全量重算前缀，延迟立刻翻倍。所以建议建会话时定好模型和参数，中途要换就开新会话，而不是在同一会话里反复切换。

内存与磁盘怎么压：状态积压是隐形杀手

Gateway 运行久了，过期会话、陈旧锁文件、超大的工作区注入文件都会悄悄吃掉内存和磁盘。这一步基本是零成本，跑两条命令就行。🔧

用 doctor 做状态体检与修复

openclaw doctor是官方内置的修复工具，它会检查过期会话锁、状态目录权限、OAuth 令牌过期、端口冲突，并迁移旧版本遗留的配置结构：

openclaw doctor openclaw doctor --fix

不加--fix只读诊断，加--fix才动手修。对新手来说，每周跑一次交互式的openclaw doctor，把提示的修复项处理掉，能解决大部分"越用越慢"的问题。完整行为说明在docs/gateway/doctor.md。

控制工作区注入文件的体积

AGENTS.md等引导文件每轮都会注入上下文。doctor 会对接近预算上限的文件给出警告，并提示调agents.defaults.bootstrapMaxChars和bootstrapTotalMaxChars。文件越精简，每轮请求的固定开销越小——把历史背景移到笔记里、按需引用，比塞进引导文件划算得多。

调完怎么防回退：把健康检查变成习惯

优化做完不等于一劳永逸，版本升级、渠道插件增减都可能引入新的拖慢点。📋

用只读 lint 模式做定期巡检

--lint模式不写配置、不改状态，专为自动化巡检设计，退出码可直接接进 CI 或定时任务：

openclaw doctor --lint --severity-min warning openclaw doctor --lint --json

建议每月跑一次，发现 warning 级别的项及时跟进，避免小问题累积成大故障。

保持版本与模型路由健康

用openclaw gateway status确认 Gateway 正在跑的版本和端口（默认18789），升级后重跑一次openclaw doctor --fix，让配置迁移和插件收敛在新版本下完成。升级路径见docs/install/updating.md。

把这三步排进节奏：上下文修剪管住"每次多慢"，doctor 管住"整体多干净"，lint 巡检管住"以后会不会再慢"。从这周开始，先跑一次openclaw doctor，看看它列出多少项可修复的旧账——那是你性能提升的空间上限。

【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw