通过 OpenClaw 将 Markdown 高效转换为格式精美的飞书 Docx，支持智能追加/替换模式，自动处理标题、列表、代码块等复杂排版，是团队协作文档标准化的专业工具。
说明：
## 核心用法
**Feishu Docx PowerWrite** 是一个专注于飞书文档高质量输出的自动化技能，通过 `feishu_docx_write_markdown` 工具实现 Markdown 到飞书 Docx 的精准转换。
### 工作流程
1. **获取文档标识**：从飞书文档 URL 中提取 `document_id`（即 `docx/` 后的字符串）
2. **选择写入模式**：
– **Append 模式（推荐）**：在现有内容下方追加，适合会议纪要、日报等增量场景
– **Replace 模式**：全文档覆盖，需显式确认，适用于从零生成完整文档
3. **编写 Markdown**：使用标准 Markdown 语法，工具自动转换为飞书原生格式
### 格式支持
– **层级结构**：`#` 一级标题、`##` 二级标题、`###` 三级标题
– **列表系统**：无序列表（`-`）、有序列表（`1)`）及嵌套组合
– **代码块**：围栏代码块自动识别语言类型
– **分隔线与强调**：水平线（`—`）、粗体（`**`）等基础排版
## 显著优点
| 优势 | 说明 |
|——|——|
| **结构保真** | Markdown 的层级关系完整映射为飞书文档块结构，告别纯文本粘贴的混乱排版 |
| **双模式灵活** | Append 模式安全增量，Replace 模式支持全量重构，覆盖完整使用场景 |
| **批量友好** | 支持单次 300-600 行的内容块写入，适合自动化日报/周报生成 |
| **原生渲染** | 输出为飞书官方 Docx 格式，兼容性最佳，支持后续人工编辑 |
## 潜在局限
– **依赖 OpenClaw 平台**：需配合 OpenClaw 的 Feishu OpenAPI 工具链使用，无法独立运行
– **格式边界**：复杂表格、高级嵌入块（如图表、思维导图）需飞书端二次处理
– **权限前置**：用户需预先配置 Feishu 应用凭证（app_id/app_secret）及 `docx:document:write` 等权限范围
– **无实时预览**：Markdown 侧无法直接可视化最终飞书效果，需写入后查验
## 适合人群
– **技术团队**：需要将代码文档、API 说明、部署指南同步至飞书知识库
– **项目经理**：自动化生成会议纪要、项目周报、进度追踪文档
– **运营人员**：批量产出标准化活动文案、产品更新日志
– **DevOps/SRE**：将系统状态报告、告警汇总自动归档至协作平台
## 常规风险
| 风险类型 | 描述 | 缓解措施 |
|———-|——|———-|
| **误覆盖数据** | Replace 模式会清空原文档全部内容 | 强制要求 `confirm: true` 参数，建议先备份或使用 Append |
| **权限泄露** | 硬编码 token 或文档链接可能导致凭证暴露 | 技能内置安全约束：禁止在代码中硬写敏感信息，强制使用用户自有凭证 |
| **超长内容截断** | 单次写入过量内容可能触发 API 限制 | 建议分块处理，单批控制在 600 行以内 |
| **格式解析偏差** | 非标准 Markdown 语法可能渲染异常 | 遵循推荐模板结构，避免嵌套过深的复杂列表 |
会员专属
