Hermes를 실제 윈도우 PC에 설치하며 찍은 화면 49장을 순서대로 담았습니다. 앱을 설치하고 ChatGPT 구독을 연결한 뒤, 텔레그램이나 디스코드 중 쓸 메신저를 고르십시오.
| 1부 · 1~3장 | 준비물과 앱 설치, ChatGPT 연결, 대시보드와 파일 작업을 확인합니다. |
| 2부 · 4~5장 | 텔레그램을 연결하고 홈 채널을 지정합니다. |
| 3부 · 6~8장 | 디스코드 봇을 만들고 권한·게이트웨이·서버 초대를 마칩니다. 텔레그램만 쓴다면 건너뛰어도 됩니다. |
| 4부 · 9~10장 | 심부름과 예약 보고를 시킵니다. 막혔을 때 볼 부록 A~D도 모았습니다. |
| STEP과 그림 | 화면 바로 위에 누를 곳과 성공 표시가 붙어 있습니다. 그림 번호는 기존 설치 기록을 따릅니다. |
| 실제 사례 | 사용자명 중복 거절과 토큰 유출 등 실제 설치 중 겪은 장면입니다. |
| 말로 하기 | AI에게 요청할 우리말 문장입니다. /newbot은 BotFather에, /start·/sethome은 안내된 봇 대화방에 보냅니다. |
| 기준판 | 초판 2026-07 · 윈도우 10/11 · Hermes 데스크톱 앱 v0.18. 구독 조건과 번호는 그 설치 기록입니다. 다른 화면이면 메뉴 이름도 확인하십시오. |
| 시작 전 | 인터넷에 연결된 PC, ChatGPT 유료 구독 계정, 텔레그램 또는 디스코드 계정. 시간은 30분~1시간을 확보합니다. |
| 토큰 | 공식 설정 화면이나 가려진 입력칸에만 넣습니다. AI 채팅창에 보내지 마십시오. |
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 01.1 | 비서가 머무를 PC | ☐ |
| 01.2 | 앱을 내려받습니다 | ☐ |
Hermes는 내 PC에서 일하는 AI 비서입니다. 프로그램은 무료지만, 일을 판단할 AI 모델은 따로 연결해야 합니다. 먼저 준비물을 확인하고 앱을 설치하십시오.
ChatGPT 같은 채팅 AI는 질문에 답하는 상담원, Hermes(에르메스)는 PC에서 일하고 메신저로 보고하는 직원에 가깝습니다. Nous Research(누스 리서치)가 MIT 오픈소스로 공개했습니다. Hermes 자체의 가격은 0원입니다.
PC가 꺼지면 비서도 멈춥니다. 24시간 켜 둘 컴퓨터가 있으면 좋지만, 처음부터 새로 살 필요는 없습니다. 쓰던 PC에 설치해 보고 결정하십시오. 맥미니와 안 쓰는 노트북도 후보입니다.
| 기준 환경 | 윈도우 10/11 PC와 Hermes 데스크톱 앱 v0.18입니다. 맥(macOS)도 화면 구성과 순서는 거의 같습니다. |
| AI 구독 | ChatGPT 유료 구독 계정을 준비하십시오. 이 책은 OpenAI OAuth 연결을 설명합니다. |
| 메신저 | 텔레그램 또는 디스코드 중 하나면 됩니다. 텔레그램은 2부, 디스코드는 3부를 보십시오. |
| 시간 | 시작 전에 30분~1시간을 확보하십시오. 안내 시간은 설치와 두뇌 연결 약 15분, 텔레그램 약 10분, 디스코드 약 20분입니다. |
이 책은 2026년 7월 초판의 설치 화면을 보존했습니다. 구독 연결 조건과 화면의 숫자도 그 기록을 따릅니다. 화면이 달라지면 번호만 그대로 누르지 말고 메뉴 이름을 함께 확인하십시오.
브라우저 주소창에 hermes-agent.nousresearch.com을 입력하십시오. 첫 화면의 데스크톱 앱 다운로드에서 윈도우 10/11용을 받습니다. 맥·리눅스용도 있습니다.
설치 파일을 더블클릭하고 안내에 따라 ‘다음’을 눌러 설치를 마치십시오. 바탕화면이나 시작 메뉴에 Hermes 아이콘이 생기면 실행합니다. 다음 장의 모델 공급자 화면이 나오면 설치가 끝났습니다.
터미널은 글자로 명령을 내리는 창입니다. 터미널 설치 명령은 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash입니다. 이 책은 데스크톱 앱으로 설치합니다.
02장 ChatGPT 구독을 연결합니다 — 공급자 선택부터 장치 코드 승인까지
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 02.1 | 공급자를 고릅니다 | ☐ |
| 02.2 | 장치 코드를 승인합니다 | ☐ |
| 02.3 | 연결 표시를 확인합니다 | ☐ |
Hermes는 몸통이고 AI 모델은 두뇌입니다. 첫 실행에서 두뇌를 고르고, 브라우저에서 내 계정을 승인합니다. OpenAI OAuth 연결 화면을 차례로 보겠습니다.
STEP 01 · OpenAI OAuth (ChatGPT)를 누르십시오. Sign in with OpenAI OAuth (ChatGPT) 창이 열리면 다음 단계입니다.
첫 화면의 OpenAI OAuth (ChatGPT)를 누르십시오. OAuth는 비밀번호를 프로그램에 건네는 대신 브라우저 로그인으로 계정을 연결하는 방식입니다.
맨 위의 Nous Portal에는 RECOMMENDED(권장) 표시가 붙어 있습니다. 이것은 Hermes를 만든 회사의 유료 구독입니다. 실제 설치에서는 기존 ChatGPT 구독을 연결해 추가 비용 없이 시작했습니다. Nous Portal을 고르지 않아도 Hermes 설치는 진행됩니다.
Anthropic OAuth에는 ‘추가 크레딧 필요’라는 조건이 붙어 있습니다. 클로드 구독과 프록시 이야기는 10장의 부록 C에서 따로 읽으십시오.
STEP 02 · 내 화면의 코드를 확인하십시오. 브라우저가 안 열리면 Re-open verification page를 누릅니다.
STEP 03 · 구독 중인 내 계정을 누르십시오. 로그인하지 않았다면 로그인한 뒤 코드 입력 화면으로 갑니다.
STEP 04 · 내가 시작한 로그인의 코드를 입력하십시오. 주황색 경고를 읽고 계속을 눌러 승인 완료를 확인합니다.
Hermes가 보여 주는 9자리 장치 코드를 확인하십시오. 그림의 예시는 8SAV-WF16E이며 내 화면에는 다른 코드가 나옵니다. 브라우저가 안 열리면 Re-open verification page를 누릅니다.
브라우저에서 구독 중인 ChatGPT 계정을 선택하고, 다음 입력 칸에 내 화면의 코드를 넣으십시오. 주황색 보안 경고를 읽은 뒤 계속을 누릅니다. 승인 완료가 나오면 Hermes로 돌아갑니다.
장치 코드는 남에게 알려 주지 마십시오. 내가 방금 Hermes에서 시작한 로그인일 때만 입력합니다. 카톡이나 문자로 받은 코드를 대신 승인하면 안 됩니다.
STEP 05 · CONNECTED와 DEFAULT MODEL 이름을 확인하고 BEGIN을 누르십시오. 대시보드가 열리면 완료입니다.
OPENAI OAUTH (CHATGPT) CONNECTED와 DEFAULT MODEL 이름이 보이면 연결이 끝났습니다. BEGIN 버튼을 누르십시오. Hermes 대시보드가 열립니다.
연결됐다는 문구를 확인하고 다음으로 넘어가십시오. 브라우저 승인만 끝낸 채 앱 화면을 확인하지 않으면 어디까지 진행했는지 놓치기 쉽습니다.
03장 대시보드와 파일 작업을 확인합니다 — 말하기가 되는지, 파일 작업도 되는지 따로 봅니다
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 03.1 | 대시보드의 자리 | ☐ |
| 03.2 | 파일 작업만 실패할 때 | ☐ |
대시보드는 비서에게 일을 맡기는 책상입니다. 말을 걸어 응답을 확인한 뒤 파일 작업도 점검하십시오. 대화는 되는데 파일 작업만 실패한다면 Windows 보안 기록을 봅니다.
STEP 06 · 가운데 Describe what you need에 한글로 말을 걸어 보십시오. 응답이 돌아오는지 확인합니다.
가운데 Describe what you need 입력창에 한글로 말을 걸면 됩니다. 처음에는 ‘안녕, 넌 뭘 할 수 있어?’라고 물어보십시오. 응답이 오면 두뇌 연결은 정상입니다.
| New session | 새 대화를 시작합니다. 메신저의 새 채팅방과 같습니다. |
| Messaging | 텔레그램·디스코드 연결 설정입니다. 2부·3부에서 씁니다. |
| 아래 상태바 | Gateway(메신저 연결 상태), Agents, Cron(예약 작업)을 보여 줍니다. |
| 입력창 오른쪽 | 현재 모델 이름입니다. 누르면 모델을 바꿉니다. |
STEP 07 · Windows 보안 → 바이러스 및 위협 방지 → 보호 기록을 여십시오. 차단 항목을 펼쳐 python.exe를 확인합니다.
STEP 08 · Hermes의 차단 기록에서 작업 ∨ → 디바이스에서 허용을 누르십시오. 해당 기록을 확인한 뒤 실패했던 작업을 다시 시킵니다.
Hermes가 말은 잘하는데 파일 만들기나 문서 정리만 조용히 실패한다면, Windows 보안의 ‘제어된 폴더 액세스’를 확인하십시오. 랜섬웨어를 막는 기능입니다.
Hermes는 python.exe라는 프로그램으로 파일 작업을 합니다. 설치 당시 이 프로그램의 문서 폴더 접근이 차단됐습니다. Windows 보안 → 바이러스 및 위협 방지 → 보호 기록을 열고, ‘보호된 폴더 액세스 차단됨’ 항목을 펼칩니다.
내가 설치한 Hermes의 python.exe 차단 기록을 확인한 뒤 해당 항목을 허용하십시오. 차단 기록이 없다면 이 단계는 넘어갑니다. 허용한 뒤에는 실패했던 파일 작업을 다시 시켜 결과를 확인합니다.
04장 텔레그램 봇을 만듭니다 — BotFather에서 토큰을 받고 내 사용자 번호를 확인합니다
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 04.1 | 연결 화면을 엽니다 | ☐ |
| 04.2 | 진짜 BotFather와 대화합니다 | ☐ |
| 04.3 | 내 숫자 ID를 받습니다 | ☐ |
메신저를 연결하면 PC 앞에 앉지 않고도 폰으로 비서를 부릅니다. 텔레그램 연결에는 봇 토큰과 내 숫자 ID가 필요합니다. 토큰은 열쇠이고 ID는 그 열쇠를 쓸 사람의 명단입니다.
STEP 09 · 왼쪽 Messaging에서 Telegram을 누르십시오. Bot token과 Allowed Telegram user IDs의 위치를 먼저 봅니다.
STEP 10 · Bot token과 Allowed Telegram user IDs를 확인하십시오. 다음 화면에서 봇 토큰과 내 번호를 받아 옵니다.
Hermes의 Messaging → Telegram을 누르십시오. Bot token과 Allowed Telegram user IDs를 확인합니다. 아직 채울 값은 없습니다. BotFather에서 봇을 만들고 userinfobot에서 내 번호를 받아 오겠습니다.
| 봇 토큰 | @BotFather가 발급하는 열쇠 문자열입니다. 봇을 조종하는 비밀번호처럼 다루십시오. |
| 사용자 ID | @userinfobot이 알려 주는 내 고유 숫자입니다. 허용 사용자 칸에 넣어 내 봇을 잠급니다. |
STEP 11 · 검색 결과에서 @BotFather와 파란 공식 인증 배지를 함께 확인한 뒤 공식 계정을 누르십시오.
STEP 12 · 공식 대화방 아래 START를 누르십시오. BotFather와 대화가 시작되면 /newbot을 보낼 차례입니다.
STEP 13 · /newbot, 표시 이름, bot으로 끝나는 사용자명을 차례로 보내십시오. Done! 메시지의 토큰을 복사하되 채팅에 보내지 마십시오.
텔레그램에서 BotFather를 검색하십시오. 이름만 비슷한 사칭 계정이 있으니 @BotFather와 파란 공식 인증 배지를 함께 확인합니다. 설치 당시 공식 계정에는 월 사용자 700만 명이 표시됐습니다.
공식 대화방 아래 START를 누르고 /newbot을 보냅니다. 표시 이름을 정한 뒤 사용자명을 보내십시오. 사용자명은 반드시 bot으로 끝나야 합니다.
토큰을 복사하되 AI 채팅창에 보내지 마십시오. 나중에 Hermes 공식 설정 칸에 직접 넣습니다. 유출이 의심되면 BotFather에서 /revoke로 재발급하십시오.
STEP 14 · 입력 칸 오른쪽 바로가기 아이콘을 누르십시오. @userinfobot 링크가 브라우저에서 열립니다.
STEP 15 · 브라우저 팝업의 Telegram Desktop 열기를 누르십시오. @userinfobot 대화방으로 이동합니다.
STEP 16 · /start를 보내고 답변의 Id: 숫자를 복사하십시오. 가려진 캡처 값이 아니라 내 화면의 번호를 씁니다.
Hermes의 Allowed Telegram user IDs 오른쪽 바로가기 아이콘을 누르십시오. 브라우저에서 Telegram Desktop 열기를 누르면 @userinfobot 대화방으로 이동합니다.
/start를 보내고 답변의 Id: 숫자를 복사하십시오. 이것이 내 사용자 번호입니다. 그림의 ID는 가려져 있으므로 내 화면의 값을 쓰십시오.
05장 저장하고 보고받을 방을 정합니다 — 게이트웨이 재시작과 /sethome까지 마칩니다
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 05.1 | 토큰과 ID를 저장합니다 | ☐ |
| 05.2 | 내 봇에게 말을 겁니다 | ☐ |
| 05.3 | 홈 채널을 지정합니다 | ☐ |
값만 저장해서는 연결이 끝나지 않습니다. 게이트웨이를 재시작하고 응답을 확인한 뒤, 예약 보고가 도착할 홈 채널을 지정합니다. 게이트웨이는 메신저와 Hermes를 잇는 관문 프로그램입니다.
STEP 17 · Bot token과 내 숫자 ID를 넣고 Save changes를 누르십시오. 저장 알림이 나오면 Restart gateway를 누릅니다.
STEP 18 · Telegram 옆 Connected 표시를 확인하십시오. 이제 텔레그램에서 내 봇을 찾아 응답을 시험합니다.
Messaging → Telegram으로 돌아가 Bot token에 토큰을, Allowed Telegram user IDs에 내 숫자 ID를 넣으십시오. Save changes를 누르면 Telegram setup saved 알림과 Restart gateway 버튼이 나옵니다.
Restart gateway를 누르십시오. Telegram 옆 배지가 Connected로 바뀌면 메신저와 Hermes가 연결됐습니다. Saved는 값이 저장됐다는 뜻이고, Connected는 연결됐다는 뜻입니다.
STEP 19 · 검색창에 내 봇 사용자명을 입력해 대화방을 여십시오. /start 뒤 ‘안녕, 연결 테스트해줘’라고 보냅니다.
텔레그램 검색창에 방금 만든 내 봇 사용자명을 입력하십시오. 설치 당시에는 @digi0920_bot을 검색했습니다. 자신이 만든 봇을 찾으십시오.
대화방에서 /start를 보내고 ‘안녕, 연결 테스트해줘’라고 입력하십시오. 설치 당시 ‘연결 테스트 완료 ✅’라는 응답이 왔습니다.
STEP 20 · 실제 응답을 확인한 뒤 이 방에 /sethome을 보내십시오. Home channel set이 나오면 보고받을 기본 방이 지정됐습니다.
봇이 홈 채널이 없다며 안내하면 그 방에 /sethome을 보내십시오. Home channel set 표시가 나오면 끝났습니다. 홈 채널은 비서가 보고서를 배달하는 기본 주소입니다.
예약 작업(cron) 결과와 알림이 이 방으로 옵니다. 9장에서 만드는 아침 브리핑도 여기로 받습니다. Connected 확인과 첫 응답, 홈 채널 지정까지 마친 뒤 다음으로 넘어가십시오.
06장 디스코드 봇과 권한을 준비합니다 — 애플리케이션 생성, 인텐트 2개, 토큰 발급
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 06.1 | 개발자 포털에서 만듭니다 | ☐ |
| 06.2 | 인텐트와 최소 권한 | ☐ |
| 06.3 | 토큰을 발급받습니다 | ☐ |
디스코드 봇은 개발자 포털에서 만듭니다. 봇이 메시지를 읽도록 인텐트를 켜고, 필요한 권한만 줍니다. 모르는 화면은 토큰이 보이지 않는지 확인한 뒤 Hermes에게 물으십시오.
STEP 21 · Messaging → Discord에서 Bot token과 Allowed Discord user IDs를 확인하십시오. 개발자 포털에서 봇을 준비할 차례입니다.
STEP 22 · Hermes 입력창에서 디스코드 연결 방법을 물으십시오. 봇 생성부터 테스트까지의 안내를 확인합니다.
STEP 23 · discord.com/developers/applications에 로그인하고 오른쪽 위 신규 애플리케이션을 누르십시오. 봇 이름을 정합니다.
STEP 24 · 일반 정보 화면이 열렸는지 확인하십시오. 지금은 애플리케이션 ID나 퍼블릭 키를 복사하지 않고 봇 메뉴로 이동합니다.
STEP 25 · 막혔다면 토큰이 보이지 않는 화면을 Hermes에 보내 다음에 누를 곳을 물으십시오. 원본은 봇 메뉴와 인텐트 안내를 받았습니다.
Hermes의 Messaging → Discord에서 연결 화면을 확인하십시오. 설치 순서가 막막하면 먼저 Hermes에게 물어봅니다. 설치 당시 Hermes는 공식 문서를 읽고 관련 명령을 실행한 뒤 안내했습니다.
브라우저에서 discord.com/developers/applications에 접속하고 디스코드 계정으로 로그인하십시오. 오른쪽 위 ‘신규 애플리케이션’을 누르고 이름을 정합니다. 설치 당시 이름은 DG bot이었습니다.
일반 정보 화면이 열리면 생성 완료입니다. 애플리케이션 ID와 퍼블릭 키는 지금 복사할 필요가 없습니다. 설치 중에는 이 화면을 Hermes에게 보내 ‘여기서 뭐해야되지?’라고 물었고, 봇 메뉴와 인텐트 설정을 안내받았습니다.
STEP 26 · Server Members Intent와 Message Content Intent를 ON으로 바꾸십시오. 변경 사항 저장을 눌러 업데이트 배너를 확인합니다.
STEP 27 · 이 절의 표에 적힌 채팅 권한 8종만 고르십시오. 관리자와 서버·역할·채널 관리 권한은 체크하지 않습니다.
왼쪽 봇(Bot) 메뉴의 Privileged Gateway Intents를 찾으십시오. 인텐트는 봇이 무엇까지 들을지 정하는 스위치입니다. Server Members Intent와 Message Content Intent를 켜고 ‘변경 사항 저장’을 누릅니다.
Message Content Intent가 꺼져 있으면 봇은 온라인이어도 메시지 내용을 읽지 못해 대답하지 않습니다. 저장 뒤 ‘봇을 성공적으로 업데이트했어요!’ 배너를 확인하십시오.
| 허용할 8종 | 채널 보기, 메시지 보내기, 스레드에서 메시지 보내기, 공개 스레드 만들기, 링크 임베드, 파일 첨부, 메시지 기록 보기, 반응 추가. |
| 주지 않을 권한 | 관리자, 서버·역할·채널 관리, 멤버 추방·차단, 메시지 관리·삭제, 모두 멘션, 음성 권한 전체. |
집 열쇠를 주더라도 금고 비밀번호까지 줄 필요는 없습니다. 봇도 같습니다. 관리자를 체크하지 말고 이 책의 채팅 작업에 필요한 8종만 선택하십시오.
STEP 28 · 봇 페이지의 토큰 초기화를 누르고 ‘네, 할게요!’를 선택하십시오. 발급된 토큰은 공식 설정이나 가려진 입력칸에만 넣습니다.
STEP 29 · 토큰을 채팅에 보냈다면 즉시 개발자 포털에서 토큰 초기화를 다시 누르십시오. 새 토큰으로 등록하며 이전 값은 쓰지 않습니다.
봇 페이지 위쪽 토큰 구역에서 ‘토큰 초기화(Reset Token)’를 누르고, 확인 창의 ‘네, 할게요!’를 누르십시오. 긴 문자열이 나타나면 복사합니다. 이 화면을 벗어나면 다시 볼 수 없으며, 필요하면 다시 초기화합니다.
토큰은 채팅창에 붙여 넣지 마십시오. 공식 설정 화면이나 터미널의 가려진 입력칸에만 넣습니다. 캡처·메일·카톡으로 보내지 말고, 유출이 의심되면 그 자리에서 재발급하십시오. 이전 토큰은 무효가 됩니다.
07장 게이트웨이를 설정합니다 — 토큰 등록, 허용 사용자, 자동 시작 상태를 확인합니다
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 07.1 | 연결 설정을 시작합니다 | ☐ |
| 07.2 | 토큰과 사용자를 등록합니다 | ☐ |
| 07.3 | 자동 시작과 현재 상태 | ☐ |
게이트웨이는 PC에서 메신저의 말을 받아 Hermes에게 전달합니다. 설정 방법은 AI에게 묻고, 토큰은 터미널의 가려진 칸에 직접 넣으십시오. 마지막에는 등록과 실행 상태를 따로 확인합니다.
STEP 30 · 모르는 실행 단계는 Hermes에게 화면 기준으로 안내를 요청하십시오. 아래 ‘말로 하기’로 방법을 물은 뒤 터미널에서 직접 실행합니다.
STEP 31 · 직접 창을 열어야 한다면 윈도우 키를 누르고 terminal을 검색하십시오. 명령 프롬프트 또는 Windows Terminal을 누릅니다.
STEP 32 · 터미널에 hermes gateway setup을 입력하고 Enter를 누르십시오. 목록이 나오면 Discord를 선택합니다.
윈도우 키를 누르고 terminal 또는 ‘명령 프롬프트’를 검색해 창을 여십시오. 검은 창에 C:\Users\…와 커서가 보입니다. 연결 설정 명령은 hermes gateway setup입니다.
아래 문장으로 안내를 받고, 열린 터미널에 명령을 입력하십시오. Discord를 선택한 뒤 가려진 입력칸에 토큰을 직접 넣습니다.
STEP 33 · 목록에서 Discord를 고르십시오. Discord bot token:의 가려진 칸에 새 토큰을 넣고 Enter를 눌러 token saved를 확인합니다.
STEP 34 · 디스코드 설정(톱니) → 내 계정을 여십시오. 사용자명 항목에서 내 아이디를 확인합니다.
STEP 35 · 허용 사용자 질문에 내 사용자명을 넣고 Enter를 누르십시오. 이 봇을 쓸 사람을 내 계정으로 제한합니다.
설치 당시 메신저 목록은 25종이었습니다. Discord는 8번, Telegram은 22번이었습니다. 번호가 달라졌다면 Discord라는 이름을 보고 선택하십시오.
Discord bot token:을 물으면 새 토큰을 가려진 칸에 넣고 Enter를 누릅니다. 설치 당시에는 화면에 * 하나만 보였고, 등록 뒤 ‘✓ Discord token saved’가 나왔습니다.
디스코드 설정(톱니) → 내 계정에서 ‘사용자명’을 확인하십시오. Allowed user IDs or usernames에 내 사용자명을 넣으면 허용 사용자가 제한됩니다. 숫자 ID로 바꾸는 순서는 8장에 있습니다.
STEP 36 · 게이트웨이 시작과 자동 시작 등록 질문을 확인해 Y로 답하십시오. 해당 등록 작업의 Windows UAC 창은 예를 누릅니다.
STEP 37 · AI에게 상태 확인을 맡기십시오. Scheduled Task registered와 Gateway process running의 두 표시를 모두 확인합니다.
설치 당시에는 게이트웨이 시작과 자동 시작 등록 질문에 Y로 답했습니다. PC를 켤 때 함께 실행할지 묻는 질문입니다. Windows 관리자 승인 창(UAC)이 나오면 예를 누릅니다.
Scheduled Task registered는 자동 시작 예약이 등록됐다는 뜻입니다. Gateway process running은 지금 실행 중이라는 뜻입니다. 상태 확인 화면의 두 줄을 모두 확인하십시오.
08장 서버에 초대하고 응답을 확인합니다 — 설치 링크, 서버 초대, Connected, 멘션 테스트
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 08.1 | 설치 링크와 서버 | ☐ |
| 08.2 | 초대를 승인합니다 | ☐ |
| 08.3 | 재시작과 멘션 테스트 | ☐ |
봇을 만들었다고 대화방에 들어오는 것은 아닙니다. 설치 링크로 내 서버에 초대한 뒤 게이트웨이를 재시작하십시오. Connected 표시와 실제 응답까지 확인하면 디스코드 연결이 끝납니다.
STEP 38 · 설치 메뉴에서 길드 설치만 체크하십시오. applications.commands와 bot 스코프, 최소 8종 권한을 정하고 저장합니다.
STEP 39 · 저장 완료 표시를 확인한 뒤 Discord 제공 링크를 복사하십시오. 이 링크로 봇을 서버에 초대합니다.
STEP 40 · 디스코드 왼쪽 아래 + 버튼을 누르십시오. 봇 전용 서버를 만듭니다.
STEP 41 · 새 서버가 목록에 생겼는지 확인하십시오. 원본 이름은 디지봇이며, 독자는 자신이 만든 서버를 선택합니다.
개발자 포털의 ‘설치’를 여십시오. 설치 환경은 ‘길드 설치’만 체크하고 ‘사용자 설치’는 해제합니다. 길드는 디스코드 서버를 뜻합니다.
기본 설치 설정의 스코프에 applications.commands와 bot을 넣고, 6장에서 확인한 최소 8종 권한을 고르십시오. 저장 뒤 Discord 제공 링크를 복사합니다. 이 링크가 봇의 초대장입니다.
디스코드 왼쪽 아래 + 버튼으로 봇 전용 서버를 만드는 편이 좋습니다. 설치 당시 서버 이름은 ‘디지봇’이었습니다. 다른 사람의 서버에서 설치를 시험하지 않아도 됩니다.
STEP 42 · 초대 링크를 열고 서버에 추가:에서 내 서버를 고르십시오. 계속하기 뒤 권한 목록을 확인하고 승인합니다.
STEP 43 · 봇이 내 서버에 추가됐다는 성공 표시를 확인하십시오. 이 창을 닫고 Hermes의 Discord 설정으로 돌아갑니다.
복사한 링크를 브라우저 주소창에 넣으십시오. ‘서버에 추가:’에서 내 서버를 고르고 계속하기를 누릅니다. 권한 목록을 확인한 뒤 승인하십시오.
‘성공! DG bot이(가) 승인되어 …에 추가되었어요.’ 화면이 나오면 초대가 끝났습니다. 그 창은 닫아도 됩니다.
STEP 44 · Messaging → Discord에서 토큰과 허용 사용자 저장을 확인하십시오. Restart needed가 보이면 게이트웨이를 재시작합니다.
STEP 45 · Discord 옆 Connected를 확인하십시오. 이제 서버 채널에서 내 봇을 멘션해 응답을 시험합니다.
STEP 46 · 서버 채널에서 @봇이름으로 멘션하십시오. 원본처럼 반응과 실제 응답이 돌아오는지 확인합니다.
STEP 47 · 개발자 모드를 켜고 내 이름 우클릭 → ID 복사를 누르십시오. Hermes의 Allowed user IDs에 내 숫자 ID를 넣습니다.
STEP 48 · 내 봇에게 ‘니가 할 수 있는 일이 뭐지?’라고 물으십시오. 업무·문서·조사·PC 작업 안내가 돌아오는지 봅니다.
Hermes의 Messaging → Discord를 여십시오. 토큰과 허용 사용자에 Saved가 표시되고 Restart needed가 보이면 게이트웨이를 재시작합니다. Connected로 바뀌는지 확인하십시오.
디스코드 서버 채널에서 @봇이름으로 멘션해 말을 겁니다. 설치 당시 ‘@DG bot 응답해줘 게이트웨이 정상이야?’라고 묻자 봇은 ✅ 반응과 스레드로 답했습니다.
허용 사용자를 숫자 ID로 등록하면 사용자명이 바뀌어도 사용할 수 있습니다. 디스코드 설정에서 개발자 모드를 켜고 내 이름을 우클릭 → ID 복사를 누르십시오. Hermes의 Allowed Discord user IDs에 그 값을 넣습니다. 캡처의 값은 가려져 있습니다.
봇은 업무 자동화, 개발, 문서와 데이터, 조사와 모니터링, 디스코드 관리, PC 작업을 안내했습니다. ‘PC와 각종 서비스를 직접 다룰 수 있는 작업형 AI 에이전트’라는 답변입니다. 어떤 일을 맡길지는 다음 장에서 정합니다.
09장 작은 심부름부터 맡깁니다 — 메신저에서 질문하고 예약 보고를 받아 봅니다
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 09.1 | 어떤 일을 하는지 묻습니다 | ☐ |
| 09.2 | 오늘 쓸 심부름 | ☐ |
| 09.3 | 예약 보고와 스킬 | ☐ |
연결을 마쳤으면 실제 일을 하나 맡겨 보십시오. 텔레그램과 디스코드는 같은 비서에게 말을 거는 두 통로입니다. 아래 문장은 실제 설치에서 사용한 요청입니다.
STEP 49 · 텔레그램에서 ‘너가 무슨 일을 할 수 있지?’라고 물으십시오. 연결된 비서가 어떤 작업을 받는지 확인합니다.
텔레그램에서 ‘너가 무슨 일을 할 수 있지?’라고 물었습니다. 봇은 자기 매뉴얼인 스킬을 읽고 능력 10종을 답했습니다. 실제 답변은 이 장의 그림에 있습니다.
| 능력 10종 | 검색·조사, 컴퓨터 작업, 코딩, 문서 작업, 이미지 분석, 브라우저 조작, 예약·자동화, 기억, 음성, 여러 AI 일꾼에게 분업. |
| 문서 작업 | 보고서·PDF·엑셀 등을 다룹니다. |
| 이미지 분석 | 캡처와 문서 사진을 보내면 읽습니다. |
아래 문장을 하나씩 보내십시오. 사진 읽기에는 캡처나 문서 사진을 함께 첨부합니다. 상황을 함께 적으면 비서가 판단할 재료가 늘어납니다. 결과가 맞지 않으면 고칠 곳을 짚어 다시 시키십시오.
반복하는 일은 시간과 받을 방을 함께 알려 줍니다. 텔레그램에서 지정한 홈 채널로 결과가 옵니다. cron(크론)은 이런 예약 실행 장치입니다.
스킬은 비서가 익혀 두고 다시 쓰는 일하는 방법입니다. 다음 저장소에서 KTX 예매·중고 매물 검색·배달 조회 같은 한국 스킬 100+를 설치하는 예를 들었습니다.
10장 막혔을 때 다시 펴는 장 — 부록 A~D를 증상, 보안, 구독, 용어 순으로 살펴봅니다
| 절 | 주제 | 공부했나요? |
|---|---|---|
| 10.1 | 부록 A · 문제 해결 | ☐ |
| 10.2 | 부록 B · 토큰 3계명 | ☐ |
| 10.3 | 부록 C · 클로드 구독과 프록시 | ☐ |
| 10.4 | 부록 D · 용어 사전 | ☐ |
설치가 막혔으면 처음부터 다시 할 필요는 없습니다. 증상에 맞는 화면을 찾아 확인하십시오. 부록 네 가지를 이 장에 모았습니다.
| 증상 | 확인과 해결 |
|---|---|
| 파일 작업만 실패 | 3장 2절의 Windows 보안 보호 기록에서 Hermes의 python.exe 차단을 확인합니다. 해당 항목의 작업 → 디바이스에서 허용 뒤 다시 실행하십시오. |
| 온라인인데 응답 없음 | Message Content Intent, 허용 사용자 등록, 게이트웨이 재시작을 확인합니다. 서버 채널에서는 @봇이름으로 멘션합니다. 6장 2절·8장 3절을 보십시오. |
| 게이트웨이 중지 | AI에게 hermes gateway status를 실행해 확인하게 합니다. 중지 상태면 hermes gateway setup을 다시 실행하거나 PC를 재부팅하십시오. 자동 시작 등록이 돼 있으면 부팅 때 실행됩니다. |
| 토큰을 어디 보냈는지 모름 | 디스코드는 개발자 포털 → 봇 → 토큰 초기화, 텔레그램은 BotFather의 /revoke로 재발급합니다. 새 토큰을 Hermes에 다시 등록하십시오. |
| 모르는 화면 | 토큰이 보이지 않는 화면을 캡처해 Hermes에게 다음에 누를 곳을 물으십시오. 6장 1절의 실제 사례와 같습니다. |
토큰은 봇의 열쇠입니다. 등록할 곳과 보내면 안 되는 곳을 구분하십시오.
| 첫째 | 채팅창에 붙여 넣지 않습니다. AI 채팅창도 같습니다. 공식 설정 화면과 터미널의 가려진 입력칸에만 넣습니다. |
| 둘째 | 토큰이 보이는 화면을 캡처하거나 공유하지 않습니다. 이 책의 유출 사례도 토큰 부분을 가렸습니다. |
| 셋째 | 유출이 의심되면 즉시 재발급합니다. 이전 토큰은 무효가 됩니다. |
허용 사용자 ID 칸을 채워 사용자를 제한하십시오. 디스코드 권한은 이 책의 최소 8종으로 유지합니다.
공급자 선택 화면의 Anthropic OAuth에는 ‘추가 크레딧 필요’라는 조건이 있습니다. 이 책이 ChatGPT 구독의 공식 연결 경로를 따른 이유입니다.
프록시는 구독형 AI를 API처럼 이어 주는 중계 프로그램입니다. 클로드 구독을 우회 연결하는 방법도 있지만, 약관의 회색지대이며 계정 제재 위험이 있어 권하지 않습니다.
처음에는 2장의 ChatGPT 연결 순서로 시작하십시오. 클로드는 Hermes가 필요할 때 Claude Code를 불러 쓰는 방식으로도 활용됩니다.
| 에이전트 | 도구를 써서 실제 일을 처리하는 AI입니다. 이 책에서는 AI 비서라고 부릅니다. |
| 게이트웨이 | 메신저와 Hermes를 잇고 PC에서 대기하는 관문 프로그램입니다. |
| 토큰 | 봇을 조종하는 열쇠 문자열입니다. 비밀번호처럼 다루십시오. |
| OAuth | 비밀번호를 알려 주지 않고 브라우저 로그인으로 계정을 연결하는 방식입니다. |
| 인텐트 | 디스코드 봇이 무엇까지 들을지 정하는 권한 스위치입니다. |
| cron(크론) | ‘매일 아침 9시에’처럼 예약해 실행하는 장치입니다. |
| UAC | 시스템 변경 전에 승인을 묻는 Windows 관리자 창입니다. |
| 스킬 | 비서가 익혀 두고 다시 쓰는 일하는 방법입니다. |
| 터미널 | 글자로 명령을 내리는 창입니다. 이 책에서는 게이트웨이 설정·상태 확인에 씁니다. |
| 프록시 | 구독형 AI를 API처럼 이어 주는 중계 프로그램입니다. 부록 C를 보십시오. |
여기까지가 이 책의 본문입니다. 열 장을 다 기억하지 않아도 됩니다. 막히는 순간에 차례를 펴고 그 장 하나만 다시 읽으십시오.
설치의 끝은 연결됐다는 표시가 아닙니다. 메신저에서 말을 걸고 실제 응답을 받는 데까지 확인하십시오. 그다음에는 오늘 필요한 심부름 하나를 맡기면 됩니다.
잘되지 않으면 10장의 증상표에서 해당 장을 찾으십시오. 모르는 화면은 토큰이 보이지 않는지 확인한 뒤 Hermes에게 다음에 누를 곳을 물으면 됩니다.
바이브 코딩이 처음이라면 autofrog.kr/lab의 무료 강의 20강을 보십시오. 만든 것을 팔 차례라면 autofrog.kr/book의 『팔리는 바이브 코딩』도 무료로 읽으십시오.
오토프로그가 실제 설치하며 남긴 화면과 사례를 편집했습니다. 최신 열람본은 오토프로그 서가에서 확인하십시오.
| 기준판 | 초판 2026-07 · 실제 설치 화면과 사례 수록 |
| 지은이·펴낸 곳 | 오토프로그 · autofrog.kr |
| 배포 범위 | 무료 공개 · 출처를 남겨 주신다면 공유 환영 |
| 글·화면 | 오토프로그의 실제 Hermes 설치 기록. 실화면 49장은 원본 파일을 그대로 사용했습니다. 토큰·ID를 가린 원본 캡처도 유지했습니다. |
| 판형 | FIELD MANUAL 005와 같은 A4 장 표지·절 헤더·요약 카드·러닝풋입니다. |