Hermes Agent · Nous Research · MIT

Hermes Agent 실전 운용 매뉴얼

Hermes는 Nous Research가 만든 자가성장형 AI 에이전트다. IDE에 갇힌 코파일럿도, 단일 API 챗봇도 아니고 — 메시징 게이트웨이 하나로 20개 넘는 채널을 받고, 스킬을 스스로 만들며, 크로스세션 메모리로 자란다. 이 문서는 바니가 텔레그램 DM으로 사는 이 데스크탑을 기준으로, 설치부터 세 PC 메시 운용까지 우리 손에 맞게 정리했다.

설치 · 첫 실행 모델 → Opus 4.8 우리 세 PC 워크플로

bani mesh · one bunny

🐰 바니 · 이 데스크탑

Hermes 게이트웨이 + 텔레그램 DM 관제. Claude Code · Codex · Hermes가 한 몸.

Hermes gateway Opus 4.8 Telegram DM

🦋 나비 · 갤럭시북5 · 🦎 후추봇 · 거실 PC

각 PC의 인격이 그 PC의 모든 에이전트 CLI를 관제하는 1 PC = 1 인격 규약.

WSL / Linux Hermes 이식 가능

설치와 첫 실행

한 줄 설치 후 hermes setup 마법사가 모델·도구·게이트웨이를 한 번에 잡아준다. 우리 PC는 전부 WSL/Linux라 셸 설치가 기본이다.

설치 (WSL2 · Linux · macOS)

Windows/macOS는 데스크탑 인스톨러도 있지만, 우리 환경은 WSL2라 셸 한 줄이 가장 깔끔하다. Android(Termux)도 같은 스크립트를 쓴다.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell에서 네이티브로 깔 때는 이쪽을 쓴다.

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

설정 마법사

모델 provider, 도구, 메시징 게이트웨이를 화살표 선택으로 한 번에 잡는다. Nous Portal을 쓰면 OAuth 로그인 한 번으로 300개 넘는 모델 + Tool Gateway가 한 번에 붙는다.

hermes setup # 전체 설정 마법사

hermes setup --portal # Nous Portal 로그인 + provider 지정 원샷

실행 — 대화 · 원샷 · 백그라운드

터미널에서 바로 대화하거나, 스크립트에서 한 방 프롬프트를 던지거나, 게이트웨이를 백그라운드 서비스로 띄운다.

hermes # 대화형 세션 시작

hermes -z "커밋 로그 요약해줘" # 원샷: stdout에 최종 응답만

hermes gateway start # 메시징 게이트웨이를 백그라운드로

점검 · 업데이트

설정이나 의존성이 꼬이면 doctor가 진단해준다. 최신화는 update 한 줄.

hermes doctor # 설정·의존성 진단

hermes update # 최신 코드 pull + 의존성 재설치

핵심 경로. 설정은 ~/.hermes/config.yaml, 비밀 값은 ~/.hermes/.env, 페르소나는 ~/.hermes/SOUL.md, 크론은 ~/.hermes/cron/에 산다. 우리 바니의 페르소나·기억도 이미 이 아래에 있다.

모델 설정 — Opus 4.8로

Hermes는 provider를 코드 수정 없이 갈아끼운다. 이번에 바니의 메인 모델을 Claude Opus 4.8로 올린다. Claude Code로 이 페이지를 만드는 지금도 opus 계열로 돌고 있다.

대화형으로 고르기

provider와 모델을 화살표로 고르는 피커가 뜨고, 선택은 ~/.hermes/config.yaml에 기록된다. 가장 쉬운 길.

hermes model # provider · model 선택 → config.yaml 기록

config.yaml 직접 — Anthropic 네이티브

Anthropic 키를 직접 쓰면 provider를 anthropic으로 두고 모델 ID는 Anthropic API 표기(claude-opus-4-8)를 넣는다. 키는 ~/.hermes/.env의 ANTHROPIC_API_KEY로.

model:
  provider: anthropic
  default: claude-opus-4-8
  base_url: ''
  api_mode: chat_completions

config.yaml 직접 — OpenRouter / Portal 경유

여러 모델을 오가려면 OpenRouter나 Nous Portal이 편하다. 이때 모델 슬러그는 프로바이더 표기(anthropic/claude-opus-4.8)를 따른다.

model:
  provider: openrouter
  default: anthropic/claude-opus-4.8
  base_url: ''
  api_mode: chat_completions

세션 안에서 즉시 전환

