목차

1. 이게 대체 뭔가 — 3분 요약
2. 전체 구조를 그림으로 이해하기
3. Hermes Agent 완전 해부
4. OpenClaw 완전 해부
5. Hermes vs OpenClaw — 상세 비교표
6. 왜 Docker인가 — "격리"를 모르면 다 털린다
7. 준비물 체크리스트
8. STEP 1 — 24시간 켜둘 컴퓨터 준비하기
9. STEP 2 — Docker 설치하기 (스크린샷 수준 상세)
10. STEP 3 — Node.js 설치하기
11. STEP 4 — WSL2 설치하기 (Windows 사용자만)
12. STEP 5 — Hermes Agent 설치하기
13. STEP 6 — AI 모델 연결하기 (두뇌 장착)
14. STEP 7 — 텔레그램 봇 만들기
15. STEP 8 — 텔레그램 ↔ Hermes 연결하기
16. STEP 9 — 보안 설정 (절대 건너뛰지 마세요)
17. STEP 10 — 접속 테스트 & 첫 원격 개발
18. 실전 운영 — 고급 활용법
19. 전력 소모·비용 분석
20. 트러블슈팅 — 안 될 때 이것부터
21. 자주 묻는 질문 15선

---

1. 이게 대체 뭔가 — 3분 요약

1-1. 한 줄 요약

집에 컴퓨터 하나 켜두면, 밖에서 휴대폰 텔레그램으로 AI에게 코딩을 시킬 수 있습니다.

카페에서든, 공원에서든, 아이 어린이집 앞에서든 — 주머니에서 폰을 꺼내고 텔레그램에 채팅을 칩니다. "메인 페이지에 다크모드 토글 추가해줘." AI가 집 컴퓨터에서 코드를 작성하고, 파일을 저장하고, 빌드를 돌리고, 결과 스크린샷까지 찍어서 텔레그램으로 보내줍니다.

이걸 가능하게 하는 오픈소스 프로그램이 두 개 있습니다. Hermes Agent(에르메스)와 OpenClaw(오픈클로)입니다.

1-2. 이걸 왜 써야 하나

일반적인 AI 챗봇(ChatGPT, Claude 등)은 "대화"만 합니다. 코드를 제안해 줄 수는 있지만, 직접 파일을 만들거나, 터미널 명령을 실행하거나, 빌드를 돌리지는 못합니다. 결국 사람이 코드를 복사해서 붙여넣고, 직접 실행해야 합니다.

Hermes Agent와 OpenClaw는 다릅니다. AI가 컴퓨터의 터미널에 직접 접근합니다. 파일을 읽고 쓰고, 명령어를 실행하고, 웹 브라우저를 조작하고, Git 커밋까지 합니다. 그리고 이 모든 것을 텔레그램 채팅 한 줄로 지시할 수 있습니다. 노트북을 들고 다닐 필요가 없습니다.

1-3. 얼마나 어렵나

이 글의 원작자도 "저도 오늘 처음 했습니다"라고 말합니다. Docker 설치는 다운로드 → 클릭 → 다음 수준이고, Hermes Agent 설치는 터미널에 명령어 한 줄입니다. 막히면 지금 쓰고 있는 이 AI에게 물어보면 됩니다. 유튜브에 단계별 영상도 수십 개 있습니다.

전체 소요 시간: 익숙하면 30분, 완전 처음이어도 1~2시간이면 충분합니다.

---

2. 전체 구조를 그림으로 이해하기

2-1. 데이터 흐름

전체 시스템은 세 구간으로 나뉩니다.

첫째, 당신의 휴대폰(텔레그램). 밖에서 텔레그램 앱을 열고 봇에게 메시지를 보냅니다. "로그인 페이지 CSS 수정해줘."

둘째, 텔레그램 서버. 텔레그램 클라우드가 메시지를 중계합니다. 당신의 메시지가 봇 토큰에 연결된 서버로 전달됩니다.

셋째, 집 컴퓨터(Hermes Agent + Docker). 집에 24시간 켜둔 컴퓨터에서 Hermes Agent의 게이트웨이 프로세스가 텔레그램 메시지를 수신합니다. 에이전트가 메시지를 읽고, AI 모델(GPT, Claude, Kimi 등)에 전달하여 응답을 생성하고, 필요하면 Docker 컨테이너 안에서 터미널 명령을 실행합니다. 결과를 다시 텔레그램으로 보냅니다.

2-2. 핵심 포인트 — 모든 작업은 Docker 안에서

AI가 실행하는 모든 명령은 Docker 컨테이너라는 격리된 가상 환경 안에서만 동작합니다. 컨테이너 밖의 시스템(당신의 사진, 문서, 비밀번호 등)에는 물리적으로 접근할 수 없습니다. 당신이 허락한 특정 폴더(예: D:\Shared)만 컨테이너 안에서 보입니다. 이것이 안전의 핵심입니다.

2-3. AI 모델은 어디에 있나

중요한 포인트입니다. Hermes Agent는 AI 모델 자체가 아닙니다. "AI에게 컴퓨터를 제어할 수 있는 손발을 달아주는 프레임워크"입니다. 실제 두뇌 역할은 외부 AI 모델(GPT, Claude, Kimi K2.5 등)이 합니다. 따라서 집 컴퓨터에 강력한 GPU가 필요하지 않습니다 — AI 추론은 클라우드에서 일어나고, 집 컴퓨터는 그 지시를 받아 명령만 실행합니다.

---

3. Hermes Agent 완전 해부

3-1. 정체

Hermes Agent는 Nous Research가 2026년 2월 25일에 공개한 오픈소스(MIT 라이선스) 자기 개선형 AI 에이전트입니다. 공개 8주 만에 GitHub 스타 10만 개를 돌파하며, 역대 오픈소스 프로젝트 중 가장 빠른 성장 속도를 기록하고 있습니다.

