OpenClaw ✖  飞书 发图发文件指南

作为 AI 团队的管理者，你是不是经常遇到这样的场景：需要给团队成员发送生成的报告截图，要把自动化产出的文件分享给同事，想通过飞书机器人发送通知和图片...

核心思路

飞书 API 发送图片/文件的流程其实很简单，就三步：

1. 获取访问令牌（Token）2. 上传文件拿到文件 Key3. 用文件 Key 发送消息

是不是听起来也没那么复杂？下面我们来一步步实现。

实战：发送图片

Step 1：获取访问令牌

APP_SECRET="你的 App Secret"APP_ID="你的 App ID"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'])")

说明：Token 有效期 2 小时，建议每次发送前重新获取，不要硬编码在代码里。

Step 2：上传图片

IMAGE_KEY=$(curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/images' \ -H "Authorization: Bearer $TOKEN" \ -F "image_type=message" \ -F "image=@/tmp/image.png" \ | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['image_key'])")

说明：支持格式：JPEG, PNG, WEBP, GIF, TIFF, BMP, ICO，单张最大 20MB。

Step 3：发送消息

RECEIVE_ID="ou_xxxxxxxx"# 接收人 open_idcurl -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":"'$RECEIVE_ID'","msg_type":"image","content":"{\"image_key\":\"'$IMAGE_KEY'\"}"}'

实战：发送文件

发送文件的流程完全一样，只有两个地方不同：

Step 2：上传文件

FILE_KEY=$(curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/files' \ -H "Authorization: Bearer $TOKEN" \ -F "file_type=message" \ -F "file=@/tmp/report.pdf" \ | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['file_key'])")

Step 3：发送文件消息

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

支持的文件格式

完整脚本

把上面三步整合成一个脚本，直接运行：

#!/bin/bash# ============ 配置区域 ============APP_ID="cli_xxxxxxxx"APP_SECRET="你的 App Secret"RECEIVE_ID="ou_xxxxxxxx"FILE_PATH="/tmp/image.png"# 要发送的文件路径SEND_TYPE="image"# image 或 file# =================================# Step 1: 获取 TokenTOKEN=$(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'])")# Step 2: 上传文件if [ "$SEND_TYPE" = "image" ]; then    API_URL='https://open.feishu.cn/open-apis/im/v1/images'    FILE_PARAM="image"    TYPE_PARAM="image_type=message"else    API_URL='https://open.feishu.cn/open-apis/im/v1/files'    FILE_PARAM="file"    TYPE_PARAM="file_type=message"fiFILE_KEY=$(curl -s -X POST "$API_URL" \ -H "Authorization: Bearer $TOKEN" \ -F "$TYPE_PARAM" \ -F "$FILE_PARAM=@$FILE_PATH" \ | python3 -c "import json,sys; key=json.load(sys.stdin)['data']; print(key.get('image_key') or key.get('file_key'))")# Step 3: 发送消息MSG_TYPE="$SEND_TYPE"RESULT=$(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\":\"$RECEIVE_ID\",\"msg_type\":\"$MSG_TYPE\",\"content\":\"{\\\"${MSG_TYPE}_key\\\":\\\"$FILE_KEY\\\"}\"}")echo"发送结果：$RESULT"

常见问题

Q1: 提示"无权限"

原因：应用未配置相应权限解决：飞书开发者后台 → 应用管理 → 权限管理 → 添加权限

Q2: Token 无效

原因：Token 过期（有效期 2 小时）或 App Secret 错误解决：重新获取 Token，检查 App Secret 配置

Q3: 文件上传失败

原因：文件过大或格式不支持解决：检查文件大小（图片 20MB，文件 100MB）和格式

Q4: 消息发送失败

原因：receive_id 错误或用户未授权解决：检查 open_id 是否正确，确认用户已授权应用

小结

今天分享了通过飞书 API 自动发送图片和文件的方法：

• ✅ 三步流程：获取 Token → 上传文件 → 发送消息
• ✅ 支持格式：图片 7 种，文件支持常见格式
• ✅ 大小限制：图片 20MB，文件 100MB
• ✅ Token 有效期：2 小时

相比手动上传，这个方法可以：

• 🚀 集成到自动化流程中
• 🚀 减少重复操作
• 🚀 提升工作效率

💡 如何使用本文档？

将本文档发送给 AI 助手，让它帮你将代码和配置写入到 TOOLS.md 文档中，方便日后查阅和使用。

操作步骤：

1. 复制本文档链接或内容
2. 发送给 AI 助手
3. 说："把这些内容整理到 TOOLS.md 文档中"
4. AI 会自动帮你配置好所有代码和说明

🔗 相关链接

• 飞书开放平台 - 上传图片（本文参考）^[1]
• 飞书开放平台 - 上传文件（本文参考）^[2]
• 飞书开放平台 - 发送图片消息^[3]
• 飞书开放平台 - 获取 tenant_access_token^[4]
• 飞书开发者后台^[5]

本文代码已测试可用，如有疑问欢迎留言讨论。

© 2026 大昊的锅 | 公众号

引用链接