lark-cli

name	lark-cli
description	Lark/Feishu 官方 lark-cli：日历、通讯录、IM、云文档、多维表格、通用 Open API 等。在用户需要直接调 Lark API、用 CLI 排查、或 OpenClaw 内置 feishu_* 工具未覆盖的场景下使用。触发词：lark-cli、飞书 CLI、Lark API、calendar/contact/im 命令行。
metadata	{"openclaw":{"requires":{"bins":["lark-cli"]},"homepage":"https://github.com/larksuite/cli"}}

Lark CLI（lark-cli）

通过终端调用飞书/Lark Open API，需本机已安装 lark-cli 并完成 lark-cli auth（与 OpenClaw 通道里配置的 appId/appSecret 是两套凭证，按 CLI 文档单独登录）。

何时用 CLI、何时用内置工具

• OpenClaw 已启用飞书插件时，文档/云盘/会话等优先用内置 feishu_* 工具（免拼 curl、权限与网关一致）。
• 适合用 lark-cli：需要 lark-cli api、lark-cli schema 查参数；日历/通讯录/IM 等子命令；--dry-run 调试；或官方 CLI 工作流。

基本用法

# 健康检查与配置
lark-cli doctor

# 查看某 API 的 schema（参数、scope）
lark-cli schema <service.resource.method> --format pretty

# 通用 HTTP 调用（method + path + JSON）
lark-cli api GET /open-apis/calendar/v4/calendars
lark-cli api POST /open-apis/... --data '{"key":"value"}'

# 输出格式：json | table | csv | pretty 等
lark-cli --format table contact +search-user --query "关键词"

子命令一览（详见 lark-cli <command> --help）：api、auth、base、calendar、config、contact、docs、drive、event、im、mail、minutes、sheets、task、vc、wiki 等。

分页与大批量

需要拉全量列表时使用：--page-all，并用 --page-limit 限制页数，避免误扫全租户数据。

给 Agent 的提示

• 不确定路径或 body 时先 lark-cli schema ... 或 --dry-run。
• JSON 参数用单引号包裹，注意转义。
• 若执行报 command not found，在 shell 工具中使用 lark-cli 的绝对路径（本机常见为 nvm 下 ~/.nvm/versions/node/.../bin/lark-cli），或把该目录加入运行环境的 PATH。

官方「AI Agent Skills」包（可选）

仓库提供与 CLI 配套的说明包，可用官方命令安装到本机 skills 生态后，将生成内容同步到 ~/.openclaw/skills 或工作区 skills/（与 OpenClaw Skills 文档 一致）：

npx skills add larksuite/cli -g -y
# 或按领域：npx skills add larksuite/cli -s lark-calendar -y

若安装路径不在 OpenClaw 扫描目录内，可把该 skill 目录复制或软链到 ~/.openclaw/skills/。