헤르메스 에이전트(Hermes Agent)를 처음 보면 “또 하나의 AI 챗봇인가?”라고 생각하기 쉽습니다. 하지만 공식 문서 기준으로 Hermes Agent는 단순 대화창보다 더 넓은 층의 도구입니다.
터미널에서 대화하고, 필요한 도구를 호출하고, 경험을 skill과 memory로 쌓아 가며, Gateway를 통해 Telegram 같은 메신저에서도 사용할 수 있는 개인 AI 에이전트 런타임에 가깝습니다.
설치법보다 먼저, 구조를 이해해야 하는 이유
Hermes Agent는 설치 명령어만 따라 한다고 끝나는 도구가 아닙니다. 어떤 provider/model을 쓸지, Gateway를 어디까지 열지, 누가 bot에 접근할 수 있는지, 어떤 명령을 승인할지까지 사용자가 직접 책임져야 합니다.
그래서 설치 전에 “Hermes가 어떤 층의 도구인지”를 먼저 잡아야 합니다. 이 글은 설치 튜토리얼이 아니라, 설치 전에 읽는 개념 지도입니다.
Hermes는 웹 대화창 하나가 아니라 CLI/TUI, provider/model, skills/memory, tools/runtime, Gateway/security를 함께 다룹니다.
메신저에서 부를 수 있고 도구를 실행할 수 있는 만큼, 접근 권한과 실행 경계를 함께 설계해야 합니다.
개념이 잡히면 기존 Hermes Agent 설치 절차에서 실제 설정 흐름으로 넘어가면 됩니다.
일반 챗봇과 Hermes Agent의 차이
일반 챗봇은 보통 제공자가 만든 웹사이트나 앱에서 질문을 입력하고 답변을 받는 구조입니다. 사용자는 모델과 UI를 빌려 쓰고, 실행 환경과 도구 권한은 대부분 제공자 쪽에 있습니다.
Hermes Agent는 다릅니다. 사용자는 로컬 컴퓨터, WSL2, 서버, VPS 같은 환경에 Hermes를 설치하고, 어떤 provider/model을 쓸지 정하고, 어떤 도구와 Gateway를 연결할지 직접 구성합니다.
웹/앱 안에서 질문하고 답변을 받는 경험이 중심입니다.
터미널, 모델 provider, skill/memory, 도구 실행, Gateway 연결을 사용자가 운영합니다.
Hermes는 더 유연하지만, 그만큼 설정·보안·비용·실행 환경을 직접 이해해야 합니다.
Hermes Agent의 5층 구조
Hermes Agent는 다섯 층으로 나누어 보면 훨씬 이해하기 쉽습니다.

기본 출발점은 hermes CLI와 hermes --tui TUI입니다. Telegram을 붙이기 전, 로컬 실행을 먼저 확인하는 이유입니다.
Hermes 자체가 하나의 모델은 아닙니다. Nous Portal, OpenRouter, OpenAI Codex, Anthropic, DeepSeek, GitHub Copilot, custom endpoint 등 선택한 provider/model 위에서 움직입니다.
반복 작업과 과거 맥락을 skill과 memory로 남겨 다음 세션의 출발점을 개선하도록 설계되어 있습니다.
설정과 권한에 따라 command, terminal backend, container, MCP, 파일/환경 접근 같은 실행 능력을 가질 수 있습니다.
Messaging Gateway를 통해 Telegram/Discord/Slack 같은 채널로 확장할 수 있고, allowlist/pairing/command approval이 중요해집니다.
self-improving agent를 과장 없이 이해하기
Hermes Agent에서 가장 눈에 띄는 표현은 self-improving입니다. 이 말은 AI가 마법처럼 혼자 완벽해진다는 뜻이 아닙니다.
더 정확히는 반복 작업에서 얻은 경험을 skill과 memory로 남기고, 과거 대화와 절차를 다시 참고해 다음 작업의 맥락을 개선하는 구조입니다.

왜 CLI/TUI 첫 대화가 먼저인가요?
Hermes Agent를 설치한 뒤 바로 Telegram Gateway부터 붙이면 문제가 생겼을 때 원인을 나누기 어렵습니다. 답변이 안 오는 이유가 provider 인증 문제인지, 모델 선택 문제인지, Gateway 실행 문제인지, token/allowlist 문제인지 섞이기 때문입니다.
그래서 기본 원칙은 단순합니다. 먼저 CLI/TUI에서 Hermes가 정상 답변하는지 확인하고, 그다음 Gateway, Telegram, cron, skills, routing 같은 확장을 붙입니다.
Provider와 model은 Hermes의 엔진입니다
Hermes를 설치했다고 곧바로 답변 품질이 정해지는 것은 아닙니다. 어떤 provider와 model을 쓰는지가 실제 답변 품질, context 길이, 비용, 속도, 도구 사용 안정성에 큰 영향을 줍니다.
공식 Quickstart 기준으로 provider 선택은 가장 중요한 초기 설정입니다. Hermes는 최소 64K context window를 요구하므로, 작은 context 모델은 시작 단계에서 맞지 않을 수 있습니다.
Messaging Gateway와 Telegram 연동의 의미
Hermes Messaging Gateway는 Hermes를 메신저와 연결해 주는 통로입니다. Telegram을 예로 들면 BotFather에서 bot token을 만들고, 숫자 Telegram user ID를 확인하고, Gateway 설정에서 allowlist나 pairing을 잡는 흐름이 필요합니다.
이 구조 덕분에 Hermes를 터미널 앞에 앉아 있을 때만 쓰는 도구가 아니라, 내가 쓰는 채팅앱에서 부를 수 있는 개인 에이전트로 확장할 수 있습니다.
보안 구조: 누가 말하고, 무엇을 실행할 수 있나
Hermes 공식 문서는 defense-in-depth 구조를 설명합니다. 대표적으로 allowlist와 DM pairing, 위험 명령 승인, hardline blocklist, container isolation, MCP credential filtering, context file scanning, cross-session isolation 같은 장치가 있습니다.
Telegram이라면 username이 아니라 숫자 user ID 기준으로 allowlist를 잡거나 DM pairing을 사용해야 합니다.
위험한 명령은 승인 없이 실행되지 않도록 두는 것이 안전합니다. off 모드는 신뢰된 환경에서만 조심스럽게 다뤄야 합니다.
Docker, SSH, Modal, Daytona, Vercel Sandbox, Singularity 같은 backend는 각기 다른 격리 방식과 운영 조건을 가집니다.
OpenClaw와 Hermes Agent는 어떤 관계인가요?
OpenClaw를 이미 봤다면 Hermes Agent가 낯설지 않을 수 있습니다. 둘 다 개인 AI assistant, Gateway, messaging, tool-enabled agent라는 흐름과 연결됩니다.
하지만 Hermes Agent는 OpenClaw의 단순한 이름 변경판이 아닙니다. Hermes는 ~/.hermes를 중심으로 별도 설정과 명령어 체계를 가지며, provider/model 설정, CLI/TUI, learning loop, skills/memory, Messaging Gateway를 Hermes 방식으로 묶습니다.

