Hermes 에이전트
설치 매뉴얼

1-1Hermes가 뭐길래 — 1분 요약

Hermes(에르메스)는 내 PC 안에 사는 AI 비서입니다. ChatGPT 같은 채팅 AI와 뭐가 다르냐면 — 채팅 AI는 물어볼 때만 대답하는 '상담원'이고, Hermes는 시키지 않아도 정해진 시간에 스스로 일하고, 폰 메신저로 결과를 보고하는 '직원'입니다.

미국의 AI 회사 Nous Research(누스 리서치)가 만들어 무료(오픈소스)로 공개했고, 컴퓨터를 잘 모르는 사람도 쓸 수 있게 전용 앱까지 계속 업데이트하고 있습니다. 개념 이야기는 이 정도면 충분합니다 — 바로 설치로 갑시다.

1-2앱 내려받아 설치하기

1-3첫 실행 — 두뇌(AI 모델) 고르기

Hermes를 처음 실행하면 "어떤 AI를 두뇌로 쓸까요?"라고 묻는 화면이 나옵니다. 여기가 이 책에서 가장 중요한 갈림길입니다.

화면 맨 위에 Nous Portal이 "RECOMMENDED(권장)" 딱지를 달고 있습니다. 이건 Hermes 회사의 유료 구독입니다. 편하지만 매달 돈이 나갑니다. 우리는 그 아래 OpenAI OAuth (ChatGPT)를 선택합니다 — 이미 내고 있는 ChatGPT 구독료로 충분하니까요.

1-4ChatGPT 구독 연결 — 장치 코드 인증

연결 방식이 조금 독특합니다. Hermes가 9자리 코드를 보여 주고, 브라우저에서 그 코드를 입력하면 연결됩니다. 은행 앱의 인증 번호와 비슷한 절차라고 생각하시면 됩니다.

브라우저에는 먼저 어느 ChatGPT 계정으로 연결할지 묻는 화면이 나옵니다.

1-5연결 완료 확인

1-6대시보드 한 바퀴 — 어디에 뭐가 있나

처음 열리는 화면입니다. 넓어 보이지만 실제로 쓰는 곳은 몇 군데 안 됩니다.

1-7⚠ 중요 — 윈도우 보안이 Hermes를 막을 때

여기가 이 책에서 가장 많은 분이 걸려 넘어지는 지점입니다. 증상이 이렇습니다 — Hermes가 말은 잘하는데, 파일을 만들어 달라거나 문서를 정리해 달라면 조용히 실패합니다. 에러도 잘 안 보여 줍니다.

범인은 윈도우의 '제어된 폴더 액세스'(랜섬웨어 차단 기능)입니다. Hermes는 속으로 python.exe(파이썬)라는 프로그램을 시켜 파일 작업을 하는데, 윈도우 보안이 이 python.exe를 수상한 프로그램으로 보고 문서 폴더 접근을 몰래 차단해 버립니다.

수고하셨습니다. 이제 이 비서를 폰에서 부르는 방법을 배울 차례입니다. 텔레그램파는 2부로, 디스코드파는 3부로 가세요.

2-1메신저 연결이 필요한 이유

지금까지는 PC 앞에 앉아야 비서와 대화할 수 있었습니다. 메신저를 연결하면 밖에서, 폰으로, 언제든 비서를 부를 수 있게 됩니다. 아침 브리핑을 받고, 떠오른 아이디어를 던져 두고, 퇴근길에 "그 일 어떻게 됐어?"라고 묻는 것 — 전부 메신저에서 일어납니다.

연결 설정은 대시보드 왼쪽의 Messaging 메뉴에 있습니다. 들어가서 목록 맨 위의 Telegram을 누르면 이 화면이 나옵니다.

화면이 알려 주는 준비물은 두 가지입니다. 지금부터 하나씩 구해 옵니다.

• 봇 토큰(Bot token) — 텔레그램의 @BotFather에게 봇을 만들어 달라고 하면 주는 열쇠 문자열
• 내 사용자 번호(user ID) — @userinfobot에게 말을 걸면 알려 주는 내 고유 숫자 (아무나 내 봇을 못 쓰게 잠그는 자물쇠)

2-2진짜 BotFather 찾기 — 사칭 주의

BotFather(봇파더)는 이름 그대로 텔레그램의 봇 공장장입니다. 그런데 검색해 보면 놀랍게도 사칭 계정이 잔뜩 나옵니다.

2-3/newbot — 봇 만들기

이제 봇을 주문합니다. 대화 세 마디면 끝납니다. 실제 대화 그대로 보여 드립니다.

2-4내 숫자 ID 받기 — @userinfobot

