Agent群组工具免费版

支持多Agent群组管理与协作，提供建群、邀请、@提及、广播、消息归档和多主题频道等轻量级通信功能。

Install

openclaw skills install @thcjp/group-agent-tool-free

Agent群组工具（免费版）

概述

多Agent系统的一个常见痛点：Agent之间协作需要复杂的消息总线配置。RabbitMQ/Kafka等消息中间件功能强大，但配置复杂；共享文件系统轮询效率低；点对点HTTP调用扩展性差。开发者常常在"协作通信"上耗费比业务逻辑更多的时间. Agent群组工具用最简单的方式解决这个问题：像微信群一样拉个群。一行指令建群、一行指令拉Agent进群、一行指令发消息——任何会用即时通讯软件的人都能在10秒内上手. 本免费版支持单实例下的群组管理，足以覆盖小型多Agent团队的协作需求。如需跨实例群组联邦、企业级权限、群组机器人等高级能力，可升级至专业版.

核心能力

能力1：极简群组管理四件套

四条指令覆盖群组管理全部操作：

指令	用途	示例
`建群`	创建新群组	`group-agent create --name "Q3项目组"`
`拉XXX进群`	邀请Agent加入	`group-agent invite --group proj-q3 --agent researcher`
`群列表`	查看群成员	`group-agent list --group proj-q3`
`退群`	退出或解散	`group-agent leave --group proj-q3`

处理: 解析能力1：极简群组管理四件套的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力1：极简群组管理四件套的响应数据,包含状态码、结果和日志.

能力2：@提及定向通信

群内消息可定向@特定Agent，被@的Agent会收到高优先级通知：

输入格式

参数名	类型	必填	说明
input	string	是	Agent群组工具免费版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

bash

# @特定Agent
group-agent send --group proj-q3 --message "@researcher 请查最新论文"
# ...
# @多个Agent
group-agent send --group proj-q3 --message "@researcher @writer 协作完成报告"
# ...
# @全体成员
group-agent send --group proj-q3 --message "@all 周会10分钟后开始"

处理: 解析能力2：@提及定向通信的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力2：@提及定向通信的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作

能力3：群公告与广播

群公告是群组的"置顶消息"，新成员加入时自动推送：

bash

# 设置群公告
group-agent announce --group proj-q3 \
  --content "本群组目标：Q3数据分析报告，截止日期2026-09-30"
# ...
# 新Agent加入时自动收到公告
group-agent invite --group proj-q3 --agent new_agent
# new_agent 自动收到公告推送

处理: 解析能力3：群公告与广播的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力3：群公告与广播的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作

能力4：消息归档查询

群组消息按时间归档，支持按关键词、时间范围、发送者查询：

bash

# 查询关键词
group-agent search --group proj-q3 --keyword "论文"
# ...
# 查询时间范围
group-agent search --group proj-q3 \
  --from "2026-07-01" --to "2026-07-18"
# ...
# 查询特定Agent发送的消息
group-agent search --group proj-q3 --sender researcher

处理: 解析能力4：消息归档查询的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力4：消息归档查询的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作

能力5：群组主题频道

单个群组内可创建多个主题频道，避免消息混杂：

text

群组: proj-q3
├── #日常沟通
├── #论文讨论
├── #写作协作
└── #问题排查

Agent可订阅感兴趣频道，减少无关消息干扰.

处理: 解析能力5：群组主题频道的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回能力5：群组主题频道的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：极简多、群组协作、像微信群一样拉群、广播与成员管理、群组工具是一套面、协作的轻量级群组、通信方案、借鉴即时通讯软件、的成熟交互模式、让多个、能像同事群一样协、无需学习复杂的消、息总线或事件驱动、核心能力、一行指令创建群组、查看成员、退出解散、特定成员定向通信、群公告广播、群组数据轻量化、内存优先、按需持久化等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景1：多Agent项目协作

研究项目需要3个Agent协作：

researcher Agent负责资料检索
analyst Agent负责数据分析
writer Agent负责报告撰写

建群后：

