夜雨聆风学习资料网

ARTICLE · 1306653

飞书文档读不完?OpenClaw 变出 32 张能搜的卡

飞书文档读不完?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 篇你上周收藏过、现在翻不出来的文档,按上面那六段跑一遍,存进仓库,然后用关键词去搜它们——搜得准,这套才算立住了;搜不准,回头改文件名和"① 用了什么工具"那段。

知识管理最容易失败的地方不是没收集,是收集完了就再也不看第二眼。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料