最近飞书官方开源了 CLI 工具 lark-cli,顺手把它接到了 Multica 上,这样 Multica 里的 Agent 就能直接处理飞书里的消息、文档和日程了。这里记录下接入过程。
lark-cli 是什么
lark-cli 是飞书官方维护的命令行工具(MIT 协议),定位是"让人类和 AI Agent 都能在终端中操作飞书"。覆盖消息、云文档、多维表格、电子表格、日历、邮箱、任务、视频会议、审批、OKR 等业务域,提供 200+ 命令,并附带二十多个现成的 AI Agent Skills(如 lark-im、lark-doc、lark-calendar、lark-task 等)。
对 Multica 来说,这点很关键:Multica 本身不需要做任何飞书适配,只要运行 Agent 的机器上装好 lark-cli 和对应的 Skills,Claude Code、Codex 这类 Agent 就会在任务中按需调用 lark-cli。
接入思路
Multica 的 Agent 实际是由本地 Daemon 在运行时机器上拉起的 CLI(Claude Code、Codex 等)。所以"Multica 接入飞书"其实就是两件事:
- 在运行 Multica Daemon 的机器上安装 lark-cli 及其 Skills;
- 用同一个系统用户完成飞书应用配置与登录授权。
完成后,在 Multica 里给 Agent 派一个 Issue,比如"整理今天飞书群里的讨论并写成文档",Agent 就能自己调用 lark-cli 去做。
安装
前提:机器上已有 Node.js(npm/npx 可用)。
npx @larksuite/cli@latest install
这个 install 是一个交互式安装向导,会依次完成:
- 全局安装
@larksuite/cli(之后就有lark-cli命令了); - 安装 AI Skills(等价于
npx skills add larksuite/cli -y -g,装到用户级 Skills 目录,Claude Code 等 Agent 可直接发现); - 配置飞书应用(等价于
lark-cli config init --new,按提示在浏览器中一键创建应用即可); - 询问是否授权 AI 以你的身份访问飞书数据。
如果第 3、4 步失败或跳过了,后续手动执行对应命令即可。
登录授权
lark-cli auth login --domain all
--domain all 表示一次性申请所有业务域(消息、文档、日历、任务、邮箱等)的权限,省得后面 Agent 用到某个功能时再反复补授权。执行后终端会输出一个授权链接,在浏览器中打开并确认即可,服务器无图形界面也没问题。
如果不想给太多权限,可以按需缩小范围:
# 只授权日历和任务
lark-cli auth login --domain calendar,task
授权完成后检查一下状态:
lark-cli auth status
验证
先在终端里手动跑一条命令,确认能正常访问飞书:
lark-cli calendar +agenda
能看到今天的日程,说明链路打通了。之后回到 Multica,给 Agent 新建一个 Issue 试试,例如:
- 查询我今天的飞书日程,整理成待办清单;
- 把这个 Issue 的结论写成一篇飞书文档;
- 给某个飞书群发一条进度通知。
Agent 会自动加载 lark-* Skills 并调用 lark-cli 完成。
注意事项
- 装在 Daemon 所在机器、同一用户下。如果 Daemon 跑在云服务器上,就要在服务器上安装和登录,本地电脑装了没用。
- 权限即身份。授权后 Agent 会以你的飞书身份执行操作,官方也提示存在模型幻觉、提示词注入等风险。
--domain all虽然省事,但更适合个人账号;团队或敏感场景建议按需授权。 - 机器人别拉进群。官方建议把对接的飞书机器人当作私人助手使用,不要拉进群聊或让其他人与之交互,避免权限被滥用。
- 升级。再次执行
npx @larksuite/cli@latest install会检测版本并升级,已安装的 Skills 和已配置的应用会跳过。
写在最后
lark-cli 对 Agent 很友好,Multica 这边几乎零成本就能接入飞书。让 Agent 顺手处理飞书里的消息、文档、日程,又少了一些来回切换。