飞书消息发送
依赖说明
本 skill 需要读取飞书应用凭据来进行 API 认证：
- 凭据位置:
~/.openclaw/openclaw.json
- 读取字段:
appId, appSecret
- 用途: 调用飞书开放 API 接口进行图片/文件上传和消息发送
快速开始
# 发送图片
feishu_send_message --msg-type image --file-path /path/to/image.jpg --receive-id ou_xxx --receive-id-type open_id
# 发送文件
feishu_send_message --msg-type file --file-path /path/to/file.pdf --receive-id ou_xxx --receive-id-type open_id
参数说明
| 参数 | 说明 | 必填 | 适用类型 |
|---|
| --msg-type | 消息类型：image 或 file | 是 | 全部 |
| --file-path | 文件路径（图片或文件） | 是 | 全部 |
| --receive-id | 接收者 ID（用户 open_id 或群 chat_id） | 是 | 全部 |
| --receive-id-type | 接收者类型：open_id（用户）或 chat_id（群聊） | 否，默认 open_id | 全部 |
使用示例
发图片给用户
feishu_send_message \
--msg-type image \
--file-path /tmp/photo.jpg \
--receive-id ou_xxxxxxxxxxxxxxxxxx \
--receive-id-type open_id
发文件到群聊
feishu_send_message \
--msg-type file \
--file-path /tmp/document.pdf \
--receive-id oc_xxx \
--receive-id-type chat_id
消息类型说明
| 类型 | 说明 | 限制 |
|---|
| image | 图片消息 | 大小不超过 10MB，分辨率不超过 12000×12000 |
| file | 文件消息 | 大小不超过 100MB |
支持的文件格式
- 图片：JPG、JPEG、PNG、WEBP、GIF、BMP、ICO、TIFF、HEIC
- 文件：根据扩展名自动判断（pdf、doc、xls、ppt、mp4、opus 等），未知类型使用 stream
实现原理
- 从 ~/.openclaw/openclaw.json 读取 appId 和 appSecret
- 调用飞书 auth API 获取 tenant_access_token
- 根据消息类型：
- image: 调用 im/images API 上传图片，获取 image_key
- file: 调用 im/files API 上传文件，获取 file_key（自动根据扩展名判断 file_type）
- 调用 im/messages API 发送消息，content 为字符串格式的 JSON
依赖
- curl
- sips（macOS 自带，用于图片压缩）
- stat