lark-cli 實戰 01：從安裝到創建飛書文檔完整指南
发布于 2026-04-15 00:04:25（微信公众号导出记录）。
本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。
原文链接：查看原文
OCR 转写有效文字约 7192 字；代码、流程图和版式以文末原始排版图为准。
正文（本地 OCR 转写）
original wex7ce EI V1ajero 2026年4月15日 00:84美国 這是一份真實操作記,每一個命令和输出都在何服器上實账敦行退。記综了如何在一台 Linux 何服器上配置lark-cli,读AI Agent(Claude)直接以用户身份调用飛害 API,實現零代碼操作刑鲁文權。 工具: Hermes + ClaudeCode + lark-cli vl.0.9 核心思路:不間發飛書用,不寫代码。直接用Lark-cl1绑定你的飛善畅户,然後据AI Agent 用 CLI 命令操作冠害。 Aaout Th atcsl LagFEtu CLIo I yme ar,IMal, laeks, aertings cevmanes and 23+IAgeet irsm tnetct (NX) yiseer dna ay1g9 heanaga 合 TB s
一、琅境配置全過程
1.1 安装lark-cli
伺服器上已有Node.jsv24.14.1,直接安装: npn install -g @larksuilte/cl1 邵 Lark-cli version 1.0.9
1.2配置飛晋應用證
lark-cli 幂要一個飛善开放平台的愿用(App ID+App Secret)。有雨種方式: 围後自動创建) 配量完後硫: sess yane tio-yue s
-
appId": "cli a956xxxxx*
-
brand": "feishu*,
-
identity": "bot*,
-
note": "No user logged in. Only bot (tenant) identity is available."
此時只有bot(愿用)身份,看不到用户的個人资源。要邯定用户易份。
1.3用户登錄授權-0AuthDeviceFLow群解
何服器没有测贸器,所以用Dev1ce FLow模式。道一步是整個配置的核心。
第一步:Agent起授權請求
业“回“TM- Agent 孰行 Lark-cl1 auth login --recommend - -donain docs,drive,wiki,im - -no-wait 返回值(JS0N):
-
device_code*: *oQTl_UBkqutIThCPUFCBjMVxCat2rSBP...",
-
verification_url*: "
https://accounts.feishu-cn/oauth/v1/device/verif -
user_code": *7JZR-TR4Y",
expires_in*: 600
谁奎生的 字段 含额 换token的愚證,後續要 飛善OAuth何服器,通适本命令返 dev1ce_code 用 国 verif1cat1on_ur 授權真面翘接 同上 1 user_code 在授權真面輸入的验證碼 同上 有效期686秒(10分 同上 expires_in 键) device_code 是這個命令直接返回的,不是测質器授權後產生的。先拿到devireC odc,用户再去测置器授槽,显後用devicc_codc换token。
第二步:用户在實器授權
Agent 把縫接和user_code登给用户。用户在自己電上: L. 打用 verification url
2.真面顯示user_cade(或手勤输入)
3.贴链超授槽
飛害伺服器會配:這因dcvicc_codc對庭用户wex7ce,已授權。
第三步:Agent用device_code完成置錄
用户告新Agent 授權完成,Agent 用第一步的device_code敦行: lark-cli auth login --device-code "oQTl_uekqutIThcPUFCBjMVxCotzr5BP.." 實察返回: 0K:冀赣成功! 用卢:w8x7ce (ou_8b699fcd377ea78ff5e16abb4b8ba397) 本次求 scopes: docs:docunent.content:read decx:docunent:create docx:c 本次末授予scopes:(空) 验最终状部: 瞻證最终状题: S lark-cli auth status
xxxxxx9s6eT1p...,Idde.
-
identity": “user*,
-
userName": "uex7ce",
-
tokenstatus*:*valid",
Ldentity徙bot爱成了user。现在Agent 可以用wox7ce的身份操作册 V 書了。
二、創建文檔一每種元素的真實命令
以下是所有文檔能力的實测结果。每個命令都在何服器上實腐執行透,输出是真實的。
2.1創建文檔基础
Lark-cli docs +create \
- -markdown“遭是一段普通文本。
實际返回:
-
ok": true,
-
data":{
-
doc_id": "QfqTaXy6AoVRz7xdTNcc6Xgmngb",
"dpc_url": "https://www. feishu.cn/docx/QfqTdxybApvRz7xdTNcc6Xgmngb"
厚x。obessu
後绩操作都用 doc_id来定位道霜文榴。
2.2富文本格式
Lark-cli docs +update \
- -doc "QfqTdxy6AoVRz7xdTNcc6Xgnngb"
\ puodde apou-
- -markdown“普通文本,支持*加和**、科體、障螺,“行内代碼”。
返回:
- ok": true,
',puadde,. +,apou.
對效果:普通文本中的加粗、斜、删除線、行内代疆。
2.3高亮塊(Callout)
三福常用高亮境:
Lark-c1i docs +update
- -doc "QfqTdXy6AoVRz7xdTNcc6Xgnngb"\
\ puadde apou-- =1 [cue 4malless, umopyeu-
- backgraund-color=-light-hlue">
亚色提示高亮境。 /callout> ccallout emoji-** background-color-"light-yellow"> 黄色警告高亮场。 </callout> ccallout emoji=X background-color="light-red*s 红色危险高亮境。 </callout>: 返回:同上 append 成功. 到愿效果:带enoji图标、带背景色的高亮场。 隔性明: 隔性 可退值 脱明 左例 enoj1 任意emoji字符 light-blue 背景 background ,light-yellow, Light-red, light-green, light-pu J0103- 色 rple, light-orange, pale-gray callout内部可以格式化文本,但不支持代碼现、表格、图片。
2.4分(Grid)
雨等宽:
Lark-cl1 docs +update
1puadde opoa
markdo/n
,=5]02 p7./6>,
<column>
左内容,支持格式化。
列表项1
- 列表2
</column> 右帽内客。
1.有序列表
2.第二顷
</column> </gr1d>
三棚自定宽度:
Lark-cli docs +update
70C
mode append 1
1puadde opos
- ,08/ko
<3=apim ums 20%真 </column> <,09,=qapim uuos> 60%宽 </column> <,3,=qapim uuas> 20%真 </column> </grid> 性就明: cols 列数,2到5
- width-列寶百分比,铺和必须為160,等实可省略
2.5表格
表格直接用Markdown惩法: Lark-cl1 docs +update \
- doc"QfqTdXy6AoVR7xdTVc5Xgm
mode appcnd 1
-
Barkdown°1列 1|列 2|列 3
-
1 数 1 | 数域 2 1 数摄 3 | 数球4|数擦5|数6| 辩表格(单元格内有列表、代码等)用飛画增强表格: Lark-cli docs +update
- doc "QfqTdXy6AovRz7xdTNcc6Xgnngb"
\ puadde apou--
- -narkdown *slark-table calumn-widths="2ee,2so,2ee" header-row=*true
xlark tr> zlark-td>
- 功能*
s/lark-td>
- 部令**
slark-td>
- 些明*
</lark-td> clark-tr> 创建文福 clark-td> docs +create </lark-td> Markdown 刨建新文榴 c/lark-td> c/lark-tables' lark-table的clark-td标箍内的内容前後必须空行,否则解析失。
2.6代碼瑰
lark-cli docs +update
doc "0fqTdXy6AoVRz7xdTVcC
- oode append 1
srkdown“##代碍示例 python def hello() : print(“Hello, Feishu!*) return True 支持的語言磁:python,javascript,go,Java,sql,json,yanl,shcl L, bash 等。
2.7任務列表
lark-cli docs +update
- doc "QfqTdXy6AoVRz7xdTNcc6Xgmngb"
\puadde apou-- markdown"-[]末完成的任称
- [x]已完成的任務“
效果:带勾避框的待群列表,
2.8引用瑰
lark-cli docs +update
-
doc "QfqTdXy6AoVRz7xdTNcc6Xgnngb
-
-node append 1
可以跨多行 支持**加赠*和寂
2.9文字颜色
lark-cli docs +update
doc "ofqTdXy6AoVRz7xdTNC
mode append 1
Barkdawin‘红色文字暂色文字
红色文字蓝色文字
黄色背景高亮
支持的频色:red,orange,yellow,green,blue,purple,gray。
支持的颜色:red,
purple ,
ef
2.10插入圆片
通過公開URL插人国片(lark-cli自封下载亚上傅到形善): Lark-cli docs +update \
- doc "0fqTdxy6AoVRz7xdTNcc6Xgnngb"
\ pusdde apou
- -narkdown *<inage url="
https://exanple.con/photo.jpg" width=40e al.
图片插入是具步操作。命令返回的是task_id,不是立即生效。實察测斌中耗時的8 秒。 返回示例:
-
status": "running*.
-
task_id": "418dcd05=852f-4fa8-bdda-ec231cae3b49*,
-
estimated_tine*: *5-15s"
性明: 隔性 必填 就明 url 是 图片的公可防間 URL 宽度(像素) width 否 left align 否 / center / right caption 否 图片下方期明文字 支持格式:PNG/JPG/GIF/WebP/BMP,显大10MB. 如果是本地图片,流程不同:先用docs+update离文本,再用docs+Hiedla-insert追 加本地文件。
2.11標题颜色和對齊
lark-cli docs +update ↑
- -doc "QtqTdxy6AoVRz7xdTNcc6Xgmngb"\
puadde apou- ##红色精题{coLor=red°} 国中文字{align="center*}
2.12分割線
Lark-cli docs +updatc
- doc "0fqTαXy6AoVRz7xaTVcc6Xgmngb*
1 puadde apow-
分割缘下面的内容
三、文檔更新-六種模式详解
doc5+update有7种模式,以下是每種模式的實测命令和结果。
3.1append-追加到末尾
最常用的模式,在文檀最後追加内容:
Lark-cli dacs +update
xxxuoxopop-
\ puadde apou--
返回:
{
',puadde., ..apou.
(puade)x。:,afessau.
- success":truc
3.2insert_before-在指定位置前面插入
用标题定位,在标题前面插入内容:
Lark-cli docs +update
xxxuoxopop-
-
-node insert_before \
-
-selectian-by-title“目题\
markdown“>这段言出现在目标杨题的南面 返回:
-
node": "insert before",
-
success": true
3.3insert_after-在指定位置後面插入
lark-cli docs +update xxxu5xopoop-
- -node insert_after \
selection-by-title“##目题\
返回: "node": "insert_after",
- success": true
3.4replace_range-替换整個章節
用标题定位,替换被标题下的整個章的内容: Lark-cli docs +update \
- doc "doxcnXXX* 1
mode replace_range 1 selection-by-title “ 標蹈”
- 8rkdown“新棵题
mankcdown 智换後的全新内容。 可以包含列表 可以包含其他格式 返回: "node": "replacc_range", success": true
3.5replace_all-全文替换文本
在全文图内查找亚警换文本: 1 Lark-cl1 docs +update \
- -doc"daxcnxxx"\
11easedou apou-
- -markdown“新文本”
實际返回: '11e aseldau, +.apou, ‘t :,lun agda, “ncssage":“文福更新感功(replacc_all模式),共世1虚"
注意rcplacc_count字段告新你實际替换了袭点。
3.6delete_range-删除整個章節
用棵定位,删除敲棵题下的整個童前:
lark-cli docs +update
\xxxuoxopoop--
- -node delete_range \
返回:
- node": "delete range",
“nessage":“文福更斯成功(delctc_rangc模式)", 'success": true
3.7overwrite-全文覆蓝(慎用)
清空文榴重宽。會丢失已有圆片、钾输等。
lark-cli docs +update
xxxuoxopoop--
-
-node overwrite \
-
narkdown“全斯的文指内容
更新横式速查表: 定位方式 模式 用途 围险 無(末尾) 追加新内容 低 puedde 低 标题定位 在某章顾前插入 insert before 标翘定位 在某章前後插入
- 低
insert_after
- 中
replace_range 标题定位 替换整個章的 中● replace_all 文本匹配 全文查找替拍 delete_range 标题定位 删除盈個章筋 overwrite 清空重窝 無 高
四、镇取文檔内容
Lark-cli docs +fetch 返回文樓的 Markdown 内容(Lark-flavored 格式),包含文樓标题、长度、正文。可用 来检查文檀當前内容後再决定如何更新。
五、踩坑記錄(真實遇到的問题)
5.1長文槛必须分段寫入
刑晋API对单次寫入有限制實测中發现一篇9章衍的文楼無法一次性寫入,需要: 别建主经 lark-cli docscreate --title“棵题--markdown“第—部分 #逐段通加 lark-cli docs +update --doc
- -narkdown“第二部分”
"xxx" puadde apou-
5.2搜索文檔需要额外權限
實涮docs +search罐:
-
ok": falsc,
-
error":{
"type": "missing scope", 'nessage*: nissing required scopc(s]: scarch=docs:read
search:docs:read scope: 需要额外授權 lark-cli auth login --scope search:docs:read
5.3圆片插入是巽步的
插入圖片不會立即生效,返回的是task_id: "status":"running" "task_id":"418dcd05-052f-4fa8-bdda-ec231c0e3b49", "estimated_time":"5-15s"
實測約8秒後圖片才出現在文檔中。
5.4bash中---會被解析為flag
在shell中通過$(catfile)傅含 分割線的Markdown時,bash會把 當作命令行flag,導致報錯。 解决方案:直接在参数中寫内容,避免用$(cat) 展開。
六、最終效果
配置完成後,我可以直接對Agent: “我創建一篇飛書文檔,標題是XXX" "我在飛書文檔裡追加一段關於XXX的内容" “我把飛書文檔裡那個舊章節替換成新内容“ “我往飛書文檔裡插一張圖” lark-cli完成操作,文檔實時出現在飛書裡。 Agent會直接調用 本文所有命令和輸出均為真實執行結果
lark-cli·目录= 下一篇·lark-cli實02:AIAgent操作飛書電子表格全流程實測(22頂功能)>
原始排版图
原始导出图超过单张 WebP 的尺寸上限，以下图片按从上到下的顺序连续保存。
