無料GitHub で公開

lark-cli

飞书官方 CLI 工具 (lark-cli)，在终端中操作飞书。覆盖消息、文档、多维表格、电子表格、日历、邮箱、任务、会议、审批等 12 大业务域，提供 200+ 命令。当需要通过 CLI 方式操作飞书（而非飞书 OAuth API）时使用此 Skill。

触发词："lark-cli"、"飞书CLI"、"飞书命令行"、"lark命令"。

适用场景： (1) 需要通过命令行执行飞书操作（发消息、查日程、读写文档等） (2) 需要批量操作飞书数据 (3) AI Agent 需要以用户/机器人身份调用飞书 API (4) 需要底层 API 调试或 schema 查询 (5) 用户提到 "lark-cli"、"飞书CLI"

pengfeiqiao/kunpeng

インストール方法を見る

含まれるファイル（200）

SKILL.md7.4 KB
lark-approval/SKILL.md1.7 KB
lark-attendance/SKILL.md1.6 KB
lark-base/references/dashboard-block-data-config.md12.0 KB
lark-base/references/examples.md3.1 KB
lark-base/references/formula-field-guide.md54.2 KB
lark-base/references/lark-base-advperm-disable.md2.1 KB
lark-base/references/lark-base-advperm-enable.md2.0 KB
lark-base/references/lark-base-base-copy.md2.7 KB
lark-base/references/lark-base-base-create.md2.4 KB
lark-base/references/lark-base-base-get.md975 B
lark-base/references/lark-base-cell-value.md4.5 KB
lark-base/references/lark-base-dashboard-arrange.md2.1 KB
lark-base/references/lark-base-dashboard-block-create.md3.6 KB
lark-base/references/lark-base-dashboard-block-delete.md1008 B
lark-base/references/lark-base-dashboard-block-get.md1.7 KB
lark-base/references/lark-base-dashboard-block-list.md1.5 KB
lark-base/references/lark-base-dashboard-block-update.md3.0 KB
lark-base/references/lark-base-dashboard-create.md1.7 KB
lark-base/references/lark-base-dashboard-delete.md1.0 KB
lark-base/references/lark-base-dashboard-get.md1.6 KB
lark-base/references/lark-base-dashboard-list.md1.5 KB
lark-base/references/lark-base-dashboard-update.md1.5 KB
lark-base/references/lark-base-dashboard.md10.8 KB
lark-base/references/lark-base-data-analysis-sop.md6.6 KB
lark-base/references/lark-base-data-query.md18.8 KB
lark-base/references/lark-base-field-create.md3.5 KB
lark-base/references/lark-base-field-delete.md1.3 KB
lark-base/references/lark-base-field-get.md904 B
lark-base/references/lark-base-field-list.md992 B
lark-base/references/lark-base-field-search-options.md1.2 KB
lark-base/references/lark-base-field-update.md6.5 KB
lark-base/references/lark-base-field.md1.3 KB
lark-base/references/lark-base-form-create.md2.5 KB
lark-base/references/lark-base-form-delete.md1.5 KB
lark-base/references/lark-base-form-get.md1.6 KB
lark-base/references/lark-base-form-list.md1.9 KB
lark-base/references/lark-base-form-questions-create.md4.4 KB
lark-base/references/lark-base-form-questions-delete.md1.8 KB
lark-base/references/lark-base-form-questions-list.md2.0 KB
lark-base/references/lark-base-form-questions-update.md2.8 KB
lark-base/references/lark-base-form-questions.md1.0 KB
lark-base/references/lark-base-form-update.md2.1 KB
lark-base/references/lark-base-form.md1.0 KB
lark-base/references/lark-base-history.md630 B
lark-base/references/lark-base-record-batch-create.md2.1 KB
lark-base/references/lark-base-record-batch-update.md2.1 KB
lark-base/references/lark-base-record-delete.md1.3 KB
lark-base/references/lark-base-record-history-list.md2.9 KB
lark-base/references/lark-base-record-share-link-create.md1.9 KB
lark-base/references/lark-base-record-upload-attachment.md1.6 KB
lark-base/references/lark-base-record-upsert.md2.3 KB
lark-base/references/lark-base-record.md2.6 KB
lark-base/references/lark-base-role-create.md3.3 KB
lark-base/references/lark-base-role-delete.md2.1 KB
lark-base/references/lark-base-role-get.md2.7 KB
lark-base/references/lark-base-role-list.md2.4 KB
lark-base/references/lark-base-role-update.md2.8 KB
lark-base/references/lark-base-shortcut-field-properties.md11.6 KB
lark-base/references/lark-base-table-create.md1.7 KB
lark-base/references/lark-base-table-delete.md1.3 KB
lark-base/references/lark-base-table-get.md1.3 KB
lark-base/references/lark-base-table-list.md948 B
lark-base/references/lark-base-table-update.md1004 B
lark-base/references/lark-base-table.md1.0 KB
lark-base/references/lark-base-view-create.md1.4 KB
lark-base/references/lark-base-view-delete.md976 B
lark-base/references/lark-base-view-get-card.md791 B
lark-base/references/lark-base-view-get-filter.md797 B
lark-base/references/lark-base-view-get-group.md794 B
lark-base/references/lark-base-view-get-sort.md791 B
lark-base/references/lark-base-view-get-timebar.md806 B
lark-base/references/lark-base-view-get-visible-fields.md684 B
lark-base/references/lark-base-view-get.md794 B
lark-base/references/lark-base-view-list.md957 B
lark-base/references/lark-base-view-rename.md932 B
lark-base/references/lark-base-view-set-card.md1.2 KB
lark-base/references/lark-base-view-set-filter.md4.3 KB
lark-base/references/lark-base-view-set-group.md1.7 KB
lark-base/references/lark-base-view-set-sort.md1.5 KB
lark-base/references/lark-base-view-set-timebar.md1.4 KB
lark-base/references/lark-base-view-set-visible-fields.md1.3 KB
lark-base/references/lark-base-view.md2.6 KB
lark-base/references/lark-base-workflow-create.md7.8 KB
lark-base/references/lark-base-workflow-disable.md2.8 KB
lark-base/references/lark-base-workflow-enable.md2.8 KB
lark-base/references/lark-base-workflow-get.md5.5 KB
lark-base/references/lark-base-workflow-guide.md22.3 KB
lark-base/references/lark-base-workflow-list.md4.3 KB
lark-base/references/lark-base-workflow-schema.md33.0 KB
lark-base/references/lark-base-workflow-update.md6.6 KB
lark-base/references/lark-base-workflow.md1.7 KB
lark-base/references/lark-base-workspace.md684 B
lark-base/references/lookup-field-guide.md18.2 KB
lark-base/references/role-config.md19.9 KB
lark-base/SKILL.md36.1 KB
lark-calendar/references/lark-calendar-agenda.md2.3 KB
lark-calendar/references/lark-calendar-create.md5.0 KB
lark-calendar/references/lark-calendar-freebusy.md3.8 KB
lark-calendar/references/lark-calendar-room-find.md9.1 KB
lark-calendar/references/lark-calendar-rsvp.md1.3 KB
lark-calendar/references/lark-calendar-schedule-meeting.md18.4 KB
lark-calendar/references/lark-calendar-suggestion.md7.0 KB
lark-calendar/references/lark-calendar-update.md6.3 KB
lark-calendar/SKILL.md14.0 KB
lark-contact/references/lark-contact-get-user.md625 B
lark-contact/references/lark-contact-search-user.md5.3 KB
lark-contact/SKILL.md2.4 KB
lark-doc/references/lark-doc-create.md20.2 KB
lark-doc/references/lark-doc-fetch.md8.4 KB
lark-doc/references/lark-doc-md.md5.0 KB
lark-doc/references/lark-doc-media-download.md2.1 KB
lark-doc/references/lark-doc-media-insert.md2.2 KB
lark-doc/references/lark-doc-media-preview.md1.6 KB
lark-doc/references/lark-doc-search.md14.4 KB
lark-doc/references/lark-doc-update.md12.3 KB
lark-doc/references/lark-doc-whiteboard.md5.0 KB
lark-doc/references/lark-doc-xml.md8.1 KB
lark-doc/references/style/lark-doc-create-workflow.md3.6 KB
lark-doc/references/style/lark-doc-style.md6.7 KB
lark-doc/references/style/lark-doc-update-workflow.md7.6 KB
lark-doc/SKILL.md11.1 KB
lark-drive/references/lark-drive-add-comment.md9.5 KB
lark-drive/references/lark-drive-apply-permission.md3.5 KB
lark-drive/references/lark-drive-create-folder.md3.5 KB
lark-drive/references/lark-drive-create-shortcut.md4.2 KB
lark-drive/references/lark-drive-delete.md2.6 KB
lark-drive/references/lark-drive-download.md755 B
lark-drive/references/lark-drive-export-download.md1.5 KB
lark-drive/references/lark-drive-export.md3.5 KB
lark-drive/references/lark-drive-import.md8.5 KB
lark-drive/references/lark-drive-move.md4.5 KB
lark-drive/references/lark-drive-pull.md7.6 KB
lark-drive/references/lark-drive-push.md14.0 KB
lark-drive/references/lark-drive-reactions.md6.1 KB
lark-drive/references/lark-drive-search.md14.5 KB
lark-drive/references/lark-drive-status.md7.3 KB
lark-drive/references/lark-drive-task-result.md9.2 KB
lark-drive/references/lark-drive-upload.md4.9 KB
lark-drive/SKILL.md22.9 KB
lark-event/references/lark-event-im.md4.2 KB
lark-event/SKILL.md7.5 KB
lark-im/references/lark-im-chat-create.md7.8 KB
lark-im/references/lark-im-chat-identity.md3.1 KB
lark-im/references/lark-im-chat-list.md4.6 KB
lark-im/references/lark-im-chat-messages-list.md7.4 KB
lark-im/references/lark-im-chat-search.md7.0 KB
lark-im/references/lark-im-chat-update.md3.2 KB
lark-im/references/lark-im-flag-cancel.md2.7 KB
lark-im/references/lark-im-flag-create.md2.6 KB
lark-im/references/lark-im-flag-list.md3.8 KB
lark-im/references/lark-im-messages-mget.md3.4 KB
lark-im/references/lark-im-messages-reply.md10.7 KB
lark-im/references/lark-im-messages-resources-download.md4.7 KB
lark-im/references/lark-im-messages-search.md11.2 KB
lark-im/references/lark-im-messages-send.md11.8 KB
lark-im/references/lark-im-reactions.md9.7 KB
lark-im/references/lark-im-threads-messages-list.md4.7 KB
lark-im/SKILL.md11.1 KB
lark-mail/references/lark-mail-decline-receipt.md4.0 KB
lark-mail/references/lark-mail-draft-create.md7.5 KB
lark-mail/references/lark-mail-draft-edit.md16.8 KB
lark-mail/references/lark-mail-forward.md11.5 KB
lark-mail/references/lark-mail-message.md9.5 KB
lark-mail/references/lark-mail-messages.md4.3 KB
lark-mail/references/lark-mail-reply-all.md10.5 KB
lark-mail/references/lark-mail-reply.md12.2 KB
lark-mail/references/lark-mail-send-receipt.md6.0 KB
lark-mail/references/lark-mail-send.md11.6 KB
lark-mail/references/lark-mail-share-to-chat.md3.0 KB
lark-mail/references/lark-mail-signature.md2.7 KB
lark-mail/references/lark-mail-template-create.md5.6 KB
lark-mail/references/lark-mail-template-update.md5.8 KB
lark-mail/references/lark-mail-thread.md4.2 KB
lark-mail/references/lark-mail-triage.md5.2 KB
lark-mail/references/lark-mail-watch.md4.8 KB
lark-mail/SKILL.md38.1 KB
lark-markdown/references/lark-markdown-create.md2.8 KB
lark-markdown/references/lark-markdown-fetch.md1.7 KB
lark-markdown/references/lark-markdown-overwrite.md2.2 KB
lark-markdown/SKILL.md2.1 KB
lark-minutes/references/lark-minutes-download.md5.6 KB
lark-minutes/references/lark-minutes-search.md11.1 KB
lark-minutes/references/lark-minutes-upload.md4.3 KB
lark-minutes/SKILL.md10.1 KB
lark-okr/references/lark-okr-contentblock.md9.3 KB
lark-okr/references/lark-okr-cycle-detail.md2.5 KB
lark-okr/references/lark-okr-cycle-list.md3.7 KB
lark-okr/references/lark-okr-entities.md20.1 KB
lark-okr/references/lark-okr-image-upload.md3.4 KB
lark-okr/references/lark-okr-progress-create.md5.1 KB
lark-okr/references/lark-okr-progress-delete.md1.4 KB
lark-okr/references/lark-okr-progress-get.md2.1 KB
lark-okr/references/lark-okr-progress-list.md3.2 KB
lark-okr/references/lark-okr-progress-update.md7.6 KB
lark-okr/SKILL.md6.1 KB
lark-openapi-explorer/SKILL.md4.8 KB
lark-shared/SKILL.md6.0 KB
lark-sheets/references/lark-sheets-cell-data.md5.3 KB
lark-sheets/references/lark-sheets-cell-images.md1.8 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

