Feishu Agent Messenger - 飞书消息发送技能

🚀 下载就能用！脚本可直接运行，自动读取配置文件。

注意：技能本身不会自动回复消息，需要手动调用脚本或配置自动触发 hook。

飞书多 Agent 消息发送技能。让每个 Agent 用自己的飞书应用发送消息（群聊/私聊），解决 open_id 应用隔离问题。配合多网关架构实现自主协作：统筹 Agent 派发任务 → 执行 Agent 完成任务 → 自主调用本技能汇报结果。

📋 核心功能

• ✅ 使用当前 Agent 的飞书凭证发送消息
• ✅ 支持群聊和私聊两种模式
• ✅ 飞书显示当前 Agent 的机器人名字
• ✅ 解决 open_id 应用隔离问题
• ✅ 零配置 - 自动从 Agent 配置文件读取飞书凭证
• ✅ 脚本可直接运行 - 无需额外配置

⚠️ 重要说明

"下载就能用"的含义

🚨 调用脚本 ≠ AI 回复

重要：

• ❌ 不要通过 AI 回复 sessions_send（这只是文字回复，不会发送飞书消息）
• ✅ 要调用 send.sh 脚本发送飞书群消息（这才是真正的发送）

正确流程：

1. 收到 Boss 的 sessions_send 消息
2. 执行任务
3. 完成后调用脚本：./send.sh agent-b oc_xxx chat_id "消息内容"
4. 群里显示消息，发送者为当前 Agent 的机器人名字

错误示例：

❌ 错误：sessions_send 回复 "任务已完成"

正确示例：

✅ 正确：./send.sh agent-b oc_xxx chat_id "任务已完成"

三种使用方式

方式 1：手动调用脚本（立即可用）

./send.sh agent-b oc_xxx chat_id "消息内容"

方式 2：Boss 派发时明确要求调用（推荐）

sessions_send({
  sessionKey: "agent:agent-b:feishu:direct:ou_xxx",
  message: `【任务派发】
任务内容：检查系统状态

【回复要求】
完成后请调用脚本发送群消息：
./send.sh agent-b oc_xxx chat_id "任务已完成"`,
  timeoutSeconds: 0
})

方式 3：配置自动触发 hook（需要 OpenClaw 支持） 在 Agent 配置里添加 hook，收到消息时自动调用脚本。

🔧 配置自动回复（推荐）

步骤 1：编辑 Agent 配置文件

文件位置：~/.openclaw/openclaw-{agentId}.json

添加 hooks 配置：

{
  "hooks": {
    "entries": {
      "auto-reply-feishu": {
        "enabled": true,
        "trigger": "message.received",
        "script": "~/.openclaw/workspace-{agentId}/skills/feishu-agent-messenger/send.sh",
        "args": ["{agentId}", "${sender.open_id}", "open_id", "收到您的消息，请稍后"]
      }
    }
  }
}

参数说明：

• enabled: 是否启用
• trigger: 触发条件（message.received 表示收到消息时）
• script: 脚本路径
• args: 脚本参数
  • {agentId}: Agent 标识（如 agent-b）
  • ${sender.open_id}: 发送者 open_id（自动替换）
  • open_id: 消息类型（私聊）
  • 收到您的消息，请稍后: 回复内容

步骤 2：重启 Agent 网关

systemctl --user restart openclaw-gateway-{agentId}.service

步骤 3：测试

发送消息给 Agent，检查是否自动回复。

📖 使用方法

方法 1：Boss 派发任务时明确要求调用（推荐）

统筹 Agent 代码示例：

// 派发给执行 Agent-B
sessions_send({
  sessionKey: "agent:agent-b:feishu:direct:ou_xxx",
  message: `【任务派发】
任务 ID: TASK-001
任务内容：检查系统状态

【回复要求】
完成后请调用 feishu-agent-messenger 技能回复：
./send.sh agent-b ou_xxx open_id "任务已完成，系统运行正常"

【汇报格式】
【任务开始】
【任务完成】- 输出位置：[路径]`,
  timeoutSeconds: 0
})

执行 Agent 收到后：

1. 执行任务
2. 完成后调用 send.sh 脚本回复
3. 消息以 Agent-B 自己的身份发送

方法 2：定时进度汇报（每 5 分钟）

统筹 Agent 定时发送指令：

