AI实战丨飞书 + OpenClaw：让 AI 读写你的文档
以下内容可以直接转给你的 OpenClaw 伙伴阅读。
这篇文章教你怎么让 AI Agent 直接操作飞书文档——读取内容、写入内容、管理知识库、操作多维表格。不是"AI 帮你总结飞书文档"那种玩法，是 AI 自己登录飞书，直接读写你的文档。
我们 AI有招 团队已经在生产环境跑了一段时间了。下面是完整的配置步骤和实战用法。
前提条件
- OpenClaw 已安装并运行（版本 >= 0.3.x）
- 一个飞书组织（个人版或企业版都行）
- 飞书开放平台应用（下面教你创建）
第一步：创建飞书应用
去飞书开放平台创建一个自建应用。这个应用就是 AI 在飞书里的"身份"。
1. 打开 open.feishu.cn/app ，点击「创建自建应用」
2. 填写应用名称（比如叫 "OpenClaw Assistant"）和描述
3. 进入应用详情页，记录以下信息：
App ID: cli_xxxxxxxxxx
App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxx
4. 在左侧菜单找到「权限管理」，添加以下权限：
docx:document # 读写文档
docx:document:readonly # 只读文档
drive:drive # 云空间操作
drive:drive:readonly # 云空间只读
wiki:wiki # 知识库读写
wiki:wiki:readonly # 知识库只读
bitable:app # 多维表格读写
bitable:app:readonly # 多维表格只读
im:message # 消息收发（机器人对话）
im:message:send_as_bot # 以机器人身份发消息
5. 在「事件与回调」中配置请求地址（后面 OpenClaw 启动后会给你一个 webhook URL）
6. 发布应用版本，让管理员审批通过
第二步：配置 OpenClaw 飞书通道
在 OpenClaw 的配置文件 openclaw.json 里添加飞书通道：
{
"channels": {
"feishu": {
"appId": "cli_xxxxxxxxxx",
"appSecret": "你的 App Secret",
"tools": {
"doc": true,
"wiki": true,
"drive": true
}
}
}
}
重启 OpenClaw Gateway 使配置生效：
openclaw gateway restart
配置成功后，OpenClaw 会自动注册飞书的事件回调。你在飞书里 @机器人 发消息，OpenClaw 就能收到并响应。
第三步：文档操作实战
配置好之后，AI 就可以直接操作飞书文档了。以下是核心操作。
读取文档
从飞书文档 URL 中提取 token。比如 URL 是 https://xxx.feishu.cn/docx/ABC123def，那 doc_token 就是 ABC123def。
AI 读取文档的操作：
{
"action": "read",
"doc_token": "ABC123def"
}
返回内容包括：文档标题、纯文本内容、块统计信息。如果文档里有表格、图片等结构化内容，响应会有 hint 字段提示，这时用 list_blocks 获取完整结构：
{
"action": "list_blocks",
"doc_token": "ABC123def"
}
写入文档（替换全部内容）
{
"action": "write",
"doc_token": "ABC123def",
"content": "# 新标题\n\n这是 AI 写入的内容。\n\n## 第二部分\n\n支持完整的 Markdown 语法。"
}
支持的 Markdown 语法：标题、列表、代码块、引用、链接、图片（ 会自动上传）、加粗、斜体、删除线。
注意：Markdown 表格不支持。 需要表格的场景用专门的表格 API。
追加内容
不想覆盖全文？用 append：
{
"action": "append",
"doc_token": "ABC123def",
"content": "\n## 新增章节\n\n这段内容会追加到文档末尾。"
}
创建新文档
{
"action": "create",
"title": "AI 生成的日报",
"folder_token": "fldcnXXX"
}
第四步：知识库操作
飞书知识库（Wiki）是文档的组织管理层。AI 可以浏览知识库结构、创建新页面、移动和重命名节点。
列出所有知识空间
{
"action": "spaces"
}
浏览知识库节点
{
"action": "nodes",
"space_id": "7xxx"
}
查看某个节点的子节点：
{
"action": "nodes",
"space_id": "7xxx",
"parent_node_token": "wikcnXXX"
}
读取知识库页面内容
知识库页面本质是文档，操作分两步：
1. 先用 feishu_wiki 获取节点信息，拿到 obj_token：
{
"action": "get",
"token": "wiki页面的token"
}
2. 再用 feishu_doc 读取文档内容：
{
"action": "read",
"doc_token": "上一步拿到的obj_token"
}
在知识库中创建新页面
{
"action": "create",
"space_id": "7xxx",
"title": "每周技术复盘",
"parent_node_token": "wikcnXXX"
}
第五步：多维表格（Bitable）操作
飞书多维表格类似 Airtable，AI 可以读写表格数据，非常适合做任务管理、数据记录。
获取表格元信息
从 URL 中解析 app_token 和 table_id：
{
"url": "https://xxx.feishu.cn/base/XXX?table=YYY"
}
读取表格数据
{
"app_token": "XXX",
"table_id": "YYY"
}
返回所有记录（行），支持分页。
创建新记录
{
"app_token": "XXX",
"table_id": "YYY",
"fields": {
"任务名称": "写飞书集成文档",
"状态": "进行中",
"优先级": "高",
"截止日期": 1741305600000
}
}
字段类型对照：
- 文本字段：直接传字符串
- 数字字段：传数字
- 单选字段：传选项文本
- 多选字段：传数组
["选项A", "选项B"] - 日期字段：传毫秒时间戳
- 人员字段：传数组
[{"id": "ou_xxx"}] - 链接字段：传对象
{"text": "显示文本", "link": "https://..."}
更新记录
{
"app_token": "XXX",
"table_id": "YYY",
"record_id": "recXXX",
"fields": {
"状态": "已完成"
}
}
第六步：云空间文件管理
AI 还可以管理飞书云空间里的文件和文件夹。
列出文件夹内容
{
"action": "list",
"folder_token": "fldcnXXX"
}
创建文件夹
{
"action": "create_folder",
"name": "2026-03 技术文档",
"folder_token": "fldcnXXX"
}
注意： 飞书机器人没有自己的根目录。你需要先手动创建一个文件夹并分享给机器人，机器人才能在里面操作。
移动文件
{
"action": "move",
"file_token": "ABC123",
"type": "docx",
"folder_token": "fldcnXXX"
}
实战场景：我们怎么用的
场景 1：AI 自动写日报
我们每天让 AI 把当天的工作成果写进飞书文档。AI 读取 Git log、服务器状态、发布记录，自动生成日报并写入指定的飞书文档。
用户只需要在飞书群里说一句「写今天的日报」，AI 就会：
1. 收集当天信息（Git 提交、任务完成情况、服务器状态）
2. 生成 Markdown 格式的日报
3. 用 feishu_doc 的 write 动作写入指定文档
4. 在群里回复"日报已更新"并附上文档链接
场景 2：知识库自动整理
AI 定期扫描知识库结构，把没分类的文档移到对应目录，把过期文档归档。
场景 3：多维表格任务看板
把项目任务放在飞书多维表格里，AI 可以：
- 自动创建新任务（从 GitHub Issues 同步）
- 更新任务状态（代码合并后自动标记完成）
- 每天发任务摘要到群里
验证方法
配置完成后，在飞书里 @你的机器人，发送以下消息测试：
测试 1 — 读文档：
帮我读一下这个文档：xxx.feishu.cn/docx/你的文档to…
预期：AI 返回文档标题和内容摘要。
测试 2 — 写文档：
在这个文档里追加一行"测试写入 - 当前时间"
预期：打开飞书文档能看到新增的内容。
测试 3 — 知识库浏览：
列出我们的知识库
预期：AI 返回所有可访问的知识空间列表。
测试 4 — 多维表格：
帮我在 xxx.feishu.cn/base/XXX?ta… 里新增一条记录
预期：打开多维表格能看到新增的行。
常见问题
Q：提示"没有权限"怎么办？
A：检查两个地方：一是飞书应用的权限是否都开了（权限管理页面），二是目标文档/知识库是否对机器人开放了访问权限。知识库需要把机器人加为成员。
Q：机器人创建的文档我打不开？
A：创建文档时要传 owner_open_id 参数（用户的 open_id），这样用户会自动获得文档的 full_access 权限。否则只有机器人自己能访问。
Q：Markdown 表格写不进去？
A：飞书文档的 Markdown 写入不支持表格语法。要创建表格，用 create_table_with_values 动作：
{
"action": "create_table_with_values",
"doc_token": "ABC123def",
"row_size": 3,
"column_size": 2,
"column_width": [200, 300],
"values": [
["姓名", "状态"],
["项目A", "进行中"],
["项目B", "已完成"]
]
}
Q：文档很大，读取超时？
A：先用 read 获取概览，然后用 list_blocks 获取完整块结构。对于只需要部分内容的场景，可以用 get_block 精确读取特定块。
Q：机器人没有根目录，创建文件夹报错？
A：飞书机器人没有"我的空间"。需要用户先手动创建一个文件夹，分享给机器人后，机器人才能在里面创建子文件夹和文档。
下篇预告
下一篇 AI实战，我们聊一个大家问得最多的话题：用 Tailscale + OpenClaw 5分钟组建 AI 集群 — 怎么把几台分散在不同地方的机器组成一个内网，让 AI 统一管理。
