一、飞书 CLI 是什么？
飞书CLI 是飞书官方开源的命令行工具，它为 AI Agent 提供了连接飞书业务系统的标准化执行入口。接入后，Agent 不再停留在生成建议或输出文本的层面，而是可以直接读消息、查日历、写文档、建多维表格、发邮件，把任务真正落到飞书里完成。
从这个意义上说，飞书 CLI 解决的不是“再给 Agent 增加一个工具”，而是补上了 Agent 从理解到执行的关键一环，让 AI 能更自然地进入实际协作流程。
飞书 CLI 本质上是对飞书 OpenAPI 的 AI 友好型封装，不涉及界面模拟或 UI 自动化，不通过“模拟点击页面”的方式执行操作，而是在既有开放接口和权限边界内完成能力调用。其安全模型沿用飞书开放平台现有体系，不引入额外的 AI 专属扩权机制。
250px|700px|reset
核心安全原则：飞书 CLI 的权限边界与开放平台应用完全一致，仅能在已获授权范围内调用相关能力，无法绕过既有权限机制。
二、飞书 CLI 可以做什么？
飞书 CLI 支持 AI 在飞书内获取业务上下文并执行相应操作，当前能力已覆盖飞书多个核心业务域。对于企业用户而言，其核心价值在于，AI 不再仅提供建议，而是能够在授权范围内协助完成实际工作，从而提升流程衔接效率与日常办公体验。
业务域 | 支持的操作能力 | 典型使用场景 |
消息与群组 | 发送消息、创建群组、管理群成员、@提及、撤回消息 | 团队协作、通知推送、自动化提醒 |
云文档 | 创建文档、编辑内容、分享文档、管理权限、获取文档历史 | 文档协作、知识管理、内容创作 |
云空间 | 上传/下载文件、管理文件夹、分享文件链接、设置访问权限 | 文件存储与共享、资料归档 |
多维表格 | 创建表格/视图、增删改查记录、执行公式计算、管理字段 | 数据管理与分析、项目管理、信息收集 |
日历 | 创建/查询日程、查询成员空闲时间、发送/处理会议邀请 | 时间管理、会议安排、资源协调 |
视频会议 | 创建即时/预定会议、邀请成员、管理会议设置、获取录制链接 | 远程协作、线上培训、跨地域沟通 |
邮箱 | 发送/接收邮件、管理邮件草稿与文件夹、设置邮件规则 | 邮件沟通、客户跟进、通知分发 |
任务 | 创建任务、分配负责人、更新进度与状态、设置截止日期 | 项目管理、个人待办、进度跟踪 |
知识库 | 创建知识库节点、编辑文章、管理节点权限、搜索内容 | 知识沉淀、内部Wiki、新人入职指南 |
通讯录与搜索 | 查询用户/部门详情、搜索组织架构、验证用户身份 | 人员查找、组织信息查询、权限验证 |
能力边界明确：上表所列能力均需在飞书开放平台为对应应用申请并获得相应 scope 授权后，方可被 CLI 调用。
三、飞书CLI 身份认证与权限控制机制
飞书 CLI 基于OpenAPI 现有能力支持两种独立的工作模式，以适应不同场景的需求。
250px|700px|reset
权限控制核心：飞书 CLI 的权限以开放平台 scope 为原子边界。开发者需为应用申请相应能力，企业租户管理员对应用上线及权限申请进行最终审批。用户身份与应用身份相互独立，权限不互相继承。
250px|700px|reset
四、飞书CLI 安全控制与审计能力
飞书 CLI 统一纳入飞书开放平台治理体系，沿用所有现有安全控制与审计机制。
- 统一权限治理：无论是应用创建、能力申请还是接口调用，均遵循飞书开放平台管理机制。AI 可使用的权限上限，严格等同于应用获批的 scope 集合。
- 管理控制：企业租户管理员可在 飞书开放平台管理后台 对应用准入及每一项权限申请进行审批，从源头控制 CLI 可调用的能力范围。
- 完整操作审计：所有通过飞书 CLI 发起的 OpenAPI 调用，均会记录到飞书管理后台的 审计日志 中。企业管理员可按时间、用户、应用、操作类型等维度进行查询与追溯。
- 行为归属清晰：结合两种身份模式，审计日志能清晰区分“个人用户行为”与“应用自动化行为”，便于归因分析和安全事件调查。
无特殊通道：飞书 CLI 不存在 面向 AI Agent 的特殊权限通道或额外扩权机制。其安全性完全建立在飞书开放平台多年积累的成熟体系之上。
五、飞书CLI 安全体系迭代规划方向
飞书 CLI 的安全体系将持续迭代，从操作可追溯、权限精细化到资源级管控，分阶段构建更完善的 AI 操作安全治理框架。
六、飞书CLI 安全使用建议
为保障安全、稳妥地使用飞书 CLI，建议遵循以下最佳实践。
250px|700px|reset
七、常见问题
Q1：飞书 CLI 会绕过现有飞书权限体系吗？
不会。飞书 CLI 完全复用飞书开放平台现有安全模型，其权限边界与任何普通的开放平台应用一致，仅能在已获授权（scope）范围内调用相关能力，不存在任何绕过机制。
Q2：企业管理员是否可以管理 CLI 应用的权限？
完全可以。CLI 应用的本质仍是飞书开放平台应用。企业管理员可以通过开放平台管理后台，对应用的上线审批、权限申请进行全生命周期管理，规则与企业内其他所有应用一致。
Q3：用户身份模式与应用身份模式可以混用吗？
两种身份模式相互独立，一个 CLI 应用可以同时配置两种模式的凭证，但每次调用只能选择一种身份。权限不互通，用户模式下不能使用应用权限，反之亦然。开发者需根据每次操作的具体需求选择合适的身份。
Q4：飞书 CLI 的操作记录能否被审计？
可以。所有通过 CLI 发起的 API 调用，都会记录在飞书开放平台的审计日志中。企业管理员可以查询到详细的操作时间、执行者（用户或应用）、操作类型、目标资源等信息，满足安全合规与审计要求。
总结
飞书 CLI 通过提供 AI 友好的接口封装，在严格继承飞书开放平台成熟安全体系的前提下，开启了 AI 与飞书生态深度融合的新阶段。遵循最小权限、身份隔离和操作审计三大核心安全原则，企业可以安全、高效地利用 AI 能力提升办公自动化水平。
