feishu-mention-bot（飞书提及机器人）

飞书 @机器人 技能

在飞书群聊中 @其他机器人并发送消息，让被艾特的机器人收到通知并响应。

前提条件

确保飞书应用有以下权限：

• im:message 或 im:message:send_as_bot — 发送消息
• im:message.group_at_msg:readonly — 接收 @消息

核心：@机器人格式

文本消息

<at user_id="open_id">名字</at> 你的消息内容

富文本消息（post）

在 markdown 内容中使用：

<at user_id="open_id">名字</at>

卡片消息（interactive）

在 lark_md 内容中使用：

<at id=open_id></at>

如何获取机器人的 open_id

方法：从消息历史提取

# 1. 获取 tenant_access_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":"YOUR_APP_ID","app_secret":"YOUR_APP_SECRET"}' | jq -r '.tenant_access_token')

# 2. 获取群消息历史，提取 mentions
curl -s "https://open.feishu.cn/open-apis/im/v1/messages?container_id_type=chat&container_id=CHAT_ID&page_size=50" \
  -H "Authorization: Bearer $TOKEN" | \
  jq '[.data.items[]? | select(.mentions != null and .mentions != []) | .mentions[]?] | unique_by(.id)'

关键点：

• 飞书的群成员 API 不返回机器人信息
• 必须从消息历史的 mentions 字段提取
• 机器人在群里被艾特过的消息才会有 mentions

使用示例

使用 message 工具

message action=send channel=feishu target=chat:CHAT_ID message="<at user_id=\"ou_xxx\">机器人名</at> 你好！"

使用飞书 API 直接调用

curl -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": "CHAT_ID",
    "msg_type": "text",
    "content": "{\"text\":\"<at user_id=\\\"ou_xxx\\\">机器人名</at> 你好！\"}"
  }'

注意事项

1. 必须使用 open_id：不能用 app_id，必须是 ou_ 开头的 open_id
2. 机器人必须在群里：被艾特的机器人必须是群成员
3. 机器人需要订阅事件：被艾特的机器人需要订阅 im.message.group_at_msg 事件才能收到通知
4. 缓存机器人 open_id：获取后建议保存到 TOOLS.md 或数据库，避免重复查询

当前群机器人列表

从 TOOLS.md 或消息历史中查找具体的 open_id

示例：