JYP Garden Internal

나만의 Hermes 에이전트 설계 및 구축

Properties1
tagsproject, agentic-ai, hermes-agent, harness-engineering, personal

11 min read

나만의 Hermes 에이전트 설계 및 구축

Outcome (완료 조건) — v3.0 기준

OpenClaw Gateway + Hermes 3에이전트(dap-pm / ax-expert / kids-academy-teacher) 구축 완료.

  • OpenClaw Gateway vault-shared 6-file 초기화 + Slack hermes-agent / Telegram 바인딩 완료
  • Hermes 3개 프로필 SOUL.md · AGENTS.md 입력 완료 및 gateway 상시 실행
  • 실제 업무 투입 1건 이상 검증 (dap-pm: 운영 요청 처리 또는 ax-expert: 강의 자료 초안 생성)
  • 에이전트 간 비동기 협업 (OpenClaw Gateway → Hermes shell 라우팅) 1건 실증

Why This Project

DAP 운영 PM · AX 교육 멘토 두 역할을 별도 에이전트로 분리해 전문성을 유지하면서 협업한다. 설계서 v2.5 (raw/articles/hermes-agent-design.md, 2026-04-29)가 기초 청사진. v3.0 개정 (raw/articles/hermes-agent-design-v3.md, 2026-05-04): coordinator → OpenClaw Gateway+Router 전환. hermes-agent Profiles 기능으로 전문 에이전트별 SOUL.md + 메모리 + 스킬이 완전 독립된다. (배경: gateway-architecture — OpenClaw Gateway+Router 패턴, agent-identity-design — SOUL.md 5요소)

Context

Hermes Agent는 SOUL.md + memories + sessions + skills + cron을 프로필 단위로 분리하는 구조다. 각 프로필은 자동으로 독립 CLI alias(dap-pm chat, ax-expert chat 등)를 생성하고, terminal.cwd를 각 볼트에 고정해 에이전트가 항상 올바른 워크스페이스에서 시작한다.

구성요소 역할 (v3.0 — coordinator → OpenClaw Gateway+Router):

구성요소Slack 채널볼트/워크스페이스핵심 역할
OpenClaw Gatewayhermes-agent + Telegram~/Documents/vault-shared채널 소유·binding 라우팅 (coordinator 대체)
dap-pm (Hermes)dap-운영~/Documents/dap-wiki-vaultDAP 운영·장애·Jira·Airflow
ax-expert (Hermes)ax-전문가~/Documents/my-wiki-vaultAX 방법론·Agentic AI·멘토링
kids-academy-teacher (Hermes)kids-academy~/Documents/kids-academy-vault초등 공부방·네이버 블로그

관련 배경:

Knowledge Pulls

이 프로젝트가 소환하는 위키 지식

Project → Zettel 단방향. 아래 페이지는 이 프로젝트를 모름 (역링크 추가 금지).

Concepts

multi-agent-team-design

  • 소환 이유: Hermes Profiles 분리 구조 + Shared 볼륨 비동기 협업 + 호명 규칙·NO_REPLY
  • 활용 지점: 4개 에이전트 역할 경계 설계 및 TEAM.md·COLLAB-RULES.md 작성 기준

agent-identity-design

  • 소환 이유: SOUL.md 5가지 구성요소 (Identity / Mission / Personality / Boundaries / Tone)
  • 활용 지점: Phase 3 SOUL.md 초안 작성 시 직접 참조 — 설계서 5절 보완

agent-workspace-structure

  • 소환 이유: ~/.hermes/ 구조 + OpenClaw 비교표 + profiles/ 분리 원리
  • 활용 지점: Phase 0~1 파일시스템 구조 설계 및 확인 기준

subagent-orchestration

  • 소환 이유: delegate_task 한계(SOUL·메모리 미상속) + Router 패턴 (shell 직접 호출)
  • 활용 지점: coordinator 오케스트레이션 방식 결정 — delegate_task vs -q shell 호출

