前言¶
在飛書裏做自動化，常見路徑是自建應用、走 Bot、再向管理員申請租戶級權限。對個人開發者或小團隊來說，審批週期長，且很多操作其實只需要「當前登錄用戶」能做的事。若你的 Agent 運行在 OpenClaw 或 EnClaws 上，又希望直接讀寫文檔、發消息、改日曆和任務，就需要一套按通用 SKILL.md 組織的集成說明，而不是零散的 API 筆記。
下面介紹 SkillHub 上的 feishu-skills（座標 @user_3ad8e894/feishu-skills，版本 1.0.0）：社區來源的 ai-agent 類 Skill，面向 OpenClaw 與 EnClaws，強調用用戶個人 OAuth Token 訪問飛書能力，而不是依賴 Bot Owner 權限，也無需管理員授權。
這是什麼¶
feishu-skills 是飛書集成的完整技能包。發佈者爲 SkillHub 用戶 user_3ad8e894，標籤標明 requires_api_key=false（以 SkillHub 頁面元數據爲準）。
官方簡介概括爲：讓 AI Agent 能夠讀寫飛書文檔、發送消息，並管理日曆、任務和多維表格；運行環境以 OpenClaw 和 EnClaws 爲主。與「先建企業機器人、再申請全租戶權限」相比，這條路徑更貼近「誰授權、誰的數據就按誰的令牌操作」。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在頁面單獨展開接口清單的部分不在此臆造：
- 飛書文檔：讀寫文檔類內容（具體 API 與字段以 Skill 包內 SKILL.md 爲準）。
- 消息：通過集成能力發送消息。
- 日曆：管理日曆相關資源。
- 任務：管理任務。
- 多維表格：操作多維表格（飛書 Bitable 場景）。
鑑權模型：用戶個人 OAuth Token，而非 Bot Owner 權限；無需管理員授權（官方表述）。
安裝與啓用¶
SkillHub 頁面給出的安裝指引是：先閱讀官方安裝文檔，再安裝本 Skill。
1. 準備 SkillHub CLI¶
若尚未安裝 CLI，按 SkillHub 安裝與優先源配置 檢查或安裝：
command -v skillhub && skillhub --version
未安裝時，文檔推薦執行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝 feishu-skills¶
安裝時必須用 --dir 指向當前 Agent 正在使用的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法加載。
skillhub install @user_3ad8e894/feishu-skills --dir <你的 Agent skills 目錄>
常用客戶端的 skills 路徑（摘自 SkillHub 安裝文檔，按你實際使用的工具選用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
OpenClaw 及其變體（文檔列出的 NanoBot、PicoClaw、memUBot、MaxClaw、CoPaw、AutoClaw、KimiClaw、QClaw、EasyClaw、workbuddy 等）通常也有各自的 skills 目錄，需與當前運行環境一致。
3. 讓 Agent 完成配置¶
SkillHub 頁面提供的提示詞範式爲：讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_3ad8e894/feishu-skills。安裝完成後，OAuth 授權、令牌存放與具體工具調用步驟應以 Skill 包內的 SKILL.md 爲準；公開頁面未列出單獨的配置字段名，本文不編造。
典型用法¶
公開資料未附帶可逐行復制的業務腳本示例。可復現的流程是：
- 按上一節將
@user_3ad8e894/feishu-skills安裝到對應 Agent 的 skills 目錄。 - 在 OpenClaw 或 EnClaws 中加載該 Skill，按 SKILL.md 完成飛書個人 OAuth 授權。
- 在對話中用自然語言描述目標（例如整理文檔、發送通知、更新任務或多維表格記錄），由 Agent 按 Skill 內說明調用飛書能力。
具體請求參數、錯誤碼與速率限制需以飛書開放平臺文檔及 Skill 內指引爲準。
適用場景與注意¶
適合誰
- 已在或計劃使用 OpenClaw、EnClaws 的開發者，希望 Agent 直接操作飛書文檔、消息、日曆、任務與多維表格。
- 希望用個人 OAuth 完成授權，避免走 Bot Owner 與管理員審批鏈路的場景。
需要注意
- 來源爲 community：維護節奏與官方飛書 SDK 文檔可能不同步，升級前建議在 SkillHub 查看版本 1.0.0 是否有更新。
- 環境綁定：簡介明確面向 OpenClaw / EnClaws；Cursor、Codex 等僅能通過「把 Skill 裝到對應 skills 目錄」嘗試加載，是否與這些客戶端的全部能力兼容，需以實際 Agent 行爲爲準。
- 權限邊界：個人 OAuth 只能代表授權用戶可訪問的資源；不能替代企業合規審計或跨租戶管理。
- 頁面統計（截至資料抓取）：SkillHub 評分 100000，下載約 748 次；安裝計數爲 0 僅表示商店側統計，不代表不可用。
結尾¶
feishu-skills 把飛書文檔、消息、日曆、任務與多維表格串成一套面向 Agent 的集成 Skill，並用個人 OAuth 降低管理員介入成本。若要查看元數據或安裝入口，可打開 SkillHub 頁面：
- https://www.skillhub.cn/skills/user_3ad8e894/feishu-skills
- https://api.skillhub.cn/user_3ad8e894/feishu-skills
