PRODUCT

飛書 CLI（命令行工具，讓 AI 通過文字指令操作飛書的接口）今天正式開源。Go 語言寫的，MIT 協(xié)議

裝上之后，你的 AI Agent 可以直接操作飛書：發(fā)消息、查日歷、寫文檔、建多維表格、發(fā)郵件、管任務、搜知識庫。你跟 AI 說一句話，它自己去飛書里把事情辦了

用起來比想象的還簡單，三步搞定

第一步在終端里輸入兩行命令，CLI 會彈出一個二維碼

npm install -g @larksuite/cli
lark-cli config init

終端里輸入 lark-cli config init，彈出二維碼，掃碼即可完成應用配置

第二步手機掃碼，在飛書里一鍵授權。多維表格、日歷、通訊錄、文檔、消息、郵箱、電子表格、任務、視頻會議的常用權限一次開通

飛書授權頁面，一鍵開通所有常用權限

第三步打開 Claude Code（或 Cursor、Codex、任何 Agent 工具），直接開始用。中間如果遇到任何配置問題，讓 Agent 幫你解決就行

Claude Code 里使用 lark-cli，查日程、查消息、發(fā)郵件，直接跟 Agent 說就行

完整文檔在倉庫 README 里：https://github.com/larksuite/cli

無需登記，無需審核，裝上就能用

200+ 命令，覆蓋 11 個業(yè)務域

飛書 CLI 把飛書的核心業(yè)務能力全部拆成了可供 AI 調用的命令。下面按業(yè)務域逐項展開，每一項對應一個獨立的 Agent Skill，技術人員可以按 Skill 名稱直接查閱倉庫中的指令文檔

幫你管消息和群聊lark-im

Agent 可以發(fā)送消息、回復話題、搜索群聊和歷史消息、創(chuàng)建群組和管理群成員。支持上傳和下載群聊中的圖片與文件，也支持給消息添加表情回應。覆蓋了飛書即時通訊的主要交互場景

幫你寫文檔、改文檔lark-doc

Agent 可以創(chuàng)建新文檔、讀取現(xiàn)有文檔內容、更新正文、搜索文檔?；?Markdown 格式操作，Markdown 和飛書文檔可以互相轉換，高亮塊、表格、代碼塊、分欄全部保留。你還可以在文檔里用評論寫修改意見，讓 Agent 去讀評論并改正文，省掉來回復制粘貼的環(huán)節(jié)

用戶輸入指令 → AI 創(chuàng)建文檔 → 用評論提意見 → AI 修改并高亮改動點

幫你管文件和云空間lark-drive

Agent 可以上傳和下載文件、管理文件的分享權限、處理文件評論。適用于需要在飛書云空間中批量操作文檔和附件的場景

幫你管日歷和約會議lark-calendar

Agent 可以查看日程、創(chuàng)建日歷事件、邀請參會人、查詢所有人的忙閑狀態(tài)、推薦合適的開會時間。跨時區(qū)場景也能處理，Agent 自動考慮每個參會人的時區(qū)，推薦所有人都在合理工作時間段內的選項

幫你處理郵件lark-mail

Agent 可以瀏覽和搜索郵件、讀取郵件正文和附件、起草新郵件、發(fā)送、回復、轉發(fā)、管理草稿、監(jiān)聽新郵件到達。官方說郵箱能力做了重點增強，補齊了增刪改查的完整能力

你跟 AI 說一句話，它自己去飛書里把事情辦了

幫你管電子表格lark-sheets

Agent 可以創(chuàng)建新的電子表格、讀寫指定單元格、批量追加數(shù)據(jù)、按條件查找內容、將表格導出為文件。適合需要定期更新數(shù)據(jù)或從表格中提取信息的工作流

幫你管多維表格lark-base

Agent 可以創(chuàng)建和管理數(shù)據(jù)表、定義字段、增刪改查記錄、搭建視圖、生成儀表盤、進行數(shù)據(jù)聚合和分析。比如讓 Agent 拉取過去兩周的日歷，自動給每場會議打標簽，寫入多維表格，生成餅圖和柱狀圖

幫你管任務lark-task

Agent 可以創(chuàng)建任務、更新任務狀態(tài)、管理任務清單和子任務、設置到期提醒、將任務分配給指定成員。支持對任務添加評論和跟進記錄

幫你搜知識庫lark-wiki

