飞书 @机器人 技能
在飞书群聊中 @其他机器人并发送消息，让被艾特的机器人收到通知并响应。
前提条件
确保飞书应用有以下权限：
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> 你好！\"}"
}'
注意事项
- 必须使用 open_id：不能用 app_id，必须是
ou_ 开头的 open_id
- 机器人必须在群里：被艾特的机器人必须是群成员
- 机器人需要订阅事件：被艾特的机器人需要订阅
im.message.group_at_msg 事件才能收到通知
- 缓存机器人 open_id：获取后建议保存到 TOOLS.md 或数据库，避免重复查询
当前群机器人列表
从 TOOLS.md 或消息历史中查找具体的 open_id
示例：
| 名称 | open_id |
|---|
| OpenClaw唐 | ou_xxx |
| Lynn | ou_xxx |