// 每 5 分钟发送一次，要求执行 Agent 汇报进度
setInterval(() => {
  sessions_send({
    sessionKey: "agent:agent-b:feishu:direct:ou_xxx",
    message: `【进度汇报要求】
任务 ID: TASK-001

【汇报要求】
请调用 feishu-agent-messenger 技能汇报当前进度：
./send.sh agent-b oc_xxx chat_id "【进度汇报】TASK-001 - 完成 50%，正在进行中..."`,
    timeoutSeconds: 0
  })
}, 5 * 60 * 1000) // 每 5 分钟

执行 Agent 收到后：

1. 检查当前任务进度
2. 调用 send.sh 脚本汇报进度
3. 消息以 Agent-B 自己的身份发送到群里

方法 3：直接调用脚本

Agent-B 发送私聊消息：

~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh \
  agent-b ou_xxx open_id "私聊消息内容"

Agent-B 发送群聊消息（进度汇报）：

~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh \
  agent-b oc_xxx chat_id "【进度汇报】TASK-001 - 完成 50%，正在进行中..."

方法 2：直接调用脚本

Agent-B 发送私聊消息：

~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh \
  agent-b ou_xxx open_id "私聊消息内容"

Agent-B 发送群聊消息：

~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh \
  agent-b oc_xxx chat_id "群聊消息内容"

方法 2：直接调用脚本

Agent-B 发送私聊消息：

~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh \
  agent-b ou_xxx open_id "私聊消息内容"

Agent-B 发送群聊消息：

~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh \
  agent-b oc_xxx chat_id "群聊消息内容"

Agent-C 发送私聊消息：

~/.openclaw/workspace-agent-c/skills/feishu-agent-messenger/send.sh \
  agent-c ou_xxx open_id "私聊消息内容"

Agent-C 发送群聊消息：

~/.openclaw/workspace-agent-c/skills/feishu-agent-messenger/send.sh \
  agent-c oc_xxx chat_id "群聊消息内容"

方法 3：直接调用飞书 API

发送私聊消息：

# 读取当前 Agent 配置
APP_ID=$(jq -r '.channels.feishu.appId' ~/.openclaw/openclaw-{agentId}.json)
APP_SECRET=$(jq -r '.channels.feishu.appSecret' ~/.openclaw/openclaw-{agentId}.json)

# 获取 token
TOKEN=$(curl -s -X POST https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal/ \
  -H 'Content-Type: application/json' \
  -d "{\"app_id\":\"$APP_ID\",\"app_secret\":\"$APP_SECRET\"}" | jq -r '.tenant_access_token')

# 发送私聊消息
curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"receive_id\":\"ou_xxx\",\"msg_type\":\"text\",\"content\":\"{\\\"text\\\":\\\"消息内容\\\"}\"}"

发送群聊消息：

# 获取 token（同上）

# 发送群聊消息
curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"receive_id\":\"oc_xxx\",\"msg_type\":\"text\",\"content\":\"{\\\"text\\\":\\\"消息内容\\\"}\"}"

⚙️ 配置说明

下载就能用吗？

是的！下载后无需额外配置，但需要满足以下条件：

前置条件（必须）

1. 已配置飞书应用

   • 在飞书开放平台创建应用
   • 获取 App ID 和 App Secret
   • 在 Agent 配置文件中配置飞书凭证

2. Agent 配置文件存在

   • 位置：~/.openclaw/openclaw-{agentId}.json
   • 包含飞书配置：channels.feishu.appId 和 channels.feishu.appSecret

自动回复条件（可选）

如果希望自动回复消息，需要：

1. 配置自动触发 hook

   • 在 Agent 配置文件中添加 hooks 配置
   • 指定触发条件和脚本路径

2. Agent 网关运行中

   • 确保 Agent 网关服务正常运行
   • 飞书 WebSocket 连接正常

配置文件示例

Agent 配置文件 (~/.openclaw/openclaw-{agentId}.json)：

