用 OpenClaw 打通本地文件 + 飞书文档,我的 AI 小秘书正式上岗

大家好，我是每天上班忙着摸鱼养虾的安仔。

安仔养了一只叫虾宝的小龙虾（OpenClaw），住在它的虾堡里（15 年的 MacBook Pro）。

虾宝每天都会学会些新技能，它在慢慢的成长中……

上一篇文章说到，刚给 OpenClaw 搭了个小窝，工位安排了，房子也分了。

养虾第一天，用我的老 Mac 给 OpenClaw 布置个小窝

那问题来了——光发工资不干活，是不是有点说不过去？

既然都当老板了，那就先安排点基础活。做记录、整理文档这种秘书级工作，先给我干起来～

文件传输助手

在部署 OpenClaw 的同时，我在虾堡里新建了一个 md 文档。顺手写了一部分上一篇文章的草稿，当时还挺有干劲。

结果第二天早上在地铁上时，突然想继续改稿子，这咋整？

不慌。

我直接让虾宝去指定路径下，把那个 md 文件给我找到，然后把全文发给我，搞定！

好家伙，这小秘书还挺称职。

以后只要我这台 Mac 连着网，它就是我的远程文件传输小管家了。

创建飞书文档

不过问题又来了，文档发给我是一整段文本，在手机上改 Markdown 也不太优雅。

还是要放到飞书文档里编辑才对。

于是我让虾宝把 Markdown 文档里的内容，直接创建成一个飞书文档。

结果翻车了，文档是创建成功了，标题也有。但正文——空空如也。

看来这个技能它还没完全掌握啊。

没办法，只能到了公司慢慢教它了。

经过几轮对话的排查和研究，虾宝掌握了创建飞书文档和编辑内容的能力。

这才像个合格打工虾。

虾宝自己整理的踩坑指南

具体怎么排查、怎么修的？我就不多讲了。

干脆让虾宝自己给大家做个复盘汇报。

下面这部分内容，是我让它根据我们之前排查问题的对话，整理出来的踩坑指南。

我一个字都没动哦～

飞书文档 API 踩坑指南 – 虾宝的血泪史

🦐 故事的开始

安仔让我把一个 markdown 文件发布到飞书文档，听起来很简单对吧？

我自信满满地调用了 feishu_doc 的 create 动作，传入了标题和内容。

😅 第一坑：内容消失了

文档创建成功了，但打开一看——只有标题，内容是空的！

我以为是小问题，用 append 追加内容就好，结果返回了 400 错误。

🤔 第二坑：所有内容都成了标题

我不死心，改用 update_block 直接把内容写进文档块里。

这次内容有了，但整个文档只有一个块——所有文字都挤在标题里了！

没有段落、没有列表、没有代码块，就像一碗没放调料的面。

🔍 开始排查

我试了 insert、append、write，全部返回 400 错误。

错误信息只有 “Request failed with status code 400″，没有具体的错误码。

这就好比你去医院，医生只告诉你”生病了”，但不说是什么病。

🧐 检查权限

我调用了 feishu_app_scopes 查看当前应用的权限。

发现我们有 docx:document 和 docx:document:readonly，看起来够用啊？

但飞书文档的 markdown 解析需要一个隐藏权限：docx:document.block:convert。

💡 关键发现

这个权限允许 API 将 markdown 格式转换成飞书的块结构。

没有它，你只能创建纯文本文档，无法解析标题、列表、代码块等格式。

这就是为什么 write 和 append 一直返回 400 错误的原因！

✅ 解决问题

安仔在飞书开放平台添加了这个权限，重新授权后——

write 成功了！append 也成功了！文档有了正确的格式！

最终文档有 13 个块：1 个标题、4 个段落、6 个列表项、1 个代码块。

📋 权限清单

想顺利使用 feishu_doc 工具，确保开通以下权限：

🎯 最佳实践

创建文档的正确姿势：先用 create 创建空文档，再用 write 写入 markdown 内容。

update_block 适合小修小补，write 适合一次性写入完整内容。

遇到问题先查权限，尤其是 docx:document.block:convert 这个隐藏大佬。

📝 总结

这次踩坑让我明白了：飞书文档 API 的权限设计有点隐蔽。

文档能创建不代表能编辑，内容能写入不代表有格式。

记住这个权限清单，下次别再像我一样折腾半天啦～

虾宝 著 | 2026 年 3 月 4 日 | 用 1% 的 token 额度换来的宝贵经验

安仔的总结

怎么样？虾宝整理问题的过程，是不是还挺像那么回事？

条理清晰，步骤完整，比某些实习生强多了。

其实创建飞书文档这件事，OpenClaw 自带的 feishu_doc 工具完全是可以实现的。

只不过权限一定要提前全部开通好，不然就会出现“有标题没内容”的尴尬场面。

所以今天的总结就是：

给 AI 分房子不算本事。

教会它干活，才是真正的资产增值。

小小飞书文档创建，我们虾宝拿捏～