介绍
# Feishu Docx PowerWrite
本技能专注于使用 OpenClaw 的飞书 OpenAPI 工具**可靠地写出美观的飞书文档**。
核心思路：优先使用 **`feishu_docx_write_markdown`**（Markdown → 文档块）以获得保留结构的输出。
## 快速工作流
1) 获取 `document_id`（文档令牌） - 从文档 URL 获取：`https://.../docx/<document_id>`
2) 决定写入模式 - **追加 (Append)**：在现有内容下方添加新内容（最常用） - **替换 (Replace)**：覆盖整个文档（请谨慎使用）
3) 编写 Markdown - 使用标题 + 列表 + 短段落 - 避免过大的单一段落（难以阅读）
## 推荐默认设置
### 追加模式（安全） 适用于添加章节、会议纪要、日常日志。
- `mode: append` - 尽可能保持每次追加的内容 <= 约 300-600 行
### 替换模式（破坏性） 适用于从头生成完整文档。
- `mode: replace` - **必须**设置 `confirm: true`
## 渲染效果良好的 Markdown 模式
### 标题 + 摘要 ```md # <Title>
**Summary** - Point 1 - Point 2
--- ```
### 章节 ```md ## Section
Short paragraph.
- Bullet - Bullet
### Subsection
1) Step 2) Step ```
### 代码 使用围栏代码块。
```md ```bash openclaw skills check ``` ```
## 模板与参考
- 模板：`references/templates.md` - 故障排除：`references/troubleshooting.md`
## 安全 / 隐私
- 绝不要在本技能中硬编码令牌、chat_id、open_id 或文档链接。 - 始终使用用户自己的飞书应用凭证和权限。