飞书官方 CLI (lark-cli)

版本: 1.0.3 | 仓库: https://github.com/larksuite/cli | 协议: MIT

安装与配置

# 安装（已完成）
npm install -g @larksuite/cli

# 调用方式
npx lark-cli <command>

初始配置（仅需一次）

# 1. 配置应用凭证（后台运行，会输出授权链接发给用户）
npx lark-cli config init --new

# 2. 登录授权（后台运行，会输出授权链接发给用户）
npx lark-cli auth login --recommend

# 3. 验证状态
npx lark-cli auth status

身份切换

所有命令支持 --as user 或 --as bot 切换身份：

npx lark-cli calendar +agenda --as user
npx lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello"

三层命令体系

层级	前缀	说明	示例
快捷命令	`+`	人机友好，智能默认值	`lark-cli calendar +agenda`
API 命令	无	平台同步，精选 100+	`lark-cli calendar calendars list`
通用调用	`api`	全 API 覆盖 2500+	`lark-cli api GET /open-apis/...`

核心命令速查

📅 日历 (calendar)

npx lark-cli calendar +agenda                          # 今日日程
npx lark-cli calendar +create --summary "会议"          # 创建日程
npx lark-cli calendar +freebusy --user-ids "ou_xxx"    # 忙闲查询
npx lark-cli calendar calendars list                     # 日历列表

