核心用法
agent-architecture-guide 是一套面向 OpenClaw 平台的智能体架构最佳实践集合，包含12个经生产环境验证的模式：
关键模式速览
| 模式 | 解决痛点 | 核心操作 |
|------|---------|---------|
| **WAL Protocol** | 用户纠正/偏好被上下文压缩丢失 | 先写文件(W)再响应(R)，触发词："actually"、"let's do X"、具体日期值 |
| **Working Buffer** | 上下文>60%后近期对话丢失 | 自动写入`memory/working-buffer.md`，压缩后优先读取 |
| **Memory Anti-Poisoning** | 外部内容污染持久化记忆 | 仅存储声明性事实(❌指令性语句)，强制标注来源，引用后确认再写入 |
| **Cron Jitter** | 整点任务触发API限流 | `--stagger 2m`添加随机偏移 |
| **Delivery Dedup** | 定时任务+系统消息双重投递 | `--no-deliver`或`NO_REPLY`二选一 |
| **Isolated Sessions** | 后台任务被忽略或打断对话 | 监控类用`isolated agentTurn`，交互提示用`main systemEvent` |
| **Selective Skill Integration** | 全量安装覆盖SOUL.md等核心配置 | 读取→提取2-3个创新点→整合到自有架构，跳过setup脚本 |
| **ClawHub API过滤** | 低质量/废弃技能干扰 | 按stars/downloads/installs排序筛选，提供curl命令模板 |
| **Heartbeat Batching** | 多个cron消耗过多token | 单心跳检查多项，节省~60% token |
| **Relentless Resourcefulness** | 首次失败即放弃或求助 | 强制尝试5-10种方法(CLI+浏览器+搜索+子智能体)后才认输 |
| **TOOLS.md 清单** | 每次会话不知可用工具 | 维护分类技能清单，含调用方式和环境变量，会话启动优先读取 |
| **Error Documentation** | 重复踩坑 | 解决后立即记录问题/原因/方案到AGENTS.md |
典型应用场景
- 新智能体架构设计：从零构建时参考完整模式栈
- 上下文管理优化：已有智能体出现"失忆"或"what were we doing"症状
- 定时任务调优：cron任务冲突、重复投递、限流问题
- 技能治理：ClawHub技能筛选与选择性集成
- 可靠性审计：对照清单检查生产智能体健康度
配套工具
- agent-health-optimizer：基于本指南的自动化诊断技能
显著优点
1. 实战验证：每个模式均来自生产环境真实故障，非理论推演
2. 粒度精准：提供具体触发词、阈值(60%上下文)、文件路径、CLI参数
3. 系统性覆盖：从内存安全→任务调度→技能管理→故障处理全链路
4. 可度量收益：心跳批量化明确标注60% token降低
5. 协作生态：明确关联proactive-agent等源头技能，支持追溯和深度整合
潜在局限
1. 平台锁定：OpenClaw/Moltbook专属概念(WAL、ClawHub、session_status)迁移成本高
2. 假设依赖：部分模式假设用户有文件系统写入权限和持久化存储
3. 动态阈值：60%上下文触发点为经验值，未提供不同模型/场景的调整指南
4. 无自动化：本技能为文档型，实际防护需人工实施或配合health-optimizer
5. curl依赖：ClawHub API调用示例依赖系统curl/python环境
适合人群
| 角色 | 使用方式 |
|------|---------|
| **智能体架构师** | 作为设计评审checklist |
| **现有智能体维护者** | 诊断"健忘"、任务遗漏、重复消息等问题 |
| **ClawHub技能开发者** | 理解平台最佳实践，避免常见反模式 |
| **高可靠性场景** | 客服、监控、自动化工作流等不能丢失关键信息的场景 |
| **资源敏感用户** | 通过心跳批量化降低API调用成本 |
常规风险
| 风险场景 | 缓解措施 |
|---------|---------|
| **过度工程** | 小型智能体无需全量12模式，按需选择 |
| **WAL误触发** | 非关键闲聊写入造成存储膨胀，需精简触发词 |
| **Buffer未及时清理** | working-buffer.md无限增长，建议定期归档 |
| **来源标注疲劳** | 每条事实强制(source:)可能降低写入意愿，建议区分 obvious vs non-obvious |
| **cron stagger漂移累积** | 长期运行后确定性hash偏移可能仍冲突，建议监控API错误率 |
| **TOOLS.md维护遗漏** | 安装技能后忘记更新清单，建议skill安装hook自动化 |
| **资源耗尽循环** | Relentless Resourcefulness在复杂故障时可能消耗过量token，建议设置尝试上限 |
实施建议优先级
P0(立即)：WAL Protocol + Working Buffer → 解决失忆问题
P1(本周)：Memory Anti-Poisoning + TOOLS.md → 建立安全基线
P2(调优期)：Cron设计3模式 + Heartbeat Batching → 降低运行成本
P3(治理期)：Selective Integration + Error Documentation → 长期健康度