前言¶

在飛書協作裏，經常需要把本地截圖、文檔或圖片發給指定用戶。手工上傳再粘貼消息，會打斷你和 Agent 的對話流。若希望 Agent 在對話中直接完成「選文件 → 上傳 → 發消息」，需要在技能層封裝飛書開放能力，並事先配好應用憑證。

下面介紹 SkillHub 社區技能「飛書文件圖片傳輸」（@user_037a0790/feishu-file-image-sender），用於在 Agent 側觸發本地文件向飛書用戶的發送。

這是什麼¶

「飛書文件圖片傳輸」是 SkillHub 上的社區技能（版本 1.0.0，分類 office-efficiency），發佈者爲 user_037a0790。官方簡介概括爲：將本地文件發送給飛書用戶，上傳文件併發送消息；在用戶要發圖片、發文件時由 Agent 調用。

技能標記爲 requires_api_key=true，實際依賴在 openclaw.json 中配置飛書應用的 appId 與 appSecret，而不是在技能包裏寫死密鑰。

核心功能¶

依據 SkillHub 頁面與抓取元數據，可確認的能力如下：

1. 本地文件發送：面向飛書用戶，從本機路徑讀取文件並走飛書側上傳與消息流程。
2. 圖片與通用文件：簡介明確在用戶發送圖片、發送文件的場景下調用，覆蓋常見辦公附件類型（具體 MIME、大小上限以飛書開放平臺與運行時實現爲準，頁面未單獨列出）。
3. 消息聯動：不僅上傳，還會發送消息，把文件作爲消息內容帶給對方。

未在官方簡介中出現的接口名、回調地址或 CLI 子命令，本文不展開，避免與真實 SKILL.md 不一致。

安裝與啓用¶

安裝 SkillHub CLI（如尚未安裝）¶

先檢查是否已有 CLI：

command -v skillhub && skillhub --version

未安裝時，可按 SkillHub 安裝文檔執行完整安裝（含 CLI 與默認 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

僅需要 CLI 時：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安裝本技能¶

安裝時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。

skillhub install @user_037a0790/feishu-file-image-sender --dir <skills 目錄>

常見客戶端 skills 路徑（來自 SkillHub 安裝文檔，按你當前環境選用其一）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可將下列提示交給支持 Skill 安裝的 AI，讓其按 SkillHub 安裝說明 安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_037a0790/feishu-file-image-sender`。

安裝後若 Agent 未立即識別新技能，按你所用客戶端說明重啓或刷新技能列表。

飛書應用配置¶

在 openclaw.json 中配置飛書 appId 與 appSecret。這是技能說明中的硬性前提；未配置時，上傳與發消息相關能力無法正常工作。

頁面未給出 openclaw.json 的完整字段示例，請對照你所用 OpenClaw 系運行時與飛書開放平臺文檔，填寫合法的應用憑證，並確保應用具備發消息、傳文件所需的權限範圍。

典型用法¶

官方資料未附帶可複製的端到端對話腳本，用法可從簡介反推爲可復現的工作方式：

1. 完成 Skill 安裝與 openclaw.json 中的飛書憑證配置。
2. 在對話中說明要發送的對象（飛書用戶）與本地文件路徑，或明確「把這張圖/這個文件發給某某」。
3. Agent 在識別到發圖片、發文件意圖時調用本技能，執行上傳併發送消息。

你無需記憶飛書 REST 步驟；技能把「上傳 + 發消息」收斂爲 Agent 可調用的能力。具體參數名、錯誤碼處理以技能包內 SKILL.md 爲準。

適用場景與注意¶

適合誰

• 已在飛書側創建應用，並能在 openclaw.json 維護 appId / appSecret 的團隊或個人。
• 希望用自然語言讓 Agent 代發本地附件，減少在飛書客戶端裏反覆點選上傳的人。

限制與注意

• 社區來源（community），升級與維護節奏依賴發佈者；生產環境使用前建議在測試租戶驗證權限與配額。
• 標籤 requires_api_key=true：密鑰只應放在配置文件中，不要寫進對話或倉庫明文。
• SkillHub 統計（抓取時）：評分 100000，下載 1236 次，安裝 50 次；數據會隨時間變化，以 技能頁 爲準。

結尾¶

「飛書文件圖片傳輸」把本地文件到飛書用戶的消息鏈路封裝成 Agent Skill，適合辦公效率類自動化。安裝座標爲 @user_037a0790/feishu-file-image-sender，使用前務必配好 openclaw.json 中的飛書應用信息。

官方入口：

• SkillHub 頁面：https://www.skillhub.cn/skills/user_037a0790/feishu-file-image-sender
• API 座標頁：https://api.skillhub.cn/user_037a0790/feishu-file-image-sender