공식 태그라인: *"The agent that grows with you — 당신과 함께 성장하는 에이전트."*

3-2. Nous Research란

Hermes, Nomos, Psyche 등 유명 오픈소스 LLM을 훈련하는 미국 AI 연구소입니다. AI 모델을 직접 만드는 팀이 에이전트도 만들었다는 점이 특별합니다. 연구용(강화학습 데이터 수집)과 실전 운영용(코딩, 자동화)을 동시에 만족하도록 설계되었습니다.

3-3. 무엇이 특별한가 — 6대 핵심 기능

[기능 1] 자기 개선 학습 루프. 이것이 Hermes Agent의 가장 강력한 차별점입니다. 에이전트가 복잡한 작업(도구를 5번 이상 호출하는 작업)을 성공적으로 완료하면, 그 과정을 SKILL.md라는 문서로 자동 저장합니다. "Django 프로젝트에 JWT 인증 추가하기"를 한 번 성공하면, 다음에 비슷한 요청을 받았을 때 SKILL.md를 로드하여 시행착오 없이 바로 실행합니다. 더 중요한 건, 스킬을 사용하다 더 나은 방법을 발견하면 스킬 자체를 자동 업데이트한다는 것입니다. 시간이 갈수록 에이전트가 더 유능해집니다.

[기능 2] 영속 메모리. 일반 AI 챗봇은 대화가 끝나면 모든 것을 잊어버립니다. Hermes Agent는 두 개의 메모리 파일을 유지합니다. MEMORY.md(2,200자)에는 환경 사실, 도구 특성, 배운 교훈을 저장합니다. 예: "이 서버는 Ubuntu 22.04, Docker와 Podman 설치됨." USER.md(1,375자)에는 사용자 선호와 소통 스타일을 저장합니다. 예: "TypeScript를 JavaScript보다 선호, 간결한 응답 선호." 매 세션 시작 시 이 파일들이 자동으로 시스템 프롬프트에 주입됩니다. 또한 과거 모든 대화를 FTS5 전문 검색으로 찾을 수 있어, "지난주에 그 API 어떻게 설정했었지?"에 답할 수 있습니다.

[기능 3] 15+ 플랫폼 게이트웨이. Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, SMS, Home Assistant 등 15개 이상의 메시징 플랫폼에서 대화할 수 있습니다. 하나의 hermes gateway 프로세스가 모든 플랫폼을 동시에 관리합니다. CLI에서 시작한 작업을 Telegram에서 확인하고 Discord에서 이어갈 수 있습니다 — 세션이 플랫폼이 아니라 사용자에게 연결되기 때문입니다.

[기능 4] 6개 터미널 백엔드. 로컬, Docker, SSH, Daytona, Singularity, Modal — 6가지 방식으로 명령을 실행할 수 있습니다. Docker는 보안 격리, SSH는 원격 서버, Daytona와 Modal은 서버리스(유휴 시 환경이 동면하여 비용 0에 가까움). $5 VPS에서도, GPU 클러스터에서도 돌릴 수 있습니다.

[기능 5] 7계층 보안 모델. (1) 사용자 인증(허용 목록 + DM 페어링), (2) 위험 명령 승인(rm -rf, DROP TABLE 등 30+ 패턴 감지), (3) 컨테이너 격리(capabilities 드롭, 권한 상승 차단, PID 256 제한), (4) MCP 자격증명 필터링, (5) 컨텍스트 파일 프롬프트 인젝션 스캐닝, (6) 크로스 세션 격리, (7) 입력 새니타이제이션 및 SSRF 방어.

[기능 6] 200+ 모델 자유 선택. OpenRouter(200+ 모델), Nous Portal, OpenAI, Anthropic, NVIDIA NIM, Kimi/Moonshot, Hugging Face, Ollama(로컬) 등 어떤 모델이든 사용할 수 있습니다. hermes model 명령 하나로 전환하며, 코드 변경이 불필요합니다. 최소 요구 컨텍스트는 64K 토큰입니다.

3-4. 스킬 시스템 상세

스킬은 ~/.hermes/skills/ 디렉토리에 SKILL.md 파일로 저장됩니다. 각 스킬은 "언제 사용할지(When to Use)", "절차(Procedure)", "함정(Pitfalls)", "검증(Verification)" 섹션으로 구성됩니다. 토큰 효율을 위해 3단계로 점진 로드됩니다 — Level 0(이름·설명 목록, ~3K 토큰)에서 시작하여, 실제 필요할 때만 전체 내용을 로드합니다. 수십 개의 스킬이 있어도 기본 비용은 ~3K 토큰뿐입니다.

Skills Hub(agentskills.io)에서 커뮤니티 스킬을 검색·설치할 수 있고, hermes skills search kubernetes처럼 CLI에서 바로 검색할 수 있습니다. 모든 설치된 스킬은 자동으로 슬래시 명령이 됩니다: /plan, /github-pr-workflow 등.

3-5. 프로파일 시스템

hermes -p coder, hermes -p researcher처럼 용도별로 완전히 독립된 환경(설정, 메모리, 세션, 게이트웨이 PID)을 가집니다. 코딩 전용 에이전트와 리서치 전용 에이전트를 분리 운영할 수 있습니다. 텔레그램 봇도 각각 별도로 만들어 연결하면, 채팅방별로 다른 AI와 대화할 수 있습니다.

---

4. OpenClaw 완전 해부

4-1. 정체

OpenClaw는 Peter Steinberger와 커뮤니티가 만든 개인용 AI 어시스턴트 오픈소스(MIT 라이선스) 프로젝트입니다. 원래 Moltbot → Clawdbot이라는 이름이었고, 2026년 1월 OpenClaw로 리브랜딩 후 72시간 만에 6만 스타, 현재 GitHub 스타 29만 5천 개 이상으로 React와 Linux를 넘어선 역대급 오픈소스 프로젝트입니다.