💬 即时通讯 (im)

npx lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"
npx lark-cli im +messages-send --open-id "ou_xxx" --text "私聊"
npx lark-cli im chats list                              # 群列表
npx lark-cli im +messages-list --chat-id "oc_xxx"       # 消息列表
npx lark-cli im +messages-search --query "关键词"        # 搜索消息
npx lark-cli im +resource-download --message-id "om_xxx" --file-key "img_xxx" --type image

📄 文档 (docs)

npx lark-cli docs +create --title "标题" --markdown "# 内容"
npx lark-cli docs +read --doc-id "doc_xxx"
npx lark-cli docs +update --doc-id "doc_xxx" --markdown "# 新内容"
npx lark-cli docs +search --query "关键词"

📁 云空间 (drive)

npx lark-cli drive files list --folder-token ""
npx lark-cli drive files upload --file-path "/local/file.pdf"
npx lark-cli drive files download --file-token "xxx" --output-path "/local/"

📊 多维表格 (base)

npx lark-cli base +tables-list --app-token "xxx"
npx lark-cli base +records-list --app-token "xxx" --table-id "xxx"
npx lark-cli base +records-create --app-token "xxx" --table-id "xxx" --fields '{"字段":"值"}'

📈 电子表格 (sheets)

npx lark-cli sheets +read --spreadsheet-token "xxx"
npx lark-cli sheets +write --spreadsheet-token "xxx" --values '[[1,2],[3,4]]'
npx lark-cli sheets +append --spreadsheet-token "xxx" --values '[[5,6]]'
npx lark-cli sheets +export --spreadsheet-token "xxx" --format xlsx

