什么是 飞书白板自动化？

飞书白板技能是 Openclaw Skills 的一个强大集成功能，使开发人员和团队能够直接从文本提示创建视觉内容。通过解析自然语言请求，该技能生成高质量的 Mermaid 或 PlantUML 代码，并使用飞书开放 API 在飞书或 Lark 文档中渲染图表、流程图和思维导图。这消除了手动绘制的需要，实现了快速文档化和更好的技术沟通。

该技能专为提高效率而设计，简化了视觉文档的流程，确保技术图表始终保持一致且易于更新。无论您是在绘制复杂的微服务架构还是简单的项目时间线，此工具都提供了连接到飞书视觉组件的编程桥梁。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mydreamhorse/feishu-whiteboard-v2

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

飞书白板自动化 应用场景

• 通过简单的提示快速可视化系统架构和逻辑流程。
• 直接在飞书中为项目规划或头脑风暴会议创建层级思维导图。
• 为技术文档和 API 规范生成时序图。
• 将甘特图和类图插入共享团队文档，以提高项目可见性。

1. 代理识别用户的意图并确定所需的特定图表类型。
2. 生成相应的语法，优先使用具有原生兼容性的 Mermaid，或根据要求使用 PlantUML。
3. 技能调用 feishu-board.js 脚本来处理身份验证和 API 通信。
4. 在指定的文档中创建一个新的白板块，并填充图表节点。
5. 系统返回新创建白板的最终文档 URL 和管理令牌。

飞书白板自动化 配置指南

要在 Openclaw Skills 环境中使用此技能，请将您的飞书开发者凭据配置为环境变量：

export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"

然后，您可以使用以下命令执行完整的图表生成工作流：

node skills/feishu-whiteboard/scripts/feishu-board.js run r
  --doc-id  r
  --parent-block-id  r
  --syntax-type mermaid r
  --code-file /tmp/board.mmd

飞书白板自动化 数据架构与分类体系

该技能根据以下架构处理和组织数据：

执行时，技能会管理 whiteboard_token 和有关节点创建状态的元数据，以确保 Openclaw Skills 内部的数据完整性。

name: feishu-whiteboard
description: Create and fill Feishu/Lark Whiteboard (画板) content from natural language requests by generating Mermaid or PlantUML code and calling Feishu Open API directly. Use when user asks to draw流程图/思维导图/架构图/时序图 in Feishu docs or wants AI-generated board diagrams.

Feishu Board (画板) Skill

将用户自然语言需求转成 Mermaid/PlantUML，然后通过飞书开放平台 API 创建并填充画板。

核心流程（必须按顺序）

1. 理解意图：判断图类型（流程图、时序图、类图、甘特图、思维导图等）。
2. 生成图语法：优先生成 Mermaid；若用户明确要求 PlantUML 则用 PlantUML。
3. 调用脚本：执行 scripts/feishu-board.js 完成“创建画板块 + 填充节点”。
4. 回报结果：返回文档链接、画板 token、节点创建结果。

环境变量

在执行前确认：

• FEISHU_APP_ID
• FEISHU_APP_SECRET

可选：

• FEISHU_BASE_URL（默认 https://open.feishu.cn/open-apis）

参数约定

• docId: 文档 ID（非完整 URL）
• parentBlockId: 插入位置父块（通常可先用 docId 作为根块）
• syntaxType: mermaid 或 plantuml
• codeFile: 临时代码文件路径

推荐执行方式

先把图语法写入临时文件，再执行一体化命令：

node skills/feishu-whiteboard/scripts/feishu-board.js run r
  --doc-id  r
  --parent-block-id  r
  --syntax-type mermaid r
  --code-file /tmp/board.mmd

子命令

• run: 一步完成（创建画板块 + 填充语法节点）
• create-whiteboard: 只创建画板块并解析 whiteboard token
• fill-diagram: 向已有画板 token 填充 Mermaid/PlantUML
• get-tenant-token: 仅测试鉴权

失败处理

• 若报权限不足，提示补齐 scope（至少）：
  • board:whiteboard:node:create
  • board:whiteboard:node:read
  • docx:document
• 若无法从 block 解析出 token：先返回 block_id，提示用户检查文档块结构权限或改用已有 whiteboard token。

参考资料

需要接口细节时读取：

• references/feishu-board-api.md