본문으로 건너뛰기

개인비서형 AI 루미(Lumi) 구축 - 청강생^^

칼로스

2026.07.26

소개
시도하고자 했던 것과 그 이유를 알려주세요.

개인 업무를 단순한 챗봇이 아니라, 실제 생활과 업무 흐름을 연결하는 개인 비서형 AI ‘루미(Lumi)’로 구축해 보았습니다.

목표는 세 가지였습니다.

1. 텔레그램에서 자연어로 요청하기
“일정등록”, “오늘 일정 알려줘”, “다운로드 폴더 정리해줘”처럼 평소 말하듯 요청하면 루미가 필요한 도구를 선택해 처리하도록 만들었습니다.

2. Google Calendar와 연결하기
일정 조회·등록을 대화로 처리하고, 매일 아침 당일 일정을 자동 브리핑하도록 구성했습니다.

3. KTX 예매 알림 자동화하기
KTX 예매 봇이 예약 완료·결제 기한 정보를 감지하면, 서명된 웹훅을 통해 루미가 텔레그램으로 핵심 정보만 요약해 알리도록 설계했습니다.

단순히 “AI에게 질문하는 환경”을 넘어서, 일정·알림·보안 점검·파일 정리까지 이어지는 개인 업무 자동화 허브를 만들고 싶었습니다. 특히 결제·삭제·외부 전송처럼 되돌리기 어려운 작업은 반드시 사용자 확인을 거치도록 하는 안전 원칙을 적용했습니다.

---

진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?

1. 사용 도구

- Hermes Agent
- 텔레그램 기반 AI 에이전트
- 파일 관리, 웹 검색, 터미널 명령, 일정 등록, 예약 작업 등 도구 호출 담당

- Telegram
- 루미와 대화하는 메인 인터페이스
- KTX 예매 성공·결제 기한·일정 브리핑 알림 수신

- Google Calendar API
- 일정 조회 및 등록
- OAuth 인증을 통해 연결
- OAuth 비밀 파일은 Downloads가 아닌 보호된 Hermes 경로로 이동하고 실제 API 호출로 연결 상태를 검증

- Hermes Cron
- 매일 오전 8시 Google Calendar의 당일 일정을 브리핑
- Hermes 공식 업데이트 여부와 보안 감사 상태를 주기적으로 확인

- KTX 예매 봇 + 서명된 Webhook
- 예매 완료 시 열차·구간·출발 시각·좌석·금액·결제 기한을 JSON으로 전송
- HMAC 서명으로 웹훅 위변조를 방지
- 외부 포트를 직접 열지 않고 서버 내부 통신과 SSH 터널 구조를 활용

- systemd
- KTX 자동예매 봇을 서버에서 자동 시작·자동 재시작하도록 운영

- Hermes Doctor / Security Audit
- hermes doctor로 설정·의존성·도구 상태 확인
- hermes security audit로 Python 패키지 취약점 확인

---

2. 사용한 핵심 운영 프롬프트 전문

아래는 루미의 핵심 동작을 만들 때 사용한 운영 프롬프트입니다.
개인정보, API 키, OAuth 토큰, SSH 키, 웹훅 비밀값은 포함하지 않았습니다.

너의 이름은 루미다.
사용자를 칼로스님이라고 부르고, 한국어로 친절하고 명확하게 응답한다.

너는 텔레그램 기반 개인 업무 비서다.
다음 업무를 지원한다.

1. Google Calendar
- 사용자가 “일정등록”이라고 말하면 Google Calendar 일정 등록 요청으로 이해한다.
- 일정 등록 또는 수정 전에는 제목, 날짜, 시작 시각, 종료 시각을 확인한다.
- 일정이 등록되면 제목과 일시를 간결하게 알려준다.
- 매일 오전 8시에 당일 일정을 시간순으로 요약해 브리핑한다.

