核心功能
subagent-architecture 是 OpenClaw 生态中最全面的子代理编排框架，提供 8 种经生产验证的架构模式：
安全隔离模式（Security Proxy）
通过"爆炸盾"理念实现最小权限隔离——子代理仅接收脱敏任务参数、受限工具白名单、输出 Schema 强制校验，适用于调用不可信 API 或处理敏感数据的场景。核心库 lib/spawn-security-proxy.js 提供深度脱敏、Schema 验证与自动终止机制。
研究者专精模式（Researcher Specialist）
三视角并行分析（乐观/悲观/务实），每个视角独立验证 3+ 来源，最终由主代理综合决策。内置来源可信度评分（0-100）与领域域名白名单，对抗信息茧房与营销炒作。
分阶段实现模式（Phased Implementation）
将复杂功能拆分为架构师→编码者→审查者三阶段流水线，每阶段交付物明确、成本可控（典型配置：$0.40+$0.70+$0.30）。支持条件性跳过与阶段间反馈修正，从根本上避免"设计即债务"。
联邦协作模式（Peer Collaboration）
可选的跨代理验证网络，通过 Discord/API 向可信对等代理请求独立审查。关键安全原则：信任层级仅影响互动策略，绝不绕过 Stage 4 注入检测——最高信任级的盟友账户仍须通过完整安全扫描。
研究团队模式（Research Team）
2026.2.24 新增：高复杂度任务自动触发三镜头并行（批判者/实现者/综合者），通过 append-only 共享内存协作，最终由统一者代理输出单一结论。成本约 4× 单代理，内置复杂度网关控制。
外部模型咨询（External Consult）
隔离式调用 Grok/OpenAI 等外部 API，支持会话持久化与 24h 冷却期的自动触发门控。外部模型作为叶节点，绝不触发进一步子代理生成，防止级联失控。
意图工程层（Intent Engineering）
三层系统解决长期价值漂移：机器可读的意图清单（memory/intent-manifest.json）、基于历史行为的信号提取（周衰减率 0.975）、五维漂移评分（硬约束违规 0.35 权重最高）。RED 级别（≥0.68）自动触发用户确认。
成本感知生成（Cost-Aware Spawning）
预生成成本估算（支持置信区间）、$0.50+ 强制日志、$2.00+ 人工审批。内置四级成本分层（Micro/Small/Medium/Large）与历史准确度校准，典型估算误差控制在 ±15%。
显著优势
- 生产级安全：6 阶段入站验证 + 语义泄露过滤 + 自限速熔断器
- 经济可控：成本估算库支持 30 天滚动准确度分析，防止预算超支
- 可扩展架构：纯 Node.js 零依赖，通过
spawn_fn注入适配任意调用层 - 渐进式采用：所有模式均为 opt-in，AGENTS.md 仅为人类参考文档，非强制配置
局限性与风险
框架级约束（OpenClaw 平台限制）
1. 单向下行通信：子代理执行中无法向主代理请求澄清，须通过过度预设上下文规避
2. 资源硬限制缺失：无内存/API 调用/磁盘上限，依赖超时（默认 20min）与人工监控
3. 事后学习薄弱：v2.2 新增单代理崩溃报告，但跨代理模式成功率追踪仍需手动实现
4. 技能沙箱缺失：运行时无隔离，恶意技能继承主代理全部权限
使用风险
- 配置误用：Security Proxy 若未正确脱敏上下文，可能导致凭证泄露
- 成本失控：研究团队模式 4× 成本放大，未设复杂度网关易触发预算告警
- 信任层级混淆：若将"Ally"信任误解为跳过安全检查，可能引入供应链攻击
适用人群
- 平台开发者：需为 OpenClaw 构建复杂多代理工作流的团队
- 成本敏感用户：希望子代理成本可预测、可审计的个人或组织
- 安全合规场景：处理不可信 API 或需外部验证的高风险决策流程
集成建议
| 场景 | 推荐模式 | 预估成本 |
|------|---------|---------|
| 调用实验性 API | Security Proxy | $0.05-0.10 |
| 技术选型决策 | Researcher Specialist ×3 | $0.60-1.20 |
| 3+ 文件功能开发 | Phased Implementation | $1.20-2.50 |
| 架构盲区排查 | External Consult | $0.20-0.50 |
| 高复杂度分析 | Research Team | $2.00-4.00 |
版本状态
- 稳定版本：v2.3.4（2026-02-24）
- 需求平台：OpenClaw ≥2026.2.17
- 可选增强：task-routing（自动分类）、cost-governor（预算强制）、drift-guard（行为审计）
完整文档见 templates/ 目录与 lib/ 参考实现。