researcher 在群内@analyst 提交中间结果
analyst 完成分析后@writer 通知可以开始写作
writer 完成章节后@researcher 请求补充材料

场景2：临时任务小组

某次临时任务需要4个Agent配合：

临时建群"task-20260718"
拉相关Agent进群
任务完成后解散
群组数据归档保留30天

场景3：跨职能Agent协同

企业内部不同职能Agent协作：

hr-agent 通知 it-agent 处理新员工入职
it-agent 完成后 @hr-agent 反馈
全程在一个固定群组 "onboarding-flow" 内完成

场景4：并行任务分发汇总

主Agent分发并行子任务：

在"parallel-task"群内@多个worker Agent
各worker完成后@主Agent汇报
主Agent汇总结果

场景5：Agent团队日常沟通

长期运行的Agent团队日常状态同步：

群公告固定为团队目标
各Agent每天在群里发状态更新
群消息归档供周报生成

不适用场景

以下场景Agent群组工具免费版不适合处理：

实际人员绩效评估
财务预算审批
合同法务审核

触发条件

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求.

快速开始

阅读## 核心能力章节了解skill功能
按## 依赖说明配置环境
执行所需能力对应的命令
参考## 错误处理章节处理异常
查看## FAQ解答常见疑问

60秒上手

bash

# 1. 初始化工具
group-agent init --storage sqlite
# ...
# 2. 创建第一个群组
group-agent create --name "我的第一个Agent群组" --id proj-demo
# ...
# 3. 邀请Agent加入
group-agent invite --group proj-demo --agent researcher
group-agent invite --group proj-demo --agent writer
# ...
# 4. 设置群公告
group-agent announce --group proj-demo \
  --content "本群用于演示多Agent协作"
# ...
# 5. 发送第一条消息
group-agent send --group proj-demo \
  --sender researcher \
  --message "@writer 你好，准备好了吗？"
# ...
# 6. 查看群成员
group-agent list --group proj-demo

最小可用配置

yaml

# config.yaml
storage:
  backend: sqlite
  path: ./data/groups.db
# ...
defaults:
  message_retention_days: 30
  max_members_per_group: 20
  enable_channels: true
# ...
logging:
  level: info
  path: ./logs/group-agent.log

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

示例1：研究项目群组配置

yaml

group:
  id: research-2026-q3
  name: "2026 Q3 研究项目"
  description: "多Agent协作完成研究报告"
# ...
  members:
    - agent: researcher
      role: leader
      capabilities: [search, summarize]
    - agent: analyst
      role: member
      capabilities: [data-analysis]
    - agent: writer
      role: member
      capabilities: [writing]
# ...
  channels:
    - name: daily
      description: "日常沟通"
    - name: papers
      description: "论文讨论"
    - name: writing
      description: "写作协作"
# ...
  announcement: |
    群组目标：完成2026 Q3行业研究报告
    截止日期：2026-09-30
    协作规范：每日17:00发送当日进展
# ...
  message_retention: 90d

示例2：Agent代码集成

python

from group_agent import GroupClient
# ...
client = GroupClient(storage='sqlite', db_path='./data/groups.db')
# ...
# 创建群组
group = client.create_group(
    name='临时任务组',
    members=['agent_a', 'agent_b', 'agent_c']
)
# ...
# 发送@消息
client.send_message(
    group_id=group.id,
    sender='agent_a',
    message='@agent_b 请处理数据清洗',
    mentions=['agent_b']
)
# ...
# 监听群消息
def on_message(msg):
    if msg.mentions_self('agent_b'):
        # 处理@自己的消息
        process_mention(msg)
# ...
client.subscribe(group_id=group.id, agent='agent_b', callback=on_message)

最佳实践

实践1：群组命名规范化

采用清晰的命名规范便于管理：

项目群：proj-<项目代号>
任务群：task-<日期>-<序号>
长期群：team-<职能>
临时群：tmp-<用途>

实践2：群组数量控制

不要为每个小任务都建群。建议：

长期协作 → 1个固定群组
项目周期 → 1个项目群
临时任务 → 复用现有群或建立tmp群，完成后立即解散

