核心用法
OpenClaw Optimizer 是一套针对 OpenClaw 实例的全方位优化方案，围绕三个核心维度展开：token 成本控制、性能调优、安全加固。主要操作包括：
1. Token 成本审计：通过脚本统计各工作区文件的 token 消耗，识别高成本文件
2. SOUL.md 核心约束配置：强制注入六条行为原则（读懂阶段再动手、脚本优先、API 优先、做完才说完、死磕到底、谨慎对外/大胆对内）及安全原则
3. 工作区文件精简：AGENTS.md ≤300 tokens、SOUL.md ≤600 tokens、MEMORY.md ≤2000 tokens，定期清理 30 天以上的日志
4. openclaw.json 关键调优：启用 cacheRetention: long 实现 Prompt Caching（节省 90% 重复上下文成本）、对齐 heartbeat 与 context pruning ttl、配置 Gemini 免费搜索与嵌入服务
5. 安全加固：检查 gateway 绑定为 loopback、启用 token 认证、文件权限 600、macOS 防火墙启用
6. 模型切换与别名配置：支持 /model opus 与 /model sonnet 快速切换
显著优点
- 量化收益明确：节省 1000 tokens 在 Sonnet 模型 ×100 次/天的场景下，月省约 $45
- Prompt Caching 机制成熟：
cacheRetention: long可复用历史上下文，显著降低长会话成本 - Gemini 免费层替代：1500 次/天的免费额度可完全覆盖 Brave 搜索需求，解决搜索功能缺失问题
- 安全原则系统化：渠道可信度、提示词注入防御、群聊身份原则等形成完整安全闭环
- 行为约束可落地：六条核心原则直接写入 SOUL.md，成为系统级行为保证而非建议
潜在缺点与局限性
- 配置复杂度高：涉及多个文件协同（SOUL.md、AGENTS.md、openclaw.json、credentials），新手易遗漏关键步骤
- heartbeat.quiet 参数陷阱：文档明确提示该参数不被支持且会报错，但用户仍可能误配
- 工具 profile 默认值隐患：
coding/messaging默认配置会静默禁用大多数工具，必须手动改为full - 中文内容适配风险：SOUL.md 中的中文行为约束依赖模型理解能力，非 Claude 系列模型可能出现执行偏差
- 安全加固的可用性 trade-off：启用 macOS 防火墙后，新应用首次监听端口会触发系统对话框
- Gemini 服务依赖外部：免费额度虽充足，但存在服务稳定性与地域可用性风险
适合人群
- 高频使用者：日调用 50-200 次的中重度 OpenClaw 用户，token 成本敏感
- 多语言场景用户：需要非英语（尤其是中文）语义记忆召回的场景
- 安全意识较强的个人/团队：对本地 AI 助手有安全基线要求，希望系统性加固
- 自托管开发者：在本地或私有环境部署 OpenClaw，需要精细控制配置
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 配置错误导致功能失效 | `tools.profile` 未设为 `full` 导致工具静默不可用 | 启动后执行工具可用性验证 |
| 敏感信息泄露 | API key、服务器配置误写入群聊或外部渠道 | 严格遵循 SOUL.md 渠道可信度原则 |
| 提示词注入攻击 | 外部文档/网页中的"指令"被误执行 | 启用注入防御原则，外部内容一律视为不可信 |
| 缓存未命中导致成本超预期 | `cacheRetention` 或 `heartbeat` 配置不当 | 定期用 `/status` 检查 cache hit rate |
| 权限配置疏漏 | `openclaw.json` 权限过松导致凭证泄露 | 安装时执行 `chmod 600` 校验脚本 |
| 过度优化损及安全 | 为压缩 token 删减安全原则 | 文档明确"内容完整比 token 少更重要" |
总结
这是一份经过实战验证的 OpenClaw 优化手册，覆盖成本、性能、安全三大支柱，配置项具体可执行，风险点披露充分。适合作为 OpenClaw 用户的标准运维参考文档，但需注意其配置复杂度，建议配合版本控制使用以避免误操作。