ARTICLE · 1306653
飞书文档读不完?OpenClaw 变出 32 张能搜的卡
📅 2026-11-02

飞书里存了几十篇同事分享的好文档,收藏夹也塞满了。某天我想找其中一篇的做法,翻了二十分钟没找到——那些文档不是没价值,是躺在飞书里,你搜不到它们。
我知道有人已经把这件事跑通了:一台机器接住飞书的知识,加工成结构化文档,再落进 Obsidian。我照着这个思路做了一版,跑通了。但真正让我意外的不是流程本身,而是最后一步——检索。
▎ 先说结论:这套流程分三段
整条链路是「飞书取 → OpenClaw 加工 → Obsidian 沉淀」。我本地跑通的这版:
·取:从飞书文档 / 妙记 / 群聊把原始素材捞出来
·加工:交给 OpenClaw,按固定结构提炼成卡片
·沉淀:卡片存进 Obsidian 仓库,之后按关键词一秒调出来
有意思的地方在第三段。加工这步只要提示词写对,产出会很整齐;沉淀这步才决定这套东西三个月后还有没有用。
▎ 取:让 OpenClaw 认你的飞书
官方接法是走飞书开放平台。流程大致是:
# 1. 飞书开放平台建应用,加机器人能力
# 2. 配权限 + 配事件订阅,发布版本
# 3. 在飞书里找到机器人,拿到配对码
# 4. 把配对码发给 OpenClaw 网页端完成绑定

第 4 步之后,你就能把飞书文档链接直接丢给 OpenClaw 了。
▎ 加工:提示词里得有「输出规格」
这一步最容易翻车。我一开始的提示词只写了"帮我总结这篇文档",出来的东西读着顺,但没法检索——因为它不知道该把工具名放在哪。
后来我改成固定六段结构,每张卡都长这样:
你是一个实操复刻顾问。下面是一篇技术实操帖。
请提炼出「读者照着就能复刻」的信息,用中文输出,严格按下面 6 个小标题:
## ① 用了什么工具
列出具体工具名与版本(没有版本就写「未标注」)。
## ② 前置条件
要跑通这篇需要先有什么(账号、API Key、软件、订阅、权限)。
## ③ 复刻步骤
编号列出可执行步骤。必须是原文能支撑的步骤,不要臆造命令、参数或数字。
## ④ 关键配置 / 提示词
贴出原文里出现的配置片段、Prompt 原文,不要改写。没有就写「无」。
## ⑤ 踩过的坑
原文提到的报错、限制、注意事项。没有就写「原文未提及」。
## ⑥ 复刻难度与门槛
用一句话说:小白能不能照着做?大概要多久?卡点在哪。
硬要求:
- 只用原文里出现过的信息,绝不补充原文没有的命令、参数、数字、结论。
- 不确定的地方明确写「原文未说明」,不要猜。
关键在最后那两条硬要求。没有它们,AI 会很自然地替你补上原帖里没有的数字和命令——这跟读者自己的经历对不上,卡片就废了。
▎ 沉淀:这一步的坑,比前面两步加起来都多
我把这批卡片存进了 Obsidian 仓库,实测数据如下(都是本机跑出来的):
项目 | 实测值 |
OpenClaw 版本 | 2026.10.8 |
已跑通的 agent 数 | 11 个 |
飞书路由(渠道) | 5 条 |
仓库内笔记 | 3232 篇 |
知识卡片 | 32 张 |
六段结构齐全率 | 32 / 32 |
单卡平均字数 | 8256 字 |
原文压缩比 | 226042 字 → 20151 字(约 11.3 倍) |
32 张卡片全文检索 | 0.11 秒 |
3232 篇笔记全库检索 | 0.36 秒 |
单看这个表,检索速度完全不是问题。0.11 秒就能翻完 32 张卡,比你打开浏览器找收藏夹还快。
问题出在另一头。
我把一张卡片的文件名写成了"……_复刻要点.md",全库一搜"复刻要点",命中 64 个文件。搜"视频号",跳出来 3 个文件,但其中 2 个只是正文里提了一句"视频号",跟我想找的"视频号带货怎么起号"根本不是一回事。
更扎心的是我回头统计了一下:32 张卡片里,只有 13 张在"① 用了什么工具"那段写了明确工具名,剩下 19 张写的是"未标注"或"仅提到使用 AI 工具"。
于是搜索变成了这样:
# 想找某个工具的实操,但关键词只出现在正文叙述里
grep -l 'MCP' *.md# → 15 个命中
15 个命中听着不少,可其中大半是"这个帖子里提了一嘴 MCP",真正是 MCP 实操的可能只有 4 个。搜得到,但搜不准——这是比搜不到更让人恼火的事。

▎ 三个补救动作,都在我自己的提示词里
① 把工具名变成硬性字段。 不许写"未标注",实在没有就写原文出现过的那一次具体提及:
## ① 用了什么工具
- 列出具体工具名与版本。
- 原文只提到工具名但没写版本的,写「未标注版本」但**必须写出工具名**。
- 原文完全没出现工具名的,才写「原文未明确列出」。
② 文件名带主题词,不要带统一后缀。 之前我图省事,全用 _复刻要点.md 收尾,结果 64 个文件在检索里挤成一团。改成主题词开头:
<主题词>_<工具名>_<一句话结论>_复刻要点.md
③ 检索时按"工具名 + 关键词"两段筛,别只搜一个词。
# 先按工具名粗筛,再在结果里看标题
grep -l 'Codex' *.md | xargs grep -l '标题关键词'
# 全库搜(3232 篇笔记,0.36 秒)
grep -rl '关键词' --include='*.md' ~/Obsidian仓库/ | head
▎ 别踩这四个坑
一,别一上来就追求全自动。 我第一版想让它自动收集、自动推送、自动归档,结果每天早上收一堆看不懂的卡片,还得回头手工筛。中间留一个人工确认的节点,这一步省不掉。
二,别把提示词写太宽松。 "帮我总结"出来的东西不能检索。要点明段落、要规定每个段落回答什么、要写死"不许补充原文没有的东西"。
三,别用统一后缀当文件名。 这就是 64 个命中挤成一团的原因。文件名是给未来那半秒检索用的。
四,别让卡片"看起来全"就当成功。 我那 19 张写着"未标注"的卡片,当时看着挺整齐,其实是把"我不知道"包装成了"原文没写"。卡片的价值在于能直接照着做,工具名缺失的卡,等于少了一半信息。
▎ 复刻难度与门槛
上手不难——飞书机器人绑定大约半小时,提示词第一版就能跑。真正要花时间的是调结构:六段格式要跟你的使用场景对上,文件名规范要跟你的检索习惯对上。这两件事没有标准答案,只能自己跑几轮再改。
我的成本参考:32 张卡片,跑了不到两周,全部加起来平均每天不到 3 张。这个节奏不赶。
▎ 如果你也想搭这套
先做最小可跑通的一版,别一上来就 32 张卡。挑 3 篇你上周收藏过、现在翻不出来的文档,按上面那六段跑一遍,存进仓库,然后用关键词去搜它们——搜得准,这套才算立住了;搜不准,回头改文件名和"① 用了什么工具"那段。
知识管理最容易失败的地方不是没收集,是收集完了就再也不看第二眼。















































































