메인컴 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. 설치 전 환경”| 항목 | 상태 |
|---|---|
| OS | Ubuntu 24.04.4 LTS (WSL2) |
| Python | 3.12.3 (Hermes는 uv로 3.11.15 자동 설치) |
| Node.js | v22.22.2 |
| Git | 2.43.0 |
| curl | 8.5.0 |
| Ollama | v0.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 업데이트”hermes update결과:
- 7 commits behind → 최신으로 업데이트 완료
- Python 의존성 업데이트
- Node.js 의존성 업데이트 (repo root, ui-tui)
- Web UI 빌드
- 스킬 동기화
2.3 서브모듈 복구
섹션 제목: “2.3 서브모듈 복구”cd ~/.hermes/hermes-agentgit submodule update --init --recursive→ tinker-atropos 서브모듈 복구됨
3. 모델 설정
섹션 제목: “3. 모델 설정”3.1 GLM-5.1 Cloud 설치
섹션 제목: “3.1 GLM-5.1 Cloud 설치”ollama pull glm-5.1:cloud3.2 Hermes 기본 모델 설정
섹션 제목: “3.2 Hermes 기본 모델 설정”hermes config set model.default glm-5.1:cloudhermes config set model.provider customhermes config set model.base_url http://127.0.0.1:11434/v1config.yaml 결과:
model: default: glm-5.1:cloud provider: custom base_url: http://127.0.0.1:11434/v13.3 메인컴 Ollama 모델 목록
섹션 제목: “3.3 메인컴 Ollama 모델 목록”| 모델 | 크기 | 비고 |
|---|---|---|
| qwen36-35b-q4ks | 20GB | 로컬 양자화 |
| qwen3.5:cloud | - | Cloud 모델 |
| gemma4:e2b | 7.2GB | 로컬 엣지 모델 |
| gemma4:26b-a4b-q4 | 16GB | 로컬 MoE |
| qwen3.6-35b-ud-q4 | 20GB | 로컬 양자화 |
| 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 설정 명령어”hermes config set TELEGRAM_BOT_TOKEN 8723523208:AAGXYzq4bXMlasExTQX2v-GtY5aieesnGfchermes config set TELEGRAM_ALLOWED_USERS 87883787134.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 해결”# WSL2 자동 DNS 비활성화sudo tee /etc/wsl.conf > /dev/null <<EOF[network]generateResolvConf = falseEOF
# 수동 DNS 설정sudo rm -f /etc/resolv.confsudo tee /etc/resolv.conf > /dev/null <<EOFnameserver 8.8.8.8nameserver 1.1.1.1EOF⚠️
wsl --shutdown후 재시작하면 resolv.conf가 다시 날아갈 수 있음
매번 WSL 시작 후 DNS 재설정 필요할 수 있음
6. OpenClaw 제거 (메인컴 WSL)
섹션 제목: “6. OpenClaw 제거 (메인컴 WSL)”메인컴 WSL의 OpenClaw가 Telegram 봇 충돌 원인이어서 완전 제거함
# 서비스 중지 + 비활성화systemctl --user stop openclaw-gatewaysystemctl --user disable openclaw-gatewaysystemctl --user stop openclaw-node 2>/dev/nullsystemctl --user disable openclaw-node 2>/dev/null
# 서비스 파일 삭제rm -f ~/.config/systemd/user/openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-node.servicesystemctl --user daemon-reload
# 프로세스 강제 종료pkill -9 -f openclaw💡 메인컴 WSL에서 OpenClaw는 더 이상 사용하지 않음
OpenClaw 게이트웨이는 맥미니에서만 운영
7. 게이트웨이 실행
섹션 제목: “7. 게이트웨이 실행”7.1 실행 방법 (tmux 사용)
섹션 제목: “7.1 실행 방법 (tmux 사용)”# tmux 세션 생성tmux new -s hermes
# 세션 안에서export PATH="$HOME/.local/bin:$PATH"hermes gateway run✅ tmux 안에서 실행하면 SSH가 끊겨도 유지됨
✅ WSL 창을 띄워두면 게이트웨이가 계속 실행됨
7.2 게이트웨이 재접속
섹션 제목: “7.2 게이트웨이 재접속”tmux attach -t hermes7.3 게이트웨이 로그 확인
섹션 제목: “7.3 게이트웨이 로그 확인”cat ~/.hermes/logs/errors.log8. 겪은 문제 & 해결 요약
섹션 제목: “8. 겪은 문제 & 해결 요약”| 문제 | 원인 | 해결 |
|---|---|---|
| WSL SSH 접속 안 됨 | WSL이 꺼져있음 | Windows에서 wsl 실행 |
| hermes: command not found | PATH에 ~/.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 | 미설정 |
| Telegram 봇 | @miniream_bot ✅ | 미연동 |
| Ollama | v0.21.0 ✅ | 미설치 |
| OpenClaw | ❌ 제거됨 | 운영 중 |
| DNS 수동 설정 | ✅ (8.8.8.8) | 기본 |
10. 향후 작업
섹션 제목: “10. 향후 작업”- WSL 재시작 시 DNS 자동 설정 스크립트 작성
- 보조컴에도 Ollama + 모델 설정
- Hermes SOUL.md 편집 (성격/페르소나 설정)
- 추가 도구 API 키 설정 (Firecrawl, Exa 등)
- Hermes 자동 시작 스크립트 (WSL 부팅 시)
📝 핵심 교훈:
- 같은 Telegram 봇 토큰은 한 곳에서만 사용 가능
- WSL2는 DNS가 자주 깨짐 → 수동 설정 필수
- 백그라운드 실행은 tmux가 가장 안정적
- PowerShell에서 복잡한 명령어는 bash 스크립트로 작성해서 실행