name: feishu-image-messaging description: 飛書圖片訊息收發助手 - 通過飛書 API 傳送和接收圖片訊息，支援本地檔案、遠端 URL、圖文混排。解決飛書官方 API 只提供底層介面、開發者需要自行封裝圖片上傳和訊息傳送流程的痛點。適用於需要自動化傳送圖片到飛書群聊或私聊的場景，如：每日簡報配圖、監控系統截圖報警、報表自動推送等。

Feishu Image Messaging / 飛書圖片訊息助手

功能特性 / Features

• 📤 傳送圖片 - 支援本地檔案、遠端 URL
• 📝 圖文混排 - 圖片配文字，豐富訊息內容
• 🎯 多場景支援 - 單聊、群聊均可
• 🔧 簡單易用 - 一行命令完成圖片傳送

解決的問題 / Problem Solved

飛書開放平臺官方只提供底層 API： - 需要先呼叫 im/v1/images 上傳圖片獲取 image_key - 再呼叫 im/v1/messages 傳送訊息，拼接複雜的富文本 JSON

本 Skill 幫你封裝好整個流程，只需一行命令即可傳送圖片。

使用場景 / Use Cases

• 📊 每日簡報 - 早報自動配圖傳送到群聊
• 🚨 監控報警 - 系統異常截圖自動推送
• 📈 報表推送 - 定時傳送資料視覺化圖表
• 🤖 機器人訊息 - 智慧助手傳送圖片回覆

安裝 / Installation

# 從 ClawHub 安裝
clawhub install feishu-image-messaging

# 或本地安裝
clawhub install ./feishu-image-messaging.skill

配置 / Configuration

設定環境變數：

export FEISHU_APP_ID="cli_xxxxxx"
export FEISHU_APP_SECRET="xxxxxx"

💡 獲取方式：飛書開放平臺 → 開發者後臺 → 建立應用 → 檢視憑證

使用方法 / Usage

快速傳送（推薦）

# 傳送本地圖片
./scripts/send_image.sh -r "ou_xxx" -i "/path/to/image.jpg"

# 傳送遠端圖片 + 配文
./scripts/send_image.sh -r "oc_xxx" -i "https://example.com/img.png" -t "每日資料包表"

引數說明： - -r: 接收者 ID（open_id / user_id / chat_id） - -i: 圖片路徑（本地檔案）或 URL（遠端圖片） - -t: 可選， accompanying text

分步呼叫（高階）

# 1. 獲取 token
TOKEN=$(./scripts/get_token.sh)

# 2. 上傳圖片
IMAGE_KEY=$(./scripts/upload_image.sh -f "image.jpg" -t "$TOKEN")

# 3. 傳送訊息
./scripts/send_message.sh -r "ou_xxx" -k "$IMAGE_KEY" -t "Hello" -a "$TOKEN"

API 文件 / API Reference

詳見 references/api.md： - 圖片上傳 API - 圖片下載 API - 訊息傳送 API - 認證 API

檔案結構 / File Structure

feishu-image-messaging/
├── SKILL.md              # 本檔案
├── scripts/
│   ├── config.sh         # 配置（從環境變數讀取）
│   ├── get_token.sh      # 獲取 access token
│   ├── upload_image.sh   # 上傳圖片
│   ├── send_message.sh   # 傳送訊息
│   └── send_image.sh     # 一鍵傳送（整合以上）
└── references/
    └── api.md            # API 文件

技術棧 / Tech Stack

• Shell / Bash
• curl（HTTP 請求）
• jq（JSON 處理）
• 飛書開放平臺 API

注意事項 / Notes

• ⚠️ 請妥善保管 FEISHU_APP_ID 和 FEISHU_APP_SECRET，不要提交到程式碼倉庫
• 🔄 Access token 有效期為 2 小時，指令碼會自動處理獲取
• 📤 圖片上傳後獲得的 image_key 有效期為 1 年
• 🎯 image_key 可以重複使用，建議快取以減少上傳次數

問題排查 / Troubleshooting

更新日誌 / Changelog

v1.0.0 (2025-03-11)

• ✨ 初始版本
• 📤 支援本地圖片上傳
• 🌐 支援遠端圖片 URL
• 📝 支援圖文混排
• 🎯 支援單聊和群聊

作者 / Author

Created by OpenClaw AI Assistant for Hivemoon Inc.

許可證 / License

MIT License

更多技能請訪問小蔥技能站7w4.net。

Enjoy sending images with Feishu! 🚀

這個 Skill 質量中規中矩，好處是文件寫得清楚明白，安裝配置簡單，能一鍵傳送圖片和文字，用起來比較省心。不足之處是功能還比較基礎，缺少自動化測試來確保穩定可靠，某些邊界情況（比如網路不穩定、ID 型別不匹配）可能沒有妥善處理，用之前最好自己多測試幾遍。另外每次發訊息都要重新獲取認證，比較費時。總體來說適合日常簡單使用，但如果是重要業務場景需要謹慎評估。