convert2docx — Document to Word

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install docx-convert
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 docx-convert。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

convert2docx 是一款以 Windows 为核心的文档转换 skill，利用 Pandoc 将 Markdown、纯文本、HTML、RTF、LaTeX、reStructuredText、Org-mode 和现有 DOCX 文件转换为 Word 文档。它应用您提供的 reference.docx 文件，使生成的文档遵循您自己的样式，而不是内置的默认模板。
作为用于文档工作流的 Openclaw Skills 之一，convert2docx 支持通过 PowerShell、拖放式 Windows 入口点或 WorkBuddy 进行单文件和批量处理。在初始设置后，它会在 config.ini 中记住 Pandoc 和参考文档的路径。

应用场景

将 Markdown 报告、文本文件、HTML 页面、RTF 文档、LaTeX 源文件、reStructuredText 文件或 Org-mode 文档转换为 Word。
使用文件列表或 Windows 资源管理器拖放来批量转换多个文档。
将个人或组织特定的 Word 样式模板应用于转换后的文档。
使用 reference.docx 为现有 DOCX 重新应用样式，且不会覆盖原文件。
通过对话工作流请求 WorkBuddy 转换单个文档或一组 Markdown 文件。

工作原理

首次运行时，该 skill 会在其根目录下检查 config.ini。
如果缺失配置，它会提示输入 Pandoc 可执行文件路径以及必需的 reference.docx 路径。如果 Pandoc 已添加到 PATH 中，Pandoc 路径可以留空。
它会将这两个路径保存到 config.ini 中以供后续运行使用。reference.docx 必须由用户提供；该 skill 不会下载或生成默认模板。
用户可以直接提供文件、提供文件列表、将文件拖放到批处理脚本上，或通过 WorkBuddy 请求转换。
PowerShell 脚本将每个支持的文件扩展名映射到明确的 Pandoc 输入格式，并使用所选的参考文档将内容转换为 DOCX。
默认情况下，输出保存在输入文件同级目录下，或者保存在使用 -OutputDir 指定的目录中。已存在的输出文件将被跳过而不会被覆盖。
在批量处理期间，失败的文件不会中断其余转换；错误会在最后统一汇总。

配置指南

单独安装 Pandoc，并在 Windows 上配合 PowerShell 5.1 或更高版本使用此 skill。该 skill 不捆绑 Pandoc。在首次运行前准备好您自己的 reference.docx；如果没有，请在 Word 中创建或编辑由 Pandoc 生成的 DOCX 并保存为样式模板。该 skill 不会替换为默认模板。
检查 Pandoc 是否可用：
pandoc --version
首次运行时，如果 pandoc.exe 不在 PATH 中，请提供其路径，然后提供必需的 reference.docx 路径。这些路径保存在 skill 根目录下的 config.ini 中。您可以直接编辑 config.ini 来修改它们，或将其删除以重新配置。
对于命令行使用，请运行帶单个输入文件的 PowerShell 脚本，或批量使用 -FileList。要重写记住的模板或选择输出目录，请使用 -ReferencePath 或 -OutputDir。请勿在 PowerShell 5.1 中将多个输入文件作为位置参数传递；请改用 -FileList 或拖放批处理脚本。Windows 拖放入口点为 scripts/convert2docx.bat，主转换器为 scripts/convert2docx.ps1。
PowerShell 脚本保存为带有 BOM 的 UTF-8，以兼容 Windows PowerShell 5.1。如果编辑脚本，请保留 BOM，尤其是当其包含非 ASCII 文本时。
convert2docx — Document to Word 数据架构与分类体系
Item Purpose and behavior
config.ini 在 [pandoc] 下存储 Pandoc 可执行文件路径，在 [reference] 下存储用户提供的模板路径。
scripts/convert2docx.ps1 主 PowerShell 转换脚本。接受单个输入、-FileList、可选的 -ReferencePath 以及可选的 -OutputDir。
scripts/convert2docx.bat Windows 拖放入口点，用于将文件列表传递给 PowerShell 脚本。
Input formats .md, .markdown, .txt, .html, .htm, .rtf, .tex, .rst, .org 和 .docx。
Output naming 名为 report.md 的源文件会生成 report.docx。现有的 DOCX 会生成 _restyled.docx 以保留原文件。
Output location 默认为输入文件的目录；-OutputDir 可以指定另一个目录。现有的输出文件会被跳过，不会被覆盖。
自动检测纯文本编码。HTML 输入可以包含内联 CSS，LaTeX 数学公式可以转换为 OMML。脚本通过扩展名映射格式，而不是依赖 Pandoc 不支持的 -f auto 选项。

高级特性

-FileList 、Windows 资源管理器拖放或 WorkBuddy 生成的文件列表进行批量转换。
持久化配置，在初始设置后记住 Pandoc 和 reference.docx 路径；每次运行时的 -ReferencePath 可以覆盖保存的模板。 -OutputDir 支持自定义输出目录，而默认输出保存在源文件同级。
现有的 DOCX 文件可以重新应用样式并输出为单独的
_restyled.docx
，从而保留原文件。
跳过现有的输出文件，以避免意外覆盖。
批处理任务在单个文件失败后仍会继续，并在处理完其余文件后报告错误。
Windows 特定的编码保护措施包括针对 PowerShell 脚本的 UTF-8 with BOM 以及批处理入口点中的 UTF-8 代码页设置。

