代理通信

⚠️ 重要规则

切勿重复使用代理与人类的对话会话！

• - 人类-代理会话格式：agent:xxx:feishu:direct:ouxxx
• 代理-代理调用必须使用 sessionsspawn 创建子代理会话

严格工作流程（不可跳过）

步骤 1：检查现有会话

javascript
sessions_list({ limit: 50 })

在结果中查找：

• - 包含 subagent 标记
• 标签匹配 发送方-接收方 或 接收方-发送方（双向检查）

示例：

• - 如果主代理要查找 sienna，查找 main-to-sienna 或 sienna-to-main
• 任一匹配即可，无需创建新会话

步骤 2：创建新会话（如未找到）

如果步骤 1 无结果，使用 sessions_spawn 创建：

javascript
sessions_spawn({
label: main-to-sienna, // 格式：发送方-接收方
runtime: subagent,
task: , // 任务在步骤 3 中填写
mode: run
})

步骤 3：发送消息

javascript
sessions_send({
sessionKey: agent:main:subagent:xxx, // 来自步骤 1 或 2
message: 任务描述... // 实际任务内容
})

⚡ 关键规则（必须遵守）

1. 1. 不可跳过步骤 1：必须先运行 sessions_list
2. 不可走捷径：必须按步骤 1 → 2 → 3 执行
3. 双向复用：a-to-b 和 b-to-a 均可使用，无需创建两个
4. 直接回复发送方：如无特殊指示，回复给发起方
5. 使用子代理标记：sessionKey 必须包含 subagent

❌ 错误示例

javascript
// 错误 1：未检查直接创建
sessions_spawn({...}) // 必须先检查！

// 错误 2：使用人类对话会话
sessionKey: agent:sienna:feishu:direct:ou_xxx // 禁止使用！

// 错误 3：创建双向会话
// main-to-sienna 和 sienna-to-main - 一个就够了！

// 错误 4：回复给其他人
// 应直接回复发送方，不得转发或群发

SessionKey 格式指南

回复规则

默认：回复直接发送给发送方

• - 发送方发送消息 → 直接回复发送方
• 无需转发给其他人
• 无需发布到群组
• 除非发送方明确要求转发

工作流程伪代码

1. 1. 调用 sessions_list({ limit: 50 })
2. 遍历结果，查找两者：

1. 3. 找到 → 使用该 sessionKey，跳转到步骤 5
2. 未找到 → 使用 sessionsspawn 创建，保存 sessionKey
3. 调用 sessionssend({ sessionKey, message })
4. 完成

当前活跃频道（参考）

备注

• - thread=true 模式暂时不可用
• 带标签的子代理会话可通过 sessions_list 查找
• mode=session 需要 thread=true，目前不可用

会话保护机制（新增）

步骤 2.5：保护会话（创建后执行）

新的子代理会话可能默认被自动清理。为确保长期可用，创建后需进行保护：

javascript
// 保护会话免于自动清理
exec({
command: openclaw sessions cleanup --agent [目标代理] --active-key ${sessionKey} --enforce
})

注意：将 ${sessionKey} 替换为实际的 sessionKey

完整流程（含保护机制）

步骤 1：检查现有会话

javascript
sessions_list({ limit: 50 })

步骤 2：创建新会话（如未找到）

javascript
sessions_spawn({
label: main-to-sienna,
runtime: subagent,
task: ,
mode: run
})
// 返回 sessionKey，格式：agent:xxx:subagent:xxx

步骤 2.5：保护会话（新增）

javascript
exec({
command: openclaw sessions cleanup --active-key agent:xxx:subagent:xxx --enforce
})

步骤 3：发送消息

javascript
sessions_send({
sessionKey: agent:main:subagent:xxx,
message: 任务描述...
})