技能名称: agent-hive
详细描述:
最后使用: 2026-03-24
内存引用: 2
状态: 活跃

Agent Hive

创建和管理具有共享内存、预算治理和可配置生成权限的多智能体团队。

架构

主工作区 (~/.openclaw/workspace/)
├── MEMORY.md, TOOLS.md, USER.md, IDENTITY.md ← 共享大脑（实际文件）
├── agents// ← 每个智能体的发件箱、收件箱、预算
├── agents/governance/ ← 治理规则 + 审计日志
├── memory/, projects/, scripts/, skills/ ← 共享资源
└── content/ ← 共享内容

智能体工作区 (~/.openclaw/workspace-/)
├── SOUL.md ← 独特个性（本地文件）
├── AGENTS.md ← 独特指令（本地文件）
├── HEARTBEAT.md ← 智能体专属心跳（本地文件）
├── .openclaw/ ← 智能体专属配置目录
└── 其他所有内容 ← 指向主工作区的符号链接

添加新智能体

步骤 1：创建带符号链接的工作区

bash
AGENT_ID=
MAIN=$HOME/.openclaw/workspace
WS=$HOME/.openclaw/workspace-$AGENT_ID

mkdir -p $WS/.openclaw

符号链接共享大脑

for f in .learnings IDENTITY.md MEMORY.md ROADMAP.md TOOLS.md USER.md; do ln -sf ../workspace/$f $WS/$f done for d in agents content memory projects scripts skills; do ln -sf ../workspace/$d $WS/$d done

步骤 2：创建独特文件

创建 $WS/SOUL.md — 智能体的个性。这是其独有的文件。

创建 $WS/AGENTS.md — 智能体专属指令。必须包含：

• - 会话启动检查清单（读取 SOUL.md、检查 BUDGET.json、检查 INBOX.md）
• 通信规则（INBOX/OUTBOX 模式）
• 智能体做什么和不做什么
• 预算规则部分（参见 references/budget-rules.md）

创建 $WS/HEARTBEAT.md — 最小心跳配置。

步骤 3：在共享工作区创建智能体目录

bash
mkdir -p $MAIN/agents/$AGENT_ID
touch $MAIN/agents/$AGENT_ID/INBOX.md
touch $MAIN/agents/$AGENT_ID/OUTBOX.md

步骤 4：创建预算文件

复制 scripts/create_budget.sh 的输出或手动创建：

json
{
dailylimitoutput_tokens: 50000,
today: YYYY-MM-DD,
usedoutputtokens: 0,
spawns: [],
status: active,
warnings: [],
consecutiveoverbudgetdays: 0
}

保存到 $MAIN/agents/$AGENT_ID/BUDGET.json。

步骤 5：在 openclaw.json 中注册

添加到 agents.list[]：

json
{
id: ,
name: ,
workspace: /absolute/path/to/workspace-,
identity: { name: , emoji: },
model: {
primary: anthropic/claude-sonnet-4-6,
fallbacks: [, ]
},
subagents: { allowAgents: [, ] }
}

更新现有智能体的 allowAgents 以包含新智能体。

步骤 6：验证并重启

bash
python3 -c import json; json.load(open($HOME/.openclaw/openclaw.json)); print(JSON valid)
openclaw doctor # 检查模式错误
launchctl stop ai.openclaw.gateway && sleep 2 && launchctl start ai.openclaw.gateway

等待 15 秒后再测试。

生成权限模型

中心辐射型（保守）

只有编排器（主智能体）可以生成智能体。智能体通过 OUTBOX 路由请求。

json
subagents: { allowAgents: [] } // 适用于所有非主智能体

带预算的全网格（推荐）

所有智能体都可以生成对等体。预算治理防止滥用。

json
// 每个智能体可以生成所有对等体（不能生成自己）
subagents: { allowAgents: [<所有其他智能体 ID>] }

赚取型网格（渐进信任）

从中心辐射型开始。在展示预算责任后升级为网格型。 在反复超支后降级回中心辐射型。

预算治理

完整框架请参见 references/governance.md。

在心跳时运行审计脚本：

bash
python3 scripts/budget_audit.py

阈值：绿色（<80%）、黄色（80-100%）、红色（>100%）、紧急降级（>200%）。
连续 3 天超预算 → 自动降级（网格权限被撤销）。

在 HEARTBEAT.md 中添加步骤 4.5 — 参见 references/heartbeat-snippet.md。

委员会模式

对于项目工作，组建智能体委员会：

1. 1. 确定需要哪些智能体（例如，内容 + 营销 + 设计评审）
2. 并行生成它们，并分配清晰、范围明确的任务
3. 每个智能体写入其 OUTBOX.md
4. 编排器收集结果并进行综合
5. 每个智能体的预算在整个项目中跟踪

验证检查清单

添加智能体后，验证：

• - [ ] workspace-/ 包含 SOUL.md 和 AGENTS.md 作为本地文件
• [ ] 所有其他文件都是指向主工作区的符号链接
• [ ] agents//BUDGET.json 存在且模式正确
• [ ] 智能体出现在 openclaw doctor 输出中
• [ ] 网关重启无错误
• [ ] 智能体可被生成：sessionsspawn(agentId=, task=Say hello)
• [ ] 预算审计包含新智能体：python3 scripts/budgetaudit.py