헤르메스 업데이트 버전 대처법 (영상과 화면이 다를 때)

안녕하세요.

헤르메스는 업데이트가 아주 빠른 오픈소스예요. 그래서 강의를 녹화한 뒤 명령이나 화면이 바뀐 곳이 생겼고, 따라 하다 막히신 분들이 계셨어요. 바로 맞춰 드리지 못해 죄송합니다.

이 자료는 지금 확인된 차이와 임시 해결법을 한곳에 모은 것이에요. 바뀐 부분은 11월 초에 강의 전체를 한 번에 업데이트할 예정이고, 그 전에 2.2 · 3.2 유닛은 핫픽스로 먼저 고쳐 드릴게요. 새 차이가 확인되면 이 자료를 계속 갱신합니다.

💡 먼저 내 헤르메스 버전을 확인해 주세요. 같은 증상도 버전에 따라 원인이 달라요. 질문하실 때 이 결과를 같이 적어 주시면 훨씬 빨리 도와드릴 수 있어요.

hermes --version

1. 가장 큰 변화: 게이트웨이는 이제 "컴퓨터에 하나"

헤르메스 v0.21.4(2026년 9월 21일)부터 게이트웨이 구조가 바뀌었어요.

• 예전(강의 영상): 소피·올리버처럼 직원마다 게이트웨이를 따로 띄웠어요.
• 지금: default 게이트웨이 하나가 컴퓨터에서 돌고, 다른 직원도 함께 태워요(멀티플렉스).
• 그래서 영상처럼 hermes -p sophie gateway install 이나 gateway run 을 하면 "default 게이트웨이에서 설치하라"는 안내와 함께 거절돼요. 고장이 아니라 정상이에요.
• 슬랙에서 누가 대답할지는 슬랙 토큰이 어느 프로필에 들어 있느냐로 정해져요.

이 변화가 영상과 가장 많이 부딪히는 곳이 2.2 · 3.2 · 3.4 예요.

2. 지금 내 상태 확인하기

두 명령으로 지금 상태를 볼 수 있어요.

hermes profile list
hermes gateway list

• profile list 의 Gateway 칸: running 이면 그 프로필이 게이트웨이에 올라가 있고, stopped 면 내려가 있어요.
• gateway list 에서 직원 옆에 served by the default multiplexer 가 보이면, default 게이트웨이가 그 직원을 함께 태우고 있다는 뜻이에요.

3. 핫픽스 전에 2.2 · 3.2 · 3.4 를 진행하는 방법

기본: default 하나만 켜 두고 진행하기

해당 유닛에서는 게이트웨이를 default 로만 두고, 나머지 직원은 stop 해 두세요.

hermes -p default gateway start
hermes -p sophie gateway stop

• 직원이 여러 명이면 stop 줄의 sophie 자리만 바꿔 한 명씩 실행해 주세요(oliver, ada, ethan, mia, noah, sam).
• hermes profile list 에서 default 만 running, 나머지는 stopped 면 준비 끝이에요.
• 이 상태에서는 슬랙에서 default 가 대답해요. 소피와는 터미널에서 대화할 수 있어요.

hermes -p sophie

💡 이 방법은 핫픽스가 올라오기 전까지 진도를 막힘없이 나가기 위한 임시 방법이에요. 영상 속 "슬랙에서 소피·직원들이 각자 대답하는 장면"은 핫픽스 영상에서 지금 버전 기준으로 다시 보여 드릴게요.

선택: 슬랙에서 소피가 대답하게 하고 싶다면 (2.2)

지금 버전에서는 profile use sophie 와 재시작만으로는 슬랙 쪽이 바뀌지 않아요. 슬랙 토큰을 default 에서 소피로 옮기면 소피가 대답해요.

1단계. 소피에 슬랙 토큰 넣기

섹션 1에서 만든 Bot Token(xoxb-)과 App-Level Token(xapp-)을 그대로 입력해요.

hermes -p sophie gateway setup

마지막에 already served by the default multiplexer 가 보여도 정상이에요. 토큰은 저장됐고, 서비스만 따로 만들지 않는다는 뜻이에요.

2단계. default 에서 같은 토큰 빼기

같은 슬랙 앱은 한 프로필만 쓸 수 있어요. default 에 남아 있으면 default 가 먼저 봇을 차지해요.

hermes -p default config unset SLACK_BOT_TOKEN
hermes -p default config unset SLACK_APP_TOKEN

3단계. 게이트웨이 통째로 다시 켜기

-p default 를 꼭 붙여 주세요. 안 붙이면 소피만 다시 태우고 default 는 토큰을 쥔 채 그대로 남아요.

hermes -p default gateway restart
hermes gateway list

default 는 PID 가 붙어 실행 중이고, sophie 가 served by the default multiplexer 로 보이면 성공이에요. 슬랙에서 봇을 멘션했을 때 소피 말투로 대답하면 끝이에요.

⚠️ 이 상태에서 hermes -p sophie gateway stop 을 하면 소피의 슬랙 봇도 함께 멈춰요. 소피를 슬랙에 둘 거라면 소피는 stop 하지 마세요.

3.2 · 3.4 직원 게이트웨이를 하나씩 올리는 장면

영상에서는 직원마다 gateway run · install 로 게이트웨이를 올리는데, 지금 버전에서는 거절돼요. 직원 프로필에 토큰을 넣는 데까지는 영상과 같고, 그 뒤에는 위의 "기본" 방법(default 하나만 켜 두기)으로 진행해 주세요.

4. 유닛별 알려진 차이

게이트웨이 말고도 지금까지 확인된 차이예요. 해결법이 확인된 것만 적었어요.

3.5 · 6.4 스킬 설치 명령 전체는 아래와 같아요.

hermes -p mia skills install skills-sh/anthropics/knowledge-work-plugins/design/skills/design-system

5. 자주 만나는 문제

Q. 영상대로 hermes -p sophie gateway install 을 했더니 거절돼요.

지금 버전에서는 정상이에요. 게이트웨이는 default 하나만 설치합니다. default 게이트웨이가 꺼져 있다면 이것만 실행해 주세요.

hermes gateway install

Q. 소피를 stop 했더니 슬랙에서 아무도 대답하지 않아요.

슬랙 토큰이 소피에만 들어 있는 상태에서 소피를 stop 하면 그렇게 돼요. 소피를 다시 켜거나(hermes -p sophie gateway start), 3장 "기본" 방법처럼 슬랙을 default 로 쓰려면 default 에 토큰이 있어야 해요.

Q. 예전 자료실 안내대로 default 게이트웨이를 끄거나 지웠어요. 상태가 사람마다 달라서 개별로 봐 드리는 게 정확해요. hermes gateway list 결과를 캡처해 카톡방 공지 댓글이나 인프런 질문으로 남겨 주세요.

6. 막히는 곳을 알려 주세요

위 내용 말고도 막히는 부분이 있다면 수강생 카톡방의 버전 차이 공지에 댓글로 남겨 주세요.

한곳에 모여 있어야 놓치지 않고 11월 업데이트에 반영할 수 있어요.

[유닛] 예) 4.1, 03:20쯤
[영상에서는]
[지금 화면은] (캡처 환영)
[헤르메스 버전] hermes --version 결과
[해결 여부] 해결함 / 아직
[해결 방법] 해결하셨다면 적어 주세요

먼저 해결하고 방법을 나눠 주신 수강생분들 덕분에 이 자료를 빠르게 만들 수 있었어요.
서로 막힌 곳을 같이 뚫어 가요.
수강생분들과 계속 꾸준한 소통을 해나가겠습니다. 감사합니다!