만원으로 24시간 돌아가는 Hermes 설치하기

이 문서 하나면 개발을 몰라도 따라 할 수 있어요.
목표: 노트북을 꺼도 Slack에서 @Hermes를 부르면 24시간 언제나 답하는 AI 봇 만들기.

---

먼저, 우리가 뭘 만드는 건지 (1분 개념)

• Hermes: AI 에이전트. 내 노트북에서 설치하면 노트북을 끄면 멈춰요.

• VPS(=클라우드 서버): 데이터센터에 있는, 항상 켜져 있는 나만의 컴퓨터. 월 몇 천 원에 빌려요.

• 아이디어: Hermes를 이 항상 켜진 서버에 올려두면, 내 노트북 상태와 상관없이 24시간 동작하고 Slack을 통해 대화할 수 있어요

우리는 DigitalOcean이라는 서비스에서 서버를 빌립니다. (초보자에게 가장 쉬운 편)

---

미리 알아둘 비용

서버 (DigitalOcean): 월 $6 / 항상 켜진 컴퓨터 값 (고정)

AI 모델 사용료: 사용한 만큼 / 봇의 두뇌, OpenAI 등에 질문할 때마다 조금씩 과금

서버 $6는 "집세", 모델 사용료는 "전기세"라고 생각하면 쉬워요.

---

준비물

• 신용카드 (DigitalOcean 가입용)

• 맥 또는 윈도우 컴퓨터 (설정하는 동안만 필요)

• Slack 워크스페이스 (관리자 권한)

• AI 모델 계정 하나 (예: OpenAI) — 봇의 두뇌용

1부. 서버 만들기 (DigitalOcean)

1-1. 가입

https://www.digitalocean.com 에서 가입 → 카드 등록.
(가입 시 "$5 Inference 크레딧" 안내가 떠도 무시하세요. 우리가 쓸 서버와는 다른 상품이에요.)

1-2. 서버(Droplet) 생성

1. 로그인 후 우측 상단 Create → Droplets 클릭

2. Region(지역): Singapore (한국에서 가장 빠름)

3. OS: Ubuntu → 최신 LTS 버전 (예: 24.04)

4. Droplet Type: Basic → Regular

5. 크기: 월 $6 짜리 (1GB RAM / 1 CPU) 선택 — 봇 하나엔 충분

6. Authentication(로그인 방식): SSH Key 선택 (아래 1-3 참고)

7. Hostname: hermes-bot 처럼 알아보기 쉬운 이름

8. 맨 아래 Create Droplet 클릭 → 1분 뒤 서버 IP 주소(예: 203.0.113.10)가 생겨요. 복사해두세요.

1-3. SSH 키 만들기 (서버 열쇠, 1번만)

서버에 안전하게 접속하기 위한 "디지털 열쇠"예요. 맥 터미널(응용프로그램 → 유틸리티 → 터미널)에서:

ssh-keygen -t ed25519 -C "hermes"

• 질문이 3번 나오면 그냥 엔터 3번 (기본값 사용), 아래 명령어로 출력 (cat: 파일 출력)

cat ~/.ssh/id_ed25519.pub

• 출력된 긴 문자열 전체를 복사 → DigitalOcean의 New SSH Key 칸에 붙여넣기

• SSH Key name: 아무거나 (예: 내-맥북) — 그냥 이름표예요

---

2부. 서버에 접속하기

맥 터미널에서 (서버IP는 1-2에서 복사한 주소):

ssh root@서버IP

• 처음 접속 시 yes 입력

• 프롬프트가 root@hermes-bot:~# 처럼 바뀌면 서버 안에 들어온 것이에요. 이제부터 명령어는 이 서버에서 실행돼요.

💡 중요: 앞으로 "서버에서"라고 하면 이 화면(root@... 로 시작), "내 컴퓨터에서"라고 하면 접속 전 일반 터미널이에요. 헷갈리면 화면 맨 앞 글자를 보세요.

