# Send Word Reader to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "word-reader",
    "name": "Word Reader",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/xtfnhcyjpgf/word-reader",
    "canonicalUrl": "https://clawhub.ai/xtfnhcyjpgf/word-reader",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/word-reader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=word-reader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "DEVELOPMENT.md",
      "PUBLISHING.md",
      "README.md",
      "SKILL.md",
      "demo.sh",
      "install.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "word-reader",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T15:57:57.945Z",
      "expiresAt": "2026-05-08T15:57:57.945Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=word-reader",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=word-reader",
        "contentDisposition": "attachment; filename=\"word-reader-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "word-reader"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/word-reader"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/word-reader",
    "downloadUrl": "https://openagent3.xyz/downloads/word-reader",
    "agentUrl": "https://openagent3.xyz/skills/word-reader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/word-reader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/word-reader/agent.md"
  }
}
```
## Documentation

### Word 文档读取器

使用 Python 解析 Word 文档，提取文本内容和结构化信息。

### 支持的功能

文档文本提取 - 提取段落、标题、页眉页脚内容
表格解析 - 读取表格数据并转换为结构化格式
图片处理 - 提取文档中的图片信息
元数据获取 - 读取文档属性（作者、标题、创建时间等）
批量处理 - 支持处理多个文档

### 基本文本提取

python3 {baseDir}/scripts/read_word.py <文件路径>

### 指定输出格式

# JSON 输出
python3 {baseDir}/scripts/read_word.py <文件路径> --format json

# 纯文本输出
python3 {baseDir}/scripts/read_word.py <文件路径> --format text

# Markdown 格式
python3 {baseDir}/scripts/read_word.py <文件路径> --format markdown

### 提取特定内容

# 只提取文本
python3 {baseDir}/scripts/read_word.py <文件路径> --extract text

# 提取表格数据
python3 {baseDir}/scripts/read_word.py <文件路径> --extract tables

# 获取文档元数据
python3 {baseDir}/scripts/read_word.py <文件路径> --extract metadata

### 批量处理

# 处理目录下所有 .docx 文件
python3 {baseDir}/scripts/read_word.py <目录路径> --batch

### 参数说明

参数说明默认值--format输出格式（json/text/markdown）text--extract提取内容类型（text/tables/images/metadata/all）all--batch批量处理模式false--output输出文件路径stdout--encoding文本编码（utf-8/gb2312）utf-8

### JSON 格式

{
  "metadata": {
    "title": "文档标题",
    "author": "作者姓名",
    "created": "2024-01-01T10:00:00",
    "modified": "2024-01-01T12:00:00"
  },
  "text": "文档全文内容...",
  "tables": [
    [
      ["表头1", "表头2"],
      ["行1列1", "行1列2"],
      ["行2列1", "行2列2"]
    ]
  ],
  "images": [
    {
      "filename": "image1.png",
      "description": "图片描述",
      "size": "1024x768"
    }
  ]
}

### Markdown 格式

# 文档标题

**作者**：作者姓名  
**创建时间**：2024-01-01 10:00:00

## 正文内容

这是文档的正文内容...

### 表格示例

| 表头1 | 表头2 |
|-------|-------|
| 行1列1 | 行1列2 |
| 行2列1 | 行2列2 |

![图片描述](image1.png)

## 图片列表

1. **image1.png** (1024x768) - 图片描述

### 错误处理

文件不存在：显示错误信息并退出
格式不支持：提示支持的文件类型
权限问题：提示文件访问权限
编码问题：尝试自动检测编码

### 1. 查看项目文档

python3 {baseDir}/scripts/read_word.py 项目需求.docx --format markdown

### 2. 提取会议记录

python3 {baseDir}/scripts/read_word.py 会议记录.docx --extract text

### 3. 批量处理文档

python3 {baseDir}/scripts/read_word.py ./文档目录 --batch --format json --output results.json

### 注意事项

支持 .docx 格式（Office 2007+）
.doc 格式需要额外依赖（如 antiword）
大文档处理可能需要较长时间
图片提取仅获取元数据，不包含实际图片数据
表格格式可能需要手动调整

### 常见问题

ModuleNotFoundError: 确保已安装 python-docx
PermissionError: 检查文件读取权限
UnicodeDecodeError: 尝试不同的编码格式

### 安装依赖

pip3 install python-docx

对于 .doc 格式支持：

# Ubuntu/Debian
sudo apt-get install antiword

# macOS
brew install antiword

### 自定义样式处理

脚本会自动处理以下文档元素：

标题级别（H1-H6）
段落样式
列表项目
页眉页脚
文档属性

### 性能优化

大文件流式处理
内存使用优化
进度显示（批量模式）
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: xtfnhcyjpgf
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T15:57:57.945Z
- Expires at: 2026-05-08T15:57:57.945Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/word-reader)
- [Send to Agent page](https://openagent3.xyz/skills/word-reader/agent)
- [JSON manifest](https://openagent3.xyz/skills/word-reader/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/word-reader/agent.md)
- [Download page](https://openagent3.xyz/downloads/word-reader)