1. 为什么你的 AI 助手还不会操作飞书很多人已经习惯让 AI 帮忙写代码、改文案但一旦涉及帮我在飞书发条消息查一下我明天的日程把这份数据写进表格AI 就只能礼貌地回一句我无法直接操作你的飞书。原因不复杂大模型本身没有手它需要一个能落地的执行通道而飞书开放平台虽然有 2500 个 API但直接让 AI 去调这些接口鉴权、参数拼装、错误处理每一步都可能翻车。飞书官方开源的 lark-cli 正好补上了这块。它把飞书开放平台的接口封装成终端里能直接敲的命令覆盖日历、消息、文档、表格、云空间、任务、知识库等 18 个业务域、200 条命令。再配合官方提供的 26 个 AI Agent SkillAI 助手就能读懂用户说帮我约个会背后该走哪条流程、该调哪个命令、参数怎么填。这篇指南聚焦一条完整链路安装 lark-cli、完成应用配置与用户授权、理解 Skill 的声明结构、把 AI 工具的模型通道统一接到 TaoToken 的 Key 上最后用一次真实的飞书消息发送验证整条链路是否跑通。适合正在做 AI Agent 落地、希望让助手真正动手操作飞书的开发者。全程命令可复制跟着做就能复现。2. 前置准备TaoToken 统一 Key 与飞书应用2.1 为什么要在这一层引入 TaoToken飞书 CLI 负责操作飞书但 AI 助手本身还需要一个模型通道来理解意图、生成命令。如果你同时用 Claude Code、Cursor、Codex 等多个工具每个工具单独配一套 Key 会很乱。TaoToken 提供统一的 API 通道一个 Key 就能给多个 AI 工具复用模型对话、编码计划、控制台管理都在同一套体系里。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址https://taotoken.net/api需要提前准备的东西不多一个能正常登录的飞书账号、Node.js 16 以上环境、以及从 TaoToken 控制台拿到的 API Key。飞书开放平台的应用不需要你手动去创建lark-cli 的交互式配置会引导你完成。2.2 拿到 TaoToken 的 API Key登录 TaoToken 控制台后进入 API Keys 页面创建一个新 Key。建议按用途命名比如feishu-agent方便后续在多个工具间区分。创建后立即复制保存页面刷新后完整 Key 不会再显示。控制台地址https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注意API Key 属于敏感凭证不要写进会提交到 Git 仓库的配置文件里。本地开发建议用环境变量或系统钥匙串保存。2.3 检查 Node.js 环境lark-cli 的安装依赖 npm/npx先确认版本node --version # 期望输出v16.x 及以上例如 v18.17.0 npm --version如果版本低于 16去 Node.js 官网下载 LTS 版本覆盖安装即可。Windows 用户用 PowerShell 或 Windows Terminal 都可以后续涉及 JSON 参数时注意引号转义差异第 5 节会专门讲。3. 可复制配置安装 lark-cli 并接入 TaoToken3.1 一行命令安装飞书 CLI打开终端执行npx larksuite/clilatest install这条命令会自动完成三件事下载对应平台的 lark-cli 二进制、安装到全局路径macOS/Linux 通常是/usr/local/bin、同时安装配套的 AI Agent Skill 文件。安装完成后验证lark-cli --version # 输出示例v1.0.78xxxxxxx看到版本号说明 CLI 本体就绪。再看一眼它支持哪些业务域lark-cli --help你会看到 approval、calendar、contact、docs、drive、im、mail、sheets、task 等一长串 domain这些就是飞书各业务模块对应的命令入口。3.2 配置飞书应用与用户授权CLI 装好还不能直接用需要让它知道以谁的身份调飞书接口。执行交互式配置lark-cli config init终端会引导你打开浏览器跳转到飞书开放平台创建自建应用自动获取 App ID 和 App Secret 并保存到本地。如果你已经有现成的应用凭证也可以选择手动填入。应用配置完成后还需要用户登录授权让应用拿到你的用户身份令牌lark-cli auth login --recommend--recommend会自动勾选日程、消息、文档、表格等常用权限范围省去逐项勾选。执行后浏览器会弹出授权页用飞书账号扫码或登录确认即可。验证登录状态lark-cli auth status显示已登录及授权权限列表说明飞书侧配置完成。3.3 在 AI 工具的 settings.json 中接入 TaoToken接下来把 AI 工具的模型通道指向 TaoToken。以 Claude Code 的settings.json为例配置片段如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥 } }如果你用的是其他支持自定义 Base URL 的 AI 工具思路一致把模型请求地址指向https://taotoken.net/api把鉴权 Token 换成 TaoToken 的 Key。这样 Claude Code、Cursor、Codex 等工具可以共用同一个 Key切换工具时不用重复申请。提示修改 settings.json 后需要重启 AI 工具才能生效。如果工具支持环境变量注入也可以把 Key 放在系统环境变量里配置文件只引用变量名。3.4 Skill 声明文件骨架Skill 是给 AI 看的操作手册本质是结构化的 Markdown 文件。lark-cli 安装时会自动装好官方 Skill如果你想自定义一个骨架大致长这样# Skill: lark-custom-notify ## 适用场景 用户要求向指定飞书群发送通知类消息。 ## 前置条件 - 已通过 lark-cli auth login 完成授权 - 已知目标群的 chat_idoc_ 开头 ## 执行步骤 1. 若用户未提供 chat_id先执行 lark-cli im chat-search --query 群名 2. 用 --dry-run 预览消息内容 3. 确认无误后执行 lark-cli im messages-send --chat-id oc_xxx --text 内容 ## 安全规则 - 写操作必须先 dry-run - 禁止向未确认的群发送消息AI Agent 在遇到飞书相关需求时会先读取对应 Skill 的 SKILL.md识别场景、路由命令、检查前置条件再执行。官方内置的 26 个 Skill 覆盖了日历、消息、文档、表格、任务、审批、OKR 等全部核心业务域日常场景基本不用自己写。4. 验证请求发一条真实的飞书消息配置是否真的通了发一条消息最直接。先找到目标群的 chat_idlark-cli im chat-search --query 产品周会返回结果里找到oc_开头的 chat_id。发送前先用 dry-run 预览lark-cli im messages-send --chat-id oc_xxxxxxxx --text 测试消息 --dry-rundry-run 会打印出即将发送的请求内容确认 chat_id 和文本无误后去掉--dry-run正式发送lark-cli im messages-send --chat-id oc_xxxxxxxx --text 大家好本周周会改到下午3点如果返回结果里包含 message_id并且你的飞书群里真的收到了这条消息说明整条链路——lark-cli 安装、应用配置、用户授权、命令执行——全部跑通。再验证一下 AI 侧是否接上了 TaoToken。在 Claude Code 里随便问一个需要模型推理的问题如果能正常返回说明模型通道也通了。此时你可以直接对 AI 说给产品周会群发一条通知它会读取 lark-im Skill自动调用 lark-cli 完成操作。5. 本篇常见错排查5.1 command not found: lark-cli安装后终端提示找不到命令通常是安装路径不在 PATH 里。macOS/Linux 检查/usr/local/bin是否在 PATH 中Windows 检查 npm 全局安装路径。也可以手动定位二进制文件位置把它加到 PATH。5.2 授权码已过期OAuth 授权链接有时效性通常几分钟。超时后重新执行lark-cli auth login --recommend即可不需要重新配置应用。5.3 调用 API 提示权限不足说明应用没有申请对应权限。去飞书开放平台找到你的应用在权限管理里申请对应权限并发布版本企业自建应用可能需要管理员审批然后重新执行lark-cli auth login授权。5.4 Windows PowerShell 里 JSON 参数报错PowerShell 对引号的处理和 bash 不同直接传 JSON 字符串容易出错。建议把 JSON 写到文件里用文件名方式传入lark-cli sheets cells-set --url ... --sheet-name Sheet1 --range A1:B2 --cells data.json5.5 TaoToken 请求返回鉴权失败先确认ANTHROPIC_AUTH_TOKEN填的是完整的 TaoToken Key没有多余空格或换行。再确认ANTHROPIC_BASE_URL是https://taotoken.net/api不要带路径后缀。如果仍然失败去 TaoToken 控制台检查 Key 是否被禁用或额度是否耗尽。5.6 AI 助手不调用 lark-cli先确认which lark-cli能找到命令再确认 Skill 已全局安装npx skills add larksuite/cli -y -g然后重启 AI 工具。部分工具需要显式开启 Skill 发现功能检查工具的配置项。6. 让 AI 真正替你操作飞书的下一步到这里飞书 CLI 的安装、应用配置、用户授权、Skill 声明、TaoToken 统一 Key 接入、真实消息发送验证整条链路已经完整跑通。你可以继续往下做的方向有几个一是把常用操作封装成自定义 Skill比如每周一自动汇总上周日程并发到群让 AI 按固定流程执行。二是把 TaoToken 的 Key 复用到更多 AI 工具上Claude Code 写代码、Cursor 改前端、Codex 跑脚本共用一套模型通道管理成本低很多。三是长期跑编码和 Agent 任务的话可以了解 Coding Plan按计划使用比单次调用更划算。模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Coding Plan 入口https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content我自己的习惯是任何写操作先 dry-run 跑一遍确认请求内容再正式执行。飞书 CLI 的--dry-run参数在消息发送、表格写入、文档创建这些场景都能用养成这个习惯能避开大部分误操作。另外授权权限按需开不要图省事全勾上用多少开多少定期用lark-cli auth status检查一遍当前授权范围。