---

3부. Hermes 설치하기

서버 안에서 순서대로:

apt update && apt -y upgrade curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc

설치 중 몇 가지 선택지가 나와요:

• Select terminal backend → Local 선택 (지금 이 서버에서 실행한다는 뜻)

• 나머지는 일단 넘어가도 돼요. 뒤에서 다시 설정합니다.

설치 확인:

hermes --version

버전 숫자가 나오면 성공.

---

4부. 봇의 "두뇌"(AI 모델) 연결하기

봇은 스스로 생각하지 않고, 외부 AI 모델(GPT 등)에 물어봐서 답해요. 이걸 연결 안 하면 봇이 "Provider authentication failed" 에러를 냅니다.

서버에서:

hermes model

• 제공자 목록이 나오면 하나 선택 (예: OpenAI)

• 안내에 따라 로그인/API 키 입력

  • OpenAI의 경우: 화면에 뜬 URL을 브라우저로 열고 → 코드 입력 → 로그인

• "Default model set to..." 가 뜨면 성공

💡 내 노트북에서 쓰던 모델 로그인은 서버로 자동으로 넘어오지 않아요. 서버에서 한 번 더 로그인해야 합니다.

---

5부. Slack 연동하기

5-1. Slack 앱 만들기

① 앱 설계도(매니페스트) 생성 — 서버에서:

hermes slack manifest --agent-view --write

→ 화면에 나온 JSON 내용을 전부 복사해두세요.

(출력 명령어: cat 파일경로)

② Slack 앱 생성

1. 브라우저에서 https://api.slack.com/apps 접속

2. (Slack이 처음이라면) 회원 가입 후 워크스페이스 생성

3. Create New App → From an app manifest 선택

4. 워크스페이스 선택 → 위에서 복사한 JSON 붙여넣기 → Create

5-2. 권한 & 기능 켜기

만든 앱 설정 화면에서 (매니페스트로 만들면 대부분 자동 설정돼 있지만, 확인):

③ OAuth 권한 — 왼쪽 메뉴 OAuth & Permissions → Bot Token Scopes에 아래가 있는지 확인:
chat:write, app_mentions:read, channels:history, im:history, im:read, im:write, users:read

④ Socket Mode 켜기 — 왼쪽 메뉴 Socket Mode → 토글 ON

• 앱 레벨 토큰 만들라고 하면: 이름 아무거나, 권한 connections:write → 생성

• 나오는 xapp-로 시작하는 토큰을 복사해두세요 ← (앱 토큰)

⑤ 이벤트 구독 — 왼쪽 메뉴 Event Subscriptions → 토글 ON → Subscribe to bot events에 아래 추가:
app_mention, message.im, message.channels
(단체 DM도 쓰려면 message.mpim도 추가)

⑥ 챗 탭 켜기 — 왼쪽 메뉴 App Home → Chat Tab 켜고, "Allow users to send..." 체크

5-3. 앱 설치 & 토큰 받기

⑦ 워크스페이스에 설치 — 왼쪽 메뉴 Install App → Install to Workspace → 허용

• 나오는 xoxb-로 시작하는 토큰을 복사 ← (봇 토큰)

이제 토큰 두 개가 손에 있어야 해요:

• 봇 토큰: xoxb-...

• 앱 토큰: xapp-...

5-4. Hermes에 토큰 입력

서버에서:

hermes gateway setup

• 플랫폼 목록에서 Slack 선택

• 봇 토큰(xoxb-), 앱 토큰(xapp-) 순서대로 붙여넣기

5-5. 봇을 채널에 초대

Slack에서 봇을 쓰고 싶은 채널에 들어가 메시지 입력창에:

/invite @Hermes

---

6부. 24시간 자동 실행 등록 ⭐ 핵심

서버에서 (이 명령이 "노트북 꺼도 계속 돌게" 만드는 부분):

sudo hermes gateway install --system --run-as-user root

