콘텐츠로 이동
MiniCITY Docs

메인컴 WSL2 Hermes Agent 셋팅기

메인컴 WSL2 Hermes Agent 셋팅기

섹션 제목: “메인컴 WSL2 Hermes Agent 셋팅기”

실제 설치 및 설정 과정 정리
환경: 메인컴 WSL2 Ubuntu 24.04.4 LTS (PS-i14700k)
설정일: 2026-04-19
최종 결과: ✅ Hermes Agent v0.10.0 + Telegram 봇 연동 성공

1. 설치 전 환경

섹션 제목: “1. 설치 전 환경”
항목상태
OSUbuntu 24.04.4 LTS (WSL2)
Python3.12.3 (Hermes는 uv로 3.11.15 자동 설치)
Node.jsv22.22.2
Git2.43.0
curl8.5.0
Ollamav0.21.0 ✅ (이미 설치됨)
Hermes❌ 미설치 → 이미 설치되어 있었음!

💡 메인컴에는 과거에 이미 Hermes v0.10.0이 설치되어 있었음
설치 스크립트 실행할 필요 없이 업데이트만 진행

2. 작업 순서

섹션 제목: “2. 작업 순서”

2.1 WSL 실행

섹션 제목: “2.1 WSL 실행”

중요: 메인컴 WSL은 Windows에서 직접 실행해야 함

# Windows에서 WSL 실행
wsl


# 또는 PowerShell에서
wsl -d Ubuntu-24.04

⚠️ WSL이 꺼져있으면 Tailscale SSH(100.105.122.120:2222)로 접속 안 됨
Windows SSH로 WSL 실행 후 작업 권장

2.2 Hermes 업데이트

섹션 제목: “2.2 Hermes 업데이트”
Terminal window
hermes update

결과:

  • 7 commits behind → 최신으로 업데이트 완료
  • Python 의존성 업데이트
  • Node.js 의존성 업데이트 (repo root, ui-tui)
  • Web UI 빌드
  • 스킬 동기화

2.3 서브모듈 복구

섹션 제목: “2.3 서브모듈 복구”
Terminal window
cd ~/.hermes/hermes-agent
git submodule update --init --recursive

→ tinker-atropos 서브모듈 복구됨

3. 모델 설정

섹션 제목: “3. 모델 설정”

3.1 GLM-5.1 Cloud 설치

섹션 제목: “3.1 GLM-5.1 Cloud 설치”
Terminal window
ollama pull glm-5.1:cloud

3.2 Hermes 기본 모델 설정

섹션 제목: “3.2 Hermes 기본 모델 설정”
Terminal window
hermes config set model.default glm-5.1:cloud
hermes config set model.provider custom
hermes config set model.base_url http://127.0.0.1:11434/v1

config.yaml 결과:

model:
  default: glm-5.1:cloud
  provider: custom
  base_url: http://127.0.0.1:11434/v1

3.3 메인컴 Ollama 모델 목록

섹션 제목: “3.3 메인컴 Ollama 모델 목록”
모델크기비고
qwen36-35b-q4ks20GB로컬 양자화
qwen3.5:cloud-Cloud 모델
gemma4:e2b7.2GB로컬 엣지 모델
gemma4:26b-a4b-q416GB로컬 MoE
qwen3.6-35b-ud-q420GB로컬 양자화
gemma4:31b-cloud-Cloud 모델
minimax-m2.5:cloud-Cloud 모델
glm-5.1:cloud-Cloud 모델 ← 기본 설정

4. Telegram 봇 연동

섹션 제목: “4. Telegram 봇 연동”

4.1 봇 정보

섹션 제목: “4.1 봇 정보”
항목값
봇 이름@miniream_bot
토큰8723523208:AAGXYzq4bXMlasExTQX2v-GtY5aieesnGfc
허용 사용자8788378713 (미미아빠)

4.2 설정 명령어

섹션 제목: “4.2 설정 명령어”
Terminal window
hermes config set TELEGRAM_BOT_TOKEN 8723523208:AAGXYzq4bXMlasExTQX2v-GtY5aieesnGfc
hermes config set TELEGRAM_ALLOWED_USERS 8788378713

4.3 ⚠️ 봇 토큰 충돌 주의!

섹션 제목: “4.3 ⚠️ 봇 토큰 충돌 주의!”

처음에 @minireamvllm_bot 토큰을 사용했다가 실패한 이유:

같은 봇 토큰은 한 곳에서만 polling 가능함.
맥미니 OpenClaw 게이트웨이가 @minireamvllm_bot으로 이미 폴링 중이어서
Hermes가 같은 토큰으로 들어가면 Conflict: terminated by other getUpdates request 에러 발생.

해결: Hermes 전용 봇(@miniream_bot)을 새로 만들어서 사용

⚠️ 절대 OpenClaw가 사용 중인 봇 토큰을 Hermes에 설정하지 말 것!

5. WSL2 DNS 설정

섹션 제목: “5. WSL2 DNS 설정”

5.1 문제

섹션 제목: “5.1 문제”

WSL2에서 api.telegram.org DNS 해석 실패 → Hermes 게이트웨이가 Telegram에 연결 못 함

