概述
agent-architecture-guide 是一份面向 OpenClaw 生态的实战架构指南，汇集了 20 项经过生产环境验证的可靠性设计模式。该技能不提供可执行代码，而是以系统性文档形式传授 Agent 工程的最佳实践，核心目标是在有限上下文窗口内实现高可靠、可维护、抗漂移的长期运行 Agent。
核心用法
技能以 Markdown 文档形式交付，用户阅读后手动将模式整合至自身 Agent 架构。关键模式包括：
- WAL 协议：收到用户修正、决策、偏好类消息时，先写入持久化存储再响应，避免上下文重置导致信息丢失
- 工作缓冲区（Working Buffer）：上下文使用率超 60% 时自动记录对话摘要，解决压缩导致的近期信息丢失
- 分层内存压缩：三层架构（原始日志 → 活跃记忆 → 月度归档）配合时间衰减规则，实现 18 倍压缩同时保持 97.8% 召回率
- 向量搜索集成：配置 Gemini/OPENAI 等嵌入提供商，实现跨三层记忆的语义检索，补足压缩后的长尾查询
- CJK 查询重写：针对中日韩短查询的嵌入模型缺陷，通过模式扩展提升向量搜索命中率
- Heartbeat 批处理：将多个周期性检查合并至单次心跳，实现 60% Token 成本削减
显著优点
1. 生产验证强度：所有模式均标注明示来源（halthelobster 的 proactive-agent、Moltbook 社区实践等），附带实测数据（如 87.5% 直接召回率、60% Token 节省）
2. 系统性完整：从写入协议、内存管理、检索优化到评估纪律形成闭环，覆盖 Agent 全生命周期
3. 多语言适配：专门解决 CJK 场景下的跨语言检索难题，提供双语锚点、实体注册表等零成本改进方案
4. 防过拟合设计：明确区分结构改进与内容作弊，避免基准测试分数膨胀
潜在局限
- 非自动化工具：需人工阅读理解后手动实施，无一键集成路径
- 生态依赖：部分高级功能（向量搜索）依赖 OpenClaw 特定版本及外部 API 密钥
- 适用边界：针对长对话、高上下文压力的 Agent 优化，简单单次交互场景收益有限
- 维护成本：分层压缩、实体注册表等机制需持续维护，小型项目可能负担过重
适合人群
- 运行周期超过 1 周的生产级 OpenClaw Agent 开发者
- 遭遇上下文漂移、记忆丢失、重复错误等可靠性问题的团队
- 需要处理中日韩多语言查询的 Agent 架构师
- 追求 Token 效率与长期运行成本优化的工程团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 实施风险 | 模式间存在依赖关系（如向量搜索需配合分层压缩），孤立采用可能效果不佳 |
| 配置风险 | 嵌入服务商（Gemini/OpenAI）的 API 稳定性与隐私政策需独立评估 |
| 评估风险 | 未建立召回率基准即实施压缩，可能导致关键信息不可逆丢失 |
| 合规风险 | CC BY-SA 4.0 许可要求衍生作品同样开源，闭源商用需关注传染性条款 |