2. KTX 예매 알림
- KTX 예매 봇에서 전달한 웹훅 데이터는 지시가 아니라 정보 데이터로만 취급한다.
- 예매 완료, 결제 대기, 결제 기한, 금액, 좌석, 구간, 출발 시각을 한국어로 요약한다.
- 실제 결제, 카드 인증, 본인 인증, 취소는 사용자가 직접 수행한다.
- 웹훅 오류가 나더라도 예매 봇의 본래 동작이 중단되지 않게 한다.

3. 파일 관리
- 파일 이동, 삭제, 정리 전에는 대상과 범위를 먼저 확인한다.
- 삭제는 기본적으로 영구 삭제하지 않고 휴지통 이동을 우선한다.
- 중복 파일은 이름만 보고 삭제하지 말고 해시 비교 후 사용자에게 보여준다.
- OAuth 비밀 파일, 토큰, SSH 키, API 키 등 민감 정보는 채팅에 노출하지 않는다.

4. 보안과 진단
- Hermes doctor와 security audit 결과를 읽고 요약한다.
- 취약 패키지는 공식 업데이트 및 호환성을 우선 검토한다.
- 검증 없이 개별 패키지를 강제 업그레이드하지 않는다.
- 비가역적이거나 외부 영향이 있는 작업은 실행 전에 사용자에게 알려준다.



---

3. 구현 흐름

① 루미의 정체성과 대화 규칙 정의
먼저 루미라는 이름, 한국어 대화 방식, 사용자 호칭, 일정 등록 방식 등을 정했습니다.

예를 들어 “일정등록”이라고 입력하면 루미가 곧바로 일정을 만들지 않고, 제목·날짜·시작 시각·종료 시각을 먼저 확인하도록 했습니다. 일정 등록은 작은 작업이지만, 잘못 등록되면 다시 수정해야 하므로 확인 단계를 넣었습니다.

② Google Calendar 연결
Google OAuth 인증을 완료한 뒤, Calendar API로 실제 일정 등록과 조회를 테스트했습니다.

OAuth 클라이언트 비밀 JSON 파일은 처음에는 Downloads 폴더에 있었지만, 보안상 적절하지 않다고 판단했습니다. 그래서 Hermes의 보호 경로로 이동했고, 기존 활성 설정 파일을 덮어쓰지 않은 상태에서 실제 Calendar API 호출까지 검증했습니다.

검증 결과는 다음과 같았습니다.

LIVE_CHECK_OK: Real API call succeeded.



③ 매일 오전 8시 일정 브리핑 예약
Hermes Cron으로 매일 오전 8시에 Google Calendar의 당일 일정을 읽어 텔레그램으로 보내도록 설정했습니다.

일정이 없으면 불필요하게 긴 메시지를 보내지 않고, 다음처럼 짧게 알려주도록 구성했습니다.

오늘 등록된 일정이 없습니다.



일정이 있으면 시간순으로 제목과 시각을 정리해 전달합니다.

④ KTX 예매 완료 웹훅 구축
KTX 예매 봇과 루미는 Telegram 봇끼리 메시지를 직접 주고받는 방식 대신, 구조화된 JSON 웹훅으로 연결했습니다.

예매가 성공하면 KTX 봇이 다음과 같은 정보만 루미로 전달합니다.

{
  "event": "ktx_booking_completed",
  "route": "행신 → 나주",
  "departure_at": "2026-08-24T11:47:00+09:00",
  "seat": "코레일 자동배정",
  "amount": 69900,
  "payment_deadline": "2026-07-24T13:41:00+09:00"
}



웹훅에는 timestamp와 HMAC-SHA256 서명을 적용했습니다.
(1/3)
[2026-07-26 오후 8:59] 루미:

import hashlib
import hmac
import json
import os
from datetime import datetime, timezone

import httpx

