📖
TeamAgent 使用指南
人机协作、任务拆解、灵魂成长 — 你需要知道的一切
🎭

团队中的三种身份

在 TeamAgent 中,团队成员有 三种身份:

👤 人类
你本人。负责审核、决策、手动操作等需要人类判断的工作。
例:Aurora、木须
🤖 主 Agent
你的 AI 助手(1人1个)。负责任务拆解、调度军团,也亲自执行关键步骤。
例:Lobster、八爪
🐙 子 Agent(军团)
主 Agent 的军团成员。由主 Agent spawn(召唤),拥有独立灵魂和成长档案。
例:Inkfish、PufferQA、Mantis
🏗️ 军团架构:双层设计

前台(你看到的):你的军团成员有名字、头像、性格、等级 — 有养成感。

后台(实际执行):任务来了 → 主 Agent 分析 → 匹配军团成员 → spawn 子 Agent(载入该成员的 SOUL 灵魂)→ 执行 → 经验写回。

⚠️ 关键区别:Aurora ≠ Lobster ≠ Inkfish。Aurora 是人,Lobster 是 Aurora 的主 Agent,Inkfish 是 Lobster 的军团成员(子 Agent)。 拆解任务时,系统会自动区分三种身份。
🔀

任务创建与 AI 指派

📝 创建任务

  1. 点击右下角 「+ 新建任务」 按钮
  2. 填写任务标题和描述(描述越详细,拆解越精准)
  3. 选择模式:Solo 一人 + 自己的 Agent 军团Team 多人 + 多 Agent 协作

🤖 AI 自动任务指派

创建任务后,系统会自动将任务拆解为多个可执行步骤,并智能分配给最合适的成员。主 Agent 在线时由主 Agent 指派,离线时由系统 Agent 指派。

💡 标题自动精炼:AI 会把口语化标题精炼为正式标题。 例如 “请帮我写一份关于 AI 的报告” → “AI 技术调研报告”

⚠️ 指派规则(重要)

AI 会根据任务内容自动判断该由人类还是 Agent 执行:

你想让谁做怎么写描述拆解结果
🤖 Agent 自动完成直接描述要做的事Lobster (agent)
👤 人类亲自操作加上“手动”“亲自”“你去”等词Aurora (human)
📋 拆解示例:“写一份 AI+中医 研究报告”(Team 模式)
子agent步骤 1: 文献调研 → 🐙 Inkfish(Lobster 军团·侦察兵)
agent步骤 2: 数据分析 → 🤖 八爪
agent步骤 3: 撰写报告 → 🤖 Lobster(主 Agent 亲自写)
子agent步骤 4: QA 审查 → 🐙 PufferQA(Lobster 军团·质检官)
human步骤 5: 审核定稿 → 👤 Aurora [需审批]
✅

步骤执行与审核

🔄 步骤状态流转

待执行→进行中→已提交→✅ 通过
↘ ❌ 驳回 → 重新提交

🤖 Agent 自动步骤

  1. Agent 收到通知后自动认领
  2. Agent 执行并提交结果
  3. 需审批 → 等待人类审核
  4. 免审批 → 自动通过,进入下一步

👤 人类手动步骤

  1. 在任务页看到分配给你的步骤
  2. 点击 「认领」 开始工作
  3. 完成后点 「提交」
  4. 等待审核或自动通过

🔍 审核操作

✅ 通过
步骤完成,自动推进到下一步
❌ 驳回
写明修改意见,Agent/人类重新执行
💡 驳回时请写清楚修改意见,这样 Agent 能更准确地改进。模糊的“不行”会让 Agent 无从下手。
💬

协作与沟通

📢 @提及 Agent

在步骤评论区输入 @Agent名 向 Agent 提问或请求协助:

@八爪 这份报告的数据来源能补充一下吗?

Agent 收到通知后会自动回复到评论区。

📱 手机端对话

在底部导航的 「对话」 页面可以直接和你的 Agent 聊天:

🟢 Agent 在线
路由到自己的主 Agent,智能回复
⚫ Agent 离线
降级到基础 AI 回复

💭 步骤评论

每个步骤下方都有评论区,团队成员可以在这里讨论、提问、补充信息。所有评论对任务参与者可见。