에러:

[Telegram] Primary api.telegram.org connection failed ([Errno -3] Temporary failure in name resolution)

5.2 해결

섹션 제목: “5.2 해결”
Terminal window
# WSL2 자동 DNS 비활성화
sudo tee /etc/wsl.conf > /dev/null <<EOF
[network]
generateResolvConf = false
EOF


# 수동 DNS 설정
sudo rm -f /etc/resolv.conf
sudo tee /etc/resolv.conf > /dev/null <<EOF
nameserver 8.8.8.8
nameserver 1.1.1.1
EOF

⚠️ wsl --shutdown 후 재시작하면 resolv.conf가 다시 날아갈 수 있음
매번 WSL 시작 후 DNS 재설정 필요할 수 있음

6. OpenClaw 제거 (메인컴 WSL)

섹션 제목: “6. OpenClaw 제거 (메인컴 WSL)”

메인컴 WSL의 OpenClaw가 Telegram 봇 충돌 원인이어서 완전 제거함

Terminal window
# 서비스 중지 + 비활성화
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway
systemctl --user stop openclaw-node 2>/dev/null
systemctl --user disable openclaw-node 2>/dev/null


# 서비스 파일 삭제
rm -f ~/.config/systemd/user/openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-node.service
systemctl --user daemon-reload


# 프로세스 강제 종료
pkill -9 -f openclaw

💡 메인컴 WSL에서 OpenClaw는 더 이상 사용하지 않음
OpenClaw 게이트웨이는 맥미니에서만 운영

7. 게이트웨이 실행

섹션 제목: “7. 게이트웨이 실행”

7.1 실행 방법 (tmux 사용)

섹션 제목: “7.1 실행 방법 (tmux 사용)”
Terminal window
# tmux 세션 생성
tmux new -s hermes


# 세션 안에서
export PATH="$HOME/.local/bin:$PATH"
hermes gateway run

✅ tmux 안에서 실행하면 SSH가 끊겨도 유지됨
✅ WSL 창을 띄워두면 게이트웨이가 계속 실행됨

7.2 게이트웨이 재접속

섹션 제목: “7.2 게이트웨이 재접속”
Terminal window
tmux attach -t hermes

7.3 게이트웨이 로그 확인

섹션 제목: “7.3 게이트웨이 로그 확인”
Terminal window
cat ~/.hermes/logs/errors.log

8. 겪은 문제 & 해결 요약

섹션 제목: “8. 겪은 문제 & 해결 요약”
문제원인해결
WSL SSH 접속 안 됨WSL이 꺼져있음Windows에서 wsl 실행
hermes: command not foundPATH에 ~/.local/bin 없음.bashrc에 export PATH="$HOME/.local/bin:$PATH" 추가
Telegram 봇 충돌OpenClaw가 같은 봇 토큰 사용Hermes 전용 봇(@miniream_bot) 생성
DNS 해석 실패WSL2 자동 DNS 문제/etc/resolv.conf 수동 설정 (8.8.8.8)
OpenClaw 자동 재시작systemd 서비스 활성화됨서비스 비활성화 + 파일 삭제
nohup 백그라운드 실행 안 됨wsl -d 경유 시 프로세스 분리tmux 세션 안에서 직접 실행
PowerShell && 오류PowerShell이 &&를 파이프라인으로 처리bash 스크립트 파일로 실행

9. 메인컴 vs 보조컴 비교

섹션 제목: “9. 메인컴 vs 보조컴 비교”
항목메인컴 (PS-i14700k)보조컴 (MH-3900x)
Hermes 버전v0.10.0 (최신)v0.10.0 → 미확인
기본 모델glm-5.1:cloud → 맥미니 Ollama 경유미설정
Telegram 봇@miniream_bot ✅미연동
Ollamav0.21.0 ✅ → 맥미니에서 구동미설치
OpenClaw❌ 제거됨운영 중 → ❌ 제거됨
DNS 수동 설정✅ (8.8.8.8)기본

10. 향후 작업

섹션 제목: “10. 향후 작업”
  • WSL 재시작 시 DNS 자동 설정 스크립트 작성
  • 보조컴에도 Ollama + 모델 설정
  • Hermes SOUL.md 편집 (성격/페르소나 설정)
  • 추가 도구 API 키 설정 (Firecrawl, Exa 등)
  • Hermes 자동 시작 스크림트 (WSL 부팅 시)

⚠️ 2026-04-20 업데이트: Ollama는 이제 맥미니에서 구동됨. 메인컴 WSL의 Ollama 서버는 더 이상 기본으로 사용하지 않음. Hermes의 model.base_url을 맥미니 Ollama로 변경 필요.

📝 핵심 교훈:

  1. 같은 Telegram 봇 토큰은 한 곳에서만 사용 가능
  2. WSL2는 DNS가 자주 깨짐 → 수동 설정 필수
  3. 백그라운드 실행은 tmux가 가장 안정적
  4. PowerShell에서 복잡한 명령어는 bash 스크립트로 작성해서 실행

[!note] 수정이력 | 2026-04-20 11:01, 미미