✅ 任务 (task)

npx lark-cli task +tasks-list
npx lark-cli task +create --summary "任务标题"
npx lark-cli task +update --task-guid "xxx" --completed true

📚 知识库 (wiki)

npx lark-cli wiki spaces list
npx lark-cli wiki nodes list --space-id "xxx"
npx lark-cli wiki nodes get --token "xxx"

👤 通讯录 (contact)

npx lark-cli contact +search-user --query "姓名"
npx lark-cli contact +get-user --user-id "ou_xxx"

📧 邮箱 (mail)

npx lark-cli mail +list
npx lark-cli mail +search --query "关键词"
npx lark-cli mail +send --to "user@example.com" --subject "标题" --body "内容"

✍️ 审批 (approval)

npx lark-cli approval +list-tasks
npx lark-cli approval +approve --instance-id "xxx"
npx lark-cli approval +reject --instance-id "xxx"

通用参数

--format json|pretty|table|ndjson|csv   # 输出格式（默认 json）
--page-all                               # 自动翻页获取所有数据
--page-limit N                           # 最多 N 页
--dry-run                                # 预览请求，不实际执行
--no-wait                                # Agent 模式，立即返回不阻塞

Schema 查询（探索 API）

npx lark-cli schema                          # 所有 API
npx lark-cli schema calendar.events.create   # 指定 API 详情