공식 태그라인: *"The AI that actually does things — 실제로 일을 하는 AI."*

4-2. 핵심 철학 — 게이트웨이 중심

OpenClaw의 핵심은 중앙 게이트웨이 컨트롤러입니다. 하나의 게이트웨이 프로세스가 모든 것을 조율합니다. WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Google Chat, LINE, Matrix, Microsoft Teams, WeChat, QQ 등 25개 이상의 채널을 동시에 관리하는 허브-스포크 구조입니다.

Hermes가 "나만의 에이전트"라면, OpenClaw는 "만능 비서"에 가깝습니다. 이메일 정리, 일정 관리, 항공편 체크인, 파일 관리 등 생활 전반의 자동화에 강점이 있습니다.

4-3. OpenClaw의 핵심 기능

멀티채널 25+: Telegram, WhatsApp, Discord, Slack, Signal, iMessage, LINE, Matrix, Microsoft Teams, WeChat, QQ, WebChat 등. 모든 채널이 하나의 게이트웨이로 통합됩니다. 멀티에이전트 라우팅: 채널/계정/상대방별로 격리된 에이전트를 할당할 수 있습니다. 코딩용, 리서치용, 일반용 에이전트를 각각 다른 채널에 연결합니다. Voice Wake + Talk Mode: macOS/iOS에서 웨이크 워드로 음성 활성화, Android에서 연속 음성 대화. Live Canvas: 에이전트가 구동하는 시각적 작업 공간(A2UI). 컴패니언 앱: macOS 메뉴바 앱, iOS/Android 노드 앱. 10,700+ 스킬 생태계: ClawHub 마켓플레이스에서 검색·설치.

4-4. 설치 한 줄

``bash npm install -g openclaw@latest openclaw onboard --install-daemon ``

Node.js 22 이상 필요. openclaw onboard이 대화형으로 게이트웨이, 워크스페이스, 채널, 스킬을 하나씩 설정해 줍니다.

---

5. Hermes vs OpenClaw — 상세 비교표

5-1. 근본적 차이

The New Stack, getclaw.sh, 그리고 Reddit의 수많은 비교 글을 종합하면, 핵심 차이는 설계 철학입니다.

Hermes Agent = 에이전트 우선. 에이전트 자체의 "실행 → 학습 → 개선" 루프를 중심에 놓고 시스템을 구축합니다. 개인 운영자의 깊은 기억과 맞춤화에 최적화되어 있습니다. Reddit의 한 사용자는 "Hermes는 out-of-the-box polish(즉시 사용 가능한 완성도)에서 이기고, OpenClaw는 ceiling(최대 확장성)에서 이긴다"고 평가했습니다.

OpenClaw = 인프라 우선. 중앙 게이트웨이 컨트롤러가 모든 것을 조율합니다. 팀 사용, 다채널 동시 운영, 생태계 확장에 최적화되어 있습니다.

5-2. 기능별 상세 비교

5-3. 선택 기준 — 한 줄 정리

"시간이 갈수록 나를 알아서 점점 더 잘하는 나만의 에이전트" → Hermes Agent

"팀이 함께 쓰고, 25개 채널에서 동시에 일하는 만능 비서" → OpenClaw

"둘 다 써보고 싶다" → Hermes에서 hermes claw migrate로 OpenClaw 설정을 자동 임포트할 수 있으므로, 어느 쪽에서 시작하든 전환이 쉽습니다.

이 글에서는 Hermes Agent 기준으로 설치를 진행합니다. OpenClaw도 구조가 비슷하므로(Docker + Telegram 봇 연결), 핵심 개념은 동일하게 적용됩니다.

---

6. 왜 Docker인가 — "격리"를 모르면 다 털린다

6-1. Docker가 뭔가 — 비전공자를 위한 설명

Docker는 컴퓨터 안에 작은 컴퓨터를 만드는 프로그램이라고 생각하면 됩니다. 이 "작은 컴퓨터"(컨테이너)는 진짜 컴퓨터와 완전히 분리되어 있습니다. 컨테이너 안에서 무슨 짓을 해도 밖의 진짜 컴퓨터에는 영향이 없습니다.

비유하면: 당신의 집(호스트 컴퓨터) 안에 방 하나(Docker 컨테이너)를 만들어서, AI에게 그 방만 쓰게 하는 것입니다. AI가 그 방에서 벽에 페인트를 뿌려도, 가구를 부숴도 — 다른 방(당신의 사진, 문서, 비밀번호)에는 절대 영향이 없습니다.

6-2. Docker 없이 설치하면 무슨 일이 생기나

Docker 없이 호스트 OS에 직접 설치하면, AI 에이전트가 시스템 전체에 접근합니다. 구체적으로 일어날 수 있는 일: AI가 실수로 rm -rf /를 실행하면 시스템 파일이 날아갑니다. 텔레그램 봇 토큰이 유출되면 공격자가 당신의 컴퓨터를 원격 조종할 수 있습니다. AI가 ~/.ssh/ 폴더를 읽으면 SSH 키가 노출됩니다. .env 파일의 API 키를 읽어서 외부로 전송할 수 있습니다.

결론: 반드시 Docker로 격리하세요. 이것은 선택이 아니라 필수입니다.

6-3. Hermes Agent의 Docker 보안 — 자동 적용되는 것들

Hermes Agent를 Docker 백엔드로 실행하면, 다음 보안 설정이 자동으로 적용됩니다.

