Hindsight 멀티에이전트 셋업 작업로그

Hindsight 멀티에이전트 셋업 작업로그

[!note] 수정이력

• 2026-05-07 21:40, 루키 (hermes) — 초안 작성
• 2026-05-07 22:00, 루키 (hermes) — 분홍이 문제 해결 내용 추가

---

📌 작업 목표

• 루키(맥미니) + 분홍이(mainpc-wsl) + 하늘이(subpc-wsl) 3개 에이전트를 하나의 Hindsight 서버(맥미니)에서 공유
• 에이전트별 뱅크 분리: hermes(루키) / pink(분홍이) / sky(하늘이)
• SSH 터널로 WSL→맥미니 네트워크 우회

---

🏗️ 아키텍처

┌─────────────────────────────────────┐
│  Server: Mac Mini (맥미니 M4 Pro)   │
│  ┌─────────────────────────────┐    │
│  │  hindsight-embed daemon     │    │
│  │  profile: hermes, port 9177 │    │
│  │  Banks: hermes, pink, sky   │    │
│  └─────────────────────────────┘    │
│         ↑ HTTP (SSH 터널)            │
│  ┌──────┴──────┬─────────────────┐  │
│  │ 루키: Mac   │ 분홍이: WSL     │  │
│  │  localhost  │  localhost:9177 │  │
│  │  → 실제 9177│  → SSH 터널→맥미니│  │
│  └─────────────┴─────────────────┘  │
└─────────────────────────────────────┘

---

✅ 성공한 것들

1. 루키(맥미니)

• hindsight-embed 데몬 설치/실행 (profile=hermes, port=9177)
• hermes 뱅크 생성 (루키 전용)
• pink 뱅크 생성 (분홍이 전용)
• sky 뱅크 생성 (하늘이 전용)
• hindsight-embed 기능 테스트 완료 (retain/recall/reflect 모두 통과)
• Hindsight UI 시작 (port 19177)
• Caddy 등록: https://ruki-r.pinksky.kr/dashboard
• Consolidation 88% 완료 (42/48)

2. 분홍이(mainpc-wsl)

• config 수정: hindsight.enabled: true
• config 수정: hindsight.bank: pink
• SSH 터널 생성: ssh -N -L 9177:localhost:9177 pinksky@100.70.47.91
• gateway 재시작 완료
• config 수정: hindsight.base_url: http://localhost:9177 (Cloud fallback 문제 수정)
• gateway 재시작 2회 완료

3. 분석/문서화

• OpenClaw vs Hermes Hindsight 차이 분석 (미미 문서는 OpenClaw 전용)
• 데몬 바인딩 제약 확인 (localhost only → 외부 접근 불가)
• skill 문서화: hindsight-multi-agent-setup에 Remote Access 섹션 추가

---

✅ 분홍이 문제 해결 (2026-05-07 22:00)

해결 요약

• Status: available ✓ — 정상 동작 확인!
• 책임자: 분홍이 (mainpc-wsl)

해결 과정

1. 원인 발견: Hindsight 플러그인이 .env에 HINDSIGHT_API_KEY가 없으면 초기화 자체를 하지 않고 not available로 떨어짐
2. Local External 모드 버그: API key가 optional이어야 하지만, 플러그인 코드가 required로 체크해서 .env에 키가 없으면 연결을 시도하지 않음
3. 해결책: .env에 dummy key(DUMMY_KEY)를 넣어서 플러그인이 초기화되도록 유도
4. 결과: 맥미니 로컬 서버(localhost:9177)에 실제로 연결됨 (SSH 터널로 포트 포워딩된 상태)

분홍이 config 최종 상태

hindsight:
  enabled: true
  bank: pink
  base_url: http://localhost:9177
memory:
  provider: hindsight

참고: 분홍이가 Hermes Hindsight 플러그인 코드에 피드백을 남기고 싶어함 — “Local External 모드에서 HINDSIGHT_API_KEY를 optional로 바꿔줘”라는 개선사항. GitHub 이슈로 등록 고려 중.

---

❌ 실패 / 미완료 / 진행 중

1. 하늘이(subpc-wsl)

• 설정 미시작 (분홍이 해결 후 진행 예정)
• 예상 설정: bank: sky, SSH 터널, base_url: http://localhost:9177
• 중요: 하늘이도 분홍이와 동일하게 .env에 dummy key 필요할 수 있음