텔레그램/Discord/CLI 대화 도중 /model로 바꾼다. --global을 붙이면 config.yaml까지 영구 반영된다. 전환은 즉시 적용되고, 컨텍스트 압축은 다음 메시지에서 돈다.

/model claude-opus-4-8 --provider anthropic --global

hermes portal status # Portal 인증 · Tool Gateway 라우팅 확인

모델 ID 표기 주의. Anthropic 네이티브 API는 하이픈 표기 claude-opus-4-8, OpenRouter/Portal 슬러그는 점 표기 anthropic/claude-opus-4.8를 쓴다. 같은 Opus 4.8이라도 provider에 맞는 표기를 넣어야 한다.

텔레그램 게이트웨이 — Home DM

바니가 사는 방식이 바로 이거다. @BotFather로 봇을 만들고, 허용 유저 ID를 내 것만 넣으면 나와의 1:1 DM 전용으로 잠긴다. 게이트웨이 하나가 Telegram·Discord·Slack을 동시에 받는다.

@BotFather에서 봇 토큰 발급

텔레그램에서 @BotFather에게 /newbot → 표시 이름 → bot으로 끝나는 유저네임을 정하면 123456789:ABC... 형식 토큰을 준다.

/newbot # @BotFather에게 전송 → API 토큰 수령

내 숫자 유저 ID 확인

유저네임 말고 숫자 ID가 필요하다. @userinfobot에게 아무 메시지나 보내면 알려준다. 개인 DM chat ID는 이 유저 ID와 같다.

토큰 · 허용 유저 설정

마법사가 가장 쉽다. Telegram을 고르고 토큰과 허용 유저 ID를 붙여넣으면 설정이 자동 생성된다.

hermes gateway setup # Telegram 선택 → 토큰 · 허용 유저 입력

수동으로는 ~/.hermes/.env에 직접 넣는다. (config.yaml의 대응 키는 platforms.telegram.extra)

TELEGRAM_BOT_TOKEN=123456789:ABCdef...
TELEGRAM_ALLOWED_USERS=내_숫자_유저ID

게이트웨이 기동 · 여러 프로필

기본 프로필은 hermes gateway로 뜬다. 바니·나비·후추봇처럼 격리된 인스턴스를 나눌 땐 -p 프로필을 붙인다.

hermes gateway start
hermes gateway status
hermes gateway stop

hermes -p bani gateway start # 'bani' 프로필로 기동

토큰은 비밀. 봇 토큰을 쥔 사람은 봇을 조종할 수 있다. 절대 커밋·공유하지 말고, 새면 @BotFather의 /revoke로 즉시 폐기한다. ~/.hermes/.env는 항상 .gitignore 안쪽에 둔다.

스킬 · 메모리 · 세션 검색

Hermes가 "자란다"는 말의 실체. 스킬은 스스로 만들고 개선하며, 메모리는 세션을 넘어 쌓이고, 지난 대화는 전문 검색으로 되짚는다.

Skills

스킬 — 절차 기억

반복 작업을 스킬로 캡슐화한다. Hermes는 경험에서 스킬을 자동 생성하고 쓰면서 스스로 개선한다. agentskills.io 오픈 스탠다드라 다른 에이전트와 공유·이식이 된다.

브라우즈·설치·발행·감사: hermes skills / 대화 중엔 /skills, /skill <이름>, /reload-skills.

Memory

메모리 — 세션을 넘어

에이전트가 스스로 큐레이션하는 지속 메모리에 주기적 넛지가 붙는다. FTS5 크로스세션 리콜 + LLM 요약, 그리고 Honcho 기반 사용자 모델링까지.

외부 메모리 프로바이더 설정은 hermes memory.

Session search

세션 검색 — 지난 대화 되짚기

지난 세션을 FTS5 전문 검색으로 찾고 LLM이 요약해준다. "저번에 이 얘기 했잖아"를 실제로 되짚을 수 있는 근거. session_search 도구가 이 일을 한다.

이게 하나의 바니가 성립하는 기술적 바탕 중 하나다.

SOUL.md = 페르소나. 바니의 말투·정체성·경계는 ~/.hermes/SOUL.md에 산다. 프로젝트별 컨텍스트 파일로 특정 작업에서의 결도 따로 잡을 수 있다. 우리 ~/.claude/rules/의 페르소나 규약과 같은 결이다.

크론 · 도구 · MCP