--cap-drop=ALL — 모든 Linux 권한(capabilities)을 제거합니다. --cap-add=DAC_OVERRIDE,CHOWN,FOWNER — 파일 읽기/쓰기와 패키지 매니저에 필요한 최소 권한만 추가합니다. --security-opt=no-new-privileges — 컨테이너 안에서 권한 상승을 완전히 차단합니다. --pids-limit=256 — 프로세스 수를 제한하여 포크 폭탄을 방지합니다. --tmpfs /tmp:rw,nosuid,size=512m — 임시 폴더 크기를 제한합니다.

컨테이너 자체가 보안 경계이므로, 위험 명령에 대한 사람의 승인 절차도 자동으로 건너뜁니다(컨테이너 안에서는 호스트에 영향이 없으므로).

6-4. Shared 폴더 전략 — 이것만 알면 됩니다

```bash # 핵심 원칙: "이 폴더만 AI가 건드릴 수 있다" docker run -v D:\Shared:/workspace nousresearch/hermes-agent

# D:\Shared 안의 파일만 AI가 읽고 쓸 수 있습니다 # 바탕화면, 문서, 다운로드, 사진 등 나머지 전체 시스템에는 # 물리적으로 접근이 불가능합니다 ```

이것이 Docker를 설치해야 하는 이유입니다. 한 단어: 격리.

---

7. 준비물 체크리스트

시작하기 전에 필요한 모든 것을 정리합니다.

---

8. STEP 1 — 24시간 켜둘 컴퓨터 준비하기

8-1. 어떤 컴퓨터가 필요한가

AI 추론은 클라우드에서 일어나므로 고사양 PC가 필요 없습니다. CPU, RAM, GPU 전부 중요하지 않습니다. 인터넷 연결만 안정적이면 됩니다.

적합한 장비: 안 쓰는 오래된 노트북, 서브 데스크탑, 미니 PC(Intel NUC, Beelink 등), Raspberry Pi 4/5, QNAP/Synology NAS(QNAP은 공식 Hermes Agent 튜토리얼을 제공합니다), $5/월 VPS(DigitalOcean, Vultr, Hetzner 등).

최소 사양: 4GB RAM, 2GB 디스크 여유, Python 3.11+, 안정적인 인터넷.

8-2. 절대 메인 PC에 설치하지 마세요

외부에서 원격으로 AI에게 컴퓨터 제어를 맡기는 구조입니다. Docker로 격리해도 메인 개발 머신에는 설치하지 않는 것이 안전합니다. 보안 사고는 항상 "설마"하는 곳에서 일어납니다.

8-3. 노트북 사용 시 설정

노트북으로 24시간 서버를 돌릴 수 있습니다. 세 가지를 설정하세요.

1) 덮개 닫아도 꺼지지 않게: Windows — 제어판 → 전원 옵션 → "덮개를 닫을 때" → "아무 것도 안 함". Mac — 시스템 설정 → 배터리 → 전원 어댑터 → "디스플레이가 꺼져도 자동 잠자기 방지" 활성화.

2) 배터리 보호: 80% 충전 제한을 설정합니다 (대부분의 최신 노트북에 내장 기능).

3) 발열 관리: 노트북 거치대로 공기 순환을 확보합니다. AI 에이전트는 CPU를 거의 사용하지 않으므로 발열은 미미합니다.

---

9. STEP 2 — Docker 설치하기

9-1. 다운로드

https://www.docker.com/ 에서 Docker Desktop을 다운로드합니다.

Windows: "Docker Desktop for Windows" 클릭. Mac: "Docker Desktop for Mac" 클릭 (Intel/Apple Silicon 확인). Linux: 배포판에 맞는 설치 스크립트 실행.

9-2. 설치 — Windows 기준

다운로드한 설치 파일을 실행합니다. "Use WSL 2 instead of Hyper-V" 옵션이 체크되어 있는지 확인합니다 (기본값). 설치를 완료하고 재부팅합니다. Docker Desktop이 자동으로 시작되면, 우측 하단 트레이에 고래 아이콘이 나타납니다.

9-3. 디스크 이미지 위치 변경 (중요)

Docker 이미지와 컨테이너 데이터가 수십 GB로 커질 수 있습니다. C: 드라이브 용량 부족을 방지하기 위해 반드시 다른 드라이브로 변경하세요.

Docker Desktop → 우측 상단 톱니바퀴(Settings) → Resources → Advanced → Disk image location → D:\DockerData (또는 여유 공간이 있는 드라이브) → Apply & Restart.

9-4. 설치 확인

터미널(PowerShell 또는 CMD)을 열고 입력합니다:

```bash docker --version # 출력 예: Docker version 27.x.x, build xxxxx

docker run hello-world # "Hello from Docker!" 메시지가 나오면 성공! ```

"Hello from Docker!" 메시지가 보이면 Docker 설치 완료입니다.

---

10. STEP 3 — Node.js 설치하기

10-1. 다운로드 및 설치

https://nodejs.org/ko/download 에서 LTS 버전 (22 이상)을 다운로드하여 설치합니다. 설치 중 모든 옵션은 기본값으로 두면 됩니다.

10-2. 설치 확인

```bash node --version # 출력 예: v22.x.x 이상이면 성공

npm --version # 출력 예: 10.x.x 이상이면 성공 ```

Node.js는 Hermes Agent의 게이트웨이(텔레그램 연결)와 일부 도구에 필요합니다.

---

11. STEP 4 — WSL2 설치하기 (Windows 사용자만)

Mac과 Linux 사용자는 이 단계를 건너뛰세요.

11-1. 왜 필요한가

Hermes Agent는 네이티브 Windows를 지원하지 않습니다. WSL2(Windows Subsystem for Linux)를 통해 Windows 안에서 Linux를 실행해야 합니다. Docker Desktop을 설치했다면 WSL2가 이미 설치되어 있을 가능성이 높습니다.

11-2. 설치 방법

