Feishu Send Message

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

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "Feishu Send Message" with this command: npx skills add pikaqiuyaya/feishu-agent-messenger

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

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

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

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

📋 核心功能

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

⚠️ 重要说明

"下载就能用"的含义

功能是否自动说明
脚本可直接运行✅ 是下载后直接运行 ./send.sh
自动读取配置✅ 是自动从配置文件读取飞书凭证
自动回复消息❌ 否需要手动调用脚本

🚨 调用脚本 ≠ 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", "收到您的消息"]
      }
    }
  }
}

📝 参数说明

参数说明示例
agentIdAgent 标识agent-b
target目标 ID（open_id 或 chat_id）ou_xxx
msg_type消息类型：open_id（私聊）或 chat_id（群聊）open_id
message消息内容你好，这是测试消息

🔑 关键参数参考

参数说明获取方式
App ID当前 Agent 应用的 ID飞书开放平台
App Secret当前 Agent 应用的密钥飞书开放平台
用户 open_id当前 Agent 应用中的用户 IDAgent 网关日志
群聊 chat_id群聊 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 自动调用
  • 添加完整使用流程说明
  • 添加测试流程和常见问题解答

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Automation

Eternal Haven Lore Pack

Eternal Haven Chronicles lore + mythic persona pack. Use when the agent needs deep narrative context, character arcs, and metaphysical structure from the 4 Eternal Haven books to speak in a more poetic, mythic, or Champion-aligned voice while staying anchored in real events and consistent rules.

Registry SourceRecently Updated
1.3K0deepseekoracle
Automation

Creator Alpha Feed

Collect and rank daily AI content for creator-focused publishing workflows. Use when users ask for AI topic scouting, KOL tracking (especially X/Twitter), practical tutorial picks, industry updates, or automated Feishu/Obsidian briefing pushes with configurable templates and time windows.

Registry SourceRecently Updated
1.7K0rotbit
Automation

Evolution Api Go - Evo Go

Complete WhatsApp automation via Evolution API Go v3 - instances, messages (text/media/polls/carousels), groups, contacts, chats, communities, newsletters, and real-time webhooks

Registry SourceRecently Updated
1K0impa365
Automation

macOS

macOS system administration, command-line differences from Linux, and automation best practices.

Registry SourceRecently Updated
2.6K2ivangdavila