예약 실행으로 아침 매거진 같은 루틴을 자동화하고, 60개 넘는 빌트인 도구에 MCP 서버를 얹어 확장한다.

크론 — 예약과 채널 배달

대화 중 /cron으로 바로 걸거나 CLI hermes cron으로 관리한다. 결과는 deliver:로 원하는 채널(텔레그램 등)에 자동 배달된다.

/cron add 30m "빌드 확인 리마인드"
/cron add "every 2h" "서버 상태 점검"
/cron add "every 1h" "새 피드 요약" --skill blogwatcher

hermes cron create "0 9 * * *" "아침 매거진 큐레이션"
hermes cron list
hermes cron pause <job>   /   resume   /   run   /   remove

스케줄 표기: 30m · every 2h · 크론식 0 9 * * 1-5 · ISO 2026-07-10T09:00:00. 잡은 ~/.hermes/cron/jobs.json, 출력은 ~/.hermes/cron/output/에 남는다.

도구 · 툴셋

플랫폼별로 어떤 도구를 켤지 고른다. 60개 넘는 빌트인 도구가 기본 탑재.

hermes tools # 켜진 도구 구성 / 대화 중엔 /tools · /toolsets

MCP — 외부 서버 연결

MCP 서버를 붙이면 도구가 무한 확장된다. Hermes 자신을 MCP 서버로 노출하는 것도 가능해서 다른 에이전트가 바니를 도구처럼 호출할 수 있다.

hermes mcp # MCP 서버 관리 / 대화 중 갱신은 /reload-mcp

OpenClaw → Hermes, 무엇이 좋아졌나

바니는 2026-07-04에 OpenClaw에서 Hermes로 이사했다. 구 OpenClaw 데이터는 ~/.openclaw에 보관 중(승인 전 삭제 금지). 왜 옮겼는지, 그리고 Hermes가 구조적으로 무엇을 더 주는지.

항목	OpenClaw	Hermes Agent
정체성 · 유지보수	로컬 브릿지 중심의 구세대 구성. 우리 쪽에선 보관 단계로 내려감.	Nous Research 현역 프로젝트, MIT 라이선스, 2026 활발한 업데이트.
배포 · 운영	에이전트 호스트 등록 · 하트비트 · 세션 관리가 로컬 프로세스에 깊게 묶여 있었다.	`hermes gateway` 백그라운드 서비스 + 다중 프로필. VPS·GPU·서버리스(Modal 등)까지 배포 백엔드 선택.
메시징 채널	제한적.	단일 게이트웨이로 Telegram · Discord · Slack · WhatsApp · Signal · Matrix · Email · SMS 등 20+.
모델	구성 갈아끼우기가 무거움.	`hermes model` · `/model`로 즉시 전환. Portal(300+)·OpenRouter·OpenAI·커스텀 엔드포인트.
메모리	세션 경계 넘기가 약함.	FTS5 크로스세션 리콜 + LLM 요약 + 자율 큐레이션 + Honcho 사용자 모델링.
스킬	수동 확장 위주.	자율 생성 · 사용 중 자기개선, agentskills.io 오픈 스탠다드로 공유.
자동화 · 확장	별도 설계 필요.	빌트인 크론(멀티채널 배달) + 60+ 도구 + MCP 서버 양방향.
이주 경로	—	`hermes claw migrate` 한 줄로 OpenClaw 설정을 원샷 임포트.

이주는 한 줄. OpenClaw에서 넘어올 땐 아래 한 줄이면 기존 설정이 Hermes로 들어온다. 우리는 이미 넘어왔지만, 나비·후추봇 PC를 Hermes로 세울 때 그대로 쓴다.

hermes claw migrate # OpenClaw 설정 원샷 임포트

우리 세 PC를 위한 운용 워크플로

바니(이 데스크탑) · 나비(갤럭시북5 🦋) · 후추봇(거실 PC 🦎). 세 PC 공통 규약은 1 PC = 1 인격이 그 PC의 모든 에이전트 CLI를 관제. Hermes는 그 인격의 텔레그램 창구가 된다.

🐰 바니

이 데스크탑 = 관제탑

Hermes 게이트웨이가 텔레그램 DM을 받고, 이 PC의 Claude Code·Codex와 한 몸으로 움직인다. 메인 모델은 Opus 4.8.

프로젝트는 /mnt/e/Workspace/Projects, 전달용 산출물은 /mnt/e/Workspace/Temp.

🦋 나비 · 🦎 후추봇

원격 두 노드

