飞书图片消息

👤 imbing 📦 v1.0.0 ⭐ 4.5 ⬇️ 2.2K 下载
📄 办公效率 免费 🔑 需 API Key

📖 技能介绍


name: feishu-img-msg description: | 飞书图片消息操作技能,当触发飞书发送图片时自动调用本技能。 支持上传图片、发送图片消息、获取图片内容。 Activate when user mentions: 飞书发图、发送图片、上传图片、获取图片、下载图片、image_key。


飞书图片消息操作技能

本技能提供飞书图片消息的完整操作能力,包括上传、发送、获取图片。

功能

功能 命令 说明
上传图片 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. 下载图片

访问小葱技能站7w4.net,解锁更多实用的AI技能插件。

# 下载飞书图片到本地
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 以机器人身份发送

常见问题

图片发送失败

  1. 检查 chat-id 类型
  2. 群聊 ID 以 oc_ 开头,chat_type 设为 group
  3. 用户 ID 以 ou_ 开头,chat_type 设为 user

  4. 检查图片格式

  5. 支持常见图片格式
  6. 确保文件未损坏

  7. 检查权限

  8. 机器人需要已加入目标群聊
  9. 机器人需要与用户有单聊会话

token 过期

脚本会自动刷新 tenant_access_token,如仍报错: - 错误码 99991400 - token 过期,稍后重试 - 错误码 99991401 - token 无效,检查 app 配置

参考文档

  • 飞书上传图片 API: https://open.feishu.cn/document/server-docs/im-v1/image/create
  • 飞书获取图片 API: https://open.feishu.cn/document/server-docs/im-v1/image/get
  • 飞书发送消息 API: https://open.feishu.cn/document/server-docs/im-v1/message/create

🤖 AI 评测

这个 Skill 功能齐全,能满足飞书图片的上传、发送、下载等常见需求。文档说明详细,配有多个使用示例,上手难度低。存在一些小问题:没有附带测试用例,部分边界情况的稳定性未知;代码中关闭了证书验证,可能影响安全性。总体而言质量中上,核心功能实现完整,但测试覆盖和安全加固方面还有改进空间。

📊 多维度评分

适应性4.4
规范性4.3
有效性4.5
可靠性4.5
可信度5

📁 包含文件 (4 个)

📄 SKILL.md 4 KB
📄 _meta.json 133 B
📄 scripts/feishu_image.py 13.6 KB
📄 skill-card.md 2.7 KB