이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
헤르메스 에이전트 디스코드 연결, 봇 만들기부터 크론 작업까지
헤르메스 에이전트 디스코드 연결은 디스코드에 봇을 만들어 토큰을 헤르메스에 넣고 게이트웨이를 켜면 끝납니다. 이 글은 설치와 모델 설정부터 디스코드 봇 만들기, 게이트웨이 실행, 유용한 슬래시 명령, 반복 작업(크론), 대시보드와 칸반, 여러 모델에게 한 번에 묻는 MOA, 데스크톱 앱의 봇 모드까지 순서대로 안내합니다.

명령과 메뉴 이름은 2026년 10월 기준 헤르메스 공식 문서와 디스코드 개발자 포털 화면입니다. 버전이 바뀌면 달라질 수 있습니다.
헤르메스 에이전트는 무엇이고, 어디에 설치할까
헤르메스 에이전트(Hermes Agent)는 Nous Research가 만든 오픈소스 AI 에이전트입니다. 대화만 하는 챗봇과 달리 터미널 명령을 실행하고, 일을 스킬(재사용 가능한 작업 절차)로 저장하고, 시각을 정해 반복 작업을 돌리고, 디스코드·텔레그램·슬랙 같은 메신저에서 불러 쓸 수 있습니다. 매번 AI에게 똑같이 설명하는 일을 찾아서 맡기는 용도에 잘 맞습니다.
설치 장소는 세 가지 중에서 정합니다.
- 집에 있는 내 PC
- 헤르메스 전용으로 두는 PC(맥미니 등)
- VPS(데이터센터에 있는 컴퓨터를 빌려 쓰는 서비스)
에이전트는 터미널 명령을 실행할 수 있으니, 개인 파일이 가득한 메인 PC에 그대로 설치하는 것은 권하지 않습니다. 전용 PC나 VPS를 쓰거나, 헤르메스의 도커 샌드박스로 격리하는 편이 안전합니다. 24시간 켜 두려면 꺼지지 않는 VPS나 전용 PC가 편합니다. 로컬에 설치하면 서버 비용은 없고, 모델 API 비용은 어디에 설치하든 따로 듭니다. VPS 요금은 업체와 사양마다 다르니 결제 화면에서 확인합니다.
코드 작업은 클로드 코드나 코덱스 같은 코딩 도구에 맡기고, 조사·브리핑·반복 자동화는 헤르메스에 맡기는 식으로 나눠 쓰는 사람이 많습니다.
준비물
- 계정: 디스코드 계정, 모델 공급자의 API 키(또는 공급자 로그인), VPS를 쓴다면 호스팅 업체 계정
- 프로그램: 터미널 앱(맥은 터미널, 윈도우는 PowerShell), 디스코드 앱, 브라우저
- 선택: 노션 내보내기 폴더, 클로드 대화 내보내기 파일(세컨드 브레인을 만들 때)
- 보관할 곳: 토큰과 비밀번호를 적어 둘 외부에 노출되지 않는 메모장
모델 공급자는 헤르메스 설정에서 고릅니다. 성능이 낮은 모델을 고르면 헤르메스가 기대에 못 미치는 것처럼 느껴지기 쉬우니, 처음에는 성능이 좋은 모델로 시작하는 편이 낫습니다. 클로드 구독(Pro·
1. 설치 장소 정하기와 VPS 접속
1. 위 세 가지 중 하나를 정합니다. 로컬 설치를 골랐다면 VPS 구획(2~3번)은 건너뛰고 설치부터 시작합니다.
확인: 설치 장소가 정해졌습니다.
2. VPS를 골랐다면 호스팅 업체에서 가장 가까운 지역의 서버를 만듭니다. 업체에 따라 헤르메스가 미리 깔린 원클릭 설치 이미지가 있습니다. 그것을 쓰면 아래 설치 구획은 건너뜁니다.
확인: 서버 대시보드가 열리고 접속 정보(주소, 루트 비밀번호)가 보입니다.
3. 내 컴퓨터의 터미널에서 서버에 접속합니다. 대시보드에 있는 접속 명령(ssh root@서버주소 형식)을 복사해서 붙여 넣고 비밀번호를 입력합니다. 대시보드의 "터미널" 버튼을 쓰면 브라우저 안에서 바로 열립니다.
확인: 비밀번호를 넣은 뒤 터미널 줄 앞부분 표시가 바뀌면 접속된 것입니다. 입력한 글자는 화면에 보이지 않는 것이 정상입니다.
서버 비밀번호는 따로 저장해 둡니다. 나중에 대시보드를 열 때 다시 씁니다.
2. 헤르메스 설치와 모델 연결
원클릭으로 설치했다면 이 구획은 건너뜁니다.
4. 헤르메스 공식 문서(hermes-agent.nousresearch.com)를 열고, 설치 명령을 복사해서 터미널에 붙여 넣습니다. 리눅스·맥·WSL2에서는 아래 한 줄입니다.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
윈도우 PowerShell에서는 이 명령입니다.
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
확인: 설치가 끝났다는 표시가 나옵니다.
5. 셸을 다시 읽어 들인 뒤 hermes
확인: 헤르메스 대화 화면이 뜹니다. 문제가 있으면 hermes doctor
6. 모델을 연결합니다. 처음 설정 마법사는 hermes setup, 모델 공급자만 바꾸려면 hermes model
확인: 공급자 선택 화면이 나옵니다.
7. API 키로 연결한다면 공급자 목록 아래쪽의 사용자 지정(Custom)을 고르고, 주소(베이스 URL)와 API 키를 입력한 뒤 모델 이름을 지정합니다. 베이스 URL은 쓰는 서비스의 공식 안내에서 확인합니다. API 키는 남에게 보이지 않게 입력합니다.
확인: 입력한 모델 이름이 표시됩니다. 나머지 질문은 엔터로 넘겨도 설정이 마무리됩니다.
3. 디스코드 봇 만들기
헤르메스에 붙일 메신저는 여러 개입니다. 텔레그램이 가장 쉽고 많이 쓰이며, BotFather에서 새 봇을 만들어 토큰을 헤르메스에 붙여 넣으면 됩니다. 이 글은 디스코드를 따라갑니다. 디스코드는 봇 하나를 서버(디스코드의 대화방 모음)에 초대하는 과정이 한 번 더 있습니다.
8. 터미널에서 게이트웨이 설정 마법사를 시작합니다.
hermes gateway setup
확인: 메신저 목록이 나옵니다. 스페이스바로 디스코드를 선택합니다. 마법사는 토큰을 확인하고, 필요한 권한이 켜져 있는지 점검하고, 초대 링크를 보여 주고, 나를 허용 목록에 넣을 수도 있습니다.
9. 마법사가 디스코드 봇 토큰을 물으면 터미널을 열어 둔 채 브라우저에서 디스코드 개발자 포털(discord.com/developers/applications)을 엽니다. 링크가 안 보이면 "디스코드 개발자 센터"를 검색해서 들어갑니다.
확인: 개발자 포털이 열립니다.
10. 왼쪽 탭의 "Applications"에서 "New Application"을 누르고 이름을 입력합니다. 이름은 마음대로 정합니다(예: 헤르메스). 약관에 동의하고 "Create"를 누릅니다.
확인: 사람인지 확인하는 체크가 나올 수 있고, 통과하면 애플리케이션 설정 화면이 열립니다. 아이콘은 선택입니다.
11. 왼쪽 탭의 "Bot"을 누릅니다. 공식 안내 기준으로 "Public Bot"은 켜 둡니다(디스코드가 주는 초대 링크를 쓰려면 필요합니다). "Require OAuth2 Code Grant"는 끈 상태로 둡니다.
확인: 봇 설정 화면이 열립니다.
12. 같은 화면에서 아래로 내려 "Privileged Gateway Intents"를 찾아 두 가지를 켭니다.
- Message Content Intent: 필수입니다. 꺼져 있으면 디스코드가 연결을 거부해 봇이 오프라인으로 남습니다.
- Server Members Intent: 필수입니다. 사용자 이름과 역할 허용 목록을 읽을 때 씁니다.
- Presence Intent는 선택입니다.
확인: 두 스위치가 켜졌다면 "Save Changes"를 눌러 저장합니다.
13. "Reset Token"을 눌러 토큰을 만듭니다.
확인: 비밀번호 인증을 요구하고, 통과하면 토큰이 화면에 나옵니다. 토큰은 이때 한 번만 보입니다. 바로 복사해서 안전한 곳에 저장합니다. 놓쳤다면 다시 Reset Token을 눌러 새로 만들면 됩니다.
14. 복사한 토큰을 터미널의 "디스코드 봇 토큰" 입력 자리에 붙여 넣습니다. 수동으로 설정할 때는 ~/.hermes/.env 파일의 DISCORD_BOT_TOKEN
확인: 입력이 들어가고 마법사가 다음 질문으로 넘어갑니다.
토큰은 봇을 마음대로 조종할 수 있는 열쇠입니다. 채팅, 스크린샷, 공개 저장소에 올리지 않습니다.
4. 서버에 초대하고 허용 목록 만들기
15. 개발자 포털 왼쪽 탭의 "Installation"에서 "Guild Install"을 켜고 "Discord Provided Link"를 선택합니다. 범위(scope)는 botapplications.commands 두 가지를 모두 켭니다. 이 두 가지는 반드시 켜야 합니다. 직접 초대 링크를 만든다면 아래 형식에서 YOUR_APP_ID
https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=309237763136
확인: 화면 아래쪽에 초대 링크가 생겼거나, 위 형식의 링크를 만들었습니다.
16. 권한은 공식 안내를 따릅니다. 필수는 View Channels, Send Messages, Embed Links, Attach Files, Read Message History입니다. 추천은 Create Public Threads, Send Messages in Threads, Add Reactions입니다. 위 직접 만든 링크의 permissions=309237763136
확인: 권한 항목이 선택됩니다. 예전 링크로 이미 초대했다면 새 권한이 자동으로 늘지 않으니 새 링크로 다시 초대합니다.
17. 헤르메스와 대화할 서버가 필요합니다. 디스코드 앱에서 새 서버를 만듭니다. 이름은 마음대로 정합니다.
확인: 서버 목록에 새 서버가 생깁니다.
18. 복사해 둔 초대 링크를 브라우저 주소창에 붙여 넣어 엽니다. 목록에서 방금 만든 서버를 고르고 "계속", 이어서 "승인(Authorize)"을 누릅니다. 서버에 대한 서버 관리(Manage Server) 권한이 있어야 합니다.
확인: 디스코드 서버에 헤르메스 봇이 들어옵니다. 이 시점에서는 봇이 오프라인으로 보이는 것이 정상입니다. 게이트웨이를 켜야 온라인이 됩니다.
19. 내 사용자 ID를 알아냅니다. 디스코드 설정의 "고급(Advanced)"에서 "개발자 모드"를 켭니다. 개발자 모드는 버전에 따라 앱 설정의 "고급" 메뉴 안에 있습니다. 그다음 내 프로필을 우클릭하고 "사용자 ID 복사"를 누릅니다.
확인: 숫자로 된 ID가 복사됩니다.
20. 터미널의 사용자 ID 입력 자리에 붙여 넣습니다. 수동 설정이라면 .envDISCORD_ALLOWED_USERS
확인: 입력이 들어갑니다.
헤르메스 게이트웨이는 허용 목록(DISCORD_ALLOWED_USERS, DISCORD_ALLOWED_ROLES, DISCORD_ALLOWED_CHANNELS)에 없는 사람의 메시지를 기본으로 거부합니다. 모두에게 열어 두는 DISCORD_ALLOW_ALL_USERS=true
21. 봇이 먼저 말을 거는 알림을 받을 채널을 정합니다. 그 채널에서 /sethome.envDISCORD_HOME_CHANNEL(채널 ID)을 적습니다. 채널 ID는 개발자 모드를 켠 뒤 채널을 우클릭해 "채널 ID 복사"로 얻습니다. 서버 ID와 채널 ID를 헷갈리지 않게 주의합니다.
확인: 홈 채널이 정해졌다는 안내가 나옵니다.
5. 게이트웨이 켜기와 첫 대화
22. 터미널에서 게이트웨이를 실행합니다.
hermes gateway
확인: 서버가 시작됐다는 알림이 뜨고, 디스코드에서 봇이 온라인 상태로 바뀝니다. 설정을 바꾼 뒤에는 hermes gateway restart
23. 디스코드 서버 채널에서 봇을 @멘션해 메시지를 보냅니다. 서버 채널에서는 기본적으로 @멘션했을 때만 답합니다(DISCORD_REQUIRE_MENTIONtrue).
확인: 정상으로 답장이 옵니다. 슬래시 명령도 디스코드에서 그대로 쓸 수 있습니다.
24. 서버를 껐다 켜도 계속 돌게 하려면 서비스로 등록합니다.
hermes gateway install
확인: 리눅스(systemd)와 맥(launchd)은 사용자 서비스로, 윈도우는 로그온할 때 실행되는 작업(Task Scheduler)으로 등록됩니다. 상태는 hermes gateway status, 정지는 hermes gateway stop
디스코드가 안 될 때 확인할 것
- 봇이 온라인인데 답이 없다: Message Content Intent를 켰는지, 허용 목록(
DISCORD_ALLOWED_USERS등)에 내 ID가 들어갔는지 확인하고hermes gateway restart를 합니다. gateway.log에 "No Discord access policy configured"가 보이면 접근 정책이 없다는 뜻입니다. - 시작할 때
PrivilegedIntentsRequired오류: 개발자 포털에서 필수 Intents를 켜고 "Save Changes"를 눌렀는지 확인합니다. - 봇이 오프라인: 봇이 서버에 들어와 있어도 게이트웨이가 꺼져 있으면 오프라인입니다.
hermes gateway가 실행 중인지, 토큰이 최신인지 확인합니다. - 토큰을 잃어버렸다: 토큰은 한 번만 보입니다. Reset Token으로 새로 만들어 저장하고
.env를 고칩니다. - 특정 채널이 안 보인다: 봇 역할에 그 채널의 View Channel과 Read Message History 권한을 줍니다.
- 403 오류: 올바른 권한으로 봇을 다시 초대하거나 역할 권한을 조정합니다.
- "User not allowed": 내 ID를 허용 목록에 넣고 게이트웨이를 재시작합니다.
쓰기 편한 슬래시 명령
슬래시 명령은 터미널 화면과 메신저에서 대부분 같이 씁니다. 헤르메스가 가진 스킬도 사실상 슬래시 명령으로 부를 수 있습니다. 모든 스킬을 보려면 헤르메스에게 "네가 가진 스킬을 모두 알려 줘"라고 시킵니다.
/bg 질문: 별도 백그라운드 세션에서 작업을 돌립니다. 지금 대화는 그대로 쓸 수 있습니다. 예를 들어 "랜딩 페이지를 만들어 줘"를 백그라운드로 맡기고, 같은 화면에서 다른 질문을 이어 합니다. 새 탭을 열 필요가 없습니다./btw 질문: 지금 하던 대화에 대한 곁다리 질문을 읽기 전용 복사본에서 답합니다. 본 작업은 계속 돌아갑니다. 기억에 남기지 않고 가볍게 묻고 싶을 때 씁니다./steer 지시: 작업 도중에 메모를 끼워 넣습니다. 다음 도구 호출이 끝난 뒤 에이전트에게 전달돼 작업을 멈추지 않고 방향을 바꿀 수 있습니다./skin 이름: 터미널 화면 테마를 바꿉니다.poseidon(진한 파랑과 청록),mono,slate,daylight,warm-lightmode,sisyphus,charizard,ares,default가 있습니다. 적용은 현재 세션에만 되고, 기본으로 쓰려면 설정 파일의 display.skin에 적습니다. /insights: 최근 30일의 사용 현황과 분석을 보여 줍니다./model: 모델을 확인하고 바꿉니다. 바꾼 값은 게이트웨이를 재시작해도 유지되고,--global을 붙이면 설정 파일에 기록됩니다. /new: 새 세션을 시작합니다. 메신저에서 대화는 계속 이어지는 한 세션이라, 주제가 바뀔 때/new를 쓰면 기억 저장과 검색이 깔끔해집니다.
일을 시킬 때는 구체적으로 적습니다. "내가 답장해야 할 메일 알려 줘"처럼 메일 연동이 된 상태에서 쓰는 요청이 좋은 예입니다.
반복 작업(크론) 맡기기
크론(cron)은 정해진 시각마다 같은 일을 돌리는 예약 작업입니다. 만드는 방법은 세 가지입니다.
- 대화로 말하기: "매일 아침 7시에 새로운 정보를 요약해 줘"처럼 평소 말투로 시킵니다. 헤르메스가 내부 도구로 작업을 만듭니다.
- 슬래시 명령(터미널 대화 화면에서):
/cron add "every 2h" "서버 상태 확인" - 터미널 명령:
hermes cron create "every 2h" "서버 상태 확인"
시각 표현은 in 30m(30분 뒤 한 번), every 2h(2시간마다), daily at 7am, weekdays at 9am, every monday 9am, 크론 식(0 9 * * *)을 씁니다. 결과를 받을 곳은 --deliver~/.hermes/cron/output/telegram, discord
쓰임새 예시는 이렇습니다.
- 매일 아침 7시에 관심 분야 새 소식을 요약해 받기
- 뉴스레터를 받는다면 "매주 수요일 뉴스레터를 요약해 줘"
- SNS용으로 "매일 아침 7시에 특정 분야 정보를 바탕으로 올릴 만한 포스팅 세 가지를 세 줄 요약으로 써 줘". 내 SNS의 성격이 어느 정도 전달돼 있어야 결과가 좋아집니다.
- 모니터링: 경쟁사의 가격·디자인·SNS 게시물, 유튜브 채널, 키워드 확인. 예를 들어 "제품 사이트나 앱스토어에서 특정 분야 제품의 별점 3점 이하 리뷰를 정리하고 기존 사용자의 불만이 무엇인지 알려 줘"
- 생활 자동화 후보 찾기: "매일 반복하고 있는데 자동화할 수 있는 일이 뭐야?" 먼저 내 생활과 업무에 대한 정보를 충분히 알려 줘야 쓸 만한 답이 나옵니다.
- 자기 전에 "내 일을 편하게 해 줄 도구를 만들어 줘"를 시켜 두고 아침에 결과 확인
크론으로 쓸 때 알아 둘 점이 있습니다.
- 게이트웨이가 켜져 있어야 합니다. 에이전트 작업은 게이트웨이 안에서 실행되고 60초마다 일정을 확인합니다.
- 매번 새 세션으로 돌아갑니다. 이전 실행을 기억하지 못하므로, 프롬프트에 필요한 정보를 모두 담습니다.
- 크론 작업은 기본으로 다른 크론 작업을 만들지 못합니다. 예약이 끝없이 늘어나는 것을 막기 위해서입니다.
- 관리 명령은
hermes cron list,pause,resume,run,edit,remove,status입니다. 반복 작업은 하나만 맡겨 놓고 한 달 정도 돌려 본 뒤 계속 둘지 판단하는 식으로 시작하면 부담이 작습니다.
대시보드 열기와 칸반 보드
헤르메스 대시보드는 사용 기록, 모델과 키 설정, 크론 작업, 스킬 등을 브라우저에서 보는 화면입니다.
25. 헤르메스가 설치된 곳의 터미널에서 대시보드를 켭니다.
hermes dashboard
확인: 주소(http://127.0.0.1:9119)가 뜹니다. 내 컴퓨터에 설치했다면 브라우저가 자동으로 열립니다. 기본값은 이 컴퓨터에서만 접속되는 주소와 9119번 포트입니다.
26. VPS에 설치했다면 내 컴퓨터에서 새 터미널을 하나 더 열고 터널을 만듭니다. 공식 문서는 대시보드를 외부에 직접 열기보다 SSH 터널이나 테일스케일을 권합니다. 일반적인 SSH 터널 명령은 이런 모양입니다.
ssh -L 9119:127.0.0.1:9119 root@서버주소
확인: 비밀번호를 묻습니다. 입력하면 별다른 출력이 없어도 터널이 열린 상태입니다.
27. 내 컴퓨터 브라우저 주소창에 localhost:9119
확인: 헤르메스 대시보드가 열립니다. 상태, 세션, 분석, 크론, 스킬, 설정 화면이 있습니다.
대시보드를 0.0.0.0 같은 외부 주소로 열면 로그인 인증이 켜지고 인증 제공자를 설정해야 시작됩니다. 사용자 이름과 비밀번호 방식은 믿을 수 있는 내부망이나 VPN용입니다. 인터넷에 열 때는 OAuth 같은 방식을 씁니다. 윈도우 기본 환경에서는 대시보드의 채팅 화면이 안 열리고 나머지 화면만 열린다고 공식 문서에 적혀 있습니다.
28. 대시보드 왼쪽 메뉴에서 "Kanban"을 엽니다.
확인: Triage(분류 대기), Todo, Ready, In progress, Blocked, Done 칸이 있는 보드가 보입니다.
29. 거친 아이디어를 Triage 칸에 올립니다. 예를 들어 "새 랜딩 페이지를 만들어 줘"입니다. 터미널에서는 hermes kanban create "제목"
확인: 기본 설정에서는 디스패처(일을 나눠 주는 부분)가 이 아이디어를 읽고 디자인·카피·구현·검수 같은 작은 작업으로 쪼개 알맞은 프로필(담당 에이전트)에 배정합니다.
칸반은 게이트웨이가 켜져 있고 담당 프로필이 준비돼 있어야 작동합니다. 프로필에 필요한 키가 없으면 작업을 시작하지 못합니다.
기억 확인하기와 세컨드 브레인 만들기
헤르메스는 두 가지로 기억합니다. 하나는 ~/.hermes/memories/~/.hermes/state.db)입니다. 그래서 "지난번에 우리가 ○○ 얘기했었나?"처럼 주제로 물으면 지난 대화 내용을 찾아 줍니다. 날짜보다 주제나 단어로 물어야 잘 찾습니다.
기억과 스킬을 점검하려면 /journeymemory.write_approval: true/memory pending
세컨드 브레인(내가 쌓아 둔 지식을 AI가 읽고 활용하게 하는 구조)을 만들려면 자료를 한 폴더에 모읍니다.
30. 노션 설정에서 워크스페이스 전체를 내보냅니다(내보내기 형식은 노션 화면에서 고릅니다). 노션 MCP를 쓰면 별도 폴더에 전체를 동기화할 수도 있습니다.
확인: 내보낸 폴더가 생깁니다.
31. 클로드 웹의 설정에서 "개인정보 보호" 탭의 "데이터 내보내기"를 누릅니다.
확인: 지금까지의 대화와 클로드가 정리한 나에 대한 메모리 파일을 받을 수 있습니다.
32. 노션 폴더와 클로드 내보내기 파일을 하나의 폴더로 모으고, 헤르메스가 그 폴더를 읽도록 지시합니다. 폴더를 위키 형태로 구조화해 달라고 시키면 요약과 분류를 맡길 수 있습니다.
확인: 헤르메스가 폴더의 내용을 바탕으로 답합니다.
내보낸 자료에는 개인 정보가 많습니다. 헤르메스가 읽은 내용은 선택한 모델 공급자에게 전달되므로, 민감한 자료는 빼고 시작합니다.
레딧의 특정 서브레딧이나 X의 특정 인물을 매일 보게 하고 싶다면 처음부터 대상을 좁혀 지정합니다. 제품을 만드는 사람이라면 프로덕트 헌트, 인디해커스, 해커 뉴스 같은 곳을 매일 확인하도록 크론으로 맡기는 방법이 있습니다. 이런 사이트를 읽는 도구는 별도로 설치해야 할 수 있으니 도구의 공식 안내를 확인합니다.
MOA로 여러 모델에게 한 번에 묻기
MOA(Mixture of Agents)는 여러 모델에게 같은 질문을 시킨 뒤 하나의 최종 모델이 의견을 종합해 답하는 방식입니다. 헤르메스에서는 moa
33. 터미널에서 설정을 시작합니다.
hermes moa configure
확인: 최종 답을 쓰는 모델(aggregator)과 먼저 의견을 내는 참조 모델을 고르는 화면이 나옵니다. 대시보드의 모델 설정이나 데스크톱 앱에서도 만들 수 있습니다.
34. 모델 선택 화면에서 방금 만든 MOA 프리셋을 현재 모델로 고릅니다. 모델 선택 화면은 hermes model/model
확인: 사용 모델이 MOA 프리셋으로 표시됩니다.
35. 판단하기 어려운 질문을 입력합니다.
확인: 여러 모델의 의견이 모인 뒤 하나로 종합된 최종 답이 나옵니다.
MOA는 틀리면 비용이 큰 질문, 예를 들어 설계 방향이나 사업 방향 같은 결정에 어울립니다. 답이 정해진 단순한 질문에는 토큰과 시간만 더 들 뿐이라 쓸 필요가 없습니다.
데스크톱 앱의 봇 모드로 봇 여러 개 만들기
봇 모드는 헤르메스 프로필 하나를 이름과 역할이 있는 봇으로 만들어 쓰는 기능입니다. 헤르메스 데스크톱 앱에 들어 있고 기본으로 켜져 있습니다. CLI로 설치했다면 hermes desktop
36. 데스크톱 앱을 최신 버전으로 업데이트합니다.
확인: 왼쪽 사이드바에 세션 옆으로 "Bots" 탭이 보입니다.
37. Bots 탭의 명단(roster)에서 새 에이전트(New Agent) 버튼을 누릅니다.
확인: 봇 생성 화면이 열립니다.
38. 목적에 맞게 이름, 타이틀, 설명을 적습니다.
확인: 이름에 따라 아바타가 자동으로 만들어지고, 봇이 새 채팅에서 자기소개를 합니다.
39. 필요하면 "Advanced"를 열어 봇별 설정을 합니다. 기존 프로필 복제, 봇마다 다른 모델과 공급자, 성격과 상시 지침을 적는 SOUL.md 작성, 쓸 스킬·도구·MCP 서버 선택이 가능합니다. 채팅에서 "이런 봇을 만들어 줘"라고 시켜도 만들어 줍니다.
확인: 봇별 설정이 저장됩니다.
봇은 ~/.hermes/profiles/이름/ 아래의 프로필이고, 터미널에서 hermes -p 이름 chathermes -p 이름 auth add 공급자
40. 봇끼리 소통시키려면 채팅에서 @를 입력해 봇 이름을 부릅니다. 여러 봇을 묶어 그룹 채팅방(봇 2~6개)을 만들면 서로 협업합니다.
확인: 호출한 봇이 응답합니다. 아무도 호출하지 않으면 모든 봇이 답할 수 있고, 판단이 필요한 일은 봇이 @user
시작 후 점검 목록
hermes를 입력하면 헤르메스가 실행되고 응답한다 - 디스코드에서 봇이 온라인이고 @멘션하면 답한다
/bg,/btw같은 슬래시 명령이 작동한다- 반복 작업 하나를 맡겨 두었다
- VPS라면 터널을 연 뒤
localhost:9119에서 대시보드가 열린다
첫 결과가 기대와 다를 때
- 첫 결과가 기대에 못 미친다: 처음에는 흔한 일입니다. 내 생활과 업무에 대한 정보를 충분히 넣어 주는 시간이 이후 결과에 쌓입니다. 새 기능을 급하게 따라가기보다, 내가 AI에게 매번 똑같이 설명하는 일이 무엇인지 먼저 찾아 맡기는 순서가 효율적입니다.
- 모델 성능이 낮아 마음에 안 든다: 상위 모델로 바꿔 봅니다.
- 영상 생성이나 X 검색이 안 된다: 그록(xAI) 구독이나 키가 필요한 기능이 있습니다. 해당 공급자의 계정과 인증을 확인합니다.
- 디스코드 봇이 오프라인: 게이트웨이를 켜지 않은 상태입니다. 22번의
hermes gateway를 실행합니다.
자주 묻는 질문
헤르메스 에이전트 디스코드 연결에 꼭 필요한 설정이 뭔가요?
봇 토큰, Message Content Intent와 Server Members Intent, 허용 목록에 넣을 내 사용자 ID, 그리고 켜져 있는 게이트웨이입니다. 이 가운데 하나라도 빠지면 봇이 오프라인이거나 답을 하지 않습니다.
디스코드에서 봇이 온라인인데 답이 없어요.
서버 채널에서는 봇을 @멘션해야 답하는 것이 기본입니다. 그래도 조용하면 Message Content Intent가 켜져 있는지, DISCORD_ALLOWED_USERShermes gateway restart
헤르메스 크론 작업은 컴퓨터를 꺼도 돌아가나요?
게이트웨이가 켜져 있어야 돌아갑니다. 내 PC를 끄면 멈추므로, 계속 돌리려면 꺼지지 않는 전용 PC나 VPS에 게이트웨이를 서비스로 등록합니다.
헤르메스를 메인 PC에 설치해도 되나요?
권하지 않습니다. 에이전트는 터미널 명령을 실행할 수 있어서 개인 파일이 있는 컴퓨터에서는 위험이 큽니다. 전용 PC나 VPS를 쓰거나 도커 샌드박스로 격리하는 방법이 있습니다.
이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.
원본 영상 보러가기 ↗