갤럭시북5와 거실 PC. 전부 WSL/Linux + Tailscale SSH라 ssh bani / navi / huchu로 오간다. 각 PC에 Hermes 프로필을 세우면 세 인격이 각자의 텔레그램 창구를 갖는다.

Syncthing

공유 폴더 = 핸드오프

세 PC는 Syncthing shared 폴더로 묶여 있다. 핸드오프 md를 shared/handoff/에 떨어뜨리면 다른 인격이 이어받는다. Hermes 크론 결과물도 이리로 흘려보낼 수 있다.

어디서든 텔레그램으로 바니 호출

외출 중에도 텔레그램 DM 한 줄이면 이 데스크탑의 바니가 받아서 프로젝트를 만진다. 게이트웨이는 hermes gateway start로 상시 대기.

모델 전환이 필요하면 그 자리에서 /model claude-opus-4-8 --provider anthropic --global.

무거운 루틴은 크론에 얹고 텔레그램으로 배달

아침 매거진, 피드 요약, 백업 점검 같은 반복 작업은 크론으로 예약하고 결과를 DM으로 받는다.

hermes cron create "0 8 * * *" "오늘 매거진 큐레이션" --skill magazine

반복 절차는 스킬로, 기억은 메모리로

자주 하는 작업 흐름을 스킬로 캡슐화하면 세 PC가 공유할 수 있다(agentskills.io 오픈 스탠다드). 세션 검색·메모리 덕에 "저번에 한 얘기"를 다른 몸에서도 되짚는다.

PC 간 인계는 Syncthing shared로

나비/후추봇에 넘길 일은 핸드오프 md로 shared/에 남기고, 급하면 ssh navi·ssh huchu로 직접 들어가 처리한다. 각 PC의 Hermes 프로필이 그쪽 인격의 텔레그램 창구가 된다.

이 데스크탑에 hermes gateway start 상시 대기 확인 메인 모델 claude-opus-4-8로 설정(hermes model 또는 config.yaml) 텔레그램 허용 유저를 내 ID 하나만으로 잠갔는지(DM 전용) ~/.hermes/.env가 .gitignore 안쪽인지(토큰 유출 방지) 아침 루틴 크론에 deliver: telegram 붙였는지 나비/후추봇 이식은 hermes claw migrate + -p 프로필로

출처와 확인 기준

명령어·경로는 변할 수 있어 Hermes Agent 공식 문서를 우선했다. 비밀 값(봇 토큰·API 키)은 이 문서 어디에도 담지 않았다.

Hermes Agent 공식 문서 https://hermes-agent.nousresearch.com/docs

Quickstart https://hermes-agent.nousresearch.com/docs/getting-started/quickstart

Configuring Models https://hermes-agent.nousresearch.com/docs/user-guide/configuring-models

Telegram https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram

Scheduled Tasks (Cron) https://hermes-agent.nousresearch.com/docs/user-guide/features/cron

CLI Commands Reference https://hermes-agent.nousresearch.com/docs/reference/cli-commands

GitHub · NousResearch/hermes-agent https://github.com/NousResearch/hermes-agent

설치와 첫 실행

설치 (WSL2 · Linux · macOS)

설정 마법사

실행 — 대화 · 원샷 · 백그라운드

점검 · 업데이트

모델 설정 — Opus 4.8로

대화형으로 고르기

config.yaml 직접 — Anthropic 네이티브

config.yaml 직접 — OpenRouter / Portal 경유

세션 안에서 즉시 전환

텔레그램 게이트웨이 — Home DM

@BotFather에서 봇 토큰 발급

내 숫자 유저 ID 확인

토큰 · 허용 유저 설정

게이트웨이 기동 · 여러 프로필

스킬 · 메모리 · 세션 검색

스킬 — 절차 기억

메모리 — 세션을 넘어

세션 검색 — 지난 대화 되짚기

크론 · 도구 · MCP

크론 — 예약과 채널 배달

도구 · 툴셋

MCP — 외부 서버 연결

OpenClaw → Hermes, 무엇이 좋아졌나

우리 세 PC를 위한 운용 워크플로

이 데스크탑 = 관제탑

원격 두 노드

공유 폴더 = 핸드오프

추천 워크플로 — Telegram Home DM 중심

어디서든 텔레그램으로 바니 호출

무거운 루틴은 크론에 얹고 텔레그램으로 배달

반복 절차는 스킬로, 기억은 메모리로

PC 간 인계는 Syncthing shared로

출처와 확인 기준