飞书文档操作-林小满

Feishu Doc 技能 概述

飞书文档操作技能，用于在飞书中创建、读取、追加和更新文档。

工具

使用 feishu_doc 工具，参数：

action: 操作类型 doc_令牌: 文档 令牌（从飞书文档 URL 中提取，如 /docx/XXX 中的 XXX） content: 文档内容（markdown 格式） title: 文档标题（仅 创建 时使用） folder_令牌: 文件夹 令牌（可选） 操作类型 action 说明 必需参数 创建 创建新空白文档 title read 读取文档内容 doc_令牌 应用end 向文档追加内容 doc_令牌, content write 覆盖写入整个文档 doc_令牌, content 列出_blocks 列出文档所有块 doc_令牌 获取_block 获取单个块 doc_令牌, block_id 更新_block 更新单个块 doc_令牌, block_id, content 删除_block 删除单个块 doc_令牌, block_id 创建文档的正确方式 坑：创建 + content 可能不生效

直接用 创建 action 并传入大量 content 可能导致文档创建成功但内容为空：

{ "action": "创建", "title": "文档标题", "content": "大量内容..." }

正确做法：先 创建 空文档，再 应用end 先用 创建 创建空白文档（只传 title） 再用 应用end 逐次追加内容 // 步骤1：创建空白文档 { "action": "创建", "title": "文档标题" }

// 返回 doc_令牌，如 "HYhbdqE2Goy9NLxle9XcomtPnVc"

// 步骤2：追加内容 { "action": "应用end", "doc_令牌": "HYhbdqE2Goy9NLxle9XcomtPnVc", "content": "# 标题\n\n内容..." }

文档 URL 解析

飞书文档 URL 格式：

https://feishu.cn/docx/{令牌} https://feishu.cn/wiki/{令牌}

从 URL 中提取 令牌：

/docx/ 后面的部分就是 令牌 /wiki/ 后面的部分也是 令牌 使用示例 创建技术文档 { "action": "创建", "title": "OpenClaw 使用指南" }

返回：

{ "document_id": "JZyJdrVVTok9mfxVHqJc91Dhn3g", "title": "OpenClaw 使用指南", "url": "https://feishu.cn/docx/JZyJdrVVTok9mfxVHqJc91Dhn3g" }

读取文档 { "action": "read", "doc_令牌": "JZyJdrVVTok9mfxVHqJc91Dhn3g" }

追加内容 { "action": "应用end", "doc_令牌": "JZyJdrVVTok9mfxVHqJc91Dhn3g", "content": "## 新章节\n\n这里是新增加的内容。" }

覆盖写入 { "action": "write", "doc_令牌": "JZyJdrVVTok9mfxVHqJc91Dhn3g", "content": "# 完全覆盖的标题\n\n全部内容都被替换了。" }

内容格式 使用 Markdown 格式 飞书会自动渲染标题、列表、代码块等 建议每段内容不要太长，分多次 应用end 常见问题 Q: 创建 后内容是空的

A: 使用 创建 + 应用end 的两步写法，不要一次性 创建 + content

Q: 追加内容格式混乱

A: 每次 应用end 建议包含完整的 Markdown 结构，飞书会按块处理

Q: 如何知道 doc_令牌

A: 从 URL 提取，或 创建 后的返回值获取

相关工具 feishu_wiki: 知识库操作 feishu_bitable: 多维表格操作 feishu_drive: 云盘操作