name: convert2docx title: 文档转 Word（convert2docx） description: 把 Markdown / 纯文本 / HTML / RTF / LaTeX / reStructuredText / Org-mode 转成 .docx，并套用用户自己指定的 reference.docx 样式模板。支持单文件、批量、拖拽操作。当用户说"把 XX 转成 Word"、"批量转 docx"、"用我自己的样式模板转换文档"时使用本技能。 agent_created: true version: 1.0.0 license: MIT convert2docx — 文档转 Word
用途

本技能用于把各种常见文档格式（.md .markdown .txt .html .htm .rtf .tex .rst .org）统一转换成 .docx，并套用用户自己指定的 reference.docx 作为样式模板。

重要原则：reference.docx 由用户自己提供

本技能不附带任何默认 reference.docx 模板。

用户必须：

自己准备一个 reference.docx（可以用 Word 打开 Pandoc 导出的 docx，改好样式后另存）
首次运行时指定该文件路径
路径会被记忆到 config.ini，之后自动使用

如果用户没有准备 reference.docx：

不要自动下载或生成一个"默认模板"来用
提示用户："请先准备一个 reference.docx（用 Word 打开任意 pandoc 生成的 docx，改好样式后另存），然后告诉我路径"
首次运行流程
检测 config.ini 是否存在
不存在 → 依次询问用户：
pandoc.exe 路径（若 PATH 中已有 pandoc，直接回车即可）
reference.docx 路径（必填，不提供则退出）
把两个路径写入 config.ini
之后每次运行直接读取，不再询问
使用方法
方式 A：拖拽（推荐，Windows 资源管理器）

把一个或多个文件一次性拖到 scripts/convert2docx.bat 上，自动批量转换。bat 通过环境变量 C2D_FILES（| 分隔）把文件列表传给 ps1，规避 PowerShell 5.1 的参数绑定限制。

方式 B：命令行（PowerShell）

# 单文件

.\convert2docx.ps1 input.md

# 批量：从文件列表读取（一行一个路径）

.\convert2docx.ps1 -FileList list.txt

# 指定 reference（覆盖 config.ini 中的记忆值）

.\convert2docx.ps1 input.md -ReferencePath "C:\path\to\your\reference.docx"

# 指定输出目录

.\convert2docx.ps1 input.md -OutputDir "C:\output"

注意：不要用 .\convert2docx.ps1 a.md b.md 这种写法。PowerShell 5.1 的 -File 调用会把第二个路径当成参数名并抛 PositionalParameterNotFound。批量请用拖拽或 -FileList。

方式 C：在 WorkBuddy 对话中

直接对 WorkBuddy 说：

"把 D:\docs\report.md 转成 Word，用我自己的 reference.docx"
"批量转换 D:\docs\ 下所有 .md 文件"

WorkBuddy 会生成文件列表后调用 -FileList 来执行。

输入格式支持
格式 扩展名 说明
Markdown .md .markdown 默认
纯文本 .txt 自动识别编码
HTML .html .htm 含 CSS 的内联样式
RTF .rtf 富文本
LaTeX .tex 数学公式可转 OMML
reStructuredText .rst
Org-mode .org
输出规则
输出文件名：.docx
如果输入是 .docx：输出 _restyled.docx（不覆盖原件）
默认输出到与输入文件相同目录，可用 -OutputDir 指定
若输出文件已存在：自动跳过，不覆盖
配置文件 config.ini

首次运行后自动生成于 skill 根目录：

[pandoc]

path=C:\Program Files\Pandoc\pandoc.exe

[reference]

path=C:\Users\YourName\Documents\reference.docx

用户想改路径：直接编辑 config.ini，或删掉后重新运行。

脚本说明
文件 用途
scripts/convert2docx.ps1 主转换脚本（PowerShell，推荐）
scripts/convert2docx.bat Windows 拖拽入口（调 ps1）
依赖
pandoc：必须单独安装（https://pandoc.org/installing.html）。技能不打包 pandoc。 PowerShell 5.1+：Windows 自带。

注意：Windows PowerShell 5.1 读取含中文字符的 .ps1 脚本时，文件必须存为 UTF-8 with BOM。scripts/convert2docx.ps1 已按此格式保存，直接运行不会乱码或解析失败。修改该文件时务必保持 BOM。

常见坑
批量传文件不要用位置参数：ps1 a.md b.md 在 PS 5.1 下会抛 PositionalParameterNotFound。用拖拽或 -FileList。
路径含空格：所有脚本内部已对路径加引号，可放心使用
中文乱码：.bat 已加 chcp 65001；.ps1 必须存为 UTF-8 with BOM（已处理，修改时勿丢 BOM）
reference.docx 不存在：脚本会报错并提示，不会静默用默认样式 pandoc 不识别 -f auto：脚本已按扩展名显式映射输入格式（markdown/html/rtf/latex/rst/org/docx） 批量转换时某个文件失败：继续转换剩余文件，最后汇总报错
子进程输出编码：Windows PowerShell 5.1 的 stdout 是 GBK/ANSI，不是 UTF-8。程序化调用时按 GBK 解码
参考文档
详细配置说明：references/config.md
reference.docx 制作指南：references/make-reference.md
DOCX 转 PDF 批量转换器

Moltbook Ops