什么是 飞书文档写入器？

飞书文档写入器是专为 Openclaw Skills 生态系统设计的专业工具，用于处理飞书（Lark）平台内的文档生成。它解决了飞书 API 中的一个特定技术限制：在初始创建阶段提供内容可能导致文档为空。通过采用“初始创建后追加内容”的两步流程，该工具确保了高保真的数据传输。

该技能对于需要将 Markdown 格式数据转换为原生飞书文档的开发人员和团队特别有价值。它弥补了自动化脚本与协同办公套件之间的鸿沟，提供了一种从 AI 智能体或 CLI 环境直接发布报告、日志和文档的可靠方式。

下载入口:https://github.com/openclaw/skills/tree/main/skills/tudoubudou/feishu-doc-writer

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

飞书文档写入器 应用场景

• 自动从 Markdown 源文件发布技术报告。
• 将 AI 生成的会议摘要或项目更新同步到飞书。
• 构建需要飞书原生格式的自动化文档流水线。
• 批量创建具有特定标题的文档并以编程方式注入内容。

1. 用户或智能体触发 create 操作，仅提供文档标题，保持内容参数为空。
2. 系统生成一个新的飞书文档并返回唯一的 document_id 或 doc_token。
3. 工作流捕获此令牌并触发第二次 append 操作。
4. Markdown 内容通过追加操作传递，工具自动将 Markdown 语法转换为飞书原生区块。
5. 文档更新完整内容，确保在初始化过程中不会丢失任何数据。

飞书文档写入器 配置指南

要在 Openclaw Skills 环境中使用此工具，您可以通过内置函数或独立的 Python 脚本调用它。

# 通过 Python 脚本使用
python3 scripts/feishu_doc_writer.py "文档标题" "content_file.md"

以编程方式调用工具时：

# 第 1 步：创建（仅标题）
feishu_doc(action="create", title="我的报告", content="")

# 第 2 步：追加（内容注入）
feishu_doc(action="append", doc_token="来自第1步的DOC_ID", content="# 标题
此处为内容...")

飞书文档写入器 数据架构与分类体系

该技能利用结构化参数集来管理文档生命周期。以下是数据要求的映射：

name: feishu-doc-writer
description: 飞书文档写入工具。用于解决飞书文档创建后内容为空的问题。正确流程：先用 create 创建文档（只有标题），再用 append 追加内容。支持 Markdown 格式自动转换。

飞书文档写入工具

解决 feishu_doc 工具写入内容为空的问题。

重要发现

直接用 create + content 参数会导致内容丢失！

正确流程：

1. 先用 create 创建文档（只有标题）
2. 再用 append 追加内容

使用方法

方式一：使用 OpenClaw 内置工具

# 第一步：创建文档（只有标题）
feishu_doc(action="create", title="文档标题", content="")

# 第二步：追加内容（重要！）
feishu_doc(action="append", doc_token="文档ID", content="实际内容")

方式二：使用 Python 脚本

python3 scripts/feishu_doc_writer.py "文档标题" "内容文件.md"

关键要点

1. 不要在 create 时传 content — 会导致内容丢失
2. 先 create 再 append — 分两步执行
3. append 会自动渲染 Markdown — 支持标题、列表、粗体等

示例代码

# 创建文档（空内容）
doc = feishu_doc(
    action="create",
    title="我的报告",
    content=""
)
doc_id = doc["document_id"]

# 追加内容
feishu_doc(
    action="append",
    doc_token=doc_id,
    content="# 报告标题

内容..."
)

常见问题

• 内容为空：检查是否在 create 时传了 content
• append 失败：确保 doc_token 正确
• 格式不对：append 支持 Markdown 自动转换