我让 Codex 直接安装飞书 CLI，并把 Excel 生成线上多维表格

先说结论#

这次最终跑通了这些东西：

• 安装了飞书 CLI：lark-cli
• 安装了飞书 Agent Skills：lark-doc、lark-sheets、lark-base 等 26 个
• 完成了飞书 CLI 应用配置
• 跑通了 lark-cli doctor
• 把本地 .xlsx 导入成飞书在线表格
• 又按要求导入成飞书多维表格

最后生成的多维表格链接形态是：

1
https://xxx.feishu.cn/base/xxxxxxxxxxxxxxxx

也就是说，整个流程可以概括成：

1
给 Codex 官方文档链接
2
-> Codex 安装飞书 CLI
3
-> 用户在浏览器里授权
4
-> Codex 验证安装
5
-> 用户给 Excel 文件
6
-> Codex 导入飞书线上文档

飞书 CLI 是什么？#

飞书 CLI 是飞书开放平台提供的命令行工具，命令名叫：

1
lark-cli

它的作用不是“打开飞书客户端”，而是让本地电脑可以通过命令行调用飞书开放平台能力。

它能做的事情包括：

• 上传本地文件到飞书云空间
• 把 Word、Excel、PPT 导入成飞书在线文档
• 把 Excel 导入成飞书表格
• 把 Excel 导入成飞书多维表格
• 读取和写入飞书表格
• 操作文档、云盘、知识库、日历、消息、任务等
• 配合 Codex 这类 AI Agent 做自动化办公

如果说飞书网页端适合人手动点点点，飞书 CLI 更适合让 AI 或脚本来自动处理。

比如这次我给了一个 Excel，最后 Codex 就能帮我生成飞书多维表格链接。

飞书 CLI 和 Skill 是一回事吗？#

不是。

这次过程中我问了 Codex 一句：

1
这个是skill吗

它解释得比较清楚：

• lark-cli 本身是飞书命令行工具，不是 skill
• larksuite/cli Agent Skills 是给 Codex、Claude Code 这类 AI Agent 使用的技能说明

可以这样理解：

1
lark-cli：真正执行飞书操作的工具
2
Agent Skills：让 Codex 更懂飞书 API 和飞书 CLI 的使用方式

所以一套完整体验里，两者最好都装：

• 装 lark-cli，让电脑能操作飞书
• 装飞书 skills，让 Codex 更会用它

第一步：把官方文档链接直接发给 Codex#

我的第一条消息是：

1
# 飞书
2
帮我安装飞书 CLI: https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md

这里最重要的是：不要只说“帮我装一下”，最好把官方文档链接也给它。

这样 Codex 会先打开文档确认当前安装方式，而不是凭旧记忆乱猜。

在这次操作里，Codex 先确认了文档里的核心步骤：

• 全局安装 @larksuite/cli
• 安装飞书 CLI 的 Agent Skills
• 使用 lark-cli config init --new 初始化配置
• 通过浏览器完成飞书授权
• 使用 lark-cli doctor 做健康检查

第二步：Codex 检查本机 Node 和 npm#

飞书 CLI 通过 npm 安装，所以 Codex 先检查了本机有没有 Node.js 和 npm。

它执行了类似命令：

1
node --version
2
npm --version
3
lark-cli --version

当时结果是：

1
node: v22.22.0
2
npm: 10.9.4
3
lark-cli: 未安装

这一步的意义是：先确认地基。

如果你的电脑没有 Node.js，Codex 一般会提醒你先安装 Node.js；如果已经有，就可以继续自动安装飞书 CLI。

第三步：Codex 安装飞书 CLI#

确认环境没问题后，Codex 执行了：

1
npm install -g @larksuite/cli

安装完成后，它继续验证：

1
lark-cli --version
2
lark-cli --help

这次得到的版本是：

1
lark-cli version 1.0.43

lark-cli --help 里可以看到很多飞书能力入口，比如：

• drive
• sheets
• base
• docs
• wiki
• calendar
• im
• task
• approval

看到这些，就说明 CLI 本体已经装好了。

第四步：Codex 安装飞书 Agent Skills#

接着 Codex 安装了飞书的 Agent Skills：

1
npx skills add larksuite/cli -g -y

安装结果显示：

1
Found 26 skills
2
Installing all 26 skills
3
Done!

这些 skill 被安装到了类似目录：

1
C:\Users\你的用户名\.agents\skills