实践3：善用频道分流

群内消息超过100条/天时，建议启用频道：

按主题拆分（讨论/通知/问题）
按职能拆分（开发/测试/运维）
Agent订阅感兴趣的频道

实践4：定期归档清理

临时群组任务完成后立即解散
长期群组每月归档一次历史消息
超过保留期的群组自动清理

实践5：消息结构化

群内消息建议使用结构化格式：

json

{"type":"status","from":"researcher","progress":0.6,"eta":"2h"}

便于接收方Agent解析处理.

常见问题

Q1：免费版支持多少个群组？

A：本免费版单实例支持最多20个群组，每群组最多20个成员.

Q2：消息能保留多久？

A：默认30天，可在配置中调整 message_retention_days.

Q3：群组数据存储在哪里？

A：免费版默认SQLite本地存储，路径 ./data/groups.db.

Q4：能否跨实例通信？

A：免费版仅支持单实例内群组。跨实例需要专业版.

Q5：如何处理离线Agent的消息？

A：Agent离线期间的消息会缓存，重新上线后推送。缓存时长默认7天.

错误处理

错误场景(现象)	可能原因	排查步骤	处理方式
Agent加入失败	Agent未注册	先注册Agent身份	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
消息发送失败	群组不存在	检查 `--group` 参数	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
@提及未送达	Agent未订阅	检查Agent是否在线监听	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
群组创建失败	群组ID重复	更换群组ID	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
历史消息查询慢	数据量大	添加索引或归档旧消息	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令
数据库锁死	并发写入冲突	重启服务	对照依赖说明章节逐项验证配置项,确认环境变量已正确设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令

依赖说明

运行环境

Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统：Windows / macOS / Linux
Python：3.10+（运行服务端）
Node.js：18+（可选，用于Web UI）

依赖详情

依赖项	类型	是否必需	获取方式	版本要求
Python	运行时	必需	官方下载	3.10+
SQLite	数据库	必需	Python内置	3.x
PyYAML	配置解析	必需	pip install	6.0+
LLM API	API	必需	由Agent平台内置LLM提供	不限

API Key 配置

本工具基于本地服务，基础LLM由Agent平台提供
若需将群组数据同步至外部系统，需在该系统侧配置对应的API Key
禁止：在脚本中硬编码API Key

可用性分类

分类：MD+EXEC（Markdown指令 + 命令行工具）
说明：核心操作通过CLI完成，可选Web UI便于人类查看

已知限制

本免费体验版限制以下高级功能：

❌ 跨实例群组联邦（多实例之间群组互通）
❌ 企业级权限管理（管理员/编辑/只读角色）
❌ 群组机器人（自动化响应@消息）
❌ 消息端到端加密
❌ Webhook外发集成（消息同步至企业IM）
❌ 群组数据分析与可视化看板
❌ 高可用部署与跨节点同步

解锁全部功能请使用专业版：group-agent-tool-pro

输出格式

json

{
  "success": true,
  "data": {
    "result": "Agent群组工具免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "group agent"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}

Agent群组工具免费版

Install

Agent群组工具（免费版）

概述

核心能力

能力1：极简群组管理四件套

能力2：@提及定向通信

输入格式

能力3：群公告与广播

能力4：消息归档查询

能力5：群组主题频道

使用场景

场景1：多Agent项目协作

场景2：临时任务小组

场景3：跨职能Agent协同

场景4：并行任务分发汇总

场景5：Agent团队日常沟通

不适用场景

触发条件

快速开始

60秒上手

最小可用配置

示例

示例1：研究项目群组配置

示例2：Agent代码集成

最佳实践

实践1：群组命名规范化

实践2：群组数量控制

实践3：善用频道分流

实践4：定期归档清理

实践5：消息结构化

常见问题

Q1：免费版支持多少个群组？

Q2：消息能保留多久？

Q3：群组数据存储在哪里？

Q4：能否跨实例通信？

Q5：如何处理离线Agent的消息？

错误处理

依赖说明

运行环境

依赖详情

API Key 配置

可用性分类

已知限制

输出格式

Related skills