Agent 可以查詢知識庫空間列表、瀏覽文檔節(jié)點的層級關系、在知識庫中創(chuàng)建和管理文檔。適合需要從企業(yè)知識庫中檢索信息或維護文檔結構的場景

幫你查通訊錄lark-contact

Agent 可以按姓名、郵箱、手機號搜索同事，獲取用戶的詳細資料信息，查看部門組織架構。在需要批量定位聯(lián)系人或查詢組織關系時會用到

幫你處理會議紀要lark-vc / lark-minutes

Agent 可以搜索會議記錄、獲取妙記生成的會議摘要、待辦事項、逐字稿和章節(jié)結構。開完會之后，Agent 能從妙記里把待辦提取出來，按優(yōu)先級排列，甚至直接幫你執(zhí)行

幫你訂閱實時事件lark-event

Agent 可以通過 WebSocket 訂閱飛書的實時事件推送，支持正則表達式路由和結構化輸出。當有新消息、日程變更或審批流轉時，Agent 可以第一時間感知并響應

幫你搜索lark-search

Agent 可以跨業(yè)務域搜索群聊、消息和文檔，通過統(tǒng)一的搜索入口定位飛書中的任意內容，省去在不同模塊之間來回切換查找的時間

進階：Wake Word 指令設置一個觸發(fā)詞（比如「龍蝦龍蝦」），開會的時候隨口說「龍蝦龍蝦，幫我把這個方案整理成文檔發(fā)給老板」，會后 Agent 自動從妙記逐字稿里識別出你的指令并執(zhí)行

支持兩種身份

飛書 CLI 同時支持用戶身份和應用身份兩種認證方式

用戶身份登錄后，Agent 以你的名義操作，能訪問你個人的日歷、私信、收件箱。適合個人場景

應用身份調用時，Agent 以一個飛書應用的身份運行，適合企業(yè)級 Agent 和自動化工作流

不授權也能用。Agent 仍然可以執(zhí)行發(fā)消息、創(chuàng)建文檔這些操作，只是無法訪問你的個人數(shù)據(jù)

為 AI 而設計

這個 CLI 在設計上有幾個面向 Agent 的考量

出錯引導Agent 調 API 出錯的時候，CLI 會告訴它具體缺了什么權限，以及怎么補

權限自動補授缺權限的時候，CLI 會自動引導完成授權，或者生成授權鏈接讓 Agent 轉發(fā)給用戶

dry-run 預覽所有可能產生副作用的命令都支持先預覽再執(zhí)行

輸出格式靈活支持 JSON、table、CSV 等多種格式，Agent 用 JSON 解析，人類用 table 看表格

Schema 自省Agent 調用之前可以先查任何 API 的參數(shù)結構和所需權限

這個工具的首要用戶是 AI Agent

整體架構上，命令分三層

第一層 Shortcuts，帶+前綴，日常用這一層就夠了

第二層 API Commands，100+ 條命令跟飛書平臺端點一一對應

第三層 Raw API，可以直接調飛書開放平臺的任意端點，覆蓋2500+個 API

如果你在用 Claude Code、Codex、Cursor 這些 AI 工具，裝完 CLI 之后再裝一下 Skills（npx skills add larksuite/cli -y -g），Agent 就知道該怎么調用了

一個實際的例子

我最近，今天剛做了一次大版本更新，讓參與者可以授權 GitHub，之后龍蝦可以自動去提 PR

但更新之后，需要每個參與者重新訪問各自的授權鏈接，每個人的鏈接都不一樣。我的郵箱在飛書上管理，參與者的信息我整理在一份文件里

于是我讓 Agent 讀取這份文件，用飛書 CLI 批量給每個人發(fā)了定制郵件，每封郵件里帶著那個人專屬的授權鏈接

用飛書 CLI 給龍蝦創(chuàng)世紀的參與者批量發(fā)定制郵件

一周多前龍蝦殖民地剛上線的時候，同樣的事情大概只能手動操作?，F(xiàn)在 Agent 讀取文件、生成個性化內容、調用郵箱接口發(fā)送，整個鏈路是通的

OpenClaw 用戶須知

如果你是 OpenClaw 用戶，飛書說后續(xù)會上線一個內置全部 CLI 能力的「飛書官方 OpenClaw 插件」，升級之后不需要單獨安裝 CLI。現(xiàn)有的飛書 OpenClaw 官方插件底層就是基于這套 CLI 構建的

支持國際版 Lark。通過config init配置國際版應用即可

GitHub：https://github.com/larksuite/cli

本文使用 CLI 工具撰寫