Xpersona
Claim this agent
agentCLAWHUBUnverified

document-reader

通用文档读取工具，支持 PDF/DOCX/XLSX/PPTX/RTF/ODT 等多种文档格式，也支持 ZIP/TAR.GZ/RAR/7Z 等主流压缩包内文档直接读取 Skill: document-reader Owner: xiaoyaliu00 Summary: 通用文档读取工具，支持 PDF/DOCX/XLSX/PPTX/RTF/ODT 等多种文档格式，也支持 ZIP/TAR.GZ/RAR/7Z 等主流压缩包内文档直接读取 Tags: latest:1.0.0 Version history: v1.0.0 | 2026-04-08T08:42:48.169Z | user Initial release: support PDF/DOCX/XLSX/PPTX/RTF/ODT documents and ZIP/TAR/RAR/7Z compressed files Archive index: Archive v1.0.0: 4 files, 6842 bytes Files: scripts/document_reader.py (17331b), skill-card.md (1

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

4.2k

Updated

Oct 9, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 4.2K downloads reported by the source. Last updated 10/9/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
4.2K downloadsadoption · observed Oct 9, 2026
Latest release
1.0.0release · observed Apr 8, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176v3w9m19hha3zy3k0nga2t184e5sa:document-reader
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-xiaoyaliu00-document-reader/snapshot"

Documentation

CLAWHUB

5,190 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: document-reader
description: "通用文档读取工具，支持 PDF/DOCX/XLSX/PPTX/RTF/ODT 等多种文档格式，也支持 ZIP/TAR.GZ/RAR/7Z 等主流压缩包内文档直接读取"
version: "1.0.0"
---

# Document Reader - 通用文档读取技能

读取各种格式文档的内容，直接输出文本供 AI 分析。支持压缩包内文档直接读取，无需手动解压。

## 📦 支持格式

### 文档
| 格式 | 扩展名 | 说明 |
|------|--------|------|
| PDF | `.pdf` | 支持文本提取，依赖 poppler-utils |
| Microsoft Word | `.docx` | 完整提取所有段落文本 |
| Microsoft Excel | `.xlsx` | 按 Sheet 输出，每个 Sheet 输出为表格文本 |
| Microsoft PowerPoint | `.pptx` | 按 Slide 分块输出 |
| Rich Text Format | `.rtf` |  |
| OpenDocument Text | `.odt` |  |
| HTML | `.html`/`.htm` | 提取正文文本 |
| 纯文本 | `.txt`/`.md`/`.json`/`.xml`/`.py`/`.js` 等 | 直接读取 |

### 压缩包
| 格式 | 扩展名 | 功能 |
|------|--------|------|
| ZIP | `.zip` | 列出文件 ➜ 读取指定文档 |
| TAR | `.tar`/`.tar.gz`/`.tgz`/`.tar.bz2` | 列出文件 ➜ 读取指定文档 |
| RAR | `.rar` | 列出文件 ➜ 读取指定文档 |
| 7-Zip | `.7z` | 列出文件 ➜ 读取指定文档 |

## 🚀 快速开始

### 依赖安装

**Python 包：**
```bash
pip install textract python-docx openpyxl python-pptx rarfile py7zr --break-system-packages
```

**系统依赖（Ubuntu/Debian）：**
```bash
apt-get install -y poppler-utils antiword unrtf tidy libxml2-dev libxslt1-dev
```

## 💡 使用示例

### 1. 直接读取本地文档

```bash
# 读取 PDF 文件
python {baseDir}/scripts/document_reader.py --file /path/to/document.pdf

# 读取 Word 文档
python {baseDir}/scripts/document_reader.py --file /path/to/report.docx

# 读取 Excel 文件（输出带 Sheet 分隔的表格文本）
python {baseDir}/scripts/document_reader.py --file /path/to/data.xlsx

# JSON 格式输出（方便程序处理）
python {baseDir}/scripts/document_reader.py --file /path/to/data.xlsx --format json
```

### 2. 处理压缩包

**先列出压缩包里有哪些文件：**
```bash
# 列出 ZIP 包内容
python {baseDir}/scripts/document_reader.py --list /path/to/archive.zip

# 列出 RAR 包内容
python {baseDir}/scripts/document_reader.py --list /path/to/archive.rar

# 列出 7z 包内容
python {baseDir}/scripts/document_reader.py --list /path/to/archive.7z
```

**读取压缩包里的指定文档：**
```bash
# 读取 ZIP 包内的 Word 文档
python {baseDir}/scripts/document_reader.py --file /path/to/archive.zip --inner-path document.docx

# 读取 7z 包内的 PDF
python {baseDir}/scripts/document_reader.py --file /path/to/archive.7z --inner-path report.pdf
```

### 输出示例

**读取文档：**
```
=== report.pdf ===

# 项目进度报告

## 本周完成

1. 完成了前端界面开发
2. 修复了三个 Bug
3. 编写了接口文档

...
```

**列出压缩包：**
```
Archive: data.zip
Found 3 file(s):

  readme.txt
  docs/report.pdf
  data/sheet.xlsx
```

## ✨ 特性

- 🎯 **开箱即用** — 装完依赖直接用，无需复杂配置
- 📦 **支持压缩包** — 不用手动解压，直接列出并读取内部文件
- 🔍 **模糊匹配** — 大小写不敏感匹配文件名，找不到精确匹配时自动尝试
- 🎨 **多种输出格式** — 人类可读文本 / JSON 程序接口都支持
- 🧩 **完整支持所有常用格式** — 办公文档+压缩包全覆盖

## 📝 使用场景

- AI 分析各种办公文档
- 批量读取压缩包内的文档内容
- 快速查看附件内容
- 数据提取和预处理

## 作者

Created by xiaoya Liu with OpenClaw

_meta.json

{
  "ownerId": "kn7bpabfda1pxgynfp9w46kjjd84fe8z",
  "slug": "document-reader",
  "version": "1.0.0",
  "publishedAt": 1775637768169
}

skill-card.md

## Description:

Document Reader extracts text from PDF, DOCX, XLSX, PPTX, RTF, ODT, HTML, plain text, and selected files inside common archives for agent analysis.

This skill is ready for commercial/non-commercial use.

## Publisher:

[xiaoyaliu00](https://clawhub.ai/user/xiaoyaliu00)

### License/Terms of Use:

MIT-0

## Use Case:

Developers, engineers, and agent users use this skill to read common office documents, text files, and files stored inside archives so the extracted content can be analyzed or processed by an agent.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Archive handling and document extraction can expose the agent environment to untrusted or oversized files.

Mitigation: Use the skill only on files the user intends the agent to read, avoid untrusted oversized archives, and review extracted content before relying on it.

Risk: The documented dependency installation command can install packages system-wide.

Mitigation: Install dependencies in an isolated virtual environment or container before running the document reader.

## Reference(s):


## Skill Output:

**Output Type(s):** [text, markdown, json, shell commands, guidance]

**Output Format:** [Plain text or JSON emitted by a command-line document reader, with Markdown documentation and shell command examples.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Can list archive contents or read a specified file from an archive; long text output may be truncated in human-readable mode.]

## Skill Version(s):

1.0.0 (source: frontmatter and server-resolved release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/xiaoyaliu00/skills/document-reader",
      "sourceUrl": "https://clawhub.ai/xiaoyaliu00/skills/document-reader",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T05:56:35.991Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-xiaoyaliu00-document-reader/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-xiaoyaliu00-document-reader/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T05:56:35.991Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "4.2K downloads",
      "href": "https://clawhub.ai/xiaoyaliu00/document-reader",
      "sourceUrl": "https://clawhub.ai/xiaoyaliu00/document-reader",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T05:56:35.991Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.0",
      "href": "https://clawhub.ai/xiaoyaliu00/document-reader",
      "sourceUrl": "https://clawhub.ai/xiaoyaliu00/document-reader",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-08T08:42:48.169Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-xiaoyaliu00-document-reader/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-xiaoyaliu00-document-reader/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.0",
      "description": "Initial release: support PDF/DOCX/XLSX/PPTX/RTF/ODT documents and ZIP/TAR/RAR/7Z compressed files",
      "href": "https://clawhub.ai/xiaoyaliu00/document-reader",
      "sourceUrl": "https://clawhub.ai/xiaoyaliu00/document-reader",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-08T08:42:48.169Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to document-reader and adjacent AI workflows.