• "Start now?" → Y

• "Start on boot?" → Y

상태 확인:

hermes gateway status --system

✓ System gateway service is running 이 보이면 성공! 🎉 서버가 재부팅돼도 자동으로 다시 켜집니다.

---

7부. 테스트

Slack에서 @Hermes 를 멘션하고 아무거나 물어보세요 (예: "안녕").
봇이 답하면 완성이에요. 이제 노트북을 꺼도 24시간 작동합니다.

---

보너스. Telegram도 추가하기 (쉬움 ⭐)

Hermes는 Slack 말고도 Telegram, Discord, WhatsApp, Signal, iMessage, LINE 등 20개 넘는 메신저를 지원해요. 하나의 봇이 여러 메신저에 동시에 붙을 수 있어요.

그중 Telegram이 제일 쉬워요. Slack처럼 앱 만들고 권한 설정하는 복잡한 과정 없이, 봇 하나 만들고 토큰 하나만 받으면 5분이면 끝나요.

B-1. 텔레그램에서 봇 만들기 (BotFather)

1. 텔레그램 앱에서 @BotFather 검색 → 대화 시작

2. /newbot 입력

3. 봇 이름 입력 (아무거나, 예: Trinity's Hermes)

4. 봇 사용자명 입력 → 반드시 bot으로 끝나야 함 (예: trinity_hermes_bot)

5. BotFather가 주는 토큰 복사 (비밀번호처럼 중요):

   8123456789:AAH1a2B3c4D5e6F7g8H9...

B-2. 내 텔레그램 ID 알아두기 (나만 쓰게 잠그기, 권장)

텔레그램 봇은 기본적으로 누구나 말 걸 수 있어요. 나만 쓰려면 내 숫자 ID가 필요해요.

• 텔레그램에서 @userinfobot 검색 → 대화 시작 → 아무 메시지나 전송

• Id: 123456789 같은 숫자를 알려줘요. 복사.

B-3. 서버에 연동

서버에서:

hermes gateway setup

• 플랫폼 목록에서 Telegram 선택

• 봇 토큰(B-1) 붙여넣기

• 허용 사용자(allowed users)를 물으면 → 내 숫자 ID(B-2) 입력

재시작:

sudo hermes gateway restart --system

B-4. 테스트

텔레그램에서 내가 만든 봇(예: @trinity_hermes_bot)을 검색 → 대화 시작 → "안녕" 전송. 답하면 완성!

💡 다른 메신저(Discord 등)도 방식은 똑같아요: 해당 앱에서 봇 토큰을 받아 hermes gateway setup에서 고르고 넣으면 돼요. Slack·Telegram 봇이 동시에 같은 서버에서 돌아갑니다.

---

자주 쓰는 명령어 모음 (서버에서)

맥이나 윈도우 터미널에서 아래 명령으로 서버에 접속 후 실행

ssh [email protected]

x.x.x.x -> Digital Ocean 'droplet' 에 추가한 서버의 IP 주소로 대체

봇 상태 보기 : hermes gateway status --system

봇 재시작: sudo hermes gateway restart --system

봇 멈추기: sudo hermes gateway stop --system

로그 보기: tail -n 30 ~/.hermes/logs/gateway.log

전체 점검: hermes doctor

모델 바꾸기: hermes model

---

한 장 요약

1. DigitalOcean에서 $6 서버(Droplet) 만들기 (Ubuntu, 싱가포르)

2. ssh root@서버IP 로 접속

3. install.sh 로 Hermes 설치 (backend = Local)

4. hermes model 로 AI 모델 연결 ← 빼먹지 말기

5. Slack 앱 만들고 토큰(xoxb-, xapp-) 받아 hermes gateway setup

6. sudo hermes gateway install --system --run-as-user root 로 24/7 등록

7. Slack에서 @Hermes 테스트

끝! 이제 노트북 없이도 24시간 도는 나만의 AI 봇이 생겼어요. 🎉