PRODUCT

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

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

用起來(lái)比想象的還簡(jiǎn)單，三步搞定

第一步在終端里輸入兩行命令，CLI 會(huì)彈出一個(gè)二維碼

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

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

第二步手機(jī)掃碼，在飛書(shū)里一鍵授權(quán)。多維表格、日歷、通訊錄、文檔、消息、郵箱、電子表格、任務(wù)、視頻會(huì)議的常用權(quán)限一次開(kāi)通

飛書(shū)授權(quán)頁(yè)面，一鍵開(kāi)通所有常用權(quán)限

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

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

完整文檔在倉(cāng)庫(kù) README 里：https://github.com/larksuite/cli

無(wú)需登記，無(wú)需審核，裝上就能用

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

飛書(shū) CLI 把飛書(shū)的核心業(yè)務(wù)能力全部拆成了可供 AI 調(diào)用的命令。下面按業(yè)務(wù)域逐項(xiàng)展開(kāi)，每一項(xiàng)對(duì)應(yīng)一個(gè)獨(dú)立的 Agent Skill，技術(shù)人員可以按 Skill 名稱直接查閱倉(cāng)庫(kù)中的指令文檔

幫你管消息和群聊lark-im

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

幫你寫(xiě)文檔、改文檔lark-doc

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

用戶輸入指令 → AI 創(chuàng)建文檔 → 用評(píng)論提意見(jiàn) → AI 修改并高亮改動(dòng)點(diǎn)

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

Agent 可以上傳和下載文件、管理文件的分享權(quán)限、處理文件評(píng)論。適用于需要在飛書(shū)云空間中批量操作文檔和附件的場(chǎng)景

幫你管日歷和約會(huì)議lark-calendar

Agent 可以查看日程、創(chuàng)建日歷事件、邀請(qǐng)參會(huì)人、查詢所有人的忙閑狀態(tài)、推薦合適的開(kāi)會(huì)時(shí)間?？鐣r(shí)區(qū)場(chǎng)景也能處理，Agent 自動(dòng)考慮每個(gè)參會(huì)人的時(shí)區(qū)，推薦所有人都在合理工作時(shí)間段內(nèi)的選項(xiàng)

幫你處理郵件lark-mail

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

你跟 AI 說(shuō)一句話，它自己去飛書(shū)里把事情辦了

幫你管電子表格lark-sheets

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

幫你管多維表格lark-base

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

幫你管任務(wù)lark-task

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

幫你搜知識(shí)庫(kù)lark-wiki

Agent 可以查詢知識(shí)庫(kù)空間列表、瀏覽文檔節(jié)點(diǎn)的層級(jí)關(guān)系、在知識(shí)庫(kù)中創(chuàng)建和管理文檔。適合需要從企業(yè)知識(shí)庫(kù)中檢索信息或維護(hù)文檔結(jié)構(gòu)的場(chǎng)景

幫你查通訊錄lark-contact

Agent 可以按姓名、郵箱、手機(jī)號(hào)搜索同事，獲取用戶的詳細(xì)資料信息，查看部門(mén)組織架構(gòu)。在需要批量定位聯(lián)系人或查詢組織關(guān)系時(shí)會(huì)用到

幫你處理會(huì)議紀(jì)要lark-vc / lark-minutes

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

幫你訂閱實(shí)時(shí)事件lark-event

Agent 可以通過(guò) WebSocket 訂閱飛書(shū)的實(shí)時(shí)事件推送，支持正則表達(dá)式路由和結(jié)構(gòu)化輸出。當(dāng)有新消息、日程變更或?qū)徟鬓D(zhuǎn)時(shí)，Agent 可以第一時(shí)間感知并響應(yīng)

幫你搜索lark-search

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

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

支持兩種身份

飛書(shū) CLI 同時(shí)支持用戶身份和應(yīng)用身份兩種認(rèn)證方式

用戶身份登錄后，Agent 以你的名義操作，能訪問(wèn)你個(gè)人的日歷、私信、收件箱。適合個(gè)人場(chǎng)景

應(yīng)用身份調(diào)用時(shí)，Agent 以一個(gè)飛書(shū)應(yīng)用的身份運(yùn)行，適合企業(yè)級(jí) Agent 和自動(dòng)化工作流

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

為 AI 而設(shè)計(jì)

這個(gè) CLI 在設(shè)計(jì)上有幾個(gè)面向 Agent 的考量

出錯(cuò)引導(dǎo)Agent 調(diào) API 出錯(cuò)的時(shí)候，CLI 會(huì)告訴它具體缺了什么權(quán)限，以及怎么補(bǔ)

權(quán)限自動(dòng)補(bǔ)授缺權(quán)限的時(shí)候，CLI 會(huì)自動(dòng)引導(dǎo)完成授權(quán)，或者生成授權(quán)鏈接讓 Agent 轉(zhuǎn)發(fā)給用戶

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

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

Schema 自省Agent 調(diào)用之前可以先查任何 API 的參數(shù)結(jié)構(gòu)和所需權(quán)限

這個(gè)工具的首要用戶是 AI Agent

整體架構(gòu)上，命令分三層

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

第二層 API Commands，100+ 條命令跟飛書(shū)平臺(tái)端點(diǎn)一一對(duì)應(yīng)

第三層 Raw API，可以直接調(diào)飛書(shū)開(kāi)放平臺(tái)的任意端點(diǎn)，覆蓋2500+個(gè) API

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

一個(gè)實(shí)際的例子

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

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

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

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

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

OpenClaw 用戶須知

如果你是 OpenClaw 用戶，飛書(shū)說(shuō)后續(xù)會(huì)上線一個(gè)內(nèi)置全部 CLI 能力的「飛書(shū)官方 OpenClaw 插件」，升級(jí)之后不需要單獨(dú)安裝 CLI?，F(xiàn)有的飛書(shū) OpenClaw 官方插件底層就是基于這套 CLI 構(gòu)建的

支持國(guó)際版 Lark。通過(guò)config init配置國(guó)際版應(yīng)用即可

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

本文使用 CLI 工具撰寫(xiě)