Feishu Send Image

Permission Setup Review

python scripts/_setup_logs.py is an optional setup helper for the Feishu Send Image skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.

Feishu Send Image

通过飞书 API 发送图片消息。支持发送本地图片文件给指定用户或群聊。

安装

方式1：通过 OpenClaw 对话安装

在飞书（或其他渠道）的 OpenClaw 对话框中直接说：

安装 leo-feishu-send-image skill

或

帮我装一下 leo-feishu-send-image

OpenClaw 会自动从 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：

1. 访问 飞书开放平台
2. 创建企业自建应用
3. 进入应用详情 → 凭证与基础信息
4. 复制 App ID 和 App Secret
5. 确保应用有 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_xxxxxxxx

API 流程说明

本 skill 底层调用飞书开放平台的三个 API：

1. 获取 Access Token

   • 接口：POST /auth/v3/tenant_access_token/internal
   • 使用 app_id 和 app_secret 换取 tenant_access_token

2. 上传图片

   • 接口：POST /im/v1/images
   • 上传图片文件，返回 image_key

3. 发送消息

   • 接口：POST /im/v1/messages
   • 使用 image_key 发送图片消息
   • ⚠️ 注意：content 字段必须是 JSON 字符串（使用 jq tojson 转换）

支持的图片格式

• JPEG / JPG
• PNG
• WEBP
• GIF
• TIFF
• BMP
• ICO

故障排查

获取接收者 ID

获取用户 open_id

1. 在飞书开放平台 → 应用详情 → 权限管理
2. 确保有 contact:user.read 权限
3. 调用 API 或通过事件订阅获取

获取群聊 chat_id

1. 将机器人添加到群聊
2. 在群设置 → 群机器人 中查看
3. 或通过 im.chat.list API 获取

相关链接

• 飞书开放平台文档
• 发送消息 API
• 上传图片 API
• ClawHub Skill 页面

更新日志

v1.0.0

• 初始版本发布
• 支持发送图片到用户和群聊
• 支持多账户配置

作者: @leo-jiqimao
ClawHub: https://clawhub.com/skills/leo-feishu-send-image
问题反馈: 请在 ClawHub 页面提交 issue