- name
- feishu-send-image
- description
- Send images via Feishu (Lark) messaging platform using the underlying API. Supports sending local image files to users or group chats. Use when the user wants to send images through Feishu, share generated images via Feishu messages, or automate image delivery to Feishu conversations. Triggers on phrases like "send image to feishu", "飞书发图", "feishu发送图片", "飞书发送图片", "用飞书发图", or when explicitly requesting to send images via Feishu API.
Feishu Send Image
通过飞书 API 发送图片消息。支持发送本地图片文件给指定用户或群聊。
安装
方式1：通过 OpenClaw 对话安装
在飞书（或其他渠道）的 OpenClaw 对话框中直接说：
安装 leo-feishu-send-image skill或
帮我装一下 leo-feishu-send-imageOpenClaw 会自动从 ClawHub 下载并安装 skill。
方式2：通过命令行安装
clawhub install leo-feishu-send-image前置要求
1. 飞书应用配置
在 ~/.openclaw/openclaw.json 中添加飞书应用配置：
{
"channels": {
"feishu": {
"accounts": {
"default": {
"appId": "cli_xxxxxxxxxxxxxxxx",
"appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
}如何获取 App ID 和 App Secret：
- 访问 飞书开放平台
- 创建企业自建应用
- 进入应用详情 → 凭证与基础信息
- 复制
App ID和App Secret - 确保应用有
im:chat:readonly和im:message:send_as_bot权限
2. 安装依赖工具
需要 jq 工具处理 JSON：
# Ubuntu/Debian
sudo apt-get install jq
# CentOS/RHEL
sudo yum install jq
# macOS
brew install jq使用方法
方式1：通过 OpenClaw 对话使用（推荐）
安装 skill 后，直接在对话框中说：
用飞书发图 skill 发送 /path/to/image.jpg 给 ou_xxxxxxxx或
用 leo-feishu-send-image 发图给 ou_xxxxxxxx或
飞书发送图片 /path/to/image.jpg 给 ou_xxxxxxxx参数说明：
/path/to/image.jpg- 本地图片文件路径ou_xxxxxxxx- 接收者的 open_id（用户）或oc_xxxxxxxx（群聊）
方式2：直接调用脚本
# 进入 skill 目录
cd ~/.openclaw/workspace/skills/leo-feishu-send-image
# 基本用法
./scripts/send-image.sh <图片路径> <接收者ID>
# 指定账户
./scripts/send-image.sh <图片路径> <接收者ID> <账户ID>示例：
# 发送给用户
./scripts/send-image.sh ./output.jpg ou_114db42b481a66952fceb246da9c7bd7
# 发送到群聊
./scripts/send-image.sh ./output.jpg oc_e4bc81fe9899665019af2cccaa7bb30d
# 使用指定账户（如果配置了多个账户）
./scripts/send-image.sh ./output.jpg ou_xxxxxxxx prompt完整使用场景示例
场景1：AI 生成图片后自动发送
用户：用即梦生成一张风景图，然后发给我
OpenClaw：
1. 调用即梦 skill 生成图片
2. 保存到 workspace
3. 调用 leo-feishu-send-image 发送图片给用户场景2：批量发送图片
用户：把这 5 张图都发给我
OpenClaw：
for i in 1 2 3 4 5; do
./scripts/send-image.sh ./image_$i.jpg ou_xxxxxxxx
done场景3：发送到群聊
用户：把这张图发到游戏开发群
OpenClaw：
./scripts/send-image.sh ./design.png oc_xxxxxxxxAPI 流程说明
本 skill 底层调用飞书开放平台的三个 API：
- 获取 Access Token
- 接口：POST /auth/v3/tenant_access_token/internal - 使用 app_id 和 app_secret 换取 tenant_access_token
- 上传图片
- 接口：POST /im/v1/images - 上传图片文件，返回 image_key
- 发送消息
- 接口：POST /im/v1/messages - 使用 image_key 发送图片消息 - ⚠️ 注意：content 字段必须是 JSON 字符串（使用 jq tojson 转换）
支持的图片格式
- JPEG / JPG
- PNG
- WEBP
- GIF
- TIFF
- BMP
- ICO
故障排查
| 错误信息 | 可能原因 | 解决方法 |
|---|---|---|
缺少 app_id | 飞书配置未找到 | 检查 ~/.openclaw/openclaw.json 中的 channels.feishu.accounts 配置 |
获取 token 失败 | App ID / Secret 错误 | 确认应用凭证正确，且应用已启用 |
上传失败 | 图片格式不支持 | 转换为 JPEG/PNG 格式后重试 |
发送失败 | 接收者 ID 错误 | 确认 open_id 或 chat_id 正确，且机器人有权限发送给该用户/群聊 |
未安装 jq | 缺少依赖工具 | 执行 sudo apt-get install jq 或对应系统的安装命令 |
获取接收者 ID
获取用户 open_id
- 在飞书开放平台 → 应用详情 → 权限管理
- 确保有
contact:user.read权限 - 调用 API 或通过事件订阅获取
获取群聊 chat_id
- 将机器人添加到群聊
- 在群设置 → 群机器人 中查看
- 或通过
im.chat.listAPI 获取
相关链接
更新日志
v1.0.0
- 初始版本发布
- 支持发送图片到用户和群聊
- 支持多账户配置
作者: @leo-jiqimao ClawHub: https://clawhub.com/skills/leo-feishu-send-image 问题反馈: 请在 ClawHub 页面提交 issue