LarkSuite CLI – 飞书命令行工具

飞书（LarkSuite）官方命令行工具，让您通过终端管理飞书资源、自动化工作流、开发机器人应用。

---

✨ 主要功能

🚀 快速开始

安装 LarkSuite CLI：

macOS：

brew install larksuite/tap/lark

Linux：

curl -fsSL https://cdn.jsdelivr.net/gh/larksuite/cli@main/install.sh | bash

Windows：

irm https://cdn.jsdelivr.net/gh/larksuite/cli@main/install.ps1 | iex

验证安装：

lark --version

🔐 认证登录

登录您的飞书账户：

lark login

这将打开浏览器，让您授权访问。授权完成后，CLI 将自动保存令牌。

使用企业自建应用登录：

lark login --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

📋 机器人管理

列出所有机器人：

lark bot list

创建新机器人：

lark bot create --name "我的机器人" --description "这是一个测试机器人"

查看机器人详情：

lark bot get BOT_ID

更新机器人配置：

lark bot update BOT_ID --name "新名称" --description "新描述"

删除机器人：

lark bot delete BOT_ID

📨 消息发送

发送文本消息：

lark message send --user-id USER_ID --text "你好，这是一条测试消息"

发送富文本消息：

lark message send --user-id USER_ID --rich-text '{"title":"标题","content":"内容"}'

发送卡片消息：

lark message send --user-id USER_ID --card @card.json

发送群消息：

lark message send --chat-id CHAT_ID --text "大家好！"

📊 多维表格

列出所有多维表格：

lark bitable list

创建新的多维表格：

lark bitable create --name "项目管理" --folder-token FOLDER_TOKEN

获取表格数据：

lark bitable records list --app-token APP_TOKEN --table-id TABLE_ID

添加记录：

lark bitable records create --app-token APP_TOKEN --table-id TABLE_ID --fields @record.json

批量导入数据：

lark bitable records import --app-token APP_TOKEN --table-id TABLE_ID --file data.csv

📁 云文档

列出文档：

lark doc list

创建新文档：

lark doc create --title "会议纪要" --folder-token FOLDER_TOKEN

获取文档内容：

lark doc get DOC_TOKEN

导出文档：

lark doc export DOC_TOKEN --format pdf --output document.pdf

👥 用户管理

获取用户信息：

lark user get USER_ID

搜索用户：

lark user search --query "张三"

列出部门用户：

lark user list --department-id DEPARTMENT_ID

📅 日历管理

列出日历事件：

lark calendar event list --calendar-id CALENDAR_ID

创建日历事件：

lark calendar event create --calendar-id CALENDAR_ID --title "团队会议" --start-time "2024-01-01T10:00:00+08:00" --end-time "2024-01-01T11:00:00+08:00"

删除日历事件：

lark calendar event delete --calendar-id CALENDAR_ID --event-id EVENT_ID

---

🔧 高级功能

🤖 机器人开发

初始化机器人项目：

lark bot init --name my-bot --template echo

本地运行机器人：

lark bot dev

部署机器人：

lark bot deploy

📦 应用管理

创建应用：

lark app create --name "我的应用"

发布应用：

lark app publish --app-id APP_ID

🔌 Webhook 管理

列出 Webhook：

lark webhook list

创建 Webhook：

lark webhook create --url "https://example.com/webhook" --events "im.message.receive_v1"

删除 Webhook：

lark webhook delete WEBHOOK_ID

---

📝 配置管理

查看配置：

lark config list

设置配置：

lark config set log.level debug

清除配置：

lark config unset log.level

导出配置：

lark config export --output config.json

导入配置：

lark config import --file config.json

---

🎯 使用场景

自动化工作流

示例：每天自动发送日报

#!/bin/bash
lark message send --chat-id CHAT_ID --text "$(date +%Y-%m-%d) 日报：n$(cat daily-report.txt)"

设置定时任务：

# crontab -e
0 18 * * * /path/to/send-daily-report.sh

批量操作

示例：批量导入用户

lark user batch-import --file users.csv

示例：批量发送消息

for user_id in $(cat user-list.txt); do
  lark message send --user-id "$user_id" --text "节日祝福！"
done

数据同步

示例：同步多维表格到数据库

lark bitable records list --app-token APP_TOKEN --table-id TABLE_ID --output json | python3 sync-to-db.py

---

🔐 安全最佳实践

1. 使用环境变量存储敏感信息

   export LARK_APP_ID=your_app_id
   export LARK_APP_SECRET=your_app_secret
   lark login --app-id "$LARK_APP_ID" --app-secret "$LARK_APP_SECRET"

2. 定期轮换令牌

   lark logout
   lark login

3. 限制权限范围
   使用最小权限原则，只申请必要的权限。

---

📚 更多资源

• 官方文档： https://open.feishu.cn/document
• API 参考： https://open.feishu.cn/document/server-docs/api-call-guide/api-list
• 问题反馈： https://github.com/larksuite/cli/issues
• 社区讨论： https://github.com/larksuite/cli/discussions

---

📄 许可证

MIT License

---

整理基于飞书 CLI 官方文档和常见使用场景