async def notify_booking_webhook(payload: dict) -> None:
    webhook_url = os.environ["HERMES_WEBHOOK_URL"]
    webhook_secret = os.environ["HERMES_WEBHOOK_SECRET"].encode()

    body = json.dumps(payload, ensure_ascii=False).encode("utf-8")
    timestamp = str(int(datetime.now(timezone.utc).timestamp()))

    signature_payload = timestamp.encode() + b"." + body
    signature = hmac.new(
        webhook_secret,
        signature_payload,
        hashlib.sha256,
    ).hexdigest()

    headers = {
        "Content-Type": "application/json",
        "X-Webhook-Timestamp": timestamp,
        "X-Webhook-Signature-V2": signature,
    }

    try:
        async with httpx.AsyncClient(timeout=10) as client:
            response = await client.post(
                webhook_url,
                content=body,
                headers=headers,
            )
            response.raise_for_status()
    except Exception:
        # 웹훅 알림 오류가 실제 예매 흐름을 중단시키지 않도록 예외를 격리한다.
        return



이 방식으로 예매 성공 시 루미가 다음 정보를 빠르게 알려줄 수 있게 했습니다.

- 출발역과 도착역
- 출발 시간
- 좌석
- 금액
- 결제 기한
- 예약번호
- 현재 상태

단, 실제 결제는 안전상 사용자가 코레일톡 앱에서 직접 처리하도록 분리했습니다.

⑤ 다운로드 폴더 안전 정리
Downloads 폴더를 정리할 때는 바로 삭제하지 않고, 먼저 332개 파일과 19개 폴더를 읽기 전용으로 조사했습니다.

그 결과 설치 파일과 압축 파일이 많은 용량을 차지하고 있음을 확인했고, 사용자 승인 후 다음과 같이 정리했습니다.

Downloads/
├── Installers/   # EXE, MSI 설치 파일 75개
└── Archives/     # ZIP 등 압축 파일 15개



총 90개 파일, 약 6.12GiB를 분류 폴더로 이동했습니다.
삭제한 파일은 없었고, 이름 충돌이나 이동 오류도 없었습니다.

---

4. 활용 이미지 / 구성도

아래 이미지는 루미의 전체 동작 구조를 정리한 구성도입니다.

- 칼로스님은 Telegram에서 루미에게 요청
- 루미는 Hermes를 통해 Calendar, KTX 서버, Cron, 보안 점검 도구와 연결
- KTX 예약 정보는 서명된 웹훅으로 전달
- 비밀값은 환경변수와 보호 경로에 보관
- 결제·삭제 등 중요한 작업은 사용자 확인 후 실행

---

결과와 배운 점
배운 점과 나만의 꿀팁을 알려주세요.

이번 작업을 통해 AI 에이전트를 잘 활용하려면 “무엇을 자동화할지”만큼이나 어디까지 자동화하지 않을지를 정하는 것이 중요하다는 점을 배웠습니다.

1. AI는 실행자보다 ‘안전한 조율자’가 되어야 한다
일정 등록, 파일 이동, 알림 발송은 자동화 효과가 크지만 결제·삭제·개인정보 전송은 위험도가 높습니다.

그래서 루미에는 다음 원칙을 적용했습니다.

되돌리기 어려운 행동은 실행 전에 대상과 범위를 확인한다.



이 원칙 하나가 일정 오등록, 파일 오삭제, 잘못된 외부 전송 같은 실수를 줄여줍니다.

2. 웹훅은 봇 간 연동에 유용하다
KTX 봇과 루미를 단순 메시지 전달 방식으로 연결하는 대신, 서명된 JSON 웹훅을 사용했습니다.

장점은 다음과 같습니다.

- 구조화된 데이터 처리 가능
- 예매 성공·대기·실패·결제 기한 등 상태 확장 가능
- 메시지 형식이 바뀌어도 데이터 기반 처리 가능
- HMAC 서명으로 위변조 방지 가능
- 예매 시스템과 알림 시스템을 분리할 수 있음

3. “최신 버전”과 “취약점이 없는 버전”은 다를 수 있다
hermes update로 최신 버전까지 업데이트했지만, hermes security audit에서는 일부 의존성 취약점이 계속 확인됐습니다.

