agent-squad

用途

Agent Squad 用于编排一组专业化的 AI 智能体，使它们通过共享工作区和心跳调度协同完成任务。它解决的是“单个 AI 包揽所有事情”带来的上下文膨胀和产出泛化问题，转为由具有明确分工的多个智能体协作。

主要能力

初始化并管理智能体小队（squad）。
添加具有不同角色的智能体，每个智能体拥有独立人格（SOUL.md）。
每个智能体是隔离的 OpenClaw 会话，拥有唯一会话键（agent:{name}:main）、自定义 SOUL.md、心跳 cron 以及对共享任务系统的访问权限。
采用心跳模式：智能体按计划周期性唤醒，检查 @提及、被分配任务和活动；若无任务则返回 HEARTBEAT_OK 并休眠。
通过共享任务系统进行协调，支持 Linear（推荐）、Trello、GitHub Issues 和本地 Markdown 文件。
支持多模型配置，可为不同智能体指定不同模型。
支持自定义心跳调度，可错开各智能体的唤醒时间。
提供 AGENTS.md 共享操作手册模板与 SOUL.md 人格模板（如 Researcher、Writer、Lead、SEO Analyst、Social Media、Developer）。

使用方式

快速开始：

# 初始化小队
agent-squad init my-squad

# 添加智能体
agent-squad add researcher --role "Deep researcher. Finds sources and data."
agent-squad add writer --role "Content writer. Sharp, opinionated voice."
agent-squad add lead --role "Squad lead. Coordinates and reports."

# 配置任务系统
agent-squad config --tasks linear --project "Content Squad"

# 启动心跳（智能体每 15 分钟唤醒一次）
agent-squad start

小队管理命令：

agent-squad init <name>              # 创建新小队工作区
agent-squad status                   # 显示所有智能体及健康状态
agent-squad logs <agent>             # 查看最近的心跳记录

智能体管理命令：

agent-squad add <name> [options]
  --role "Description of role"
  --personality "skeptical|creative|analytical"
  --schedule "*/15 * * * *"
  --model "kimi-code"

agent-squad edit <name>              # 编辑 SOUL.md
agent-squad remove <name>            # 移除智能体及 cron
agent-squad disable <name>           # 暂停心跳
agent-squad enable <name>            # 恢复心跳

任务系统集成命令：

agent-squad config --tasks linear    # 使用 Linear
agent-squad config --tasks trello    # 使用 Trello
agent-squad config --tasks github    # 使用 GitHub Issues
agent-squad config --tasks file      # 使用本地 markdown 文件

操作命令：

agent-squad start                    # 启动所有心跳
agent-squad stop                     # 停止所有心跳
agent-squad trigger <agent>          # 手动触发心跳
agent-squad notify "@writer draft ready"  # 发送通知

自定义心跳调度（错开智能体唤醒）：

agent-squad add lead --schedule "0,15,30,45 * * * *"
agent-squad add researcher --schedule "5,20,35,50 * * * *"
agent-squad add writer --schedule "10,25,40,55 * * * *"

多模型小队：

agent-squad add researcher --model "kimi-code"        # Cheap, fast
agent-squad add writer --model "claude-opus-4-5"      # Premium creative

适用场景

示例为内容营销小队，3 个智能体配合 Linear：

agent-squad init content-squad
agent-squad add fury --role "Researcher. Every claim needs a source."
agent-squad add loki --role "Writer. Sharp, anti-fluff voice."
agent-squad add jarvis --role "Lead. Coordinates, reports to human."

agent-squad config --tasks linear --project "Content Squad"
agent-squad start

工作流：在 Linear 创建 issue（如“Blog post: AI Agent Security”）→ Jarvis（负责人）分配给 Fury（研究员）→ Fury 心跳唤醒后研究、发布发现并 @提及 Loki → Loki 心跳唤醒后撰写草稿、发布并 @提及 Jarvis → Jarvis 通过 Telegram 通知你“草稿已就绪待审阅”。

限制与要求

运行要求：

OpenClaw gateway 正在运行。
任务系统凭据（如 Linear API key、Trello token 等）。
Node.js（用于 CLI）。

参数选项包括 --role、--personality（skeptical|creative|analytical）、--schedule、--model。其中 --personality 的具体取值范围以资料所示为准。

其他架构细节（如 OpenClaw Gateway、Cron Jobs 与任务系统的关系）见官方架构图。关于收费、价格、平台支持范围等信息，资料暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制与要求