飛書 CLI（lark-cli）是什麼、怎麼安裝：飛書官方命令行工具與 Agent Skills，讓 AI 智能體操作飛書

本文根據 larksuite/cli 倉庫的中英文 README、飛書開放平台文檔和 npx skills 工具說明整理，資料核對於 2026-10-10。命令和技能數量更新較快，以倉庫 README 為準。

是什麼

lark-cli 是飛書（海外版叫 Lark）官方的命令行工具，由 larksuite 團隊維護，README 的說法是「讓人類和 AI Agent 都能在終端中操作飛書」。它包含兩層東西：一是 lark-cli 這個程序，把飛書開放平台的接口包裝成命令；二是隨倉庫提供的一組 Agent Skills，告訴智能體每個業務域有哪些命令、該怎麼調用、要注意什麼。兩者配合，Claude Code 這類智能體就能替你查日程、發消息、寫文檔。

README 稱覆蓋 18 個業務域、200 多條命令。命令分三層：以 + 開頭的快捷命令（帶預設值和預覽）、與平台接口一一對應的 API 命令，以及可以直接調用任意開放平台接口的通用命令。

截至 2026-10-10，GitHub 顯示該倉庫約 1.8 萬 Star、1388 Fork，最近一次推送 2026-10-09。

包含哪些 Skill

中文 README 的技能表列出 23 個（正文裏寫的是 26 個，以倉庫 skills/ 目錄為準），都以 lark- 開頭：

• 基礎：lark-shared——應用配置、登入認證、身份切換、權限管理和安全規則，其他技能都會自動加載它；
• 溝通：lark-im（消息與群聊）、lark-mail（電郵）、lark-contact（通訊錄查人）；
• 文檔與數據：lark-doc（雲文檔）、lark-drive（雲空間文件）、lark-markdown（原生 Markdown 文件）、lark-sheets（電子表格）、lark-slides（幻燈片）、lark-base（多維表格）、lark-wiki（知識庫）、lark-whiteboard（畫板與圖表）；
• 日程與協作：lark-calendar（日曆）、lark-task（任務）、lark-meeting（會議與妙記）、lark-approval（審批）、lark-okr、lark-attendance（考勤記錄查詢）；
• 事件與擴展：lark-event（實時事件訂閱）、lark-openapi-explorer（從官方文檔探索底層接口）、lark-skill-maker（自定義技能的框架）；
• 現成工作流：lark-workflow-meeting-summary（會議紀要彙總成結構化報告）、lark-workflow-standup-report（日程與待辦摘要）。

怎麼安裝

方式一：從 npm 安裝（README 推薦，需要 Node.js）：

bash
npx @larksuite/cli@latest install

方式二：從源碼安裝（需要 Go v1.23 以上和 Python 3），這種方式要另外執行一條安裝技能的命令，README 標註為必需：

bash
git clone https://github.com/larksuite/cli.git
cd cli
make install
npx skills add larksuite/cli -y -g

配置與登入：

bash
lark-cli config init
lark-cli auth login --recommend
lark-cli calendar +agenda

第一條交互式配置應用憑證（只需一次），第二條登入授權，--recommend 會自動勾選常用權限，第三條查看今日日程，用來驗證是否裝好。企業想把它嵌進自研智能體或平台，README 指向飛書開放平台的專門文檔。

怎麼用

• 交給智能體：裝好並登入後，直接說「看看我明天下午有沒有空，約個半小時的會」「把這份週報發到飛書雲文檔」「彙總本週的會議紀要」，智能體會加載相應技能並調用 lark-cli；
• 自己敲命令：例如 lark-cli calendar +agenda 看日程，lark-cli <service> --help 查看某個業務域的全部快捷命令；
• 先預覽再執行：對會產生實際影響的命令，README 建議加 --dry-run 先看請求內容，比如發消息之前；
• 切換身份：命令可以用 --as user 或 --as bot 指定以用戶還是機器人身份執行。

適合誰 / 不適合誰

適合：

• 公司用飛書辦公、又在用 Claude Code 等命令行智能體的人；
• 想把日程、待辦、會議紀要這些重複操作交給 AI 的個人用戶；
• 要把飛書能力接進自研智能體的企業 IT 和開發者。

不適合：

• 不用飛書的團隊；
• 不熟悉命令行、也沒有權限在企業裏創建和授權應用的普通員工——配置憑證這一步可能需要管理員配合；
• 想讓機器人在群裏對所有人開放使用的場景，官方明確不建議這樣做。

注意事項

• 許可證：MIT（倉庫根目錄有 LICENSE 文件，版權方 Lark Technologies Pte. Ltd.）。工具運行時調用飛書 / Lark 開放平台接口，還須遵守飛書的用戶服務協議、私隱政策和開放平台的相關規範。
• 維護狀態：最近一次推送 2026-10-09，官方團隊持續更新。
• 安全（README 有專門的風險提示，務必讀）：授權之後，智能體是以你本人的身份在授權範圍內操作飛書，模型出錯或被提示詞注入時，可能造成數據外泄或越權操作。官方建議把對接的機器人當作私人助手使用，不要拉進群聊，也不要讓其他人與它交互；不要主動修改預設的安全配置。授權時只勾需要的權限，發消息、審批、刪改文檔這類操作先 --dry-run。
• 數據說明：README 披露，為識別令牌被盜用，CLI 向飛書官方域名發請求時預設附帶操作系統類型和裝置硬件型號兩項資訊，可用 lark-cli config risk-control off 在當前工作區關閉。
• 兼容性：README 只說技能適配主流 AI 工具，沒有逐一列出；飛書項目的能力由另一個獨立的 CLI 提供，需單獨安裝。