Codex CLI 对接飞书 + 飞书文档实操记录(从零到可用)


Codex CLI 对接飞书 + 飞书文档实操记录(从零到可用)

最近我尝试把 Codex CLI 接入飞书,用来直接操作飞书文档、消息和日历。整个过程比我预期简单,基本 10 分钟内可以跑通。这里把完整过程整理一下,尽量写清楚每一步,方便后面复用。


一、环境准备

我先确认了以下几个基础环境:

  1. Codex CLI 已安装

    复制代码
    codex --version

    能正常输出版本号即可。如果没有安装:

    复制代码
    npm install -g @openai/codex
  2. Node.js

    • 版本 >= 16
  3. 飞书账号

    • 个人或企业都可以
  4. 可以正常打开终端

    • macOS(Terminal / iTerm)我是 Mac

    • Windows(CMD / PowerShell)

准备好之后,我直接进入 Codex:

复制代码
codex

二、让 Codex 自动安装飞书 CLI

这一部分我没有手动操作,而是直接让 Codex 帮我执行。

我在 Codex 里输入:

复制代码
请帮我安装飞书 CLI(lark-cli),并完成初始化和登录。

如果想更可控一点,可以明确步骤:

复制代码
1. npm install -g @larksuite/cli
2. npx skills add larksuite/cli -y -g
3. lark-cli config init --new
4. lark-cli auth login --recommend

实际执行过程

Codex 会逐步执行命令,中间有两个关键点:

1. 授权链接

在执行:

复制代码
lark-cli config init --new
lark-cli auth login --recommend

时,会输出一个链接。

我做的操作是:

  • 复制链接

  • 浏览器打开

  • 用飞书扫码登录

  • 点击"同意授权"

2. 权限选择

我这边选择的是:

  • 仅个人使用(避免权限过大)

授权完成后,Codex 会继续执行剩余步骤。

更简单的方法:

直接复制下面整段话,发给 Codex(在 codex 运行的终端里粘贴):按照步骤进行就可以了

复制代码
请立刻帮我安装飞书官方 CLI(lark-cli),让我可以直接操作飞书和飞书文档。

请严格按顺序执行以下步骤:

1. 运行命令:npm install -g @larksuite/cli

2. 运行命令:npx skills add larksuite/cli -y -g

3. 运行命令:lark-cli config init --new
   (这一步会输出授权链接,请把链接发给我,我会在浏览器里完成飞书授权)

4. 运行命令:lark-cli auth login --recommend
   (同样会输出授权链接,请发给我授权)

安装完成后,告诉我"安装完成",并显示 lark-cli --version 和 lark-cli auth status 的结果。

三、安装完成后的关键步骤(容易踩坑)

这里有一个必须做的动作,否则后面大概率用不了:

重启 Codex

我一开始没重启,结果一直调不到 CLI。

正确做法:

复制代码
# 退出
exit

# 重新进入
codex

四、验证是否成功

我在 Codex 里执行:

复制代码
运行 lark-cli auth status

如果看到:

  • 已登录

  • 有可用的 skills

说明已经接通成功。

第一个文档创建:


五、开始实际使用(飞书文档为主)

接下来就可以直接用自然语言操作飞书了,这部分是我觉得最有价值的地方。

1. 创建飞书文档

我测试用的是:

复制代码
帮我创建一个飞书文档,标题是"测试文档",内容:
# 本周工作
- 完成 Codex 接入
- 验证文档创建

实际效果:

  • 自动创建文档

  • Markdown 会被正确解析成飞书格式


2. 读取文档

复制代码
打开这个飞书文档链接:https://xxx,帮我总结内容

适合做:

  • 文档快速摘要

  • 长文档阅读


3. 修改文档

复制代码
把文档最后一段改成"总结:效率明显提升",并添加评论说明修改原因

这个能力比较关键,相当于:

  • 不只是读

  • 可以"改 + 留痕"


4. Markdown 转飞书文档

复制代码
把这段 Markdown 转成飞书文档,并优化排版

我测试下来:

  • 标题 / 列表 / 代码块都能正确转换

  • 比手动复制粘贴稳定很多


5. 自动审稿(比较实用)

复制代码
帮我检查这个文档的逻辑问题和错别字,并用评论标出来

这个在写 PRD 或方案时比较有用。


六、扩展能力(不止文档)

我顺便试了几个非文档能力:

  • 总结群消息

    复制代码
    帮我总结昨天飞书群的重要内容
  • 查日历

    复制代码
    看我下周哪天有空
  • 写多维表格

    复制代码
    新增一条记录:项目=Codex接入,负责人=我
  • 发邮件

    复制代码
    发一封会议纪要给某人

基本可以覆盖日常办公自动化。

  • 群消息总结

七、几个实际踩过的坑

1. 没反应

原因:

  • 没重启 Codex

解决:

  • 退出重新进

2. 授权失效

重新执行:

复制代码
lark-cli auth login --recommend

3. 权限不足

表现:

  • 某些操作失败

解决:

  • 按提示去飞书后台补权限

4. 不知道能干啥

直接让 Codex 执行:

复制代码
lark-cli help

八、我的整体结论

这套方案本质上是把:

飞书 = API 能力层
Codex = Agent 调度层

连接起来。

实际价值在于:

  • 减少手动操作(复制粘贴)

  • 把"写文档"变成"描述需求"

  • 可以进一步做自动化(例如自动生成周报)

如果只是轻度使用,已经足够提升效率;

如果做深一点,可以作为内部办公自动化的基础能力。


相关推荐
w3296362714 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
宝哥聊编程15 天前
主流 Agent 平台对比:Coze、Dify、飞书、扣子、OpenClaw 落地实操手册
前端·人工智能·飞书
guoran_shini17 天前
Agent系统服务化封装和IM接入
飞书
mudtools20 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
人工智能·ai·.net·飞书·agent
极致了20 天前
飞书插件、RPA、API三条路的真实分界线
飞书·rpa
玩泥巴的21 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
ai·.net·飞书·agent
玩泥巴的22 天前
一份声明,多份产物:飞书 SDK 的 AI 工具面是怎么生成的
ai·.net·飞书·agent
OpenPortal认证计费系统25 天前
基于 飞书认证 通过 华为、H3C 结合 OpenPortal认证计费系统 实现 网络准入 飞书授权 实名认证
华为·飞书·h3c·portal认证·openportal
前进的李工25 天前
飞书企业知识库设计+后端高频八股
数据库·redis·后端·mysql·性能优化·飞书·rag