里面包括：

1
lark-approval
2
lark-apps
3
lark-base
4
lark-calendar
5
lark-contact
6
lark-doc
7
lark-drive
8
lark-im
9
lark-sheets
10
lark-slides
11
lark-task
12
lark-wiki
13
...

这一步完成后，Codex 后续就更容易理解飞书文档、表格、多维表格这些操作。

第五步：初始化飞书 CLI 配置#

CLI 装好以后，还不能直接操作你的飞书空间。

它需要先在飞书开放平台创建或绑定一个应用。

Codex 执行了：

1
lark-cli config init --new --lang zh_cn

这个命令会生成一个浏览器验证链接，类似：

1
https://open.feishu.cn/page/cli?user_code=XXXX-XXXX&lpv=1.0.43&ocv=1.0.43&from=cli

这一步需要用户配合。

Codex 可以帮你打开链接，但飞书登录、确认授权、应用配置这些动作，需要你自己在浏览器里点完。

我当时完成网页授权后，只回复了一句：

1
完成了

Codex 就继续检查配置结果。

第六步：Codex 做健康检查#

授权完成后，Codex 运行：

1
lark-cli doctor

当时检查结果里关键项是：

1
{
2
  "ok": true,
3
  "workspace": "local"
4
}

并且显示：

1
cli_version: pass
2
config_file: pass
3
app_resolved: pass
4
bot_identity: pass
5
endpoint_open: pass
6
endpoint_mcp: pass

这里有一个小细节：user_identity 当时是 missing。

这不是失败。

它表示还没有登录个人用户身份，但 bot 身份已经 ready，可以进行不少机器人或租户 API 调用。

如果后面要访问个人账号拥有的文档，或者希望新建文档自动归到个人权限下，可以再运行：

1
lark-cli auth login

第七步：我给 Codex 一个 Excel 文件#

CLI 安装好以后，我给了 Codex 一个本地 Excel 文件路径：

1
D:/softWare/weChatData/documents/xwechat_files/.../专家中心分工表.xlsx

然后我说：

1
好的，我给你一个xlsx，你给我弄成飞书线上的并给我链接

Codex 先做了两件事：

1. 检查这个文件是否存在、大小是多少
2. 查看 lark-cli drive 和 lark-cli sheets 的相关命令

文件很小，只有几 KB，所以适合直接导入。

第八步：第一次导入时遇到路径限制#

Codex 一开始尝试直接传绝对路径，结果飞书 CLI 返回：

1
unsafe file path: --file must be a relative path within the current directory

这句话的意思是：为了安全，--file 不能随便传当前目录外的绝对路径。

解决方式很简单：切换到 Excel 文件所在目录，再用相对路径。

比如：

1
cd "D:\softWare\weChatData\documents\xwechat_files\...\2026-05"

然后：

1
lark-cli drive +import --as bot --file ".\专家中心分工表.xlsx" --type sheet --name "专家中心分工表"

这个细节很重要。小白如果自己操作，很容易卡在这里。

第九步：第一次导入时遇到飞书权限不足#

导入过程中，又遇到一个飞书开放平台权限问题：

1
App scope not enabled: required scope docs:document.media:upload

这表示当前 CLI 创建的飞书应用还没有“上传媒体文件用于导入文档”的权限。

好在 CLI 会给出一个权限申请链接，类似：

1
https://open.feishu.cn/page/scope-apply?clientID=cli_xxx&scopes=docs%3Adocument.media%3Aupload

Codex 直接帮我打开了这个页面。

我在浏览器里启用权限后，回复：

1
可以了

然后 Codex 继续重试导入。

第十步：先生成了飞书在线表格#

补完权限后，Codex 成功把 Excel 导入成飞书表格。

命令类似：

1
lark-cli drive +import --as bot --file ".\专家中心分工表.xlsx" --type sheet --name "专家中心分工表"

成功结果里会有：

1
{
2
  "ok": true,
3
  "data": {
4
    "type": "sheet",
5
    "token": "xxxxxxxxxxxxxxxx",
6
    "url": "https://xxx.feishu.cn/sheets/xxxxxxxxxxxxxxxx"
7
  }
8
}

这里 /sheets/ 开头的链接就是飞书在线表格。

但我后面发现，我要的不是普通表格，而是多维表格。

于是我又对 Codex 说：

1
你给我创建成多维表格

第十一步：重新导入成飞书多维表格#

