飞书发送文件

---

name: feishu-send-file

description: 飞书发送文件技能。用于通过飞书向用户发送普通文件附件（HTML、ZIP、PDF、代码文件等）以及处理“本地图片路径被发成路径文本”的可靠补救场景。普通文件必须先上传获取 `file_key` 再发送；当本地图片用 `message`/`media` 发送后在飞书里只显示 `/root/...png` 路径而不显示图片时，改用本技能内的稳定图片上传脚本（`im/v1/images` -> `image_key` -> `msg_type=image`）。

---

# 飞书发送文件

飞书机器人发送普通文件（非图片/视频）需要两步：先上传文件获取 file_key，再用 file_key 发消息。

如果本地图片通过常规 `message` / `media` 路径发送后，用户在飞书里看到的是 `/root/...png` 路径文本而不是图片本体，不要继续重试同一种方式；直接改走本技能的**稳定图片上传脚本**。

快速流程

方式一：用脚本（推荐）

python3 scripts/send_file.py <file_path> <open_id> <app_id> <app_secret> [file_name]

**参数说明：**

**快速获取配置：**

# 获取 app_id 和 app_secret
grep -A 2 '"feishu"' /root/.openclaw/openclaw.json | grep -E '(appId|appSecret)'

**完整示例：**

python3 /root/.openclaw/workspace/skills/feishu-send-file/scripts/send_file.py \
  /root/myfiles/report.html \
  <USER_OPEN_ID> \
  <YOUR_APP_ID> \
  <YOUR_APP_SECRET> \
  report.html

**AI 助手使用示例：**

# 当需要发送文件给用户时，直接调用脚本
exec(f"""
python3 /root/.openclaw/workspace/skills/feishu-send-file/scripts/send_file.py \\
  {file_path} \\
  {user_open_id} \\
  {app_id} \\
  {app_secret} \\
  {custom_filename}
""")

方式二：手动两步

**Step 1 - 上传文件：**

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>"}' | python3 -c "import json,sys; print(json.load(sys.stdin)['tenant_access_token'])")

FILE_KEY=$(curl -s -X POST "https://open.feishu.cn/open-apis/im/v1/files" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_type=stream" \
  -F "file_name=<文件名>" \
  -F "file=@<文件路径>" | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['file_key'])")

**Step 2 - 发送消息：**

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\":\"<OPEN_ID>\",\"msg_type\":\"file\",\"content\":\"{\\\"file_key\\\":\\\"$FILE_KEY\\\"}\"}"

稳定发送图片（2026-03-15 补充）

什么时候不要再硬用 `message` + `media`

如果你把本地图片路径（尤其是 `/root/myfiles/...`）传给飞书消息链路后，用户在飞书里看到的是：

那就说明这次**没有真正发成图片**。不要继续重试同一种参数组合。

原因（真实世界版）

成功标准

**只有一个成功标准：用户在飞书里实际看到图片本体。**

如果回显的是路径文本，就视为失败。

推荐脚本（稳定版）

python3 scripts/send_image.py <image_path> <open_id> <app_id> <app_secret> [domain]

示例：

python3 /root/.openclaw/workspace/skills/feishu-send-file/scripts/send_image.py \
  /root/myfiles/generated-images/demo.png \
  <USER_OPEN_ID> \
  <YOUR_APP_ID> \
  <YOUR_APP_SECRET>

如果是国际版 Lark：

python3 scripts/send_image.py <image_path> <open_id> <app_id> <app_secret> lark

这和普通文件的区别

这两条链路不要混用。

注意事项