feishu_mcp_create_doc

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

返回值

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

• doc_id（string）：文档的唯一标识符（token），格式如 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 规范，详见下方"内容格式"章节
• 创建较长的文档时,强烈建议配合update-doc中的append mode, 进行分段的创建,提高成功率.

title（可选）

文档标题。

folder_token（可选）

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

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

wiki_node（可选）

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

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

wiki_space（可选）

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

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

参数优先级：wiki_node > wiki_space > folder_token

示例

示例 1：创建简单文档

{
  "title": "项目计划",
  "markdown": "# 项目概述\n\n这是一个新项目。\n\n## 目标\n\n- 目标 1\n- 目标 2"
}

示例 2：创建到指定文件夹

{
  "title": "会议纪要",
  "folder_token": "fldcnXXXXXXXXXXXXXXXXXXXXXX",
  "markdown": "# 周会 2025-01-15\n\n## 讨论议题\n\n1. 项目进度\n2. 下周计划"
}

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

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

{
  "title": "产品需求",
  "markdown": "<callout emoji=\"💡\" background-color=\"light-blue\">\n重要需求说明\n</callout>\n\n## 功能列表\n\n<lark-table header-row=\"true\">\n| 功能 | 优先级 |\n|------|--------|\n| 登录 | P0 |\n| 导出 | P1 |\n</lark-table>"
}

示例 4：创建到知识库节点下

{
  "title": "技术文档",
  "wiki_node": "wikcnXXXXXXXXXXXXXXXXXXXXXX",
  "markdown": "# API 接口说明\n\n这是一个知识库文档。"
}

示例 5：创建到知识空间根目录

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

示例 6：创建到个人知识库

{
  "title": "学习笔记",
  "wiki_space": "my_library",
  "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 标签：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
<h7>七级标题</h7>
<h8>八级标题</h8>
<h9>九级标题</h9>

# 带颜色的标题 {color="blue"}
## 红色标题 {color="red"}
# 居中标题 {align="center"}
## 蓝色居中标题 {color="blue" align="center"}

标题属性：支持 {color="颜色名"} 和 {align="left|center|right"} 语法，可组合使用。颜色值：red, orange, yellow, green, blue, purple, gray。请谨慎使用该能力.

列表

有序列表,无序列表嵌套使用tab或者 2 空格缩进

- 无序项1（
  - 无序项1.a
  - 无序项1.b

1. 有序项1
2. 有序项2

- [ ] 待办
- [x] 已完成

引用块

> 这是一段引用
> 可以跨多行

> 引用中支持**加粗**和*斜体*等格式

代码块

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

```python
print("Hello")
```

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

分割线

---

---

🎨 富文本格式

文本样式

**粗体** *斜体* ~~删除线~~ `行内代码` <u>下划线</u>

文字颜色

<text color="red">红色</text> <text background-color="yellow">黄色背景</text>

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

链接

[链接文字](https://example.com) （不支持锚点链接）

行内公式（LaTeX）

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

---

🚀 高级块类型

高亮块（Callout）

<callout emoji="✅" background-color="light-green" border-color="green">
支持**格式化**的内容，可包含多个块
</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 列：

两栏（等宽）

<grid cols="2">
<column>

左栏内容

</column>
<column>

右栏内容

</column>
</grid>

三栏自定义宽度

<grid cols="3">
<column width="20">左栏(20%)</column>
<column width="60">中栏(60%)</column>
<column width="20">右栏(20%)</column>
</grid>

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

表格

标准 Markdown 表格

| 列 1 | 列 2 | 列 3 |
|------|------|------|
| 单元格 1 | 单元格 2 | 单元格 3 |
| 单元格 4 | 单元格 5 | 单元格 6 |

飞书增强表格

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

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

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

属性：

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

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

<lark-td>

这里写内容

</lark-td>

完整示例（2行3列）：

<lark-table column-widths="200,250,280" header-row="true">
<lark-tr>
<lark-td>

how to use feishu-create-doc
CursorClaude CodeClineCodexWindsurfGooseGitHub CopilotVS CodeGemini CLIKiloOpencodeKimi CLIRoo ClineAiderContinueZedBolt.newLovablev0Replit AgentSweepSmol DeveloperDevinCavemanAmpAntigravity
How to use feishu-create-doc on Cursor
AI-first code editor with Composer
1
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
›Cursor installed and configured on your development machine
›Node.js version 16.0+ with npm package manager (verify with node --version)
›Active project directory or workspace where you want to add feishu-create-doc
2
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
$npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-create-doccopy
The skills CLI fetches feishu-create-doc from GitHub repository larksuite/openclaw-lark and configures it for Cursor.
3
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
◆ Which agents do you want to install to?
│
│ ── Universal (.agents/skills) ── always included ────
│   • Amp
│   • Antigravity
│   • Cline
│   • Codex
│ ●Cursor(selected)
│   • Cursor
│   • Windsurf
4
Verify installation
Confirm successful installation by checking the skill directory location:
.cursor/skills/feishu-create-doc
Reload or restart Cursor to activate feishu-create-doc. Access the skill through slash commands (e.g., /feishu-create-doc) or your agent's skill management interface.
⚠
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
Additional Resources
›View source code on GitHub›Skills CLI documentation›Learn more about Cursor›What are agent skills?