gateway-architecture

  • 소환 이유: Gateway 데몬 설정 · 멀티채널 라우팅 · 채널별 에이전트 바인딩
  • 활용 지점: Phase 5 gateway install + start 및 Slack 채널 바인딩 설정

agentic-scheduling-design

  • 소환 이유: Cron 60초 스케줄러 · workdir 지정 · inbox 감시 설계
  • 활용 지점: Phase 5 inbox-handler Cron 설정 (5분 주기 inbox 폴더 감시)

harness-engineering

  • 소환 이유: SOUL.md = 외재화된 하네스 · Profiles = CLAUDE.md 분리의 Hermes 버전
  • 활용 지점: 에이전트 워크스페이스 파일 작성 시 하네스 레이어 매핑

agent-runtime-architecture

  • 소환 이유: Hermes 런타임 5레이어 (시스템 프롬프트 조립 + 세션 + 도구 + 스케줄러 + 채널)
  • 활용 지점: Phase 1~2 config.yaml 설정 시 레이어별 설정 항목 파악

multichannel-session-management

  • 소환 이유: Slack 채널 바인딩 · 채널별 에이전트 분리 · 호명 규칙
  • 활용 지점: Phase 5 Slack MCP 설정 및 채널별 에이전트 라우팅

agent-skill-design

  • 소환 이유: SKILL.md 작성법 · 스킬 디렉토리 구조 · external_dirs 설정
  • 활용 지점: Phase 4 dap-pm 전용 스킬 3종 작성 기준

agent-memory-architecture

  • 소환 이유: memories/ 폴더 구조 · 세션 간 기억 복원 · 초기 메모리 세팅
  • 활용 지점: Phase 3 첫 세션 초기 메모리 입력 (역할·볼트 경로·핵심 우선순위)

agent-information-boundary

  • 소환 이유: 에이전트 간 정보 경계 · Shared 볼륨 inbox 큐 · 민감정보 추출 방어
  • 활용 지점: vault-shared inbox 구조 설계 + dap-pm ↔ ax-expert 협업 경계

Sources

obsidian-hermes-agent-build-guide

  • 소환 이유: Profiles 기능 상세 · terminal.cwd 고정 · Shared 볼륨 협업 · Router 패턴 전체
  • 활용 지점: Phase 1~5 전 단계에서 구현 기준으로 참조 — 가장 중요한 소스

yt-llm-wiki-hermes-agent-obsidian

  • 소환 이유: Hermes + Obsidian 연동 셋업 첫 소개
  • 활용 지점: Phase 2 볼트-프로필 연동 설정 시 보조 참조

Entities

hermes-agent

  • 소환 이유: Profiles API · config.yaml 구조 · 공식 문서 URL · skills catalog
  • 활용 지점: 설치 명령어·설정 키 확인 및 공식 문서 탐색 진입점

Insights

openclaw-vs-hermes-agent-comparison-2026-04-28

  • 소환 이유: OpenClaw vs Hermes 비교 — Hermes 선택 이유·장단점 정리
  • 활용 지점: 구현 중 OpenClaw 대안 검토 필요 시 의사결정 기준

Plan

gantt
    title 나만의 Hermes+OpenClaw 에이전트 구축 단계 (v3.0)
    dateFormat  YYYY-MM-DD
    axisFormat  %m/%d
    section Phase 0 — 설계
    설계서 v2.5 완성             :done, a0, 2026-04-29, 1d
    설계서 v3.0 개정 (coordinator→OpenClaw) :done, a0b, 2026-05-04, 1d
    section Phase 1 — 설치
    Hermes + OpenClaw 설치      :a1, 2026-05-04, 3d
    section Phase 2 — 볼트 초기화
    vault-shared 6-file + inbox :a2, after a1, 2d
    section Phase 3 — 프로필 생성
    Hermes 3개 프로필 + SOUL.md :a3, after a2, 5d
    section Phase 4 — 스킬 설치
    dap-pm 전용 스킬 3종        :a4, after a3, 3d
    section Phase 5 — 채널 연동
    OpenClaw Gateway + Hermes gateway×3 :a5, after a4, 5d

