飞书图片发送技能

👤 icesumer-lgtm 📦 v1.0.2 ⭐ 0.0 ⬇️ 745 下载
📄 办公效率 免费 🔑 需 API Key

📖 技能介绍

feishu-axiang-send-image - 飞书图片发送技能

技能说明

飞书图片发送技能,使用自有飞书应用配置发送图片到飞书聊天(个人或群聊)。

特点: - 🦞 专属配置 - 使用自有的飞书应用配置 - ⚡ 开箱即用 - 无需配置环境变量 - 🎯 简化调用 - 只需提供图片路径和目标用户

核心配置

飞书应用信息(硬编码在脚本中):

{
  "appId": "cli_XXX",
  "appSecret": "XXX",
  "accountId": "XXX"
}

允许发送的用户: - 在 feishu-axiang-allowFrom.json 中配置允许的用户列表

触发词

  • 发送图片到飞书
  • 发图给我

    小葱技能7w4.net有完整的技能分类。

  • axiang send image

核心原理

两步法: 1. 调用 im/v1/images API 上传图片到飞书 → 获取 image_key 2. 调用 im/v1/messages API 发送图片消息 → 获取 message_id

使用方法

方法 1:命令行调用

# 发送图片到个人(默认)
python scripts/send.py --file-path "C:\path\to\image.png"

# 发送到指定用户
python scripts/send.py --file-path "C:\path\to\image.png" --target "ou_xxxxx"

# 发送到群聊
python scripts/send.py --file-path "C:\path\to\image.png" --target "oc_xxxxx" --target-type chat_id

方法 2:Python API 调用

from scripts.send import send_image_to_feishu

# 发送到默认用户
result = send_image_to_feishu("image.png")

# 发送到指定用户
result = send_image_to_feishu("image.png", target="ou_xxxxx", target_type="open_id")

参数说明

参数 必需 默认值 说明
--file-path - 本地图片文件路径
--target 配置中的默认值 目标用户 open_id 或群聊 chat_id
--target-type open_id 目标类型(open_id/chat_id)

输出示例

Image Sender
   File: C:\Users\your_username\.openclaw\workspace\image.png
   Target: ou_xxxxx (open_id)
   App: cli_XXX (accountId)

Step 1: Get tenant_access_token
   OK Token obtained

Step 2: Upload image to Feishu
   OK Upload success, image_key: img_v3_xxx

Step 3: Send image message
   OK Send success, message_id: om_xxx

Image sent successfully!

支持格式

格式 支持 说明
PNG 推荐格式
JPG/JPEG 支持
GIF 支持(会自动转换)
WEBP 支持

限制

  • 单张图片最大 20MB
  • 仅支持配置允许的用户
  • 需要网络连接

故障排查

错误:open_id cross app

原因: 目标用户不在允许列表中

解决: 1. 检查目标 open_id 是否正确 2. 在 feishu-axiang-allowFrom.json 中添加用户

错误:file not found

原因: 图片路径不存在

解决: 检查文件路径是否正确,使用绝对路径

错误:tenant_access_token 获取失败

原因: AppID 或 AppSecret 错误

解决: 检查脚本中的配置是否正确

相关文件

  • scripts/send.py - 主发送脚本
  • feishu-axiang-allowFrom.json - 允许发送的用户列表(需自行配置)

版本历史

  • v1.0 - 初始版本,专属配置

安装后配置

  1. 编辑 scripts/send.py,填入你自己的飞书应用配置:
  2. app_id: 你的飞书应用 AppID
  3. app_secret: 你的飞书应用 AppSecret
  4. default_target: 默认发送目标用户

  5. 创建 feishu-axiang-allowFrom.json 文件,配置允许发送的用户列表

注意事项

⚠️ 安全提示: - 不要将包含真实 AppID/AppSecret 的脚本上传到公开仓库 - 生产环境建议使用环境变量或配置文件管理敏感信息 - 定期检查允许发送的用户列表

📁 包含文件 (5 个)

📄 README.md 1.8 KB
📄 SKILL.md 3.6 KB
📄 _meta.json 143 B
📄 examples.md 1.1 KB
📄 scripts/send.py 6.3 KB