[x-cmd] 终端里的飞书：lark-cli，让 AI Agent 拥有“实体办公”能力

终端里的飞书：lark-cli，让 AI Agent 拥有"实体办公"能力

如果你想持续获取更多相关资讯，欢迎关注 x-cmd 博客。

飞书（Lark）正式发布官方命令行工具 lark-cli 。这不仅是开发者提升效率的利器，更是业内首个为 AI Agent 原生设计 的飞书操作接口。

它的核心使命在于构建一套**"人机通用"**的终端交互协议：无论是人类开发者在 Shell 中手动敲击，还是 AI Agent 自动化调度，都能在终端环境内实现对飞书全量业务能力的无缝操控。

💎 核心价值

AI Agent 原生适配 ：内置 19 个 Agent Skills。主流大模型（GPT/Claude 等）无需额外学习，即可通过结构化指令直接调用，处理复杂的办公流，有效降低"模型幻觉"。
业务全域覆盖 ：横跨 IM、日历、云文档、多维表格、任务、视频会议等 11 大业务领域，提供 200+ 精选命令，并支持 2500+ 全量 API 调用。
三层调用架构 ：
- 快捷命令 (+)：语义化封装，为人机交互优化。
- API 命令：与平台端点一一对应，精细控制。
- 通用调用：底层 OAPI 全量覆盖，满足极致自定义需求。
工业级安全加固 ：采用 OS 原生密钥链存储凭证，内置输入防注入 与终端输出净化功能，在效率与安全之间取得完美平衡。

⚡ 快速上手

无论你是追求效率的开发者，还是正在构建 AI 助手的架构师，上手 lark-cli 只需三步。

1. 极简安装

用 x-cmd 安装 lark-cli 非常简单，只需在终端中运行 x install lark-cli 命令即可

bash 复制代码

x install lark-cli

2. 初始化与智能认证

告别繁琐的 JSON 配置，通过交互式引导快速授权：

bash 复制代码

# 初始化配置应用凭证
lark-cli config init

# 智能登录授权（--recommend 自动选择常用权限）
lark-cli auth login --recommend

3. 核心场景演示

🚀 人类用户：语义化快捷操作

快捷命令支持表格或 Markdown 输出，输出结果直观易读。

bash 复制代码

# 查看今日议程
lark-cli calendar +agenda

# 发送群消息通知
lark-cli im +messages-send --chat-id "oc_xxx" --text "架构评审准时开始"

# 基于 Markdown 创建云文档
lark-cli docs +create --title "项目周报" --markdown "# 进展\n- 功能 A 已上线"

🤖 AI Agent：高可用的结构化输出

为 AI 编写 Tool/Skill 时，可利用其强大的参数化能力与静默执行模式。

bash 复制代码

# 检查认证状态
lark-cli auth status

# 以 JSON 格式输出多维表格记录，便于 Agent 解析处理
lark-cli base records list --table-id "xxx" --format json

🛠 进阶：不止于命令行

lark-cli 提供了强大的数据流操控能力，适配各种复杂脚本：

全自动分页 ：添加 --page-all 即可自动抓取成千上万条记录，彻底消除循环翻页逻辑。
Dry Run 机制 ：在高危操作（如删除、权限修改）前添加 --dry-run，预览请求 Payload，确保万无一失。
多维输出格式 ：支持 json, table, csv, ndjson (换行符分隔的 JSON)，完美兼容各类自动化工作流管道。

结语： 在 AI 时代，办公不应被繁杂的 UI 界面束缚。lark-cli 正是将你的"意图"转化为飞书"执行力"的高速引擎，让协同办公真正进入"指令集"时代。

来源：

https://github.com/larksuite/cli