通用 API 调用

npx lark-cli api GET /open-apis/calendar/v4/calendars
npx lark-cli api POST /open-apis/im/v1/messages \
  --params '{"receive_id_type":"chat_id"}' \
  --body '{"receive_id":"oc_xxx","msg_type":"text","content":"{\"text\":\"Hello\"}"}'

多维表格 (base) 完整命令

# 字段管理
lark-cli base +field-create --base-token <token> --table-id <tid> --json '{"type":"text","name":"字段名"}'
lark-cli base +field-list --base-token <token> --table-id <tid>

# 记录管理
lark-cli base +record-get --base-token <token> --table-id <tid> --record-id <rid>
lark-cli base +record-list --base-token <token> --table-id <tid> --limit 50
lark-cli base +record-upsert --base-token <token> --table-id <tid> --record-id <rid> --json '{"字段":"值"}'
lark-cli base +record-batch-create --base-token <token> --table-id <tid> --json '{"fields":["f1","f2"],"rows":[["v1","v2"]]}'
lark-cli base +record-delete --base-token <token> --table-id <tid> --record-id <rid> --yes

# 附件管理
lark-cli base +record-upload-attachment --base-token <token> --table-id <tid> --record-id <rid> --field-id <fid> --file "filename.png"

常见陷阱

1. 参数名是 `--base-token`，不是 `--base`

# ❌ lark-cli base +record-list --base xxx
# ✅ lark-cli base +record-list --base-token xxx

2. `--name` 参数已废弃

上传附件时不传 --name，文件名自动使用本地文件名。

3. 附件上传必须用相对路径

必须先 cd 到文件目录，再用 --file "filename.png"（不要用绝对路径）。

4. upsert 的行为差异

带 --record-id → 更新已有记录
不带 --record-id → 创建新记录

5. Python subprocess 的 PATH 问题

lark-cli 是 Node.js 脚本，子进程不继承 shell 环境。必须传 PATH：

import os
env = os.environ.copy()
env['PATH'] = '/opt/homebrew/bin:' + env.get('PATH', '')
subprocess.run(["lark-cli", ...], env=env)

6. 删除必须加 `--yes`

不加会阻塞等待交互确认，在脚本/子进程场景会挂起。

注意事项

安全：操作会以用户身份执行，写操作前建议先用 --dry-run 预览
超时：CLI 命令建议设置 timeout=30，批量操作设 timeout=120
授权：首次使用需完成 config init + auth login，结果存储在系统密钥链中
环境：不需要额外 API Key，通过 OAuth 登录获取权限

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