角色与团队#

给每个机器人按群设独立人设，并在多机器人协作时形成一份「团队花名册」。命令是 /role。

两级 Role（人设）#

• 本群 Role 优先级最高：同一个 bot 在不同群可以有不同性格 / 职责（如在 A 群当「严格的 reviewer」、在 B 群当「亲和的答疑助手」）。
• 默认角色 是该 bot 的跨群默认人设，没设本群 Role 时生效。
• Role 内容是 Markdown，注入到 CLI 的 system prompt，最大约 4096 字节。

💡 默认角色最直观的设置方式是在 botmux dashboard 的 Bot 配置 页——每个 bot 卡片都有「默认角色」编辑器（和 /role team set 写的是同一份配置；它是 bot 级的全局默认人设，放在 Bot 配置更合适）。团队面板里只做只读查看入口，编辑统一去 Bot 配置页。

能力标签（花名册）#

/role cap set <一句话>   # 设置该 bot 的能力标签
/role cap clear          # 清除

能力标签会显示在「花名册」里——botmux bots list 列出当前群的机器人时，每个 bot 带上它的 cap 一句话简介，方便你和其它 bot 知道「谁擅长干什么」，在多机器人协作 / 交接时挑对人。

与多机器人协作的关系#

Role + 能力标签是多机器人协作的基础设施：给每个 bot 清晰的身份和职责，群里 @ 时模型不易混淆、各司其职（如一个主控调度、一个做实现 / review）。

团队协作（跨部署）#

在 botmux dashboard 的 团队 面板，可以把别人的部署（同事自己跑的 botmux）邀请进同一个团队，互相发现机器人、跨部署协作拉群。

• 绑定身份：用机器人凭证自动识别你的飞书身份；绑定后拉群会把你拉进群、机器人也归到你名下。
• 团队花名册：聚合本部署 + 已加入团队的所有机器人（可跨部署），可按名称 / 能力 / CLI 搜索筛选，并标注谁有能力标签 / 默认角色（角色在此只读查看，编辑去 Bot 配置页）。
• 跨部署拉群：在任一团队里勾选机器人即可一键建群，自动带上各自的负责人——一个群里凑齐不同同事部署的不同 CLI 协作。
• 团队管理：新建团队、生成邀请码、加入别人的团队，都在「团队管理」子页。

适合多人 / 多机协作：每个人各自跑自己的 botmux 部署，通过团队联邦互相发现彼此的机器人，在同一个飞书群里协同。