PowerShell을 관리자 권한으로 열고 입력합니다:

``bash wsl --install ``

재부팅 후, Microsoft Store에서 Ubuntu를 검색하여 설치합니다. Ubuntu를 실행하면 사용자명과 비밀번호를 설정하라고 합니다. 이후 모든 Hermes Agent 관련 명령은 이 Ubuntu 터미널 안에서 실행합니다.

11-3. 확인

``bash wsl --version # WSL 버전 정보가 나오면 성공 ``

---

12. STEP 5 — Hermes Agent 설치하기

12-1. 원라인 설치 (정말 한 줄입니다)

WSL2 Ubuntu 터미널(Windows) 또는 일반 터미널(Mac/Linux)에서 입력합니다:

``bash curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash ``

이 한 줄이 Python 3.11, 필요한 패키지, Hermes Agent 본체를 모두 설치합니다. 설치에 3~5분 정도 걸립니다.

12-2. 셸 재로드

``bash source ~/.bashrc # 또는 source ~/.zshrc ``

12-3. 설치 확인

``bash hermes --version # 버전 정보가 나오면 성공! ``

12-4. Docker 백엔드 설정 (보안을 위해 필수)

``bash hermes config set terminal.backend docker ``

이 한 줄로 에이전트의 모든 명령 실행이 Docker 컨테이너 안에서 일어나도록 설정됩니다. 반드시 이 설정을 하세요.

---

13. STEP 6 — AI 모델 연결하기 (두뇌 장착)

13-1. 핵심 이해

Hermes Agent는 AI 모델 자체가 아닙니다. 외부 AI 모델을 호출하는 프레임워크입니다. "두뇌"를 장착해야 작동합니다. 어떤 AI 모델을 사용할지 선택하고 API 키를 입력하는 과정입니다.

13-2. 대화형 설정 (가장 쉬운 방법)

``bash hermes model ``

이 명령을 실행하면 대화형 메뉴가 나타나고, 프로바이더(어디서 AI를 제공받을지)와 모델(어떤 AI를 쓸지)을 선택합니다.

13-3. 추천 조합 — 상황별

[가장 쉬운 시작] OpenRouter 무료 모델. OpenRouter에 가입하면 무료 API 키를 받을 수 있고, 200+ 모델 중 무료 모델도 많습니다. 비용 부담 없이 시작하기 최고입니다.

``bash hermes config set providers.openrouter.api_key "sk-or-여기에-키-붙여넣기" hermes config set agent.model "openrouter/meta-llama/llama-4-scout" ``

[가성비 최강] OpenCode GO + Kimi K2.5. Kimi K2.5는 Moonshot AI가 개발한 오픈소스 코딩 모델로, 262K 토큰 컨텍스트 윈도우를 가지고 있습니다. Reddit에서 "오픈소스 중에 Kimi K2.5보다 나은 게 없다"는 평가를 받고 있으며, 많은 벤치마크에서 Claude Opus급 코딩 성능을 보여줍니다. OpenCode와 함께 사용하면 매우 저렴하게 강력한 코딩 에이전트를 구축할 수 있습니다.

[이미 구독 중이라면] OpenAI Codex / ChatGPT Pro. ChatGPT Pro($200/월) 구독이 있다면 API 키를 연결합니다. https://openai.com/ko-KR/codex/

``bash hermes config set providers.openai.api_key "sk-여기에-키-붙여넣기" hermes config set agent.model "openai/gpt-4.1" ``

[완전 무료 — 로컬] Ollama. GPU가 있다면 Ollama로 로컬 모델을 돌릴 수 있습니다. API 비용 완전 0원. 단, 64K 토큰 이상 컨텍스트를 지원하는 모델을 사용해야 합니다.

13-4. 첫 대화 테스트

``bash hermes # 또는 hermes --tui (더 보기 좋은 인터페이스) ``

프롬프트가 나타나면 아무 질문이나 입력합니다:

`` 안녕! 현재 디렉토리의 파일 목록 보여줘. ``

에이전트가 터미널 명령을 실행하고 결과를 보여주면 AI 모델 연결 성공입니다. 여기까지가 가장 중요한 관문입니다. 이게 안 되면 다음 단계로 넘어가지 마세요.

---

14. STEP 7 — 텔레그램 봇 만들기

이 단계부터가 "밖에서 휴대폰으로 개발하기"의 핵심입니다.

14-1. @BotFather에게 봇 생성 요청

1. 휴대폰 또는 데스크탑에서 텔레그램을 엽니다.
2. 검색창에 @BotFather를 검색하여 대화를 시작합니다.
3. /newbot 을 입력합니다.
4. 봇 이름을 입력합니다. 예: My Hermes Dev Bot (아무 이름이나 가능)
5. 봇 사용자명을 입력합니다. 예: my_hermes_dev_bot (반드시 bot으로 끝나야 하고, 전 세계에서 고유해야 합니다)
6. BotFather가 봇 토큰을 발급합니다. 이런 형태입니다:

`` 7123456789:AAF1bC2dE3fG4hI5jK6lM7nO8pQ9rS0tUv ``

이 토큰은 봇의 비밀번호입니다. 절대 공개하지 마세요. 유출되면 즉시 BotFather에서 /revoke로 폐기하세요.

14-2. 내 텔레그램 사용자 ID 확인

Hermes Agent는 허용된 사용자만 봇과 대화할 수 있도록 숫자 ID로 접근을 제어합니다. 사용자명(@username)이 아니라 숫자 ID가 필요합니다.

확인 방법: 텔레그램에서 @userinfobot을 검색하여 아무 메시지나 보내면, 즉시 당신의 숫자 ID를 알려줍니다. 예: 123456789

이 숫자를 메모해 두세요.

14-3. (선택) 봇 커스터마이징

