AI实战丨飞书 + OpenClaw：让 AI 读写你的文档

AI实战丨飞书 + OpenClaw：让 AI 读写你的文档

以下内容可以直接转给你的 OpenClaw 伙伴阅读。

这篇文章教你怎么让 AI Agent 直接操作飞书文档——读取内容、写入内容、管理知识库、操作多维表格。不是"AI 帮你总结飞书文档"那种玩法，是 AI 自己登录飞书，直接读写你的文档。

我们 AI有招 团队已经在生产环境跑了一段时间了。下面是完整的配置步骤和实战用法。

---

前提条件

• OpenClaw 已安装并运行（版本 >= 0.3.x）
• 一个飞书组织（个人版或企业版都行）
• 飞书开放平台应用（下面教你创建）

---

第一步：创建飞书应用

去飞书开放平台创建一个自建应用。这个应用就是 AI 在飞书里的"身份"。

1. 打开 https://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 语法：标题、列表、代码块、引用、链接、图片（![](url) 会自动上传）、加粗、斜体、删除线。

注意：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 — 读文档：

帮我读一下这个文档：https://xxx.feishu.cn/docx/你的文档token

预期：AI 返回文档标题和内容摘要。

测试 2 — 写文档：

在这个文档里追加一行"测试写入 - 当前时间"

预期：打开飞书文档能看到新增的内容。

测试 3 — 知识库浏览：

列出我们的知识库

预期：AI 返回所有可访问的知识空间列表。

测试 4 — 多维表格：

帮我在 https://xxx.feishu.cn/base/XXX?table=YYY 里新增一条记录

预期：打开多维表格能看到新增的行。

---

常见问题

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 统一管理。