HWP 공문 자동화 도구

• Windows 11 (64비트) PC — 관리자 계정(또는 관리자 암호를 아는 계정)으로 로그인
• 정품 한컴오피스 한/글 — HWP 파일을 변환하려면 필요. PDF/PPTX/XLSX/HWPX만 쓸 거면 없어도 됩니다.
• 인터넷 연결 — Python/Node.js/AI 프로그램을 설치 중에 자동으로 내려받습니다. 이미 다 설치돼 있다면 인터넷 없이도 진행됩니다.
• (선택) 텔레그램 계정 — 변환 완료 알림을 받고 싶다면

배포 파일(hwp-watchdog.zip)을 다운로드 폴더에 그대로 두고 압축을 풀면(마우스 오른쪽 클릭 → "압축 풀기"), 자동으로 아래 폴더가 만들어집니다. 이 설명서의 모든 경로는 이 위치를 기준으로 합니다.

복사한 경로를 파일 탐색기 주소창이나 Win+R 실행 창에 붙여넣고 Enter를 누르면 이 폴더가 바로 열립니다. (브라우저 보안 정책상 이 설명서 안에서 exe 파일을 직접 눌러서 실행시킬 수는 없어서, 경로를 복사해 직접 열도록 안내합니다.)

이 폴더 안에는 설치 프로그램(exe)이 두 개 들어 있습니다. 순서대로 실행해야 합니다.

위 경로를 복사해 Win+R 실행 창에 붙여넣고 Enter를 누르면 바로 실행됩니다. 또는 위 1단계에서 연 폴더에서 hwp-watchdog-설치.exe를 직접 더블클릭해도 됩니다.

더블클릭하면 잠시 뒤 이런 창이 뜹니다.

예를 눌러주세요. Python/Node.js/AI 프로그램을 자동으로 설치하고 예약 작업(로그인 시 자동 실행)을 등록하려면 관리자 권한이 필요합니다. 이후 검은 콘솔 창이 열리고 이렇게 뜹니다:

Python이 이미 설치돼 있다면 이 자동 설치 과정은 건너뛰고 바로 "Python 확인됨" 줄부터 시작합니다. 자동 설치가 실패하면(회사/학교 정책으로 winget이 막혀 있는 경우 등) python.org에서 직접 설치하라는 안내가 뜨고 설치가 중단되니, 안내대로 설치한 뒤 hwp-watchdog-설치.exe를 다시 실행하면 됩니다.

프로그램 파일 자체를 저장할 폴더를 물어봅니다. 잘 모르면 그냥 Enter만 누르세요.

이 컴퓨터에 한컴 보안 모듈이 처음이면 "경고: 보안 모듈 DLL을 찾지 못했습니다"가 뜹니다 — 이 경우 SECURITY_MODULE.md 안내를 따라 공식 사이트에서 받아야 실제 HWP 변환이 동작합니다. 설치 자체는 이 경고와 상관없이 계속 진행됩니다.

공문을 변환할 때마다 AI가 내용을 요약해 주는 기능을 쓰려면 Claude Code / Codex / Antigravity 중 하나가 필요합니다. 먼저 이미 설치돼 있는지 자동으로 찾아봅니다.

하나만 찾으면 자동으로 그걸 씁니다. 여러 개 설치돼 있으면 화살표(↑↓) + Enter로 고르거나 번호를 눌러 선택합니다.

아무것도 못 찾으면 — 이 컴퓨터가 완전히 새 컴퓨터라 AI 프로그램이 하나도 없는 경우, 예전에는 그냥 "변환만" 모드로 넘어갔지만 이제는 그 자리에서 설치할지 물어봅니다:

어떤 걸 골라도 상관없습니다(전부 무료로 시작할 수 있는 AI 코딩 도구입니다). 이미 유료로 구독 중인 AI 서비스가 있다면 같은 회사 도구를 고르세요(예: Claude 유료 구독 → Claude Code, ChatGPT 유료 구독 → Codex) — 요약 품질이 더 좋습니다. 딱히 구독 중인 게 없다면 Antigravity를 추천합니다. 고른 뒤에는 필요한 걸 전부 자동으로 설치합니다:

Antigravity를 골랐다면 Node.js 없이 바로 winget install Google.AntigravityCLI로 설치됩니다(로그인 안내는 동일).

"아니요"를 고르면 지금처럼 "변환만" 모드로 설치가 계속되고, 각 프로그램의 수동 설치 명령어를 화면에 안내합니다. 나중에 AI 프로그램을 설치한 뒤 configure.bat을 다시 실행하면 요약 기능을 켤 수 있습니다.

세 개의 폴더 경로를 물어봅니다. 전부 자동으로 만들어지므로 잘 모르면 Enter만 누르면 됩니다.

앞으로 교사가 실제로 쓰는 방법은 이 "공문함"(감시 폴더)에 HWP/PDF/PPTX/XLSX/HWPX 파일을 갖다 놓는 것뿐입니다. 나머지는 전부 자동입니다.

변환할 때마다 AI가 내용을 요약해 텔레그램으로 알려주는 기능을 켤지 물어봅니다. (4단계에서 이미 AI 프로그램을 확인·설치했다면 이 질문은 건너뛰고 바로 텔레그램 설정으로 넘어갑니다.)

