by 运行时依赖
安装命令
点击复制技能文档
name: feishu-media description: 飞书媒体文件发送技能,支持发送图片到飞书群或个人.用于发送截图、设计图等场景. version: 1.0.0 author: Zoe license: MIT
飞书媒体发送 技能 简介
本技能提供将本地图片发送到飞书群或个人聊天的功能。
什么时候用 用户说"发图片"、"发送图片"、"发到飞书" 用户需要把本地图片发送到飞书群 安装依赖 pip 安装 请求s
安全配置 ⚠️ 重要
必须配置飞书凭证，建议使用环境变量，切勿硬编码！
方式一：环境变量（推荐） # Windows 设置 FEISHU_应用_ID=你的应用ID 设置 FEISHU_应用_SECRET=你的应用Secret
# Linux/Mac 导出 FEISHU_应用_ID=你的应用ID 导出 FEISHU_应用_SECRET=你的应用Secret
方式二：命令行参数 发送_image( image_path="C:/path/to/image.png", chat_id="oc_xxx", 应用_id="命令行工具_xxx", # 你的应用 ID 应用_secret="xxx" # 你的应用 Secret )
使用方法 发送图片 from feishu_image 导入 发送_image
# 方式一：环境变量配置后 发送_image( image_path="C:/path/to/image.png", chat_id="oc_xxx" # 群聊ID )
# 方式二：命令行传入 # python feishu_image.py <图片路径> <应用_id> <应用_secret>
参数说明 参数 说明 必填 示例 image_path 图片本地路径 是 C:/Users/admin/桌面/xxx.png chat_id 接收者ID 是 oc_xxx (群) 或 ou_xxx (个人) 应用_id 飞书应用ID 否 命令行工具_xxx（环境变量优先） 应用_secret 飞书应用密钥 否 xxx（环境变量优先） 获取飞书凭证
- 创建飞书应用
- 添加权限
在应用详情中添加以下权限：
im:resource - 上传图片和文件 im:message:发送 - 发送消息 im:chat:发送 - 发送群消息
- 获取chat_id
发送文件（扩展） # 发送文件类似，只需改用 file 相关API
注意事项 ⚠️ 安全：不要将包含真实凭证的代码提交到公开仓库！ 权限：飞书应用需要开启相应权限才能使用 图片格式：支持 JPEG, PNG, 网页P, GIF, BMP 等 文件大小：最大 30MB 频率限制：注意飞书API的调用频率限制 故障排除 错误码 230001 原因：无效的请求内容 解决：检查image_key是否正确 错误码 99991663 原因：应用没有权限 解决：在飞书开放平台给应用添加对应权限 错误码 230013 原因：机器人对该用户不可用 解决：用户需要先与机器人建立会话 更新日志 v1.0.0 (2026-03-19): 初始版本，支持发送图片