飞书消息发送#

依赖说明#

本 skill 需要读取飞书应用凭据来进行 API 认证：

• 凭据位置: ~/.openclaw/openclaw.json
• 读取字段: appId, appSecret
• 用途: 调用飞书开放 API 接口进行图片/文件上传和消息发送

快速开始#

bash

# 发送图片
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全部

使用示例#

发图片给用户#

bash

feishu_send_message \
  --msg-type image \
  --file-path /tmp/photo.jpg \
  --receive-id ou_xxxxxxxxxxxxxxxxxx \
  --receive-id-type open_id

发文件到群聊#

bash

feishu_send_message \
  --msg-type file \
  --file-path /tmp/document.pdf \
  --receive-id oc_xxx \
  --receive-id-type chat_id

消息类型说明#

类型说明限制image图片消息大小不超过 10MB，分辨率不超过 12000×12000file文件消息大小不超过 100MB

支持的文件格式#

• 图片：JPG、JPEG、PNG、WEBP、GIF、BMP、ICO、TIFF、HEIC
• 文件：根据扩展名自动判断（pdf、doc、xls、ppt、mp4、opus 等），未知类型使用 stream

实现原理#

1. 从 ~/.openclaw/openclaw.json 读取 appId 和 appSecret
2. 调用飞书 auth API 获取 tenant_access_token
3. 根据消息类型：
   • image: 调用 im/images API 上传图片，获取 image_key
   • file: 调用 im/files API 上传文件，获取 file_key（自动根据扩展名判断 file_type）
4. 调用 im/messages API 发送消息，content 为字符串格式的 JSON

依赖#

• curl
• sips（macOS 自带，用于图片压缩）
• stat