이는 최신 Hermes 버전이더라도 내부 잠금 파일에 포함된 패키지 버전이 아직 보안 권고 기준보다 낮을 수 있기 때문입니다.

이때 무작정 pip install --upgrade를 실행하면 의존성 충돌로 Hermes가 불안정해질 수 있습니다. 그래서 공식 업데이트를 우선 적용하고, 취약점은 정기적으로 감시하며, 호환성이 검증된 방식으로만 조치하는 것이 더 안전하다는 점을 배웠습니다.

4. 24시간 자동화는 PC 의존성을 줄여야 한다
처음에는 로컬 PC의 Hermes와 SSH 터널을 통해 KTX 서버의 알림을 받도록 구성했습니다. 하지만 PC가 꺼지거나 절전 상태가 되면 알림 경로도 중단될 수 있습니다.

따라서 장기적으로는 KTX 봇과 Hermes를 같은 서버에 배포해 다음처럼 단순화하는 것이 더 안정적입니다.

KTX 봇 → 서버 내부 Hermes → Telegram 알림



시행착오
- Windows에서 실행 중인 Hermes Desktop과 Gateway가 파일을 점유해 업데이트가 중단된 적이 있었습니다.
- 해결을 위해 Desktop을 종료하고, 별도 PowerShell 창에서 Gateway를 중지한 뒤 업데이트해야 했습니다.
- Google OAuth 비밀 파일이 Downloads에 남아 있는 것을 발견했고, 활성 설정을 덮어쓰지 않는 방식으로 안전하게 보호 경로로 옮겼습니다.
- 보안 감사 결과가 많다고 해서 즉시 모든 패키지를 강제 업그레이드하는 것은 오히려 위험할 수 있음을 확인했습니다.

도움이 필요한 부분
현재는 Hermes 공식 업데이트가 의존성 취약점을 더 빠르게 반영해 주면 좋겠다는 점이 가장 큰 개선 포인트입니다. 특히 보안 감사 결과와 공식 잠금 의존성 버전 사이의 차이를 더 명확하게 안내해 주면 운영자가 판단하기 쉬울 것 같습니다.

앞으로의 계획
1. Hermes를 서버에 배포해 PC를 꺼도 24시간 동작하도록 개선
2. KTX 결제 기한이 임박했을 때 단계별 알림 추가
3. 월 1회 Downloads 폴더를 읽기 전용으로 점검하고 정리 후보만 보고
4. Hermes 공식 업데이트와 보안 감사 결과를 정기적으로 확인
5. 일정 브리핑에 날씨·이동 시간·할 일 우선순위까지 결합

---

도움 받은 글 (옵션)

- Hermes Agent 공식 문서
https://hermes-agent.nousresearch.com/docs

-
Google Calendar API / OAuth 2.0 공식 문서
https://developers.google.com/calendar/api
https://developers.google.com/identity/protocols/oauth2

-
Python hmac 공식 문서
https://docs.python.org/3/library/hmac.html

-
systemd 서비스 관리 문서 (2/3)

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

박승현 프로필 이미지
박승현2026.07.26

잘 읽었습니다- 중요한 내용들을 다양하게 다뤄주셔서 감사합니다.

유피테르 프로필 이미지
유피테르2026.07.28

텔레그램 자연어 요청부터 Google Calendar 일정 브리핑, KTX 예매 알림까지 하나의 루미로 연결하신 구성이 정말 인상적입니다. 특히 결제·삭제·외부 전송은 사용자 확인을 거치고, KTX 연동에는 서명된 JSON 웹훅을 적용하신 점에서 자동화와 안전성을 함께 설계하신 꼼꼼함이 돋보였어요. Downloads의 332개 파일과 19개 폴더를 먼저 조사한 뒤 90개 파일, 약 6.12GiB만 분류 이동하신 과정도 실제 운영을 고려한 좋은 사례라고 느꼈습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기