# 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-forward-reader",
    "name": "飞书转发消息读取器",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/konce/feishu-forward-reader",
    "canonicalUrl": "https://clawhub.ai/konce/feishu-forward-reader",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/feishu-forward-reader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-forward-reader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/parse_forward.py",
      "scripts/read_forward.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "feishu-forward-reader",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T05:51:16.692Z",
      "expiresAt": "2026-05-09T05:51:16.692Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-forward-reader",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-forward-reader",
        "contentDisposition": "attachment; filename=\"feishu-forward-reader-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "feishu-forward-reader"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-forward-reader"
    },
    "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-forward-reader",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-forward-reader",
    "agentUrl": "https://openagent3.xyz/skills/feishu-forward-reader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-forward-reader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-forward-reader/agent.md"
  }
}
```
## Documentation

### 飞书转发消息读取器

读取飞书合并转发消息的详细内容。

### 问题背景

飞书的合并转发消息 (merge_forward) 在 OpenClaw 中默认只显示 "Merged and Forwarded Message"，无法看到实际转发的内容。此 skill 通过飞书 API 获取转发消息的完整子消息列表。

### 凭证配置

脚本会自动从以下位置获取飞书凭证（按优先级）：

命令行参数: --app-id / --app-secret
环境变量: FEISHU_APP_ID / FEISHU_APP_SECRET
OpenClaw 配置: ~/.openclaw/openclaw.json 中的 channels.feishu.appId/appSecret

如果已配置 OpenClaw 飞书插件，无需额外配置即可使用。

### 方法 1：Python 脚本（推荐）

# 自动从 OpenClaw 配置读取凭证
python3 scripts/parse_forward.py <message_id>

# 或手动指定凭证
python3 scripts/parse_forward.py <message_id> --app-id <id> --app-secret <secret>

# JSON 格式输出
python3 scripts/parse_forward.py <message_id> --format json

# 不查询用户名（更快）
python3 scripts/parse_forward.py <message_id> --no-names

### 方法 2：Shell 脚本（原始 JSON）

# 自动从配置读取凭证
./scripts/read_forward.sh <message_id>

# 或手动指定
./scripts/read_forward.sh <message_id> <app_id> <app_secret>

### 方法 3：直接调用 API

# 获取 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')

# 获取消息详情
curl -s "https://open.feishu.cn/open-apis/im/v1/messages/<message_id>" \\
  -H "Authorization: Bearer $TOKEN" | jq .

### API 响应结构

{
  "code": 0,
  "data": {
    "items": [
      {
        "message_id": "om_xxx",
        "msg_type": "merge_forward",
        "body": {"content": "Merged and Forwarded Message"}
      },
      {
        "message_id": "om_yyy",
        "msg_type": "text",
        "body": {"content": "{\\"text\\":\\"实际消息内容\\"}"},
        "upper_message_id": "om_xxx",
        "sender": {"id": "ou_xxx", "sender_type": "user"},
        "create_time": "1234567890000"
      }
    ]
  }
}

第一条是转发消息本身 (msg_type: merge_forward)
后续是被转发的原始消息，带有 upper_message_id 指向父消息

### 支持的消息类型

类型说明解析方式text文本消息body.content → JSON → textpost富文本消息body.content → JSON → title + contentinteractive卡片消息body.content → JSON → title + elementsimage图片显示 [图片]file文件显示 [文件]audio语音显示 [语音]video视频显示 [视频]

### 权限要求

飞书应用需要以下权限：

im:message:readonly - 获取群组中所有消息（敏感权限）
contact:contact.base:readonly - 获取用户基本信息（可选，用于显示用户名）

### 示例输出

📨 合并转发消息 (3 条)
来源群: oc_xxxxxxxxxxxxxxxxxxxx
----------------------------------------
[02-25 14:02] 张三
  大家好，这是一条测试消息

[02-25 14:03] ou_yyyyyyyyyyy...
  收到，我看看

[02-25 14:05] 李四
  已处理完成

注：可见范围内的用户显示真实姓名，范围外的显示 ID 前缀。
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: konce
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T05:51:16.692Z
- Expires at: 2026-05-09T05:51:16.692Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/feishu-forward-reader)
- [Send to Agent page](https://openagent3.xyz/skills/feishu-forward-reader/agent)
- [JSON manifest](https://openagent3.xyz/skills/feishu-forward-reader/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/feishu-forward-reader/agent.md)
- [Download page](https://openagent3.xyz/downloads/feishu-forward-reader)