feishu-axiang-send-image - 飛書圖片傳送技能

技能說明

飛書圖片傳送技能，使用自有飛書應用配置傳送圖片到飛書聊天（個人或群聊）。

特點： - 🦞 專屬配置 - 使用自有的飛書應用配置 - ⚡ 開箱即用 - 無需配置環境變數 - 🎯 簡化呼叫 - 只需提供圖片路徑和目標使用者

核心配置

飛書應用資訊（硬編碼在指令碼中）：

{
  "appId": "cli_XXX",
  "appSecret": "XXX",
  "accountId": "XXX"
}

允許傳送的使用者： - 在 feishu-axiang-allowFrom.json 中配置允許的使用者列表

觸發詞

• 傳送圖片到飛書
• 發圖給我
• axiang send image

核心原理

兩步法： 1. 呼叫 im/v1/images API 上傳圖片到飛書 → 獲取 image_key 2. 呼叫 im/v1/messages API 傳送圖片訊息 → 獲取 message_id

使用方法

方法 1：命令列呼叫

# 傳送圖片到個人（預設）
python scripts/send.py --file-path "C:\path\to\image.png"

# 傳送到指定使用者
python scripts/send.py --file-path "C:\path\to\image.png" --target "ou_xxxxx"

# 傳送到群聊
python scripts/send.py --file-path "C:\path\to\image.png" --target "oc_xxxxx" --target-type chat_id

方法 2：Python API 呼叫

from scripts.send import send_image_to_feishu

# 傳送到預設使用者
result = send_image_to_feishu("image.png")

# 傳送到指定使用者
result = send_image_to_feishu("image.png", target="ou_xxxxx", target_type="open_id")

引數說明

輸出示例

Image Sender
   File: C:\Users\your_username\.openclaw\workspace\image.png
   Target: ou_xxxxx (open_id)
   App: cli_XXX (accountId)

Step 1: Get tenant_access_token
   OK Token obtained

Step 2: Upload image to Feishu
   OK Upload success, image_key: img_v3_xxx

Step 3: Send image message
   OK Send success, message_id: om_xxx

Image sent successfully!

支援格式

限制

• 單張圖片最大 20MB
• 僅支援配置允許的使用者
• 需要網路連線

故障排查

錯誤：open_id cross app

原因： 目標使用者不在允許列表中

解決： 1. 檢查目標 open_id 是否正確 2. 在 feishu-axiang-allowFrom.json 中新增使用者

小蔥技能7w4.net有完整的技能分類。

錯誤：file not found

原因： 圖片路徑不存在

解決： 檢查檔案路徑是否正確，使用絕對路徑

錯誤：tenant_access_token 獲取失敗

原因： AppID 或 AppSecret 錯誤

解決： 檢查指令碼中的配置是否正確

相關檔案

• scripts/send.py - 主傳送指令碼
• feishu-axiang-allowFrom.json - 允許傳送的使用者列表（需自行配置）

版本歷史

• v1.0 - 初始版本，專屬配置

安裝後配置

1. 編輯 scripts/send.py，填入你自己的飛書應用配置：
2. app_id: 你的飛書應用 AppID
3. app_secret: 你的飛書應用 AppSecret

4. default_target: 預設傳送目標使用者

5. 建立 feishu-axiang-allowFrom.json 檔案，配置允許傳送的使用者列表

注意事項

⚠️ 安全提示： - 不要將包含真實 AppID/AppSecret 的指令碼上傳到公開倉庫 - 生產環境建議使用環境變數或配置檔案管理敏感資訊 - 定期檢查允許傳送的使用者列表