# Send 飞书@机器人 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-mention-bot",
    "name": "飞书@机器人",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/pcjinglang/feishu-mention-bot",
    "canonicalUrl": "https://clawhub.ai/pcjinglang/feishu-mention-bot",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/feishu-mention-bot",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-mention-bot",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-mention-bot"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-mention-bot",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-mention-bot",
    "agentUrl": "https://openagent3.xyz/skills/feishu-mention-bot/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-mention-bot/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-mention-bot/agent.md"
  }
}
```
## Documentation

### 飞书 @机器人 技能

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

### 前提条件

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

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_idOpenClaw唐ou_xxxLynnou_xxx
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: pcjinglang
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/feishu-mention-bot)
- [Send to Agent page](https://openagent3.xyz/skills/feishu-mention-bot/agent)
- [JSON manifest](https://openagent3.xyz/skills/feishu-mention-bot/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/feishu-mention-bot/agent.md)
- [Download page](https://openagent3.xyz/downloads/feishu-mention-bot)