Codex 没有覆盖前面那个表格，而是重新用 bitable 类型导入了一次。

核心命令是：

1
lark-cli drive +import --as bot --file ".\专家中心分工表.xlsx" --type bitable --name "专家中心分工表"

成功后返回：

1
{
2
  "ok": true,
3
  "data": {
4
    "type": "bitable",
5
    "token": "xxxxxxxxxxxxxxxx",
6
    "url": "https://xxx.feishu.cn/base/xxxxxxxxxxxxxxxx"
7
  }
8
}

这里 /base/ 开头的链接，就是飞书多维表格。

Codex 还继续用 inspect 验证了一次：

1
lark-cli drive +inspect --as bot --url "https://xxx.feishu.cn/base/xxxxxxxxxxxxxxxx"

确认结果里显示：

1
{
2
  "type": "bitable",
3
  "title": "专家中心分工表"
4
}

这就说明确实生成成了多维表格。

这套流程里，人需要做什么？#

这个过程里，Codex 能做很多事：

• 查官方文档
• 检查本机环境
• 安装 npm 包
• 安装 Agent Skills
• 执行 lark-cli 命令
• 读取错误信息
• 打开飞书授权页面
• 重试失败命令
• 导入 Excel
• 验证生成的飞书链接

但人仍然需要做几件事：

• 在飞书网页里登录账号
• 确认 CLI 应用配置
• 开启飞书开放平台提示缺少的权限
• 判断自己要的是表格还是多维表格
• 如果链接权限不够，在飞书里补授权，或登录 user identity

所以它不是“完全不用管”，而是“把复杂命令交给 Codex，人只处理必须人工确认的飞书网页授权”。

可以直接复制的 Codex 提示词#

如果你也想复刻这个流程，可以按下面这样发给 Codex。

1
# 飞书
2
帮我安装飞书 CLI: https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md

1
完成了

1
帮我检查飞书 CLI 是否安装和配置成功，跑一下 doctor，并告诉我 bot/user 身份状态。

1
我给你一个 xlsx 文件，请帮我导入成飞书线上表格，并把链接发我。
2
文件路径：
3
D:\你的路径\文件名.xlsx

1
请把这个 xlsx 创建成飞书多维表格，不是普通表格，生成后把 base 链接给我。
2
文件路径：
3
D:\你的路径\文件名.xlsx

1
不对，我要的是飞书多维表格，请你重新创建成多维表格。

小白最容易遇到的坑#

1
unsafe file path

1
--file ".\文件名.xlsx"

1
App scope not enabled

1
帮我处理这个飞书文档的访问权限。如果需要 user identity，请引导我登录。

为什么这种方式适合 Codex？#

飞书 CLI 这种工具很适合交给 Codex。

原因是它的流程不是单纯一条命令，而是一串判断：

• 文档里的安装命令是不是最新
• 本机有没有 Node.js
• CLI 是否已经存在
• 安装后版本是否正确
• 初始化是否需要浏览器授权
• doctor 哪一项失败
• 导入文件时是路径问题还是权限问题
• 要导入成 sheet 还是 bitable
• 最终链接是不是对应的文档类型

这些判断让小白自己做，会很容易卡住。

但交给 Codex 后，它可以边执行边读错误，然后告诉你“现在需要你去浏览器点一下授权”。

这就是 AI Agent 真正有用的地方：不是只告诉你命令，而是陪你把事情跑完。

总结#

这次我真正输入的核心需求，其实就几句话：

1
帮我安装飞书 CLI: 官方文档链接
2
完成了
3
给你一个 xlsx，弄成飞书线上的并给我链接
4
你给我创建成多维表格

剩下的安装、检查、报错处理、权限提示、重新导入、类型验证，都是 Codex 在过程中完成的。

如果你也想让 Codex 接入飞书，最推荐的方式不是先自己研究半天命令，而是直接把官方文档链接和目标说清楚：

1
请按照这份官方文档帮我安装和配置飞书 CLI，完成后帮我跑 doctor 验证。

然后等它做到需要你人工确认的地方，再去浏览器里点授权。

对于小白来说，这比传统教程友好很多；对于经常处理飞书资料的人来说，这也意味着以后可以把“本地文件 -> 飞书线上文档 -> AI 继续处理”的链路交给 Codex 来跑。

官方文档：

• 飞书 CLI 安装指南
• larksuite/cli GitHub 仓库