A specialized tool for AI agents to read, extract, and analyze text content from Korean HWP and HWPX document formats.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hwp-reader
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install hwp-reader using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is HWP Reader?
The HWP Reader is a professional integration for Openclaw Skills designed to bridge the gap between AI agents and Korean document formats. It provides robust support for both legacy HWP files using the pyhwp library and modern HWPX files through ZIP-based XML parsing. This skill allows developers to integrate Hangul Word Processor document processing into their automated workflows, making Korean government forms, support applications, and business documents accessible for deep analysis and content extraction within the ecosystem of Openclaw Skills.
HWP Reader Use Cases
- Analyzing Korean government support application forms and grant documents.
- Automating the extraction of text from legacy HWP archives for data migration and indexing.
- Comparing differences between two versions of a Hangul document to report changes.
- Identifying specific fields and blanks within document templates for automated content suggestions.
- Summarizing lengthy Korean reports or business proposals for rapid information retrieval.
How HWP Reader Works
- The AI agent identifies the input document extension as either .hwp or .hwpx.
- For legacy .hwp files, Openclaw Skills invokes the pyhwp library to extract text and identify structural markers like table placeholders.
- For modern .hwpx files, the skill treats the file as a ZIP archive to access internal XML structures.
- It extracts a quick preview from the PrvText.txt file or performs a deep dive into sorted Section XMLs for full content retrieval.
- The extracted text is then returned to the agent for summarization, translation, or template filling as part of the Openclaw Skills workflow.
HWP Reader Setup
Ensure you have Python 3.9+ installed, then install the required pyhwp library to enable full compatibility:
pip install pyhwp
The skill utilizes standard Python libraries like zipfile and xml.etree.ElementTree for HWPX processing, requiring no additional external dependencies for modern formats.
HWP Reader Data Schema & Taxonomy
The HWP Reader processes document data into structured text outputs while maintaining a mapping of internal XML components and metadata.
| Feature | HWP (Legacy) | HWPX (Modern) |
|---|---|---|
| Extraction Method | pyhwp / hwp5txt | ZIP + XML Parsing |
| Table Detection | Placeholder markers | XML Tag Analysis |
| Metadata Source | via hwp5 metadata | version.xml |
| Image Support | Not supported | Extracted from BinData/ |
Text extraction from HWPX includes Section XML parsing to ensure full content retrieval beyond the 1KB preview limit.
HWP Reader Advanced Features
- Automatic format detection between legacy binary formats and modern XML-based ZIP containers.
- Granular section-by-section parsing for HWPX to bypass truncated preview limits.
- Integrated table detection markers to help AI agents understand document layout within Openclaw Skills.
- Support for metadata extraction to identify document authors, versions, and creation dates.
- Capability to handle complex government-style document structures for automated form processing.
SKILL.md
Loading
Related Openclaw Skills
Gateway Watchdog
A resilient self-healing system designed to monitor, backup, and automatically recover the Openclaw Skills gateway from process or configuration failures.
git-auto
A comprehensive Git automation skill that streamlines status checks, smart commits, and safe pushes with intelligent defaults.
Decision Log
A professional decision-tracking skill that records rationales and automatically evaluates results after 30 days.
Data Scraper
A lightweight web collection utility for extracting structured data and monitoring site changes without a headless browser.
Kmong Automation Skill
A browser automation tool for streamlining freelancer registration and service profile management on the Kmong marketplace.
Korean Invoice Generator
An automated tool for generating standardized Korean estimates and tax invoices with automatic VAT calculations and business data management.
Featured*
