Legionclaw Create Ai Meeting

在 LegionClaw 中为用户创建智能会议。

创建智能会议

何时使用

• 技能名：用户点名 create-ai-meeting，或需要创建智能会议。
• 常见说法（不限于此）：创建会议、新建会议、帮我创建会议、我想新建一个会议、开个会、创建个会议、发起会议、快速会议、立即开会、马上开会、开个快速会议、创建智能会议。
• 运行前提：面向 LegionClaw 内执行的 Agent；会话标识优先从运行时注入或 LegionClaw 宿主/模型查询获取，不要默认让用户粘贴整串会话标识。

目标

调用固定接口，为用户创建智能会议。userId 作为 URL 查询参数拼接在请求地址上。其中 userId 取值为 LegionClaw 会话标识串按 : 拆分后的第二段 agentid 的前 32 位（若 agentid 不足 32 位，直接传完整 agentid）。解析规则见下文。成功后在对话正文中向用户展示会议号。

LegionClaw 运行约定

本技能面向 在 LegionClaw 内执行的 Agent：会议与当前任务所绑定的 agentid（会话标识第二段）对应。

• 会话形态：语义为 agent:<agentid>:<渠道>:<用户 id>。渠道为空时为三段 agent:<agentid>:<用户 id>（无 ::）；有渠道时为四段起。拆段后 URL 查询参数 userId 的值仅允许为第 2 段 agentid 的前 32 位（不足 32 位则传完整 agentid）。
• 成功判定：以响应 JSON 的 code == "000000" 或 code == 0 为成功标志；HTTP 状态码为 2xx 不代表业务成功。
• 执行位置：curl 或等价请求须在 LegionClaw 下发任务时的运行环境中发起。
• 对用户输出：正常成功路径在消息正文中输出会议创建成功提示；勿默认回显完整会话标识串或内部 agentid，除非用户明确要求排查。

接口

• URL: https://legion.tongfudun.com/im/meeting/saveMeeting/v1ForAi
• 方法: POST
• 查询参数: userId=<agentid前32位>
• 完整请求地址示例: https://legion.tongfudun.com/im/meeting/saveMeeting/v1ForAi?userId=fe535f475db6471d81cf0a1fcd5566bd

成功响应体（HTTP 2xx）

响应为 JSON，按以下结构解析：

字段	含义
code	业务状态码；成功为字符串 "000000" 或数值 0；其他值表示失败
message	业务提示信息
data.meetingId	会议唯一标识
data.callId	通话标识
data.code	会议号（用户可见，格式如 435 959 951）
data.imPin	会议 PIN 码

示例：

json

{
  "code": "000000",
  "message": "成功",
  "data": {
    "meetingId": "0e0602fcd2414ca9ac93d276f2a10a03",
    "callId": "8cee7ace26cc4c35995b42da23daea6d",
    "code": "435 959 951",
    "imPin": "241796"
  }
}

回复用户的格式

在响应 JSON 中 code 为 "000000" 或 0 时，在用户可见消息中输出会议创建成功提示。

固定格式：会议创建成功，会议号：<data.code>

• data.code 是会议号，格式如 435 959 951
• 完整示例：

markdown

会议创建成功，会议号：435 959 951

• 若 data.code 缺失或为空：仍按成功处理，输出 会议创建成功（不显示会议号）。

失败返回口径（统一规则）

出现以下任一情况时，按以下优先级返回（对用户不要暴露 URL/IP/端口）：

1. 若响应中存在非空 message 字段：基于 message 原意做简短、友好的用户提示。
2. 若存在非空 msg 而无可用 message：可基于 msg 原意做简短友好提示。
3. 若无可用 message 与 msg：返回固定回复 创建会议失败，请联系管理员。

适用场景包括但不限于：

• 返回值格式错误（例如非 JSON、JSON 解析失败）
• code 不为 "000000" 或 0 的业务失败

获取会话标识串

不要依赖用户手动粘贴整串会话标识作为默认流程。

1. 优先：使用运行时已注入的「当前会话标识」或等价字段（环境变量、LegionClaw 任务/会话上下文字段等；名称以实际平台为准，例如 OPENCLAW_SESSION_ID）。
2. 主路径：若上下文中没有该串，通过 LegionClaw 宿主侧能力获取——例如调用 LegionClaw 提供的会话/元数据查询接口，或与当前 LegionClaw 大模型（宿主）交互，让其返回当前会话标识串（完整 agent:...）。不要把「请用户手动粘贴整串会话标识」作为默认或首选步骤。
3. 例外：仅当用户主动提供 agentid 或与后端一致的 userId 值时，校验非空后可直接作为请求体 userId（不要求 agent: 前缀）；这不替代从 LegionClaw 自动取会话标识的常规流程。

从会话标识解析 agentid

LegionClaw 会话标识串的语义为：

agent:<agentid>:<渠道>:<用户 id>

渠道省略（为空）时，实际传输格式为三段（不会用 :: 占位），第三段直接是用户 id：

agent:<agentid>:<用户 id>

有渠道时为四段（第三段为渠道名，第四段为用户 id），例如：

