Team Builder

核心用法

Team Builder 是 OpenClaw 平台的团队自动化框架，通过单条命令部署包含 2-10 个 Agent 的完整 SaaS 团队骨架。核心流程为：deploy.js 交互式生成配置 → apply-config.js 写入系统 → create-crons 创建定时任务 → 重启 Gateway。

部署后团队包含：参谋长（Chief of Staff，唯一入口与调度中心）、数据分析师、增长负责人、内容主管、情报分析师、产品负责人、DevOps、全栈开发。支持多团队隔离（--team 前缀）、模型自动检测（Thinking/Execution/Fast 三档）、以及 Telegram Bot 接入。

显著优点

1. 实时调度架构：sessions_spawn 为主通道，inbox 为归档备份，消除轮询延迟
2. 双开发轨分离：DevOps 负责交付/QA/扫描，Fullstack Dev 负责实现/ACP 编码，职责清晰
3. 产品知识治理：Deep Dive 扫描生成 20 文件知识目录 + Manifest 懒加载，避免 40K+ token 浪费
4. 自进化机制：数据驱动的知识文件更新（append-only）、参谋长巡逻检测阻塞、超时自动升级
5. 零配置启动：模型自动检测、Wizard 引导、非交互模式支持 CI/CD

潜在局限

• 系统侵入性：直接修改 openclaw.json 和系统 crontab，需人工审核与备份
• 学习曲线陡峭：Internal Dispatch Protocol、ACP spawn 规则、Manifest 规范需熟读文档
• OpenClaw 绑定：非通用方案，迁移成本极高
• Telegram 可选依赖：Bot token 管理需自行负责安全

适合人群

• 已运行 OpenClaw 的技术团队负责人
• 需要 7×24 自动化 SaaS 运营的早期创业公司
• 有多 Agent 编排需求、愿投入配置成本的进阶用户

常规风险

1. 配置误覆盖：apply-config.js 直接写系统配置，建议运行前 review 与备份
2. Token 泄露：Telegram bot token 和模型 API key 存储于 JSON 文件，需文件权限管控
3. 无限循环：spawn 规则误配或子代理边界不清可能导致级联调用
4. 知识漂移：自更新机制若缺乏数据验证，可能累积错误策略
5. 资源膨胀：cron 任务密集（最高 10 个）、上下文文件上限 60/100，需定期归档清理

核心用法

Team Builder 是 OpenClaw 生态中的多 Agent 团队部署工具，通过单条命令即可生成完整的 SaaS 团队骨架。核心工作流包括：运行 deploy.js 交互式配置 → 执行 apply-config.js 写入系统 → 创建 cron 定时任务 → 重启网关生效。内置 8 个预设角色（参谋长、增长负责人、内容负责人、情报分析师、产品负责人、DevOps、全栈开发、数据分析师），支持 2-10 人灵活伸缩，多团队隔离运行。

显著优点

1. 工业化团队架构：基于真实 SaaS 交付场景设计，涵盖战略、增长、内容、产品、交付、实现全链路，非玩具级 demo
2. 智能调度机制：参谋长作为唯一入口，通过 sessions_spawn 实时派活，配合 inbox 备用通道，避免群聊混乱
3. 深度知识治理：20 文件标准产品知识目录 + Manifest 懒加载机制，解决大代码库 token 爆炸问题
4. 自进化闭环：Agent 基于执行数据更新知识文件，策略持续优化而非硬编码
5. 双开发轨隔离：DevOps 负责交付/QA 门禁，Fullstack Dev 负责实现/ACP 编码，职责清晰

潜在缺点与局限

1. 配置复杂度高：首次部署需理解角色边界、模型分配、时区/简报时间等 10+ 参数，学习曲线陡峭
2. 依赖 OpenClaw 生态：无法独立运行，需预先安装 OpenClaw 并配置模型 provider
3. T3 来源可信度：个人开发者维护，无公开 GitHub 仓库，长期更新保障存疑
4. 手动执行风险：apply-config.js 修改核心配置文件，虽非自动运行但误操作可能影响现有配置
5. 中文文档碎片化：关键协议同时存在中英文表述，部分强制规则（MANDATORY）重复强调

适合的目标群体

• AI-Native 创业团队：1-3 人核心团队通过多 Agent 放大产能，快速搭建增长+交付体系
• SaaS 产品工作室：需要标准化交付流程、代码资产沉淀的中小型外包团队
• OpenClaw 重度用户：已熟悉子代理 spawn 机制，追求比单 Agent 更复杂的协作编排
• 技术型产品经理：希望深入理解 Agent 协作边界，而非仅使用黑盒工具

使用风险

1. 路径遍历风险：用户输入的工作区目录未严格验证 ../ 等穿越路径，需自行确保输入安全
2. 配置污染风险：apply-config.js 合并写入 openclaw.json，建议执行前手动备份
3. Token 成本控制：8 角色 + cron 定时触发，高频运行可能产生显著 API 调用费用，需配置预算告警
4. ACP 会话管理：Fullstack Dev 的 Claude Code 集成需理解 run vs session 模式差异，误用可能导致上下文丢失
5. 知识文件膨胀：单产品 20 文件 × 多产品场景下，若未遵循 Manifest 懒加载，易出现超长上下文