A powerful Windows-based automation tool for batch converting Hancom Office HWP/HWPX documents into various professional formats like PDF and DOCX.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hwp-batch-convert
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-batch-convert 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 Batch Convert?
HWP Batch Convert is a specialized Openclaw Skills utility designed to streamline the management of Hancom Hangul documents on Windows environments. By leveraging the Hancom Office COM API, it allows developers and power users to perform bulk conversions of HWP and HWPX files into modern formats including PDF, DOCX, ODT, and even image formats like PNG or JPG.
The skill is engineered for robustness, featuring a whitelist-based automatic dialog handler that bypasses repetitive security popups common in Hancom Office automation. This makes it an ideal solution for high-volume document processing workflows where manual intervention is a bottleneck.
HWP Batch Convert Use Cases
- Mass converting legacy HWP/HWPX contracts or reports into PDF for long-term archiving.
- Migrating entire directory structures of Hancom documents into DOCX for collaborative editing in Microsoft Word.
- Automating the generation of image previews (PNG/JPG) for document management system thumbnails.
- Generating machine-readable conversion reports using JSON for integration into larger CI/CD or data pipelines.
- Testing conversion workflows in a mock environment to verify path logic before executing real file operations.
How HWP Batch Convert Works
- The user provides source file paths or directory locations as input to the Openclaw Skills script.
- The Task Planner scans the input, identifying valid .hwp and .hwpx files while respecting or ignoring subdirectories based on flags.
- A conversion plan is generated, checking for potential filename collisions and determining output paths.
- If --auto-allow-dialogs is enabled, a specialized background handler monitors for Hancom-specific security prompts and automatically grants access.
- The HwpConverter service invokes the pywin32 COM interface to open the documents in Hancom Office and export them to the requested format.
- A final status report is generated in the console or as a JSON file, detailing successful conversions and any skipped items.
HWP Batch Convert Setup
This skill requires a Windows environment with Hancom Office (Hangul) installed and the pywin32 library configured.
# Navigate to the skill directory
cd skills/hwp-batch-convert
# Install required Python dependencies
pip install pywin32
# Run a basic conversion to PDF
python scripts/hwp_batch_convert.py "C:\path\to\hwp_docs" --format PDF --same-location
HWP Batch Convert Data Schema & Taxonomy
The skill produces structured output to ensure interoperability with other Openclaw Skills.
| Feature | Description |
|---|---|
| Input Formats | .hwp, .hwpx |
| Output Formats | PDF, HWPX, DOCX, ODT, HTML, RTF, TXT, PNG, JPG, BMP, GIF |
| Metadata | JSON reports including source path, destination path, and status |
| Dialog Events | Logs of all automatically handled security popups in auto_dialog_events |
HWP Batch Convert Advanced Features
- Mock Mode: Run full logic simulations without opening Hancom Office using the --mode mock flag.
- Plan-Only Execution: Generate a detailed JSON report of intended actions without performing any file writes.
- Security Automation: Intelligent whitelist-based clicker for 'Allow Access' dialogs to enable headless-style operation.
- Collision Management: Automatic numerical suffixing for output files to prevent accidental overwriting of existing data.
- Recursive Processing: Full tree traversal of directories with the --include-sub flag enabled by default.
SKILL.md
Loading
Related Openclaw Skills
Knitify Health Chatbot
A research-powered health and science assistant that provides evidence-based answers with PubMed and ClinicalTrials.gov citations.
Skill Optimizer
Skill Optimizer is a governance and maintenance tool designed to audit conversation history and local skill sets to improve triggering accuracy and workflow hygiene.
Li Lu China Opportunity Analysis
A professional analysis skill for identifying long-term investment opportunities and core assets within the context of China's massive modernization process.
Create PowerPoint (python-pptx)
A sophisticated automation skill for generating professional PowerPoint presentations programmatically using Python.
Duan Yongping Corporate Culture Analysis
A strategic evaluation tool for assessing corporate culture and long-term investment value based on Duan Yongping's Benfen philosophy.
XiaoSu Search
A high-performance web search skill for Openclaw Skills that enables real-time information retrieval with advanced filtering and deep content extraction.
Featured*