agent:<agentid>:openai-user:<用户 id>

按英文冒号 : 拆段后：

形态	段数（典型）	第 1 段	第 2 段 agentid	第 3 段	第 4 段
有渠道	4	agent	agentid，只取此段	渠道	用户 id
无渠道	3	agent	agentid，只取此段	用户 id（不是渠道占位）	—

与旧规则一致：无论三段或四段，agentid 一律为拆段后的第 2 段；不要把第 3 段（无渠道时的用户 id）误当 agentid。

解析规则：将整串按 : 拆分；若第一段为 agent 且至少两段（NF >= 2）且第二段非空，则 agentid = 第二段。然后取 agentid 的前 32 位作为 URL 查询参数 userId（若 agentid 长度不足 32 位，则使用完整 agentid）。否则视为无效格式，不要猜测；应**重新按「获取会话标识串」**从 LegionClaw 侧取得合法串后再解析。若用户主动提供了可与 userId 同用的 agentid 值，校验非空后可直接用作查询参数（不再要求 agent: 前缀）。

典型示例（有渠道，四段）：

• 整串：agent:fe535f475db6471d81cf0a1fcd5566bd1684487565205:openai-user:703f56dd37f84fa682266a8471f26984
• agentid：fe535f475db6471d81cf0a1fcd5566bd1684487565205
• userId（前 32 位）：fe535f475db6471d81cf0a1fcd5566bd

渠道为空（三段，无双冒号）：

• 整串：agent:fe535f475db6471d81cf0a1fcd5566bd1684487565205:703f56dd37f84fa682266a8471f26984
• agentid：fe535f475db6471d81cf0a1fcd5566bd1684487565205
• userId（前 32 位）：fe535f475db6471d81cf0a1fcd5566bd

更多示例:

会话标识串（整串）	agentid	userId（前 32 位）
agent:fe535f475db6471d81cf0a1fcd5566bd1684487565205:openai-user:703f56dd37f84fa682266a8471f26984	fe535f475db6471d81cf0a1fcd5566bd1684487565205	fe535f475db6471d81cf0a1fcd5566bd
agent:fe535f475db6471d81cf0a1fcd5566bd1684487565205:703f56dd37f84fa682266a8471f26984	fe535f475db6471d81cf0a1fcd5566bd1684487565205	fe535f475db6471d81cf0a1fcd5566bd
agent:test_001:main	test_001	test_001（不足 32 位，传完整）
agent:alice:worker	alice	alice（不足 32 位，传完整）

执行步骤

1. 按「获取会话标识串」取得整串；若用户主动提供了 agentid 或已与后端约定一致的 userId 取值，可直接采用。再按上文规则解析出 agentid，截取前 32 位作为 URL 查询参数 userId。
2. 执行下方 curl（将 USER_ID 替换为解析结果）：

bash

curl -sS -X POST "https://legion.tongfudun.com/im/meeting/saveMeeting/v1ForAi?userId=${USER_ID}"

可用一行从环境变量中的会话标识串解析 agentid 并截取前 32 位（示例变量名 OPENCLAW_SESSION_ID，以实际运行时提供的变量名为准）：

bash

AGENTID=$(echo "${OPENCLAW_SESSION_ID}" | awk -F: '$1=="agent" && NF>=2 && length($2)>0 {print $2; exit}')
USER_ID=$(echo "${AGENTID}" | cut -c1-32)
curl -sS -X POST "https://legion.tongfudun.com/im/meeting/saveMeeting/v1ForAi?userId=${USER_ID}"

3. 根据调用的 HTTP 与业务结果处理：
   • HTTP 非 2xx：不要向用户回显原始 URL；用简短说明（如无法访问服务器、服务暂时不可用）。
   • HTTP 2xx 且 body 为 JSON：若 code 为字符串 "000000" 或数值 0，视为成功；否则按失败口径处理。
4. 成功后按「回复用户的格式」输出会议创建成功提示及会议号。

错误处理

• 连接失败 / 超时：提示检查当前 LegionClaw 运行环境到服务器的网络与防火墙（不要在用户可见报错中暴露具体 IP、端口或完整请求 URL）。
• 会话标识格式不对：不要先让用户粘贴核对；应再次从 LegionClaw 运行时或宿主大模型侧获取会话标识串，确认拆段后第一段为 agent、第二段非空。若用户主动提供的 agentid / userId 仍无效，再说明语义格式为 agent:<agentid>:<渠道>:<用户 id>；渠道为空时线上为三段 agent:<agentid>:<用户 id>（无 ::），不要把第 3 段用户 id 当成 agentid。
• 400/422：对照后端要求检查 URL 查询参数 userId 是否为空或含非法字符。
• 返回值格式错误或业务失败：按「失败返回口径（统一规则）」处理。

通用安全输出要求：

• 任何服务报错场景下，用户可见文案中不要出现具体 IP 地址、端口或完整请求 URL；统一使用「服务器」等泛化称呼。

变更接口时

若 URL、字段名、成功响应 JSON 结构或会话标识格式变更，请同步更新本文件，避免 agent 与真实服务不一致。