BotFather에게 추가 명령을 보내면 봇을 꾸밀 수 있습니다. /setdescription — 봇 설명 설정. /setuserpic — 봇 프로필 사진 설정. /setcommands — 명령 메뉴 설정 (추천: help - 도움말, new - 새 대화, sethome - 홈 채널 설정).

---

15. STEP 8 — 텔레그램 ↔ Hermes 연결하기

15-1. 게이트웨이 설정 (대화형 — 가장 쉬운 방법)

서버 컴퓨터의 터미널에서 입력합니다:

``bash hermes gateway setup ``

대화형 메뉴가 나타납니다. Telegram을 선택하고, 앞에서 받은 봇 토큰을 붙여넣고, 허용할 사용자 ID(내 숫자 ID)를 입력합니다. 설정이 자동으로 저장됩니다.

15-2. 수동 설정 (대화형이 안 될 때)

~/.hermes/.env 파일을 열고 다음을 추가합니다:

``bash TELEGRAM_BOT_TOKEN=7123456789:AAF1bC2dE3fG4hI5jK6lM7nO8pQ9rS0tUv TELEGRAM_ALLOWED_USERS=123456789 # 여러 사용자를 허용하려면 쉼표로 구분: 123456789,987654321 ``

15-3. 게이트웨이 시작

``bash hermes gateway ``

로그에 [telegram] Connected to Telegram이 나타나면 연결 성공입니다. 봇이 온라인 상태가 됩니다.

15-4. Docker 파일 전송 주의사항

Docker 백엔드를 사용 중일 때, 에이전트가 파일을 생성하면 그 파일은 컨테이너 안에만 존재합니다. 텔레그램으로 파일을 보내려면 호스트에서도 접근 가능한 경로에 저장되어야 합니다.

``yaml # ~/.hermes/config.yaml terminal: backend: docker docker_volumes: - "/home/user/.hermes/cache/documents:/output" ``

이렇게 설정하면, 에이전트가 컨테이너 안의 /output/에 파일을 쓰면 호스트의 /home/user/.hermes/cache/documents/에서도 접근 가능하여 텔레그램으로 전송할 수 있습니다.

---

16. STEP 9 — 보안 설정 (절대 건너뛰지 마세요)

원격으로 AI에게 컴퓨터 제어를 맡기는 것이므로 보안은 생명줄입니다.

16-1. Docker 백엔드 확인

``bash hermes config get terminal.backend # "docker"가 출력되어야 합니다. 다른 값이면: hermes config set terminal.backend docker ``

16-2. Shared 폴더 제한

프로젝트 파일만 담은 특정 폴더만 컨테이너에 마운트합니다.

```yaml # ~/.hermes/config.yaml — 좋은 예 terminal: backend: docker docker_volumes: - "D:\\Shared:/workspace" # 이 폴더만 AI가 접근 가능

# 절대 하지 마세요: # - "C:\\:/host" # 전체 시스템 노출! # - "~:/home" # 개인 파일 노출! ```

16-3. 텔레그램 허용 목록

반드시 자신의 Telegram 숫자 ID만 허용하세요. 다른 사람이 봇에게 메시지를 보내도 무시됩니다.

``bash # ~/.hermes/.env TELEGRAM_ALLOWED_USERS=123456789 ``

허용 목록이 설정되지 않으면 Hermes Agent는 모든 사용자를 기본 거부합니다 (fail-closed). 이건 좋은 기본값이지만, 허용 목록을 명시적으로 설정하는 것이 가장 안전합니다.

16-4. DM 페어링 (고급)

허용 목록 대신 페어링 코드 방식도 사용할 수 있습니다. 모르는 사용자가 봇에 메시지를 보내면 8자리 일회용 코드가 발급되고, 봇 운영자가 hermes pairing approve telegram ABC12DEF로 승인해야 대화가 가능합니다. 코드는 암호학적 랜덤, 1시간 만료, 5회 실패 시 1시간 잠금이 적용됩니다.

16-5. 위험 명령 승인 시스템

Docker 밖(로컬 백엔드)에서 실행할 때, Hermes는 rm -rf, DROP TABLE, chmod 777, curl | sh 등 30개 이상의 위험 패턴을 자동 감지하여 사람의 승인을 요청합니다. 승인 모드는 세 가지입니다: manual(항상 물어봄, 기본값), smart(보조 AI가 위험도 판단), off(--yolo 모드, 모든 명령 자동 실행).

Docker 백엔드에서는 이 검사가 자동으로 건너뛰어집니다 — 컨테이너 자체가 보안 경계이므로, 컨테이너 안에서 무슨 명령을 실행해도 호스트에 영향이 없기 때문입니다.

16-6. .env 파일 권한

``bash chmod 600 ~/.hermes/.env # 본인만 읽을 수 있도록 설정 ``

16-7. 절대 root로 실행하지 마세요

게이트웨이를 root 권한으로 실행하면 보안 사고 시 피해가 극대화됩니다. 일반 사용자 권한으로 실행하세요.

---

17. STEP 10 — 접속 테스트 & 첫 원격 개발

17-1. 기본 연결 테스트

밖에 나가세요. (아니면 휴대폰으로 합니다.) 텔레그램에서 봇에게 메시지를 보냅니다:

`` 너는 누구니? ``

AI가 자신의 모델 정보와 함께 응답하면 연결 성공입니다.

17-2. 파일 시스템 접근 테스트

`` 현재 작업 디렉토리 확인해주고, /workspace 폴더 안에 뭐가 있는지 보여줘 ``

Docker 볼륨으로 마운트한 Shared 폴더의 파일들이 보이면 파일 접근 정상입니다.

17-3. 코드 생성 테스트

