让 AI 自由读写飞书云文档openclaw-lark 文档创建、更新与读取全流程指南【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-larkopenclaw-lark 是飞书官方出品的 OpenClaw 飞书/Lark Channel 插件它让你的 AI 助手获得自由读写飞书云文档的完整能力一句话创建云文档、精准更新文档内容、一键读取文档并转成 Markdown。本文将带你走完文档创建、更新与读取的全流程新手也能快速上手。先认识 openclaw-lark它能做什么openclaw-lark 将 OpenClaw Agent 无缝接入你的飞书工作区。在文档场景下它提供三大核心工具工具清单见 openclaw.plugin.json工具能力说明文件feishu_create_doc从 Markdown 创建云文档skills/feishu-create-doc/SKILL.md✏️feishu_update_doc7 种模式更新文档内容skills/feishu-update-doc/SKILL.mdfeishu_fetch_doc读取文档并返回 Markdownskills/feishu-fetch-doc/SKILL.md安装插件版本要求与获取方式开始之前请确认环境满足以下要求Node.jsv22或更高版本OpenClaw版本2026.2.26及以上可用openclaw -v查看获取插件源码git clone https://gitcode.com/gh_mirrors/op/openclaw-lark完成安装与飞书应用授权后直接在飞书私聊里对机器人说需求即可无需手动调用任何 API。更多细节可查阅 README.zh.md。⚠️安全提示插件会以你的用户身份在授权范围内操作建议将其作为私人对话助手使用不要拉入群聊或放开默认安全配置。第一步AI 创建飞书云文档一句话搞定创建文档只需两个信息标题Markdown 内容。在飞书里直接对机器人说帮我创建一篇《Q3 项目计划》文档内容包括项目背景、里程碑表格和风险提示。AI 会调用feishu_create_doc工具实现见 src/tools/mcp/doc/create.ts完成后返回doc_id文档唯一标识如doxcnXXXX...doc_url可直接在浏览器打开的文档链接message操作结果如文档创建成功创建到指定位置三个参数互斥想让文档落在正确的位置三个位置参数只能选一个优先级从高到低wiki_node知识库节点从知识库 URL 中取wikcnXXXXwiki_space知识空间 ID特殊值my_library表示个人知识库folder_token文件夹 token从文件夹 URL 中取fldcnXXXX不指定任何位置时文档会创建在个人空间根目录。让 AI 写出图文并茂的文档插件使用Lark-flavored Markdown飞书扩展 Markdown相比普通 Markdown 多了一整套飞书特色能力完整规范见 skills/feishu-create-doc/SKILL.md高亮块 Callout提示、警告、成功等醒目样式增强表格 lark-table单元格内可放列表、代码Mermaid / PlantUML 画板流程图、时序图自动渲染成飞书画板️图片自动上传写入图片 URL系统自动下载并上传到飞书文字颜色、9 级标题、对齐等富文本格式一个小技巧创建长文档时AI 会先用 create-doc 写开头再配合 update-doc 的 append 模式分段追加成功率更高。第二步更新飞书云文档的 7 种模式文档创建后难免要改。openclaw-lark 的feishu_update_doc工具实现见 src/tools/mcp/doc/update.ts提供7 种更新模式覆盖绝大多数修改场景模式作用适用场景append追加到文末补记更新日志、长文档续写replace_range定位替换改写某个章节replace_all全文多处替换批量改名如张三→李四insert_before在定位内容前插入补充警告说明insert_after在定位内容后插入在代码块后补输出示例delete_range删除定位内容清理废弃章节overwrite整体覆盖重写仅在完全重建时使用两种定位方式让 AI 精准找到要改的地方定位类模式支持两种写法二选一内容定位selection_with_ellipsis如## 旧章节标题...旧章节结尾。匹配从开头到结尾的全部内容标题定位selection_by_title如## 功能说明自动定位整个章节对新手最实用的场景示例把文档里《功能说明》这一章的负责人改成李四。AI 会选择replace_range 标题定位只改这一章其余内容包括图片和评论原样保留。黄金法则局部更新优于整体覆盖⚠️overwrite会清空文档重写图片、画板、评论等 token 型内容可能丢失且无法原样写回。因此最佳实践是✅ 多次小范围精确替换逐步修改❌ 慎用 overwrite 重写全文 文档标题也能同步更新任何模式都可附加new_title参数第三步读取飞书云文档一键转 Markdown想看文档内容直接发链接给机器人帮我总结一下这篇文档https://xxx.feishu.cn/docx/doxcnXXXXfeishu_fetch_doc工具实现见 src/tools/mcp/doc/fetch.ts会直接把文档转成 Lark-flavored Markdown 返回并且支持直接传 URL无需手动提取 token支持大文档分页offset偏移 limit限制避免超长内容知识库链接自动识别/wiki/链接背后可能是云文档、表格或多维表格插件会先解析类型再选择正确的工具读取文档里的图片怎么办读取时文档中的图片、文件、画板会以image token.../等标签形式出现。AI 会再配合feishu_doc_mediaaction: download工具把媒体文件单独下载下来做到图文都能读。工具组合对照见 skills/feishu-fetch-doc/SKILL.md。新手常见的 3 个坑提前避一下标题写重了文档标题title已经单独传过Markdown 正文里不要再写相同的一级标题。画板语法报错Mermaid/PlantUML 语法写错时会收到 warningAI 可依据replace_range修复画板后重新提交。权限反复失败多次授权仍报错时在飞书会话中发送/feishu doctor触发深度诊断自动生成账号配置、API 连通性、应用权限的完整诊断报告见 skills/feishu-troubleshoot/SKILL.md。写在最后现在你可以让 AI 在飞书里做到创建 → 更新 → 读取的完整闭环 一句话创建图文并茂的云文档支持高亮块、分栏、画板 7 种更新模式 两种定位方式精准修改不留痕 任意文档一键读取为 Markdown图片文件也能下载更多能力多维表格、日历、任务、消息等可在 README.zh.md 中查看动手试试吧【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-lark创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考