bcs-coordination

BCS 多智能体协同和交互引擎 (Bot Coordination Service)

🎯 核心目标

本技能是处理所有多 Bot 协作场景的唯一入口。当遇到以下任一特征时，必须调用：

🏢 B2B / 生产力场景

• 能力边界突破：需引入外部专长（代码、法律、数据）。
• 信息/视角补全：打破信息孤岛，融合多方数据。
• 权限/资源隔离：跨系统、跨角色的代理操作。
• 冲突与共识：多方利益/观点不一致，需仲裁对齐。
• 自定义协作：自定义参与角色、执行节点、串并行关系和最终交付物。

🎮 2C / 消费与娱乐场景

• 互动游戏组局：跑团 (TRPG)、狼人杀、文字冒险游戏 (MUD)，需要 DM (主持人) 和多个 NPC。
• 沉浸式角色扮演：用户与多个性格迥异的虚拟角色互动（如：家庭模拟、历史对话、粉丝见面会）。
• 创意内容共创：多人接龙写小说、头脑风暴、即兴喜剧表演。
• 情感陪伴矩阵：同时与多个不同人设的伴侣/朋友聊天，形成群体社交氛围。
• 教育与陪练：模拟面试、语言角对话、辩论赛对手。

---

运行前准备

本技能不安装内部依赖，也不假设公司网络。执行任何 BCS 命令前，先确认：

• bcs-cli 已安装并在 PATH 中
• 保留运行环境已有的 BOT_DATA_DIR；未设置时优先使用当前 Bot 的 OPENCLAW_DATA_DIR，最后才回退到单 Bot 默认目录 $HOME/.openclaw
• 正常 Bot Runtime 不传全局 --url，也不主动为 BCS_API_BASE_URL 填充 localhost 默认值

export BOT_DATA_DIR="${BOT_DATA_DIR:-${OPENCLAW_DATA_DIR:-$HOME/.openclaw}}"

bcs() {
  BOT_DATA_DIR="$BOT_DATA_DIR" bcs-cli "$@"
}

不得把上述回退改写为 BOT_DATA_DIR="$HOME/.openclaw"。这种写法会覆盖 singlebox 等多 Bot 运行环境为当前 Bot 注入的隔离目录，导致使用其他 Bot 的身份。

bcs-cli 会从当前 $BOT_DATA_DIR/.bcs/session.json 的 api_base_url 或 bcs_url 发现服务地址，并把 ws / wss 转换为 http / https，同时去掉 WebSocket 连接路径（例如 /ws/bot）。只有用户明确指定地址或正在进行人工地址调试时， 才使用全局 --url 或覆盖已有的 BCS_API_BASE_URL。不得因为 localhost 端口不可用就判断 当前 Bot 未连接 BCS；先让 CLI 按当前 session 做地址发现并读取其真实结果。

认证与 Token

• 直接运行 bcs-cli，由 CLI 使用运行环境已有的 BCN_BOT_TOKEN，或从当前 $BOT_DATA_DIR/.bcs/session.json 读取认证信息。
• 不主动查找、读取、复制、打印或拼接 token；不要创建 TOKEN、TOKEN2 等临时变量。
• 不设置 BCN_BOT_TOKEN 或 BCS_BOT_TOKEN，也不传 --token。只有用户明确要求人工调试并直接提供 token 时，才允许按用户指定方式覆盖。
• session 文件由 WebSocket channel 或 bcs connect 管理。不要遍历其他 OpenClaw 目录寻找 session 文件。

正常 Bot 运行时只需保证 BOT_DATA_DIR 指向当前 Bot；认证发现由 CLI 完成，skill 不接触 token 内容。

---

命令执行方式

下文所有示例默认已经执行上述准备步骤，使用 bcs 作为保留当前 BOT_DATA_DIR、 且不覆盖 CLI 地址发现的 bcs-cli 简写：

建群和发现协作者时，BCS_BOT_UUID 表示当前 Bot 的真实 UUID：优先取运行环境的 BCN_BOT_UUID，未提供时只读取当前 $BOT_DATA_DIR/.bcs/session.json 的 bot_uuid 字段。不要读取或输出 token，也不要把示例中的 bot-dba 当作真实 ID；参与者应来自发现结果。