dvcrn 飞书图片消息操作技能
本技能提供飞书图片消息的完整操作能力，包括上传、发送、获取图片。
功能
| 功能 | 命令 | 说明 |
|---|---|---|
| 上传图片 | feishu-img-msg upload |
上传本地图片到飞书，返回 image_key |
| 发送图片 | feishu-img-msg send |
发送图片到指定会话（支持文件路径或 image_key） |
| 获取图片 | feishu-img-msg get |
下载飞书图片到本地 |
| 查看图片 | feishu-img-msg view |
获取图片信息（返回 base64 供 AI 查看） |
快速使用
1. 发送本地图片到会话
# 直接发送本地图片文件
python3 ~/.openclaw/workspace/skills/feishu-img-msg/scripts/feishu_image.py \
send \
--chat-id "oc_xxxxx" \
--file "/path/to/image.jpg"
2. 上传图片获取 image_key
# 上传图片，返回 image_key
python3 ~/.openclaw/workspace/skills/feishu-img-msg/scripts/feishu_image.py \
upload \
--file "/path/to/image.png"
3. 用 image_key 发送图片
# 使用已有的 image_key 发送
python3 ~/.openclaw/workspace/skills/feishu-img-msg/scripts/feishu_image.py \
send \
--chat-id "ou_xxxxx" \
--image-key "img_xxxxx"
4. 下载图片
# 下载飞书图片到本地
python3 ~/.openclaw/workspace/skills/feishu-img-msg/scripts/feishu_image.py \
get \
--image-key "img_xxxxx" \
--output "/path/to/save.jpg"
5. 查看图片内容（AI 可读）
# 获取图片 base64，用于 AI 分析
python3 ~/.openclaw/workspace/skills/feishu-img-msg/scripts/feishu_image.py \
view \
--image-key "img_xxxxx"
参数说明
send 命令
| 参数 | 必填 | 说明 |
|---|---|---|
--chat-id |
✅ | 接收者 ID（群聊 oc_ 开头，用户 ou_ 开头） |
--file |
二选一 | 本地图片文件路径 |
--image-key |
二选一 | 已上传的 image_key |
--chat-type |
否 | 会话类型：group(默认) 或 user |
--account |
否 | 飞书账户名（默认 main） |
upload 命令
| 参数 | 必填 | 说明 |
|---|---|---|
--file |
✅ | 本地图片文件路径 |
--account |
否 | 飞书账户名（默认 main） |
get 命令
| 参数 | 必填 | 说明 |
|---|---|---|
--image-key |
✅ | 图片的 image_key |
--output |
✅ | 保存路径 |
--account |
否 | 飞书账户名（默认 main） |
view 命令
| 参数 | 必填 | 说明 |
|---|---|---|
--image-key |
✅ | 图片的 image_key |
--account |
否 | 飞书账户名（默认 main） |
支持的图片格式
- JPEG (.jpg, .jpeg)
- PNG (.png)
- GIF (.gif)
- BMP (.bmp)
- WebP (.webp)
文件大小限制：单张图片最大 30MB
权限要求
| Scope | 用途 |
|---|---|
im:resource |
上传图片、获取图片 |
im:message |
发送消息 |
im:message:send_as_bot |
以机器人身份发送 |
常见问题
图片发送失败
检查 chat-id 类型
- 群聊 ID 以
oc_开头，chat_type 设为group - 用户 ID 以
ou_开头，chat_type 设为user
- 群聊 ID 以
检查图片格式
- 支持常见图片格式
- 确保文件未损坏
检查权限
- 机器人需要已加入目标群聊
- 机器人需要与用户有单聊会话
token 过期
脚本会自动刷新 tenant_access_token，如仍报错：
- 错误码
99991400- token 过期，稍后重试 - 错误码
99991401- token 无效，检查 app 配置