`` /workspace에 hello.py 파일을 만들어줘. 내용: "Hello, Remote Dev!"를 출력하는 파이썬 스크립트. 만든 다음 실행해서 결과를 알려줘. ``

에이전트가 (1) 파일을 생성하고, (2) python hello.py를 실행하고, (3) 출력 결과 "Hello, Remote Dev!"를 텔레그램으로 보내주면 원격 AI 개발 시스템 구축 완료입니다.

17-4. 실제 개발 테스트

이미 프로젝트가 Shared 폴더에 있다면, 실제 개발 지시를 해봅니다:

`` /workspace/my-project 폴더의 index.html을 열어서, 네비게이션 바에 "About" 메뉴 항목을 추가해줘. 기존 스타일을 유지하면서 추가해. ``

에이전트가 파일을 읽고, 수정하고, 결과를 알려줍니다. 개발 서버가 돌고 있다면 스크린샷까지 찍어서 보내줄 수 있습니다.

---

18. 실전 운영 — 고급 활용법

18-1. 게이트웨이 항상 켜두기 (systemd 서비스)

컴퓨터가 재부팅되어도 게이트웨이가 자동 시작되게 설정합니다:

```bash # /etc/systemd/system/hermes-gateway.service [Unit] Description=Hermes Agent Gateway After=network.target docker.service

[Service] Type=simple User=youruser ExecStart=/home/youruser/.local/bin/hermes gateway Restart=always RestartSec=10

[Install] WantedBy=multi-user.target ```

``bash sudo systemctl enable hermes-gateway sudo systemctl start hermes-gateway ``

18-2. 여러 봇 동시 운영

프로파일 시스템으로 용도별 에이전트를 분리합니다:

``bash hermes -p coder # 코딩 전용 에이전트 hermes -p researcher # 리서치 전용 에이전트 hermes -p devops # 인프라 관리 전용 에이전트 ``

각 프로파일에 별도의 텔레그램 봇을 연결하면, 봇별로 다른 AI와 대화할 수 있습니다.

18-3. 크론 스케줄링 — 자동 작업 예약

자연어로 자동화를 설정합니다:

`` 매일 오전 9시에 프로젝트 빌드 돌리고 결과 알려줘 매주 금요일 오후 6시에 이번 주 Git 커밋 요약해줘 매일 자정에 /workspace/logs/ 폴더의 7일 이상 된 로그 삭제해줘 ``

에이전트가 크론 잡을 생성하고, 지정된 시간에 자동 실행하여 결과를 텔레그램으로 보내줍니다. 홈 채널을 설정하면(/sethome), 크론 결과가 해당 채널로 전달됩니다.

18-4. AGENTS.md로 프로젝트 맥락 제공

프로젝트 루트에 AGENTS.md 파일을 만들어두면, 에이전트가 프로젝트의 모든 맥락을 자동으로 이해합니다:

```markdown # Project: My Website

Tech Stack - Next.js 15 + React 19 - Tailwind CSS v4 - Supabase (PostgreSQL) - Vercel 배포

Conventions - TypeScript strict mode - 탭 사용, 120자 줄 너비 - 컴포넌트는 PascalCase, 유틸은 camelCase

Architecture - /app — 페이지 라우팅 - /components — 재사용 컴포넌트 - /lib — 유틸리티 함수 - /supabase — DB 스키마, 마이그레이션 ```

18-5. 음성 메모 지원

텔레그램에서 음성 메모를 보내면 자동으로 텍스트로 전사(transcription)됩니다. 로컬 faster-whisper(무료), Groq Whisper, OpenAI Whisper를 지원합니다. 타이핑하기 귀찮을 때 음성으로 지시할 수 있습니다.

18-6. MCP(Model Context Protocol) 서버 연결

외부 도구를 MCP로 연결하면 에이전트의 능력이 확장됩니다:

``yaml # ~/.hermes/config.yaml mcp_servers: github: command: npx args: ["-y", "@modelcontextprotocol/server-github"] env: GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx" ``

GitHub, 데이터베이스, 외부 API 등 어떤 MCP 서버든 연결할 수 있습니다.

---

19. 전력 소모·비용 분석

19-1. 전력

AI 추론은 클라우드에서 일어나므로 서버 컴퓨터의 부하는 매우 적습니다. 노트북/미니 PC 기준 20~30W. 한 달 전기세 약 2,000~3,000원(한국 전기 요금 기준).

19-2. AI API 비용

19-3. 총 운영 비용 요약

최소 비용 시나리오: 기존 노트북 + Docker(무료) + OpenRouter 무료 모델 + 텔레그램(무료) = 월 ~2,000원 (전기세만)

가성비 시나리오: 기존 노트북 + Kimi K2.5 = 월 ~5,000원

VPS 시나리오: $5 VPS + OpenRouter 유료 모델 = 월 ~$15

---

20. 트러블슈팅 — 안 될 때 이것부터

20-1. 만능 진단 명령

``bash hermes doctor ``

이 명령이 모든 설정 문제를 진단해 줍니다. 무조건 이것부터 실행하세요.

20-2. 문제별 해결

20-3. 복구 순서

모든 게 꼬였을 때, 이 순서로 복구합니다:

``bash hermes doctor # 1. 진단 hermes model # 2. 모델 재설정 hermes setup # 3. 전체 설정 위저드 hermes gateway status # 4. 게이트웨이 상태 확인 hermes update # 5. 최신 버전 업데이트 ``

---

21. 자주 묻는 질문 15선

Q1. 프로그래밍을 전혀 모르는데 할 수 있나요?

Docker 설치와 Node.js 설치는 프로그래밍 지식이 필요 없습니다. Hermes Agent 설치도 명령어 한 줄입니다. 다만 텔레그램으로 AI에게 지시를 내리려면, "무엇을 만들고 싶은지"를 말로 설명할 수 있어야 합니다. 프로그래밍을 모르더라도 "로그인 페이지 만들어줘"처럼 말하면 AI가 처리합니다.