공식 자료 기준으로 Hermes는 OpenClaw migration을 제공합니다. 실제 migration은 바로 덮어쓰기보다 hermes claw migrate --dry-run으로 무엇이 옮겨질지 확인한 뒤 진행하는 것이 안전합니다.
Hermes Agent가 잘 맞는 사람
CLI/TUI에서 AI 에이전트를 직접 다루고 싶은 사람에게 잘 맞습니다.
자주 하는 작업을 skill과 memory로 쌓아 가며 일관성을 높이고 싶은 사람에게 적합합니다.
Telegram이나 Discord 같은 채널에서 개인 에이전트를 호출하고 싶은 사람에게 유용합니다.
OpenClaw를 써 봤고 Hermes migration이나 인접 에이전트 구조가 궁금한 사람에게 자연스러운 다음 글입니다.
아직 기다리는 게 좋은 사람
설치, provider 설정, config 확인이 부담스럽다면 일반 챗봇이 더 편할 수 있습니다.
API key, token, allowlist, pairing, command approval을 직접 관리하기 싫다면 신중해야 합니다.
누구나 접근하는 bot을 만들기 전에 격리와 권한 제한 설계가 먼저 필요합니다.
Hermes는 가입 후 바로 쓰는 서비스라기보다 직접 운영하는 agent runtime에 가깝습니다.
다음 단계: 설치 절차와 내부 링크
이 글은 “Hermes Agent가 무엇인가”를 이해하기 위한 글입니다. 실제 설치와 Telegram 연결은 기존 설치 절차 글에서 이어서 보면 됩니다.
설치부터 provider/model 설정, CLI 첫 대화, Telegram Gateway까지 따라가는 실습 글입니다.
바로 보기
개인 AI assistant Gateway 개념을 먼저 넓게 이해하고 싶다면 함께 읽기 좋습니다.
바로 보기
OpenClaw 설치와 Telegram 연결 흐름을 비교하고 싶다면 참고할 수 있습니다.
바로 보기
FAQ
Q1. Hermes Agent는 ChatGPT나 Claude와 뭐가 다른가요?
ChatGPT나 Claude는 보통 제공자가 운영하는 웹/앱 기반 대화 서비스로 쓰입니다. Hermes Agent는 provider/model을 선택해 로컬 또는 서버 환경에서 CLI/TUI, skills/memory, tools/runtime, Gateway를 묶어 쓰는 개인 에이전트 런타임에 가깝습니다.
Q2. self-improving이라는 말은 자동으로 다 알아서 한다는 뜻인가요?
아닙니다. 경험을 skill과 memory로 남기고 과거 맥락을 활용해 반복 작업을 더 일관되게 만드는 구조로 이해하는 편이 안전합니다. 완전 자율 운영이나 무감독 실행을 뜻하지 않습니다.
Q3. Telegram 연동은 꼭 필요한가요?
필수는 아닙니다. Hermes는 CLI/TUI에서 먼저 사용할 수 있습니다. Telegram이나 다른 메신저 연동은 로컬 대화가 안정적으로 된 뒤 외부 채널에서 에이전트를 부르고 싶을 때 붙이는 확장 단계입니다.
Q4. OpenClaw 사용자라면 Hermes로 바로 옮겨도 되나요?
공식 자료 기준으로 migration 기능이 있지만, 바로 덮어쓰기보다 hermes claw migrate --dry-run으로 무엇이 옮겨질지 먼저 확인하는 것이 좋습니다.
Q5. Hermes Agent는 안전한가요?
allowlist, DM pairing, command approval, blocklist, isolation 같은 보안 장치가 있지만 안전성은 설정과 운영 방식에 따라 달라집니다. Gateway를 연결할 때는 누가 말할 수 있는지와 무엇을 실행할 수 있는지를 반드시 제한해야 합니다.
자료 출처
NousResearch/hermes-agent README와 공식 문서의 Installation, Quickstart, Messaging, Telegram, Security, CLI, Configuration, Environment Variables를 기준으로 정리했습니다.
기존 Hermes Agent 설치 절차, OpenClaw 개념 글, OpenClaw 설치 절차와 연결되도록 구성했습니다.