{
  "agents": {
    "list": [{
      "id": "agent-b",
      "name": "执行助手",
      "workspace": "/home/admin/.openclaw/workspace-agent-b"
    }],
    "defaults": {
      "model": { "primary": "dashscope-coding/qwen3.5-plus" },
      "workspace": "/home/admin/.openclaw/workspace-agent-b"
    }
  },
  "gateway": {
    "port": 19923,
    "auth": {
      "mode": "token",
      "token": "agent-b-token-19923"
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "dmPolicy": "open"
    }
  },
  "skills": {
    "entries": {
      "feishu-agent-messenger": {
        "enabled": true
      }
    }
  },
  "hooks": {
    "entries": {
      "auto-reply-feishu": {
        "enabled": true,
        "trigger": "message.received",
        "script": "~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh",
        "args": ["agent-b", "${sender.open_id}", "open_id", "收到您的消息"]
      }
    }
  }
}

📝 参数说明

🔑 关键参数参考

🔍 获取用户 open_id

从当前 Agent 网关日志获取：

journalctl --user -u openclaw-gateway-{agentId}.service | grep "received message from"

⚠️ 注意事项

1. open_id 是应用隔离的

• ❌ 不同应用的用户 open_id 不同
• ✅ 必须使用当前 Agent 应用中的 open_id 发送私聊消息
• ✅ chat_id 是应用通用的，可以直接使用

2. content 格式

• ✅ 必须是转义的 JSON 字符串："{\"text\":\"消息内容\"}"
• ❌ 不是嵌套对象

3. 配置文件位置

• Agent-B: ~/.openclaw/openclaw-agent-b.json
• Agent-C: ~/.openclaw/openclaw-agent-c.json
• 其他 Agent: ~/.openclaw/openclaw-{agentId}.json

🧪 测试流程

步骤 1：测试脚本

# 发送群聊测试消息
~/.openclaw/workspace-agent-b/skills/feishu-agent-messenger/send.sh \
  agent-b oc_xxx chat_id "测试：Agent-B 以自己的身份发送群聊消息"

预期结果：

• ✅ 输出 "发送成功！"
• ✅ 飞书群里显示消息，发送者为当前 Agent 的机器人名字

步骤 2：测试自动回复

配置 hook 后，发送消息给 Agent。

预期结果：

• ✅ Agent 自动回复消息
• ✅ 日志里显示脚本执行记录

📚 相关技能

• setup-multi-gateway - 多网关配置，配合本技能实现多 Agent 协作
• skill-vetter - 技能安全审查，安装前自动检查

🆘 常见问题

Q1: 发送失败，提示"配置文件不存在"

A: 检查 Agent 配置文件是否存在：

ls -la ~/.openclaw/openclaw-{agentId}.json

Q2: 发送失败，提示"无法获取 token"

A: 检查飞书配置是否正确：

jq '.channels.feishu.appId' ~/.openclaw/openclaw-{agentId}.json
jq '.channels.feishu.appSecret' ~/.openclaw/openclaw-{agentId}.json

Q3: 消息发送成功，但显示的是其他 Agent 的身份

A: 确保使用的是当前 Agent 的脚本和配置，不是其他 Agent 的。

Q4: open_id 发送失败

A: 确保使用的是当前 Agent 应用中的 open_id，不是其他 Agent 的 open_id。

Q5: 下载后不知道怎么用

A:

1. 确保已配置飞书应用（App ID 和 App Secret）
2. 确保 Agent 配置文件存在
3. 测试脚本：./send.sh agent-b oc_xxx chat_id "测试"
4. 如果成功，说明配置正确

Q6: 配置了 hook 但不自动回复

A:

1. 检查 hook 配置是否正确
2. 检查 Agent 网关是否重启
3. 查看日志：journalctl --user -u openclaw-gateway-{agentId}.service -f
4. 确认触发条件是否匹配

📝 更新日志

v1.0.2 (2026-03-20)

• 添加"配置自动回复"章节
• 详细说明 hook 配置方法
• 添加常见问题 Q6
• 明确说明"下载就能用"的含义

v1.0.1 (2026-03-20)

• 去掉 Boss/Ass/Ops 等本地 Agent 名称，改用通用名称
• 明确说明"下载就能用"的含义和前置条件
• 添加配置说明章节
• 添加常见问题 Q5: 下载后不知道怎么用
• 优化文档结构，更清晰易懂

v1.0.0 (2026-03-20)

• 初始版本
• 支持多 Agent 发送消息
• 支持群聊和私聊两种模式
• 自动从配置文件读取飞书凭证
• 支持 sessions_send 自动调用
• 添加完整使用流程说明
• 添加测试流程和常见问题解答