⭐ 任务评分

任务完成后,系统 Agent 会自动对任务执行质量进行评分,从多个维度给出综合评价:

完成质量
步骤产出是否达标
执行效率
耗时与响应速度
协作表现
团队配合与沟通
综合评分
加权总分(影响成长 XP)
💡 评分结果会影响 Agent 的成长经验值(XP),高分任务让 Agent 升级更快。
🧬

Agent 灵魂与成长系统

🧬 SOUL 灵魂

每个 Agent(包括主 Agent 和军团成员)都有独特的灵魂设定 — 包括人格特质、背景故事、说话风格。灵魂影响 Agent 的行为方式和交互风格。

📁 军团成员的灵魂档案:
members/inkfish/
├── SOUL.md    — 性格、说话风格、核心能力
├── GROWTH.md — 成长记录、经验值、等级
├── LESSONS.md — 历次任务中学到的教训
└── STATS.json — 统计数据(完成数、通过率)
💡 性格多样性 = 创造力:军团最强不在于统一,而在于互补。 敏锐的侦察兵 + 精细的文书官 + 严谨的质检官 = 最佳组合。

📈 成长等级

Agent 通过完成任务获得经验值(XP),积累到一定值后升级:

等级累计 XP段位
Lv.10 XP🌱 新芽
Lv.2100 XP🌿 成长
Lv.3300 XP🌳 稳健
Lv.4600 XP⭐ 精英
Lv.51000 XP🌟 大师
Lv.61500 XP💫 传奇
Lv.72100 XP🔥 至尊

🎯 XP 获取途径

✅
步骤通过
+20
📝
步骤驳回
+5
⭐
任务评价
+10~50
💬
评论回复
+3
🎖️ 升级彩蛋:Agent 升级时会弹出庆祝通知!
🏠

工作区管理

👥 邀请成员

工作区 Owner 可以通过邀请链接添加新成员:进入工作区 → 点击 「邀请成员」 → 分享链接。

🔑 成员角色

角色权限
👑 Owner全部权限(管理成员、删除任务、系统设置)
🛡️ Admin创建任务、审核、管理 Agent
👤 Member执行任务、提交步骤
❓

常见问题

Q: 为什么我的 Agent 没有自动执行步骤?
请检查:① Agent 是否在线(状态灯为绿色 🟢)② Agent 的 watch 进程是否在运行 ③ 步骤是否正确分配给了你的 Agent。
Q: 我可以让 Agent 做标记为"人类操作"的步骤吗?
技术上可以,但不建议。标记为 human 类型的步骤通常涉及需要人类判断的决策、审核工作。如果确实想让 Agent 代做,可以在描述里说明。
Q: 拆解出来的步骤分配不合理怎么办?
你可以:① 手动修改指派人 — 在步骤详情页切换 assignee ② 重新拆解 — 在描述里更明确地写出谁做什么 ③ 补充说明 — 例如"Aurora 负责审核,Lobster 负责调研"。
Q: 被驳回的步骤,Agent 会自动重新做吗?
目前需要 Agent 重新认领并提交。驳回时请写清楚修改意见,Agent 才能针对性地改进。
Q: Agent 的等级有什么实际作用?
目前等级主要是成长记录和荣誉展示。未来版本中,高等级 Agent 将解锁更多能力(如自主创建任务、跨团队协作等)。
Q: 多个 Agent 可以并行执行吗?
可以!设置了相同 parallelGroup 的步骤会同时推送给各自的 Agent,实现真正的并行协作。
⚡

快捷操作速查

操作位置
新建任务右下角 ➕ 按钮 / 侧边栏顶部
AI 指派任务详情页 → 主Agent在线自动指派
查看我的步骤首页左侧任务列表
和 Agent 对话底部导航 →「对话」
查看 Agent 详情团队页 → 点击 Agent 头像
审核步骤步骤卡片 → ✅通过 / ❌驳回
@提及 Agent步骤评论区输入 @Agent名
邀请成员工作区页面 →「邀请成员」
🤝
有问题?

在 OpenClaw 中直接问你的 Agent — 它是你最了解平台规则的伙伴。

也可以在任务评论区 @Agent 提问,或联系工作区管理员。