引言
飞书(Feishu/Lark)是国内团队协作的主流工具,而 OpenClaw 的 feishu 工具全家桶让你可以用 AI 操作飞书的一切——文档、表格、知识库、消息,一个不落。
本文是 feishu 工具的"全景图",帮你建立完整的飞书自动化能力认知。
正文
工具总览——八把利刃
OpenClaw 为飞书提供了完整的工具集:
| 工具 | 能力 |
|---|---|
| feishu_doc | 文档读写、创建、编辑 |
| feishu_bitable | 多维表格(数据库)操作 |
| feishu_wiki | 知识库节点管理 |
| feishu_drive | 云盘文件管理 |
| feishu_chat | 群聊信息查询 |
| feishu_app_scopes | 权限范围查询 |
| feishu_bitable_* | bitable 子工具(CRUD) |
feishu_doc——飞书文档操作
从 URL 提取 Token
飞书文档 URL 格式:https://xxx.feishu.cn/docx/XXXXXXXX
// doc_token 就是 docx/ 后面的部分
const doc_token = "XXXXXXXX"; // 纯 Token,不含前缀
核心操作
// 读取文档
const content = feishu_doc({
action: "read",
doc_token: "XXXXXXXX"
});
// 创建文档
const newDoc = feishu_doc({
action: "create",
title: "技术周报 2026-04-09",
folder_token: "folder_xxx" // 可选,放在指定文件夹
});
// 写入内容(覆盖)
feishu_doc({
action: "write",
doc_token: "XXXXXXXX",
content: "# 本周总结\n\n完成了 XX 功能开发..."
});
// 追加内容
feishu_doc({
action: "append",
doc_token: "XXXXXXXX",
content: "## 下周计划\n\n继续优化性能..."
});
feishu_bitable——多维表格数据库
bitable 是飞书的"数据库"产品,适合管理结构化数据。
获取 Bitable 元信息
// 从 URL 解析 app_token 和 table_id
const meta = feishu_bitable_get_meta({
url: "https://xxx.feishu.cn/base/XXXXXXXX?table=YYY"
});
// 返回 { app_token: "XXX", table_id: "YYY", tables: [...] }
CRUD 操作
// 创建记录
feishu_bitable_create_record({
app_token: "XXX",
table_id: "YYY",
fields: {
"姓名": "张三",
"部门": "研发部",
"入职日期": 1712611200000 // 时间戳毫秒
}
});
// 查询记录
const records = feishu_bitable_list_records({
app_token: "XXX",
table_id: "YYY",
page_size: 100
});
// 更新记录
feishu_bitable_update_record({
app_token: "XXX",
table_id: "YYY",
record_id: "record_xxx",
fields: {
"状态": "已审批"
}
});
feishu_wiki——知识库节点管理
// 列出知识库空间
const spaces = feishu_wiki({ action: "spaces" });
// 获取节点信息
const node = feishu_wiki({
action: "get",
token: "wiki_xxx" // wiki token 格式
});
// 创建节点
feishu_wiki({
action: "create",
space_id: "space_xxx",
parent_node_token: "parent_xxx", // 可选,放在哪个节点下
title: "新人入职指南",
obj_type: "docx" // docx/sheet/bitable
});
feishu_chat——群聊操作
// 查询群信息
const chatInfo = feishu_chat({
action: "info",
chat_id: "oc_xxx"
});
// 获取群成员
const members = feishu_chat({
action: "members",
chat_id: "oc_xxx"
});
// 查询用户信息
const userInfo = feishu_chat({
action: "member_info",
chat_id: "oc_xxx",
member_id: "ou_xxx"
});
实战案例——AI 生成周报并发送飞书
// 1. 收集本周工作数据(假设从数据库/CRM 获取)
const weekData = await getWeekWorkData();
// 2. 生成周报文档
const doc = feishu_doc({
action: "create",
title: `技术周报 ${formatDate(new Date())}`,
folder_token: FEISHU_WEEKLY_FOLDER
});
// 3. 写入周报内容
feishu_doc({
action: "write",
doc_token: doc.doc_token,
content: generateWeeklyReport(weekData)
});
// 4. 发送到群聊
message({
action: "send",
channel: "feishu",
target: "oc_team_chat",
message: `📋 本周周报已生成,点击查看:${doc.url}`
});
总结
feishu 工具全家桶覆盖了飞书的核心场景:文档(doc)、表格(bitable)、知识库(wiki)、云盘(drive)、聊天(chat)。AI 可以代替你完成文档创建、内容填写、数据管理、消息推送等操作,真正实现"说一句话,AI 帮你搞定飞书"。
下期预告:飞书工具讲完了,下一期我们深入 bitable——用 AI 自动操作飞书多维表格!
互动话题
你在工作中用飞书吗?最想用 AI 自动化哪些飞书操作?文档录入、数据汇总、还是定时报告?说说你的场景!
夜雨聆风