"예"를 고르면 알림을 어떻게 받을지 먼저 고릅니다 -- 텔레그램(휴대폰 등 어디서나 확인, 봇 설정 필요)과 윈도우 알림(설정 없이 바로 되지만 이 컴퓨터 화면 앞에 있을 때만 보임) 중 하나입니다:

"윈도우 알림"을 고르면 추가 설정 없이 바로 끝입니다:

"텔레그램"을 고르면 봇 설정으로 이어집니다:

두 값을 chatID:token 형태로 한 줄에 붙여넣으면(예: 123456789:987654321:AA...) 저장 후 바로 테스트 메시지를 보내 확인합니다. 연수 중에는 건너뛰어도 되고, 나중에 configure.bat으로 언제든 설정할 수 있습니다.

두 방식 모두 나중에 configure.bat을 다시 실행하면 바꿀 수 있습니다.

여기부터는 사람이 더 할 일이 없습니다. 컴퓨터 로그인할 때마다 자동으로 백그라운드에서 켜지도록 예약 작업에 등록합니다(창이 저절로 뜨지는 않습니다 — 대시보드가 보고 싶을 때만 다음 단계에서 설치할 바로가기로 열면 됩니다).

예약 작업 하나(HWP-Watchdog)는 실제 감시·변환·AI요약을 담당하고, 다른 하나(HWP-Watchdog-HealthCheck)는 5분마다 그 프로세스가 살아있는지 확인해서 죽어있으면 자동으로 되살리는 안전장치입니다. 여기서 창이 닫히면 (또는 Enter를 누르면) 감시 프로그램 설치는 끝입니다.

위 경로를 복사해 실행하거나 폴더에서 직접 더블클릭합니다. 방금 설치한 감시 프로그램의 폴더를 자동으로 찾아서 그 안에 대시보드 프로그램을 넣습니다 — 설치 위치를 새로 물어보지 않고 바로 진행됩니다.

설치가 끝나면 시작 메뉴와(체크하면) 바탕화면에 "HWP 공문 대시보드" 바로가기가 생깁니다. 바로가기를 실행하면:

• 감시 프로그램이 이미 켜져 있으면 → 그 서버에 자동으로 붙어서 바로 보여줍니다
• 감시 프로그램이 아직 안 켜져 있으면 → 대시보드 프로그램이 직접 서버를 켜서 보여줍니다

둘 중 어느 경우든 브라우저 탭이 아니라 주소창 없는 독립된 프로그램 창으로 뜹니다.

시작 메뉴/바탕화면의 "HWP 공문 대시보드"를 실행하면 뜨는 화면입니다. 아래는 예시 데이터로 채운 실제 화면입니다(실제 사용 시에는 여기에 진짜 처리한 공문이 카드로 쌓입니다).

실제로 띄운 대시보드 화면(예시 데이터로 채움, 2026-09-09 기준 최신 UI)

대시보드 오른쪽 채팅창에서 처리된 공문에 대해 자유롭게 물어볼 수 있습니다. "이번 달 마감인 공문 있어?"처럼 물으면 실제 처리된 문서 내용을 찾아서 답합니다.

채팅창 제목 옆 드롭다운에서 재시작 없이 바로 두 모드를 전환할 수 있습니다.

대부분의 문제는 AI CLI에게 오류 메시지를 그대로 보여주고 물어보면 해결됩니다. 그 전에 확인해볼 것들:

• status.bat 실행해서 현재 상태 확인
• AI 요약이 계속 실패한다면 → 로그인을 안 했을 가능성이 큽니다. 명령 프롬프트에서 claude(또는 codex/agy)를 입력해 로그인부터 확인하세요.
• 대시보드 창이 안 뜬다면 → 감시 프로그램이 아직 실행 전일 수 있습니다. 로그인 직후엔 예약 작업이 뜨는 데 최대 1~2분 걸립니다.
• 오류 메시지를 그대로 복사해서 Claude Code 등 AI CLI에게 이 폴더에서 열고 물어보기 — 대부분의 설정 문제는 AI가 로그를 보고 직접 진단·수정할 수 있습니다
• 그래도 안 되면 logs\background.log, 공문함 안 watchdog.log 확인

지금은 마감일이 대시보드 캘린더에만 표시되지만, Google Tasks에 실제 "할 일"로 자동 등록하는 것도 기술적으로 가능합니다 — 등록되면 휴대폰의 Google 캘린더/Tasks 앱에도 곧바로 동기화됩니다. 다만 이 설치 프로그램에 포함된 자동 기능은 아니며, 원하는 분이 직접 설정해야 하는 실험적 확장입니다.

1) CLI 설치 — installer\install_google_tasks_cli.bat을 실행하면 winget으로 gws만 설치됩니다(연동 자체는 안 됨).

2) 인증 — gcloud CLI를 먼저 설치한 뒤, 명령 프롬프트에서 gws auth setup을 실행합니다. Google Cloud 프로젝트를 자동으로 만들고 필요한 API를 켠 뒤 로그인 창을 띄웁니다.

3) 작업 등록 예시 — 인증이 끝나면 아래처럼 직접 호출할 수 있습니다(공문 처리 결과와 연결하려면 별도 스크립트 작성이 필요합니다):