Q2. GPU가 필요한가요?

아닙니다. AI 추론은 클라우드(OpenRouter, OpenAI 등)에서 일어나므로 GPU가 필요 없습니다. Ollama로 로컬 모델을 돌리고 싶은 경우에만 GPU가 도움이 됩니다.

Q3. Windows에서 되나요?

네. WSL2를 설치하면 됩니다. Docker Desktop 설치 시 WSL2가 함께 설정되는 경우가 많습니다. STEP 4를 참고하세요.

Q4. Mac에서 되나요?

네. Mac은 WSL2 없이 바로 설치됩니다. Intel Mac과 Apple Silicon(M1/M2/M3/M4) 모두 지원합니다.

Q5. 노트북을 덮어도 되나요?

네. 전원 설정에서 "덮개를 닫을 때 아무 것도 안 함"으로 변경하면 됩니다. STEP 1을 참고하세요.

Q6. 보안이 정말 괜찮나요?

Docker 격리 + 허용 목록 사용자 인증 + 7계층 보안을 모두 설정하면 합리적인 수준의 보안을 확보할 수 있습니다. Hermes Agent는 제로 텔레메트리(어떠한 데이터도 외부로 전송하지 않음) 정책을 채택합니다. 그래도 메인 PC에는 설치하지 않는 것이 최선입니다.

Q7. 텔레그램 말고 다른 앱도 되나요?

Hermes Agent는 Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, Home Assistant 등 15+ 플랫폼을 지원합니다. OpenClaw는 25+ 플랫폼(iMessage, LINE, WeChat 등 추가)을 지원합니다.

Q8. 여러 사람이 같이 쓸 수 있나요?

Hermes Agent는 기본적으로 개인 최적화이지만, 허용 목록에 여러 사용자 ID를 등록하면 여러 사람이 사용할 수 있습니다. 팀 사용이 주 목적이라면 OpenClaw의 멀티에이전트 라우팅이 더 적합합니다. Hermes Agent는 팀 텔레그램 어시스턴트 튜토리얼도 제공합니다.

Q9. OpenClaw에서 Hermes로 바꿀 수 있나요?

네. hermes claw migrate 명령으로 OpenClaw의 설정, 메모리, 스킬, API 키를 자동 이전할 수 있습니다. --dry-run으로 미리보기도 가능합니다.

Q10. 얼마나 복잡한 개발을 시킬 수 있나요?

AI 모델의 능력에 의존합니다. GPT-4.1이나 Claude Opus급 모델을 사용하면 풀스택 웹 개발, API 설계, 데이터베이스 마이그레이션, 테스트 작성 등 상당히 복잡한 작업을 처리할 수 있습니다. Hermes Agent의 스킬 시스템이 성공 경험을 축적하므로, 같은 유형의 작업은 반복할수록 더 빠르고 정확해집니다.

Q11. 인터넷이 끊기면 어떻게 되나요?

텔레그램 메시지가 전달되지 않으므로 에이전트가 지시를 받을 수 없습니다. 이미 진행 중인 작업은 (AI API 호출이 가능한 한) 계속될 수 있지만, 새로운 지시는 인터넷이 복구된 후에 가능합니다.

Q12. VPS로 하면 장점이 뭔가요?

24시간 안정적인 가동, 정전/인터넷 끊김 걱정 없음, 집 IP 노출 없음. $5/월 VPS(DigitalOcean, Vultr, Hetzner)면 충분합니다. Hermes Agent는 Daytona, Modal 등 서버리스 백엔드도 지원하여 유휴 시 비용이 거의 0에 가깝습니다.

Q13. 에이전트가 실수로 중요한 파일을 삭제하면?

Docker 격리 + Shared 폴더 전략을 사용하면, AI가 접근할 수 있는 파일은 당신이 명시적으로 마운트한 폴더 안의 파일만입니다. 그 폴더의 파일이 삭제될 수는 있으므로, 중요한 프로젝트는 Git으로 버전 관리하고, 정기적으로 백업하세요.

Q14. Hermes Agent 업데이트는 어떻게 하나요?

``bash hermes update ``

한 줄로 최신 버전으로 업데이트됩니다.

Q15. 진짜 이거 하면 밖에서 개발 되나요?

네. 됩니다. 이 글의 원작자 표현을 빌리면: "딸래미 데리고 밖에 나가도, 밖에 있어도 개발 가능ㅋㅋㅋㅋㅋ"

---

참고 자료

Hermes Agent - Hermes Agent 공식 사이트 - Hermes Agent GitHub — 10만+ 스타 - Hermes Agent 퀵스타트 - Hermes Agent 텔레그램 설정 - Hermes Agent Docker 가이드 - Hermes Agent 보안 문서 - Hermes Agent 메모리 시스템 - Hermes Agent 스킬 시스템 - Hermes Agent 팀 텔레그램 어시스턴트 튜토리얼 - DataCamp — Hermes Agent 튜토리얼 - QNAP NAS Hermes Agent 배포 가이드

OpenClaw - OpenClaw 공식 사이트 - OpenClaw GitHub — 29만 5천+ 스타 - OpenClaw 공식 문서 - OpenClaw 텔레그램 설정 가이드

비교 분석 - The New Stack — OpenClaw vs Hermes Agent - getclaw.sh — 기능별 상세 비교 - Turing Post — AI 101: Hermes Agent

도구 - Docker 공식 사이트 - Node.js 다운로드 - Telegram Desktop - OpenRouter — 200+ AI 모델 - OpenCode AI - Kimi — Moonshot AI - OpenAI Codex - Ollama — 로컬 AI - Nous Research - Skills Hub (agentskills.io)