2. 루키(맥미니) 메모리 테스트

• 분홍이 메모리 실제로 쓰는지 테스트 (memory retain → memory recall 테스트)
• 루키 자체 Hindsight 메모리 동작 확인

3. 버그 리포트/개선

• Hermes Hindsight 플러그인: Local External 모드에서 API key optional 처리 필요

---

🔍 발견한 핵심 문제

문제 1: Hermes config 구조의 모호함

• memory.provider: hindsight + hindsight.enabled: true가 동시에 필요
• hindsight.base_url이 없으면 Cloud API로 fallback → API key 요구
• 분홍이에 base_url 추가했으나 여전히 Cloud API를 찾음

문제 2: Hindsight 데몬 바인딩 제약

• 데몬이 127.0.0.1에만 바인딩 (외부 접근 불가)
• SSH 터널로 우회했으나 Hermes 내부에서 터널 주소를 인식 못 하는 가능성

문제 3: OpenClaw vs Hermes 설정 불일치

항목	OpenClaw	Hermes
설정 파일	~/.openclaw/openclaw.json	~/.hermes/config.yaml
뱅크 설정	dynamicBankId, bankId	hindsight.bank
LLM 설정	llmProvider, llmModel 별도	시스템 LLM 공유
Cloud API	✅ 지원	❌ 없음
데몬 관리	uvx hindsight-embed	hindsight-embed 직접

문제 4: 분홍이가 Hermes Cloud 모드로 진입

• 분홍이가 https://ui.hindsight.vectorize.io를 찾는 건, Hermes가 로컬 데몬 연결 실패 시 Cloud fallback 하는 로직이 있을 가능성
• 또는 분홍이에 hindsight-embed plugin이 제대로 설치/인식 안 됨

---

📋 다음 단계 (TODO)

분홍이 문제 해결 우선

1. 분홍이 WSL에서 Hermes 버전/플러그인 확인

   ~/.hermes/hermes-agent/venv/bin/hermes --version
   ls ~/.hermes/hermes-agent/venv/lib/python*/site-packages/ | grep hindsight

2. 분홍이 config 전체 덤프

   cat ~/.hermes/config.yaml

3. Hermes 로그 확인

   ~/.hermes/hermes-agent/venv/bin/hermes gateway logs --lines 50

4. hindsight-embed plugin 설치 여부 확인

   • Hermes venv 내 hindsight_embed 패키지 존재 여부

5. 분홍이 hermes doctor 결과 확인

   • 왜 Cloud API를 찾는지 정확한 원인 파악

하늘이 설정 (분홍이 해결 후)

1. 동일 설정 적용: bank: sky, base_url: http://localhost:9177
2. SSH 터널 생성
3. gateway 재시작

---

🛠️ 참고 명령어 모음

맥미니 (루키)

# 데몬 상태
hindsight-embed daemon --profile hermes status

# 뱅크 목록
hindsight-embed -p hermes bank list

# UI 시작
hindsight-embed -p hermes ui start --port 19177

# UI 중지
hindsight-embed -p hermes ui stop

분홍이/하늘이 (WSL)

# config 수정
~/.hermes/hermes-agent/venv/bin/hermes config set hindsight.enabled true
~/.hermes/hermes-agent/venv/bin/hermes config set hindsight.bank <pink|sky>
~/.hermes/hermes-agent/venv/bin/hermes config set hindsight.base_url http://localhost:9177

# 터널 생성
ssh -N -L 9177:localhost:9177 pinksky@100.70.47.91 &

# gateway 재시작
~/.hermes/hermes-agent/venv/bin/hermes gateway restart

---

📝 메모

• 아빠: “분홍이도 제대로 설정이 안되서 적용이 안되고 있는데 하늘이까지 건들이는건 아닌듯해”
• 분홍이 문제 해결이 우선순위
• 하늘이는 분홍이 성공 후 동일 패턴으로 적용
• OpenClaw(미미)와 Hermes(루키/분홍이/하늘이)는 Hindsight 설정 구조가 완전히 다름
• 미미 문서(32.58_Hindsight_-_OpenClaw_장기기억_플러그인.md)는 OpenClaw 전용 참고용