ClawHub

Zoe飞书媒体发送

Automation

Automation skill for Zoe飞书媒体发送.

Install

openclaw skills install zoe-feishu-media

name: feishu-media description: 飞书媒体文件发送skill,支持发送图片到飞书群或个人.用于发送截图、设计图等场景. version: 1.0.0 author: Zoe license: MIT

飞书媒体发送 Skill

简介

本skill提供将本地图片发送到飞书群或个人聊天的功能。

什么时候用

  • 用户说"发图片"、"发送图片"、"发到飞书"
  • 用户需要把本地图片发送到飞书群

安装依赖

pip install requests

安全配置 ⚠️ 重要

必须配置飞书凭证，建议使用环境变量，切勿硬编码！

方式一：环境变量（推荐）

# Windows
set FEISHU_APP_ID=你的AppID
set FEISHU_APP_SECRET=你的AppSecret

# Linux/Mac
export FEISHU_APP_ID=你的AppID
export FEISHU_APP_SECRET=你的AppSecret

方式二：命令行参数

send_image(
    image_path="C:/path/to/image.png",
    chat_id="oc_xxx",
    app_id="cli_xxx",      # 你的App ID
    app_secret="xxx"       # 你的App Secret
)

使用方法

发送图片

from feishu_image import send_image

# 方式一：环境变量配置后
send_image(
    image_path="C:/path/to/image.png",
    chat_id="oc_xxx"  # 群聊ID
)

# 方式二：命令行传入
# python feishu_image.py <图片路径> <chat_id> <app_id> <app_secret>

参数说明

参数说明必填示例
image_path图片本地路径是C:/Users/admin/Desktop/xxx.png
chat_id接收者ID是oc_xxx (群) 或 ou_xxx (个人)
app_id飞书应用ID否cli_xxx（环境变量优先）
app_secret飞书应用密钥否xxx（环境变量优先）

获取飞书凭证

1. 创建飞书应用

  1. 登录 飞书开放平台
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret

2. 添加权限

在应用详情中添加以下权限：

  • im:resource - 上传图片和文件
  • im:message:send - 发送消息
  • im:chat:send - 发送群消息

3. 获取chat_id

  • 群聊：在群设置中查看群ID
  • 个人：获取用户的 open_id

示例

发送UI设计图

send_image(
    image_path="C:/Users/admin/Desktop/battery-ui.png",
    chat_id="oc_205333d14cf0881ef8b79fa223ff902b"
)

发送文件（扩展）

# 发送文件类似，只需改用 file 相关API

注意事项 ⚠️

  1. 安全：不要将包含真实凭证的代码提交到公开仓库！
  2. 权限：飞书应用需要开启相应权限才能使用
  3. 图片格式：支持 JPEG, PNG, WEBP, GIF, BMP 等
  4. 文件大小：最大 30MB
  5. 频率限制：注意飞书API的调用频率限制

故障排除

错误码 230001

  • 原因：无效的请求内容
  • 解决：检查image_key是否正确

错误码 99991663

  • 原因：应用没有权限
  • 解决：在飞书开放平台给应用添加对应权限

错误码 230013

  • 原因：机器人对该用户不可用
  • 解决：用户需要先与机器人建立会话

更新日志

  • v1.0.0 (2026-03-19): 初始版本，支持发送图片
More in Automation