OpenClaw 实操指南 08：飞书 CLI 命令速查表，办公效率直接拉满｜TaoToken 统一 Key 接入

1. 飞书 CLI 命令太多记不住先搞懂它到底能做什么如果你每天在飞书里发通知、建文档、查表格、拉群成员重复操作多了确实烦。飞书 CLI 就是把这些动作搬到终端里用一行命令替代十几次点击。它适合三类人做运维通知的、写自动化周报的、以及想让 AI Agent 直接操作飞书的开发者。OpenClaw 调用飞书 CLI 时本质上是把自然语言指令翻译成这些命令所以命令记得越熟Agent 执行越稳。我试过把日常办公里最高频的十几个操作整理成速查表配合 TaoToken 统一 Key 接入模型做意图解析基本能做到「说一句话终端跑一条命令飞书里出现结果」。下面按安装、IM、文档、表格、日历、任务、审批、通讯录、Skills、自动化组合十个场景展开每条命令都给出可复制片段和验证方式。先明确两个前提。第一命令里的xxx是占位符文末有获取指引。第二所有命令在终端执行需要 Node.js v14 以上。如果你还没装 Node去官网下 LTS 版本即可这里不展开。安装和登录是第一步也是后面所有命令能跑通的基础# 全局安装飞书 CLI npm install -g larksuite/cli # 首次登录按提示扫码 lark-cli config init # 确认版本排查兼容问题 lark-cli --version # 忘记命令时查全局帮助 lark-cli --help # 查某个模块的帮助比如 IM lark-cli im --help执行lark-cli config init后终端会弹出一个二维码用飞书扫一下授权即可。授权成功后你会看到当前登录用户的信息这一步没报错就说明 CLI 已经能正常调用飞书开放接口了。2. TaoToken 统一 Key 接入让 OpenClaw 稳定调用飞书 CLIOpenClaw 本身不直接执行飞书命令它需要一个大模型来理解你的自然语言再决定调用哪条 CLI。这里用 TaoToken 的统一 Key 接入好处是一个 Key 走通多个模型不用在 OpenClaw 里反复换配置。TaoToken 的 API 地址是https://taotoken.net/api官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。配置分两步先在 TaoToken 控制台创建 API Key再把它写进 OpenClaw 的模型配置。控制台入口在https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理页在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite。创建时给 Key 起个名字比如openclaw-feishu方便后面排查。拿到 Key 后OpenClaw 的模型配置通常是一个 JSON 或 TOML 文件。以 JSON 为例路径一般在~/.openclaw/config.json写入下面这段{ models: { default: { provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, model_id: claude-sonnet-4-20250514 } } }如果你用的是 TOML 格式等价写法是[models.default] provider taotoken base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_id claude-sonnet-4-20250514这里三件套必须齐全Base URL 填https://taotoken.net/apiKey 填你刚创建的Model ID 按你实际要用的模型填。Model ID 写错会直接报model not found所以复制时别手抖。配置改完重启 OpenClaw让它重新加载。如果你更习惯在 Claude Code 里做飞书命令的润色和补全可以在 Claude Code 的 settings 里指向同一个 Base URL 和 Key这样两套工具共用一份额度管理起来省事。Claude Code 的接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite里面有完整的 settings 片段。3. 可复制配置片段IM、文档、表格命令逐条拆解配置好模型后OpenClaw 就能把「给技术群发一条部署完成通知」翻译成lark-cli im messages send。下面按场景给出命令每条都标了参数含义你可以直接复制到终端验证。IM 消息和群聊是最高频的。发文本消息到指定群lark-cli im messages send --chat-id oc_xxx --text 部署完成版本 v2.3.1chat-id是群 ID获取方式见文末。如果你想发富文本卡片把--text换成--card并传入 JSON 文件路径即可。群管理方面拉人进群用lark-cli im chats members add --chat-id oc_xxx --user-ids ou_xxx踢人用remove子命令。文档操作适合自动生成周报。创建文档lark-cli docs create --title 2026-W13 周报 --folder-token fld_xxx获取文档内容用lark-cli docs get --doc-token dox_xxx更新用lark-cli docs update --doc-token dox_xxx --content 新内容。注意 update 是覆盖式原内容会被替换所以更新前建议先 get 一份备份。删除文档用lark-cli docs delete --doc-token dox_xxx移动文档用lark-cli docs move --doc-token dox_xxx --folder-token fld_xxx。多维表格是批量数据处理的主力。列出可访问的 Baselark-cli base apps list查字段用lark-cli base tables list --app-token app_xxx查记录用lark-cli base records list --app-token app_xxx --table-id tbl_xxx。新增记录时 fields 是 JSON 字符串lark-cli base records create --app-token app_xxx --table-id tbl_xxx --fields {姓名:张三,部门:技术部}修改记录加--record-id删除同理。这里有个坑fields 的键必须和表格字段名完全一致包括空格和大小写否则会报field not found。日历和任务命令适合做会议自动化。查今日日程lark-cli calendar events list --timerange today创建会议lark-cli calendar events create \ --title 技术评审会 \ --start 2026-03-30T10:00:0008:00 \ --end 2026-03-30T11:00:0008:00 \ --attendees user1example.com,user2example.com时间必须是 ISO 格式且带时区写成2026-03-30 10:00会解析失败。任务方面列未完成用lark-cli task list --completed false创建用lark-cli task create --summary 任务标题 --due 2026-03-31完成用lark-cli task complete --task-id tsk_xxx。审批和通讯录命令偏查询。审批实例列表lark-cli approval instances list审批定义lark-cli approval definitions list。通讯录里查当前用户lark-cli auth whoami查部门lark-cli contact departments list查部门下用户lark-cli contact users list --department-id od_xxx。Skills 模块前缀是npx和其他模块不同npx skills add larksuite/cli --all -g npx skills list npx skills remove larksuite/cli最后是两个自动化组合。导出今日未完成任务到文件lark-cli task list --completed false today-task.md再把文件内容发到群lark-cli im messages send --chat-id oc_xxx --text $(cat today-task.md)批量查部门用户并导出lark-cli contact users list --department-id od_xxx department-users.md4. 验证请求逐条命令跑通并核对输出配置写完不验证等于没配。下面给出一套最小验证流程按顺序执行每步都有预期输出。第一步确认 CLI 能连上飞书。执行lark-cli auth whoami正常会返回你的用户名、user_id 和邮箱。如果返回未授权说明登录失效重新跑lark-cli config init扫码。第二步验证 IM 发送。先找一个测试群拿到 chat-id执行lark-cli im messages send --chat-id oc_测试群ID --text CLI 连通性测试终端返回message_id且群里出现消息说明 IM 链路通了。如果返回chat not found检查 chat-id 是否复制完整群 ID 通常以oc_开头。第三步验证文档创建。执行lark-cli docs create --title CLI 测试文档 --folder-token fld_测试文件夹ID返回里会有doc_token复制它去浏览器打开能看到空文档就对了。如果报folder not found说明 folder-token 不对文件夹 ID 以fld_开头。第四步验证表格读取。执行lark-cli base apps list返回一个数组每个元素有app_token和name。挑一个 app_token再执行lark-cli base tables list --app-token app_xxx能看到表名和 table_id 就说明权限没问题。第五步验证 OpenClaw 端到端。在 OpenClaw 里输入「帮我查一下今天有哪些日程」它应该调用lark-cli calendar events list --timerange today并把结果返回给你。如果 OpenClaw 没反应先检查模型配置里的 Base URL 和 Key 是否正确再确认 CLI 本身能跑通。验证时建议开两个终端一个跑命令一个看 OpenClaw 日志。日志里会打印实际执行的命令对照本文的速查表就能定位是哪一步偏了。5. 常见报错排查401、local proxy failed、reading choices 怎么解报错一401 Unauthorized。这个分两种。如果是 CLI 报的说明飞书登录失效重新lark-cli config init。如果是 OpenClaw 调模型时报的说明 TaoToken Key 不对或过期去 API Keys 页面重新生成一个替换配置里的api_key。注意 Key 前面通常有sk-前缀别漏掉。报错二local proxy failed。这个一般出现在 OpenClaw 启动时说明它连不上https://taotoken.net/api。先确认网络能访问该地址再检查配置里 Base URL 有没有多写斜杠或少了https。如果用的是 TOML注意字符串要加引号。报错三error reading choices。这是模型返回格式不符合预期常见于 Model ID 写错或模型不支持当前调用方式。检查model_id是否和 TaoToken 文档里列的一致比如claude-sonnet-4-20250514不能写成claude-sonnet-4。改完重启 OpenClaw。报错四command not found: lark-cli。CLI 没装成功。重新执行npm install -g larksuite/cli如果还不行检查 Node.js 版本是否 v14用node -v确认。npm 全局路径没配好也会导致这个问题可以用npm config get prefix看路径把它加进 PATH。报错五OAuth token expired。飞书授权过期重新扫码即可。如果频繁过期检查系统时间是否准确时间偏差过大会导致 token 校验失败。报错六field not found。多维表格新增记录时 fields 的键和表格字段名不匹配。打开表格确认字段名注意中英文和空格。建议先用lark-cli base tables list拿到字段列表再拼 JSON。报错七permission denied。当前账号没有该操作的权限。比如删除文档需要文档所有者或管理员权限发消息需要群成员身份。换有权限的账号或让管理员开通。排查时记住一个原则先确认 CLI 单独能跑通再查 OpenClaw 配置。CLI 报错看飞书权限OpenClaw 报错看 TaoToken 配置。两边分开定位效率高很多。6. 把命令用起来OpenClaw TaoToken 的日常办公流命令速查表的价值在于用起来。我的做法是把高频组合写成 shell 脚本OpenClaw 只负责触发。比如每天早上九点自动跑一个脚本先lark-cli task list --completed false today-task.md再lark-cli im messages send --chat-id oc_xxx --text $(cat today-task.md)把今日任务推到工作群。脚本放在 crontab 里OpenClaw 不需要参与稳定且省 token。需要模型理解意图的场景才走 OpenClaw。比如你说「把上周的周报文档找出来发给我」OpenClaw 会先调lark-cli docs get拿内容再决定是直接返回还是发到某个群。这时候 TaoToken 的统一 Key 就体现出价值同一个 Key 既能跑意图解析又能跑内容摘要不用在多个平台之间切换。如果你要做长期编码或 Agent 类任务比如让 OpenClaw 持续监听飞书消息并自动回复建议用 Coding Plan入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite。它适合需要稳定长连接的场景比按次调用更划算。验证模型效果时可以直接在模型对话页测试意图解析准不准入口在https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite。输入「给技术群发一条部署完成通知」看它输出的命令是否和本文速查表一致。如果偏了调整系统提示词里的命令示例即可。最后提醒一句所有命令里的占位符都要替换成真实 ID。chat-id 在群设置最下方doc-token 在文档 URL 的/d/后面folder-token 在/f/后面app-token 在/app/后面table-id 在表格设置里user-id 在用户详情页的「更多」里department-id 用lark-cli contact departments list查。把这些 ID 存到一个.env文件里脚本里用变量引用比每次手填靠谱得多。