주변 인프라 · 도구 생태계

1. 생태계 다이어그램

               ┌───────────────────┐
               │    Claude Code    │
               │  (메인 세션/오케) │
               └────────┬──────────┘
                        │
         ┌──────────────┼──────────────┐
         ▼              ▼              ▼
   ┌──────────┐  ┌────────────┐  ┌──────────────┐
   │  Hermes  │  │codex-proxy │  │   cmux 팀    │
   │ gateway  │  │  :19080    │  │  7 surface   │
   │  :18789  │  │(ChatGPT+)  │  │ Claude+Codex │
   └────┬─────┘  └────────────┘  └──────────────┘
        │
   ┌────┴──────────────────┐
   │  텔레그램 봇 3종       │
   │  크론 150개           │
   │  분석가 파이프라인 4종 │
   └───────────────────────┘

2. 도구별 상세

2.1 chatgpt-codex-proxy

• 경로: ~/chatgpt-codex-proxy (실행 소스), ~/codex-proxy-fork (개발 fork)
• 버전: v0.5.0
• 포트: 19080 (실측: node *:19080 LISTEN)
• launchd: com.openclaw.codex-proxy
• 실행: /usr/local/bin/node /Users/ron/chatgpt-codex-proxy/dist/index.js
• 로그: ~/.hermes/logs/codex-proxy.log
• 용도: ChatGPT Plus 구독을 OpenAI-compatible API로 노출. Codex CLI가 이 프록시를 base_url로 사용
• 모델 매핑: ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.3-codex (probe 로직으로 자동 선택)
• 클라이언트: cmux surface:4~7 Codex 세션, Claude Code /codex:* 스킬
• PASSTHROUGH_MODE: false (프록시 모드 활성)

2.2 cmux (7 surface 팀)

• 용도: 여러 Claude/Codex 세션을 tmux 윈도우에서 병렬 관리. 메인 세션이 오케스트레이션
• 현재 실행 세션: hermes-miniapp (1 window, 2026-04-16 생성)
• surface 구조 (cmux-map.md 기준):

surface	모델	역할
1	Claude Opus 4.6 1M	메인 감독 / 오케스트레이션 전용
2~3	Claude Opus 4.6	구현·검토·교차검증 평가자
4~7	GPT-5.4 (codex-proxy 경유)	코드 구현·수정·실측

• 병렬 상한: 동시 6개 작업 (surface:1 제외)
• 결과 저장: ~/knowledge-agent/cowork/<topic>/
• 스킬: ~/.claude/skills/cmux-orchestrator/
• 배분 스크립트: ~/.claude/skills/cmux-orchestrator/scripts/cmux-dispatch.sh

2.3 cowork 큐 시스템

• daemon: com.openclaw.cowork-daemon → ~/.hermes/workspace/scripts/cowork_daemon.py --loop
• worker: com.openclaw.agent-queue-cowork → agent_queue_worker.py --agent cowork
• 역할: 장기 자율 작업 큐. 에이전트 배분 작업을 큐에 쌓고 daemon이 순차 처리
• 작업 디렉토리: ~/.hermes/workspace

2.4 Hermes Gateway (:18789)

• launchd: ai.hermes.gateway → ~/.hermes/bin/hermes-gateway-launchd.sh
• 작업 디렉토리: ~/.hermes/hermes-agent
• 로그: ~/.hermes/logs/gateway.log
• 역할: 텔레그램 webhook 수신 + cron_ticker + 플랫폼 어댑터 (분석가 4종 라우팅)
• KeepAlive: 비정상 종료 시 자동 재시작

2.5 웹앱 / 미니앱

서비스	포트	launchd	역할
sihwang-webapp	8080	com.openclaw.sihwang-webapp	메인 웹앱 (투자 브리핑/모니터)
telegram-miniapp	9119	com.hermes.telegram-miniapp	텔레그램 미니앱 웹서버
agentfirm-dashboard	4499	com.ron.agentfirm-dashboard	에이전트팜 대시보드
미확인 서비스	19825	미확인	node 프로세스 (실측)

• 외부 접속: Cloudflare Tunnel (com.openclaw.cf-tunnel) → localhost:8080 → virtual-insanity.net (임시 URL, 터널 시작 시 생성)
• Hermes 대시보드: 별도 포트 3344는 현재 미확인 (실측 LISTEN 목록에 없음)

3. launchd 서비스 카탈로그

핵심 활성 서비스

