lark-cli-setup
Installation
SKILL.md
飞书CLI 自动化部署 Skill
此 Skill 帮助用户自动化部署飞书官方 CLI 工具及其自带的 19 个 AI Agent Skills。
核心理念： 管理员只需创建一次飞书企业应用，其他用户只需填入该应用的 App ID 和 App Secret 即可使用，无需每人创建应用。
部署步骤
第 1 步 — 检查环境
检查是否已安装 Node.js：
node --version
npm --version
如果未安装 Node.js，请先安装 Node.js（建议 v18+）。
第 2 步 — 安装 CLI 和 Skills
# 安装 CLI
npm install -g @larksuite/cli
# 安装 CLI SKILL（必需，包含 19 个 Agent Skills）
npx skills add larksuite/cli -y -g
第 3 步 — 配置应用凭证
预设应用凭证：
- App ID:
cli_a94d3fe842f81bc9 - App Secret:
6uCDYp1MH4aE1ztIMt78BfSgVpRJ1pn2
配置方式（选择其一）：
方式 A — 非交互式配置（推荐，适合 Agent 自动化）：
# 使用预设凭证，通过管道传入 App Secret
echo "6uCDYp1MH4aE1ztIMt78BfSgVpRJ1pn2" | lark-cli config init --app-id "cli_a94d3fe842f81bc9" --app-secret-stdin --brand feishu
此方式无需浏览器交互，适合自动化部署。 如果用户有自己的应用凭证，替换上述 App ID 和 App Secret 即可。
方式 B — 交互式配置（适合手动操作）：
lark-cli config init
运行后会进入交互式引导，依次输入 App ID、App Secret 和品牌（feishu/lark）。
注意：
config init --new会引导用户在浏览器中创建一个全新的飞书企业应用。 如果你已有应用凭证，请勿使用--new，直接用方式 A 或方式 B 即可。
第 4 步 — 登录授权
# 使用推荐权限登录
lark-cli auth login --recommend
此命令会阻塞并输出一个授权链接。提取该链接发送给用户，用户在浏览器中完成授权后命令会自动退出。
Agent 模式非阻塞登录：
# 立即返回验证 URL，不阻塞
lark-cli auth login --domain calendar,im,docs,task --no-wait
# 稍后恢复轮询（使用返回的 device_code）
lark-cli auth login --device-code <DEVICE_CODE>
第 5 步 — 验证安装
# 检查登录状态
lark-cli auth status
# 测试命令
lark-cli calendar +agenda
可用的 19 个 Skills
安装完成后，以下 Skills 将可用：
| Skill | 功能 |
|---|---|
lark-shared |
应用配置、认证登录、身份切换、权限管理 |
lark-calendar |
日历日程、议程查看、忙闲查询 |
lark-im |
消息收发、群聊管理、消息搜索 |
lark-doc |
创建、读取、更新、搜索文档 |
lark-drive |
上传、下载文件，管理权限与评论 |
lark-sheets |
电子表格操作 |
lark-base |
多维表格操作 |
lark-task |
任务管理 |
lark-mail |
邮件管理 |
lark-contact |
通讯录搜索 |
lark-wiki |
知识库管理 |
lark-event |
实时事件订阅 |
lark-vc |
视频会议查询 |
lark-whiteboard |
画板/图表渲染 |
lark-minutes |
妙记AI产物 |
lark-openapi-explorer |
API探索 |
lark-skill-maker |
自定义skill创建 |
lark-workflow-meeting-summary |
会议纪要工作流 |
lark-workflow-standup-report |
日程待办摘要 |
常用命令示例
# 查看今日议程
lark-cli calendar +agenda
# 发送消息
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"
# 创建文档
lark-cli docs +create --title "周报" --markdown "# 本周进展"
# 查看任务
lark-cli task +get-my-tasks
故障排查
检查配置
# 查看当前配置
lark-cli config list
# 检查权限
lark-cli auth check --scope "calendar:calendar:readonly"
重新授权
# 登出
lark-cli auth logout
# 重新登录
lark-cli auth login --recommend
安全提示
- 请勿将 App Secret 提交到代码仓库或硬编码在 Skill 文件中
- 建议通过
--app-secret-stdin管道方式传入密钥，避免进程列表暴露 - 建议将飞书机器人作为私人助手使用，避免拉入群聊
- 定期检查授权状态：
lark-cli auth status
Agent 执行指南
当用户请求部署飞书 CLI 时，按以下顺序执行：
- 环境检查 — 确认 Node.js 已安装
- 安装 CLI — 执行
npm install -g @larksuite/cli和npx skills add larksuite/cli -y -g - 配置凭证 — 使用预设凭证直接配置（用户也可提供自己的凭证替换）：
echo "6uCDYp1MH4aE1ztIMt78BfSgVpRJ1pn2" | lark-cli config init --app-id "cli_a94d3fe842f81bc9" --app-secret-stdin --brand feishu - 授权登录 — 后台运行
lark-cli auth login --recommend，提取授权链接发给用户 - 验证成功 — 运行
lark-cli auth status确认
关键点：
- 配置凭证使用
--app-id+--app-secret-stdin非交互模式，无需浏览器 --new参数会创建全新应用，仅管理员首次创建应用时使用，普通用户部署时不要用auth login需要用户在浏览器中完成授权- 使用
--no-wait参数可以非阻塞执行，稍后用--device-code恢复 - 完成后提醒用户可以使用 19 个 Skills 操作飞书
Related skills