두 번째 준비물, 내 사용자 번호입니다. 친절하게도 Hermes 설정 화면의 Allowed Telegram user IDs 입력란 옆에 바로가기 아이콘이 있습니다.

2-5토큰·ID 등록하고 게이트웨이 재시작

2-6말 걸어 보기 — 그리고 홈 채널 지정

이제 텔레그램에서 내 봇을 검색해 첫 대화를 나눕니다.

3-1모르면 Hermes에게 물어보세요

디스코드 연결을 시작하며 저희가 처음 한 일은 검색이 아니었습니다. Hermes 본인에게 물어봤습니다.

Hermes는 스스로 자기 공식 문서를 열어 읽고, 관련 명령어까지 직접 실행해 본 다음, 봇 생성 → 권한 설정 → 토큰 확보 → 게이트웨이 연결 → 테스트라는 전체 지도를 그려 줬습니다. 이 3부는 사실상 그 안내를 따라간 기록입니다.

3-2디스코드 개발자 포털에서 봇 만들기

디스코드 봇은 개발자 포털이라는 공식 사이트에서 만듭니다. 이름은 거창하지만 버튼 몇 번이면 됩니다.

화면에 애플리케이션 ID니 퍼블릭 키니 하는 것들이 보이지만, 지금 단계에서는 전부 몰라도 됩니다. 저희도 여기서 뭘 해야 하는지 몰라서 — 화면을 캡처해 Hermes에게 물었습니다.

3-3봇 설정 — 인텐트 2개와 최소 권한

Hermes가 알려 준 대로 왼쪽 메뉴의 봇(Bot)으로 들어갑니다. 여기서 스위치 두 개를 켜야 합니다. 인텐트(Intent)는 "봇이 무엇까지 들을 수 있는지"에 대한 권한 스위치입니다.

이어서 "봇 권한은 뭘 체크해야 하지?"도 Hermes에게 물었습니다. 답이 명쾌했습니다 — "관리자 권한은 주지 마세요. 최소한만."

3-4봇 토큰 발급 — 그리고 저희가 한 실수

이제 봇의 열쇠, 토큰을 발급받습니다.

그리고 여기서 저희가 실제로 사고를 쳤습니다. 복사한 토큰을 그만 Hermes 채팅창에 그대로 붙여넣어 버린 겁니다. 그 순간 Hermes의 반응이 이 매뉴얼에서 가장 값진 장면입니다.

Hermes는 토큰을 사용하지도, 저장하지도 않겠다고 선을 긋고 즉시 토큰 초기화(재발급)를 지시했습니다. 그리고 올바른 등록 방법을 알려 줬습니다 — "토큰은 채팅이 아니라 터미널의 가려진 입력칸에만 붙여넣으세요."

4-1첫 질문 — "너가 무슨 일을 할 수 있지?"

연결을 끝낸 뒤 텔레그램에서 실제로 던진 첫 질문입니다. 봇이 자기 매뉴얼(스킬)을 읽고 나서 이렇게 답했습니다.

요약하면 이렇습니다 — 검색·조사(뉴스·논문·비교), 컴퓨터 작업(파일·프로그램 실행), 코딩, 문서 작업(보고서·PDF·엑셀), 이미지 분석(캡처를 보내면 읽어 줌), 브라우저 조작, 예약·자동화, 기억, 음성, 그리고 여러 AI 일꾼에게 분업까지. 3부 디스코드에서 봤던 능력 그대로 — 같은 비서가 텔레그램에서도 받는 것뿐입니다.

4-2이런 것부터 시켜 보세요 — 복붙용 명령 모음

어렵게 생각할 것 없습니다. 아래 문장을 그대로 복사해서 보내는 것부터 시작하세요. 전부 저희가 실제로 쓰는 명령입니다.

오늘 부산 날씨랑 이번 주 비 오는 날 알려줘

이 사진에 뭐라고 쓰여 있는지 읽어줘  ← 캡처·문서 사진 첨부해서

아이디어: 키링 굿즈 만들어 보기 — 노트에 저장해줘

매일 아침 9시에 오늘 할 일이랑 주요 뉴스 요약해서 이 방으로 보내줘

매주 월요일 8시에 이번 주 일정 정리해서 브리핑해줘

github.com/NomaDamas/k-skill 이 저장소의 스킬들을 설치해줘
← KTX 예매·중고 매물 검색·배달 조회 같은 한국 스킬 100+가 한 번에

여기서부터는 여러분의 업무가 곧 교재입니다. 2부에서 지정한 홈 채널로 매일 아침 보고가 도착하기 시작하면 — 축하합니다, 직원 한 명이 출근한 겁니다.