Progress

(진행 시 /project update my-agent-design으로 기록)

Next Actions

Actions

  • Phase 1 — Hermes 설치 확인: npm install -g @nousresearch/hermes-agent + hermes setup
  • Phase 1 — OpenClaw 설치: npm install -g openclaw@latest + openclaw onboard --install-daemon
  • Phase 2 — vault-shared 6-file 워크스페이스 초기화 (SOUL.md / AGENTS.md / TOOLS.md / USER.md / IDENTITY.md / HEARTBEAT.md) — v3.0 설계서 Section 3~5 기반
  • Phase 2 — vault-shared inbox 디렉토리 초기화 (for-dap-pm / for-ax-expert / for-kids-academy-teacher / done)
  • Phase 2 — 3개 볼트(dap-wiki-vault, my-wiki-vault, kids-academy-vault) AGENTS.md에 Tier 3 내용 추가
  • Phase 3 — Hermes 3개 프로필 생성: hermes profile create dap-pm/ax-expert/kids-academy-teacher --clone (coordinator 제외)
  • Phase 3 — 각 프로필 terminal.cwd 설정 (볼트 경로 고정)
  • Phase 3 — Hermes 3개 SOUL.md 입력 (v2.5 설계서 5절 기반)
  • Phase 3 — 첫 세션 초기 메모리 입력 (dap-pm chat → 역할·볼트·채널·우선순위 기억)
  • Phase 4 — dap-pm 전용 스킬 3종 SKILL.md 직접 작성 (dap-incident-response / dap-change-plan / dap-event-transform)
  • Phase 5 — Slack MCP 설정 (채널 3개: dap-운영 / ax-전문가 / kids-academy)
  • Phase 5 — Hermes 3개 에이전트 gateway install/start
  • Phase 5 — OpenClaw Gateway: openclaw.json 설정 + Slack hermes-agent 바인딩 + Telegram 바인딩 + openclaw start
  • Phase 5 — inbox-handler Cron 설정 (5분 주기, Hermes 3개 에이전트 공유)
  • **미결 1 — kids-academy-teacher 볼트 분리 여부 결정 (현재 my-wiki-vault 공유 vs 신규 볼트)
  • **미결 3 — coordinator 오케스트레이션 방식 → 확정: OpenClaw Gateway+Router (v3.0)

Risks

식별된 리스크

  • R1 (High): Hermes npm 패키지 명칭·설치 방법 미확인 → 설치 전 공식 문서 재확인 필수
  • R1b (High): OpenClaw openclaw.json 에이전트 바인딩 API 최신 스펙 미확인 → 설치 전 공식 문서·ChangeLog 확인 필수
  • R2 (Med): Hermes 3개 + OpenClaw 1개 게이트웨이 동시 실행 시 리소스(메모리·포트) 충돌 가능 → 순차 시작 후 모니터링
  • R3 (Med): OpenClaw → Hermes 크로스 플랫폼 shell 호출(hermes -p dap-pm -q "...") 응답 지연 가능 → 타임아웃 설정 및 오류 메시지 처리
  • R3 (구): coordinator delegate_task 한계 → 해소됨 (v3.0 OpenClaw Gateway로 전환)
  • R4 (Low): kids-academy-teacher 볼트 미분리 시 ax-expert와 컨텍스트 혼재 → 설계서 미결 #1 선결 필요
  • R5 (Low): OpenClaw는 Claude API 전용 → OpenRouter 사용 불가, API 키 별도 관리 필요

Artifacts

산출물

  • raw/articles/hermes-agent-design.md — 설계서 v2.5 (Phase 0 완료, 원본 보존)
  • raw/articles/hermes-agent-design-v3.md — 설계서 v3.0 개정 델타 (coordinator → OpenClaw 변경사항만)
  • raw/articles/hermes-agent-design-unified.md — 설계서 v3.0-unified (전체 통합본, 최신 적용본) (구현 완료 후 추가 기록)

Retrospective

그래프 뷰

백링크