Token导航 LogoToken导航TokenDH.com
中转站排行榜
效率需要联网clawhub未标认证来源可访问clear审计提醒

hwp-batch-convert-repo（hwp 批量转换仓库）

Agent Skill

hwp-batch-convert-repo 用于整理文档、README、Markdown 和说明材料，适合在 OpenClaw 中需要把零散信息整理成结构清晰的文档时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

总安装

5,808

周安装

242

GitHub Stars

公开资料未说明

下载量

1,936
OpenClaw

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

来源数

2

许可证

MIT-0

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：hwp-batch-convert-repo（hwp 批量转换仓库）
来源仓库：https://github.com/twbeatles/hwp-batch-convert-repo
安装命令：
openclaw skills install hwp-batch-convert-repo
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 OpenClaw 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

ClawHubOpenClaw
openclaw skills install hwp-batch-convert-repo

简介

使用 HWP COM 自动化批量转换 한컴 한글 文档至多种格式。

  • 支持 PDF、DOCX、ODT、HTML、RTF、TXT 及图像输出。
  • 适用于文档标准化处理与多格式发布需求。
  • 安装命令：openclaw skills install hwp-batch-convert-repo。
  • 仅限 Windows 平台使用，依赖本地 HWP 软件环境。

SKILL.md

name
hwp-batch-convert
description
Batch-convert 한컴 한글 문서(HWP/HWPX) to PDF, HWPX, DOCX, ODT, HTML, RTF, TXT, and image formats on Windows using HWP COM automation. Use when the user asks for 이 폴더 hwp 전부 pdf로 바꿔줘, hwp/hwpx/doc/pdf 일괄 변환, 한글문서 일괄 처리, 폴더 단위 변환, 여러 한글 파일을 다른 형식으로 내보내기, or wants a Korean-friendly batch conversion/report flow. Prefer this skill for Windows environments with Hancom HWP installed; do not use it for non-HWP document families unless the task is explicitly about HWP/HWPX conversion.

Hwp Batch Convert

Use this skill for Windows 기반 한글(HWP/HWPX) 문서 일괄 변환.

Current scope:

  • 폴더 단위 일괄 변환
  • 파일 여러 개 일괄 변환
  • HWP/HWPX → PDF 기본 변환
  • HWP/HWPX → HWPX/DOCX/ODT/HTML/RTF/TXT/PNG/JPG/BMP/GIF 변환
  • 동일 형식 자동 건너뜀
  • 출력 파일명 충돌 시 자동 번호 부여
  • 작업 계획만 확인하는 --plan-only
  • OpenClaw 상위 레이어 연동용 --json, --report-json
  • 한글 보안 확인 팝업 자동 허용용 --auto-allow-dialogs
  • 로컬 UI 검증용 --self-test-dialog-handler
  • 테스트용 --mode mock

Source basis

This skill reuses the design of the local/source repo:

  • tmp/HwpMate
  • upstream: https://github.com/twbeatles/HwpMate

Main logic origin:

  • hwpmate/services/hwp_converter.py
  • hwpmate/services/task_planner.py
  • hwpmate/constants.py
  • hwpmate/path_utils.py

If you need the mapping details or reuse rationale, read:

  • references/hwpmate-reuse-notes.md

If you need the popup whitelist / safety details, read:

  • references/auto-allow-dialogs.md

Quick start

같은 폴더에 PDF 출력:

python skills/hwp-batch-convert/scripts/hwp_batch_convert.py "C:\docs\contracts" --format PDF --same-location

별도 출력 폴더로 변환:

python skills/hwp-batch-convert/scripts/hwp_batch_convert.py "C:\docs\hwp" --format PDF --output-dir "C:\docs\pdf" --auto-allow-dialogs

여러 파일 한 번에 변환:

python skills/hwp-batch-convert/scripts/hwp_batch_convert.py "C:\docs\a.hwp" "C:\docs\b.hwpx" --format DOCX --output-dir "C:\docs\docx"

실제 변환 없이 계획만 확인:

python skills/hwp-batch-convert/scripts/hwp_batch_convert.py "C:\docs\hwp" --format PDF --output-dir "C:\docs\pdf" --plan-only --json

테스트용 모의 변환:

python skills/hwp-batch-convert/scripts/hwp_batch_convert.py "C:\docs\sample" --format PDF --output-dir "C:\docs\out" --mode mock --json

Main script

scripts/hwp_batch_convert.py

Parameters:

  • sources...: 입력 파일/폴더 경로 하나 이상
  • --format: 출력 형식 (PDF, HWPX, DOCX, ODT, HTML, RTF, TXT, PNG, JPG, BMP, GIF, HWP)
  • --same-location: 원본과 같은 폴더에 출력
  • --output-dir: 출력 루트 폴더
  • --include-sub: 하위 폴더 포함(기본값)
  • --no-include-sub: 하위 폴더 제외
  • --overwrite: 같은 이름 출력 허용
  • --plan-only: 실제 변환 없이 작업 계획만 생성
  • --mode real|mock: 실변환 또는 모의 변환
  • --auto-allow-dialogs: 제목 한글, 본문에 접근하려는 시도, 버튼 모두 허용/허용 조건을 모두 만족하는 보안 팝업만 자동 클릭
  • --json: stdout JSON 출력
  • --report-json: 결과 JSON 파일 저장
  • --self-test-dialog-handler: 로컬 테스트용 샘플 한글 창을 띄워 자동 클릭 로직만 검증

Recommended workflow

  1. 사용자 요청이 폴더/여러 파일 기반 HWP/HWPX 변환인지 확인한다.
  2. 출력 형식이 명시되지 않았으면 보통 PDF를 기본 제안으로 사용한다.
  3. 먼저 --plan-only --json 으로 대상/건너뜀/출력 경로를 확인한다.
  4. 환경이 Windows + 한글 설치 + pywin32 가능하면 --mode real 로 실행한다.
  5. 환경 검증이 먼저 필요하면 --mode mock 으로 경로/출력 구조만 검증한다.
  6. 필요하면 --report-json 으로 결과 파일을 남긴다.

Operational notes

  • 이 스킬은 사실상 Windows 전용이다.
  • 실변환(--mode real)은 한컴 한글 설치와 pywin32가 필요하다.
  • --auto-allow-dialogs 는 화이트리스트 방식이다. 제목이 한글 이고, 본문에 접근하려는 시도 가 있으며, 버튼이 모두 허용 또는 허용 인 경우에만 클릭한다.
  • 위 조건에 맞지 않는 다른 팝업은 자동으로 건드리지 않는다. 감지되더라도 클릭 없이 이벤트만 남기거나 무시한다.
  • 자동 허용 기록은 stdout JSON/--report-json 의 auto_dialog_* 필드와 auto_dialog_events 배열에서 확인한다.
  • 한글 COM 자동화가 실패하면 --mode mock 으로 스킬/경로 로직만 먼저 검증하고, 이후 환경 문제를 분리 진단한다.
  • 여러 폴더를 동시에 입력하면서 --output-dir 를 쓰면, 파일명 충돌 가능성이 있으니 결과 경로를 확인한다.
  • 기본 입력 확장자는 .hwp, .hwpx 만 대상으로 한다.
  • 사용자 요청이 DOCX/PDF 일반 문서 처리 중심이고 HWP가 핵심이 아니면 다른 문서 스킬/도구를 우선 고려한다.

适合场景

01

OpenClaw 用户查找和安装 Skill 时

02

用户想查找某类 Agent Skill 时

03

需要根据任务场景推荐可安装能力包时

04

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

补充不同宿主或平台的使用分布数据

能力 5

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

OpenClaw

97.31%
按下载量换算1,884

安全审计

VirusTotal

可疑

ClawScan

通过

Static analysis

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果，不能写成本站确认安全。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/twbeatles/hwp-batch-convert-repo

SKILL.md 来源

clawhub.ai

/twbeatles/hwp-batch-convert-repo

继续浏览同类 Skills

更多效率 Skills（21,003）返回 Skills 目录

上一个 Skill

hwp-batch-convert（hwp 批量转换）

hwp-batch-convert 用于补充效率相关能力，适合在 OpenClaw 中需要让 Agent 承接效率相关任务时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

hwp-extract-pipeline（hwp 提取管道）

hwp-extract-pipeline 用于处理图像、截图、视觉识别或图片素材相关工作，适合在 OpenClaw 中需要让 Agent 分析图片、整理视觉素材或辅助图像流程时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。