OpenClaw飞书创建文档

feishu_mcp_创建_doc

通过 MCP 调用 创建-doc，从 Lark-flavored Markdown 内容创建一个新的飞书云文档。

返回值

工具成功执行后，返回一个 JSON 对象，包含以下字段：

doc_id（string）：文档的唯一标识符（令牌），格式如 doxcnXXXXXXXXXXXXXXXXXXX doc_url（string）：文档的访问链接，可直接在浏览器中打开，格式如 https://www.feishu.cn/docx/doxcnXXXXXXXXXXXXXXXXXXX message（string）：操作结果消息，如"文档创建成功" 参数 markdown（必填）

文档的 Markdown 内容，使用 Lark-flavored Markdown 格式。

调用本工具的markdown内容应当尽量结构清晰,样式丰富, 有很高的可读性. 合理的使用callout高亮块, 分栏,表格等能力,并合理的运用插入图片与mermAId的能力,做到图文并茂.. 你需要遵循以下原则:

结构清晰：标题层级 ≤ 4 层，用 Callout 突出关键信息 视觉节奏：用分割线、分栏、表格打破大段纯文字 图文交融：流程和架构优先用 MermAId/PlantUML 可视化 克制留白：Callout 不过度、加粗只强调核心词

当用户有明确的样式,风格需求时,应当以用户的需求为准!!

重要提示：

禁止重复标题：markdown 内容开头不要写与 title 相同的一级标题！title 参数已经是文档标题，markdown 应直接从正文内容开始 目录：飞书自动生成，无需手动添加 Markdown 语法必须符合 Lark-flavored Markdown 规范，详见下方"内容格式"章节 创建较长的文档时,强烈建议配合更新-doc中的应用end mode, 进行分段的创建,提高成功率. title（可选）

文档标题。

folder_令牌（可选）

父文件夹的 令牌。如果不提供，文档将创建在用户的个人空间根目录。

folder_令牌 可以从飞书文件夹 URL 中获取，格式如：https://xxx.feishu.cn/drive/folder/fldcnXXXX，其中 fldcnXXXX 即为 folder_令牌。

wiki_node（可选）

知识库节点 令牌 或 URL（可选，传入则在该节点下创建文档，与 folder_令牌 和 wiki_space 互斥）

wiki_node 可以从飞书知识库页面 URL 中获取，格式如：https://xxx.feishu.cn/wiki/wikcnXXXX，其中 wikcnXXXX 即为 wiki_node 令牌。

wiki_space（可选）

知识空间 ID（可选，传入则在该空间根目录下创建文档。特殊值 my_库 表示用户的个人知识库。与 wiki_node 和 folder_令牌 互斥）

wiki_space 可以从知识空间设置页面 URL 中获取，格式如：https://xxx.feishu.cn/wiki/设置tings/7448000000000009300，其中 7448000000000009300 即为 wiki_space ID。

参数优先级：wiki_node > wiki_space > folder_令牌

示例 示例 1：创建简单文档 { "title": "项目计划", "markdown": "# 项目概述\n\n这是一个新项目。\n\n## 目标\n\n- 目标 1\n- 目标 2" }

示例 2：创建到指定文件夹 { "title": "会议纪要", "folder_令牌": "fldcnXXXXXXXXXXXXXXXXXXXXXX", "markdown": "# 周会 2025-01-15\n\n## 讨论议题\n\n1. 项目进度\n2. 下周计划" }

示例 3：使用飞书扩展语法

使用高亮块、表格等飞书特有功能：

{ "title": "产品需求", "markdown": "\n重要需求说明\n\n\n## 功能列表\n\n\n| 功能 | 优先级 |\n|------|--------|\n| 登录 | P0 |\n| 导出 | P1 |\n" }

示例 4：创建到知识库节点下 { "title": "技术文档", "wiki_node": "wikcnXXXXXXXXXXXXXXXXXXXXXX", "markdown": "# API 接口说明\n\n这是一个知识库文档。" }

示例 5：创建到知识空间根目录 { "title": "项目概览", "wiki_space": "7448000000000009300", "markdown": "# 项目概览\n\n这是知识空间根目录下的一级文档。" }

示例 6：创建到个人知识库 { "title": "学习笔记", "wiki_space": "my_库", "markdown": "# 学习笔记\n\n这是创建在个人知识库中的文档。" }

内容格式

文档内容使用 Lark-flavored Markdown 格式，这是标准 Markdown 的扩展版本，支持飞书文档的所有块类型和富文本格式。

通用规则 使用标准 Markdown 语法作为基础 使用自定义 XML 标签实现飞书特有功能（具体标签见各功能章节） 需要显示特殊字符时使用反斜杠转义： ~ $ [ ] < > { } | ^ 📝 基础块类型 文本（段落） 普通文本段落

段落中的粗体文字

多个段落之间用空行分隔。

居中文本 {align="center"} 右对齐文本 {align="right"}

段落对齐：支持 {align="left|center|right"} 语法。可与颜色组合：{color="blue" align="center"}

标题

飞书支持 9 级标题。H1-H6 使用标准 Markdown 语法，H7-H9 使用 HTML 标签：

# 一级标题

二级标题

⚠️ 只支持围栏代码块（`），不支持缩进代码块。

print("Hello")

支持语言：python, javascript, go, java, sql, json, yaml, shell 等。

分割线

🎨 富文本格式 文本样式

粗体 斜体* ~~删除线~~ 行内代码` 下划线

文字颜色

红色 黄色背景

支持: red, orange, yellow, green, blue, purple, gray

链接

链接文字 （不支持锚点链接）

行内公式（LaTeX）

$E = mc^2$（$前后需空格）或 E = mc^2（无限制，推荐）

🚀 高级块类型 高亮块（Callout） 支持格式化的内容，可包含多个块

属性: emoji (使用emoji 字符如 ✅ ⚠️ 💡), background-color, border-color, text-color

背景色: light-red/red, light-blue/blue, light-green/green, light-yellow/yellow, light-orange/orange, light-purple/purple, pale-gray/light-gray/dark-gray

常用: 💡light-blue(提示) ⚠️light-yellow(警告) ❌light-red(危险) ✅light-green(成功)

限制: callout子块仅支持文本、标题、列表、待办、引用。不支持代码块、表格、图片。

分栏（Grid）

适合对比、并列展示场景。支持 2-5 列：

两栏（等宽）

左栏内容

右栏内容

三栏自定义宽度 左栏(20%) 中栏(60%) 右栏(20%)

属性: cols(列数 2-5), width(列宽百分比，总和为100，等宽时可省略)

表格 标准 Markdown 表格

当单元格需要复杂内容（列表、代码块、高亮块等）时使用。

层级结构（必须严格遵守）：

← 表格容器 ← 行（直接子元素只能是 lark-tr） 内容 ← 单元格（直接子元素只能是 lark-td） 内容 ← 每行的 lark-td 数量必须相同！

属性：

column-widths：列宽，逗号分隔像素值，总宽≈730 header-row：首行是否为表头（"true" 或 "false"） header-column：首列是否为表头（"true" 或 "false"）

单元格写法：内容前后必须空行