서비스 라벨	역할
ai.hermes.gateway	Hermes 게이트웨이 메인 (텔레그램+크론+라우팅)
com.openclaw.codex-proxy	ChatGPT→Codex API 프록시 :19080
com.openclaw.telegram-bridge	텔레그램 브릿지
com.hermes.telegram-miniapp	텔레그램 미니앱 웹서버 :9119
com.openclaw.sihwang-webapp	투자 브리핑 웹앱 :8080
com.openclaw.cf-tunnel	Cloudflare 터널 (외부 접속용)
com.openclaw.cowork-daemon	장기 작업 큐 daemon
com.openclaw.agent-queue-cowork	cowork 에이전트 큐 워커
com.openclaw.agent-queue-ron	ron 에이전트 큐 워커
com.openclaw.agent-queue-codex	codex 에이전트 큐 워커
com.openclaw.analyst-fundamental	기본분석 파이프라인
com.openclaw.analyst-macro	매크로분석 파이프라인
com.openclaw.analyst-pm	PM 분석 파이프라인
com.openclaw.analyst-technical	기술분석 파이프라인
com.openclaw.morning-briefing-telegram	모닝 브리핑 크론
com.openclaw.weekly-briefing-telegram	주간 브리핑 크론
com.openclaw.hermes-tailer	Hermes 로그 테일러
com.openclaw.orchestrator-loop	오케스트레이터 루프
com.openclaw.ron-orchestrator	Ron 오케스트레이터
com.openclaw.auto-dispatcher	자동 배분기
com.openclaw.inbox-triage	인박스 트리아지
com.openclaw.dispatch-watcher	배분 감시
com.openclaw.vault-watcher (com.ron)	볼트 변경 감시
com.ron.pipeline-orchestrator	파이프라인 오케스트레이터
com.ron.agentfirm-dashboard	에이전트팜 대시보드 :4499
com.ron.agentfirm-launcher	에이전트팜 런처
com.ron.colima-socket-bridge	Colima Docker 소켓 브릿지
com.openclaw.otel-collector	OpenTelemetry 수집기
ai.openclaw.companion	컴패니언 에이전트
ai.openclaw.memory-guardian	메모리 가디언
ai.openclaw.staged-boot	단계별 부팅
com.claude-to-im.bridge-codex	Claude→IM 브릿지 (Codex)

비활성/백업

• ai.hermes.bond-answer-listener.plist.disabled-20260420 — 채권 답변 리스너 (비활성)
• ai.openclaw.cmux-safe-restart.plist.disabled — cmux 안전 재시작 (비활성)
• 다수 .bak-* 파일 — 이전 설정 백업

4. 외부 API 의존성

API	용도	인증 방식
Anthropic Claude	Claude 모델 (Opus/Sonnet/Haiku)	ANTHROPIC_API_KEY
OpenAI/Codex	ChatGPT Plus Codex (프록시 경유)	codex-proxy 세션 쿠키
Gmail / Google Drive / Google Calendar	채권 뉴스레터 수집, 문서 관리, 일정	OAuth2 (MCP 서버 경유)
Telegram Bot API	봇 3종 (@openclaw_harybot, @ronclawBot, @RONforMAC_Bot)	TELEGRAM_BOT_TOKEN_*
DART	국내 공시 조회	DART_API_KEY (확인됨)
KIS OpenAPI	국내 주식/해외선물 실시간 시세	KIS 계좌 키 쌍
yfinance	선물 커브·ETF 데이터	무인증
Cloudflare Tunnel	외부 접속 (virtual-insanity.net)	cloudflared 바이너리

5. 웹앱 접속 경로

URL	역할
http://localhost:8080	메인 투자 브리핑 웹앱 (로컬)
https://virtual-insanity.net/*	위 웹앱 외부 접속 (CF 터널, 동적 URL)
http://localhost:9119	텔레그램 미니앱 웹서버
http://localhost:4499	에이전트팜 대시보드
http://localhost:3344	Hermes 대시보드 (plist 존재하나 현재 미실행)
http://localhost:19080	codex-proxy OpenAI-compatible API

6. 인수인계 체크리스트

• [ ] ~/chatgpt-codex-proxy 레포 클론 + npm install && npm run build
• [ ] com.openclaw.codex-proxy.plist 복사 → launchctl load
• [ ] ChatGPT Plus 계정으로 npm run login 실행 (세션 쿠키 발급)
• [ ] ~/.hermes/.env 복원: DART_API_KEY, TELEGRAM_BOT_TOKEN_*, KIS 키 등
• [ ] ai.hermes.gateway.plist 복사 → launchctl load
• [ ] 텔레그램 봇 3종 토큰 환경변수 설정
• [ ] Gmail/Google OAuth 재인증 (MCP 서버 사용)
• [ ] Cloudflare 터널 계정 및 com.openclaw.cf-tunnel.plist 설정
• [ ] cmux 세션 세팅: cmux new-session 후 surface 1~7 구성
• [ ] Colima 실행 후 com.ron.colima-socket-bridge 로드
• [ ] 웹앱 의존성: ~/.hermes/workspace/scripts/pipeline/ Python 패키지 설치