Oz: Multiagent

디지털 인포서 및 멀티 플랫폼 에이전트 오케스트레이션 네트워크

[이메일 인터페이스: oz@franzdomingo.dev] • [비공개 저장소]

---

개요

• 역할: 개발자, 배포자 및 핵심 시스템 아키텍트
• 스택: Node.js v22.22.2, OpenClaw v2026.6.5, DeepSeek V4 Flash, SQLite (Claude-Mem v13.4.0), Google Cloud VPS (Ubuntu 22.04 LTS), Telegram, Discord, WhatsApp, iCloud SMTP/IMAP
• 핵심 결과: FTS5 영구 메모리, 21개의 커스텀 스킬, 24개의 활성 cron 오케스트레이션 작업을 갖춘 완전 자동화된 멀티 에이전트 워크스페이스
• 요약: 전용 Google Cloud VPS에서 실행되는 자율형 멀티 에이전트 네트워크를 설계하고 배포했습니다. 이 시스템은 통합된 디지털 실행기 역할을 하며, 여러 채팅 게이트웨이(텔레그램, 디스코드, 왓츠앱, 이메일)의 통신을 세션 간 영구 메모리를 갖춘 단일 Obsidian 기반 인지 코어로 라우팅합니다. 또한 Oz는 분산 워크플로우를 조정하기 위해 제 Hermes Agent 프로젝트와 직접 통신하도록 구성되어 있습니다.

---

문제점

• 과제:
  • 멀티 채널 파편화: 여러 통신 채널에 분산된 다른 정보 스트림 관리.
  • 고속 자율 실행: 백업, 이메일 발송, 시스템 업데이트 및 보관소 감사의 지속적이고 예약된 실행 필요.
  • 세션 기억 상실: 기존 LLM 에이전트는 영구 메모리가 부족하여 며칠 또는 몇 주에 걸쳐 다중 턴 연속성이 저하됨.
  • Obsidian 보관소 복잡성: 230개 이상의 파일로 구성된 Obsidian 보관소의 구조적 일관성, 스키마 형식 및 노트 라우팅 유지.
  • 보안 취약점: 공개 메시징 게이트웨이의 높은 위협 프로파일에 따른 엄격한 프롬프트 인젝션 방어 및 액세스 제어 필요.
• 대상 사용자: 개인 생산성 워크스페이스, 지식 베이스 어시스턴트 및 자동화 시스템 운영자.
• 제약 조건:
  • 검색 엔진 API 제한: 검색 API 키가 허용되지 않아 커스텀 멀티 검색 엔진 스크래핑 추상화 레이어로의 포백 강제.
  • VPS 제한: 스왑이 없는 4-vCPU / 15GB RAM Google Cloud VPS에 배포되어 세심한 메모리 관리 요구.
  • 인증 차단: 인증되지 않은 클라이언트 환경으로 인해 모든 GitHub 작업이 SSH 키 인증으로 제한됨.
  • 데이터 저장: 분산된 외부 데이터베이스 대신 로컬 플랫 파일(Markdown, JSON, SQLite)로 제한.

---

접근 방식 및 결정

• 접근 방식: Oz가 기본 오케스트레이터 역할을 하며, 작업 복잡성에 따라 수신 작업을 역할 기반의 전문 서브 에이전트로 동적으로 라우팅하는 중앙 집중식 디스패처 패턴.
• 주요 결정:
  • Claude-Mem 통합: SQLite + FTS5 데이터베이스를 구현하여 세션 간 컨텍스트를 실행 중인 활성 에이전트에 자동으로 삽입.
  • Obsidian 우선 저장: 시각화, 이식성 및 수동 그래프 분석의 용이성을 위해 플랫 Markdown 파일 선택.
  • 멀티 모델 폴백 체인: 경제적인 메인 엔진으로 DeepSeek V4 Flash를 설정하고, 가동 시간을 유지하기 위해 Google Gemini 및 Grok 모델로의 폴백 경로 마련.
• 절충점:
  • 폴링 vs 웹훅: cron 기반의 이메일 확인 및 킵얼라이브(OpenClaw 게이트웨이에서 무료이며 설정 불필요)를 채택했으나, 이로 인해 이메일 확인에 최대 8시간의 지연 시간이 도입됨.
  • 플랫 파일 지식 베이스: Markdown과 SQLite는 인프라 관리 부담을 줄여주지만, 본격적인 벡터 데이터베이스에 비해 실시간 다중 노드 쿼리 집계가 제한됨.

---

핵심 결과 및 영향

• 결과: 일일 자동 커밋, 이메일 처리, 백그라운드 자동화 및 노트 아카이브를 처리하는 자율 실행기를 성공적으로 가동.
• 비교: 수동으로 업데이트되는 저널, 복잡한 멀티 앱 스크래핑, 단절된 채팅방들을 단일의 영구적이고 지능적인 워크스페이스 어시스턴트로 대체.
• 영향: 주 모델에 장애가 발생하더라도 지속적인 서비스를 보장하는 폴백 기능을 갖춘 견고한 자동화 운영을 달성.

핵심 지표

---

기술적 심층 분석

• 주요 세부 사항:
  • imap-smtp-email: iCloud SMTP를 필수 CC 체인 라우팅(oz@franzdomingo.dev → CC 목록)과 통합하여 Node.js 헬퍼 스크립트를 통해 실행.
  • multi-search-engine: 활성 API 키 없이 16개의 검색 엔진(글로벌 및 로컬)을 애그리게이션.
  • self-improving-agent: 경험을 .learnings/ 디렉토리에 직접 저장하여 향후 실행 매개변수를 형성함으로써 학습의 영속성을 지원.
  • prompt-injection-guard: 실시간 메시지 분류, 비밀번호 해시 유효성 검사 및 스푸핑 감지.
• 검증: 독립형 및 세션 바인딩형 에이전트 턴, 자동 Git 커밋, 주기적인 텔레그램 로그 브로드캐스트를 통해 모니터링.
• 최적화: 비용 효율적인 라우팅을 구현하여 단순 작업은 저비용 모델로 전송하고, 프리미엄 추론 모델은 다단계 추론 작업을 위해 예약.

---

회고

• 개선점: 예약된 폴링에만 의존하는 대신 일부 폴링 작업을 웹훅 통합으로 마이그레이션하여 입력(이메일 업데이트 등)의 지연 시간을 줄이는 방법 고려.
• 성공 요인: 중앙 집중식 디스패처 패턴이 매우 안정적인 것으로 입증되어 전문화된 워크플로우(문장 작성, 검색, 코드 작성)를 전용의 깨끗한 서브 에이전트 환경으로 격리하는 데 성공.
• 교훈: 플랫 파일 구조는 중소규모(~200개 이상의 노트)에서 매우 이식성이 높고 효율적이지만, 보관소가 1,000개 이상의 노트에 가까워짐에 따라 인덱싱 및 검색을 위해 구조화된 데이터베이스 캐싱으로의 마이그레이션이 필요함.

---

나의 기여

• 시스템 아키텍처 및 배포: Google Cloud에 Node.js/OpenClaw 런타임을 구성 및 배포하고 SSH 액세스 설정, VPS 프로세스 관리 및 커스텀 systemd 바인딩 처리.
• 스킬 엔지니어링: 21개 스킬의 워크스페이스 라이브러리를 바닥부터 개발하고 iCloud 이메일 릴레이, 키리스 검색 스크래퍼, PDF 유틸리티 및 메모리 주입 데이터베이스 구현.
• 보안 및 무결성 디자인: 노출된 공개 엔드포인트(텔레그램 봇, 디스코드 길드) 전반의 액세스 보안을 유지하는 Prompt Injection Guard 하위 시스템 구축.
• 자동화 파이프라인 디자인: 매일 백업, 코드 동기화 및 헬스 하트비트를 실행하는 24개 작업의 cron 러너 스케줄러 설정.

프로젝트 아키텍처

시스템은 중앙 집중식 디스패처 패턴을 사용하여 3개의 기본 운영 레이어를 통해 입력을 라우팅하고 실행합니다.

Oz 메인 디스패처 — 단일 결정 포인트. 수신 페이로드 복잡성(단순=0 디스패치, 복잡=1-2, 울트라=5+)을 평가하고 적절한 전문가에게 위임. 깊이 제한 유지: 사용자 개입 없이 연속 5회를 초과하는 도구 호출을 수행하지 않음.

보관소 트라이어드 — 3개의 전문 에이전트가 Obsidian 보관소 라이프사이클을 소유:

• Librarian (사서) — 보관소 인덱스, 검색 및 검색 파이프라인 소유. Oz가 직접 grep하지 않으며, Librarian이 경로를 확인한 후 Oz가 출력을 처리. 자체 일일 아카이브 cron 실행.
• Writer (작가) — 산문, 보고서 및 문서 파일 포맷팅 전문. Hemingway, Orwell, Strunk & White, King 스타일 학습. 문법, 레지스터 선택 및 "말하지 말고 보여주기(show-not-tell)" 강제 적용. 보관소에 기록되는 모든 콘텐츠 생성.
• Keeper (지기) — 메타데이터 템플릿, 프론트매터 준수 및 오래된 아카이브 처리. 3일마다 유지 관리 cron 실행. 노트 및 디렉토리 전반에 걸쳐 확장성이 뛰어난 보관소 구조 강제.

Claude-Mem 엔진 — 로컬호스트 SQLite(FTS5, systemd 관리)에 직접 연결하여 검색 임베딩을 가져오고 세션 간 기록을 LLM 프롬프트에 주입. 과도한 부하를 방지하기 위해 컨텍스트 요청을 60초 동안 캐싱. 서킷 브레이커: 3회 연속 실패 = 30초 대기 시간. 제외된 에이전트(coder, math-solver, front-end-developer, multimedia-specialist)는 curl 엔드포인트를 통해 수동으로 쿼리해야 함. 수동 브라우징을 위해 프라이빗 Web UI 제공. 이 메커니즘을 통해 총 토큰 사용량이 크게 감소함.

워커 서브 에이전트 풀 (14개의 명명된 전문가 + Oz) — 네트워크 전반의 모든 에이전트는 Claude Code, Gemini CLI 및 Antigravity에 대한 액세스 권한을 가지며, 각각 다음과 같은 빌트인 스킬을 갖춤:

• Researcher (연구원) → 보관소 우선 파이프라인: Librarian → Gemini CLI → web_search → web_fetch
• Coder (프로그래머) → 다중 파일 코딩, 디버깅, 모든 복잡한 스크립트
• Messenger (메신저) → 모든 외부 통신 (필수 CC 체인이 포함된 이메일, 디스코드, 텔레그램)
• Math-solver (수학 해결사) → 예외 없이 모든 수학 문제 (엄격한 에지 케이스 검사)
• Front-end-developer (프론트엔드 개발자) → React/UI via DeepSeek-backed Claude Code + 21st.dev MCP
• Multimedia-specialist (멀티미디어 전문가) → PDF/Word/Excel/PPT/휴먼화 (nano-pdf + python-docx + openpyxl)
• Prompt-engineer / Prompt-injection-guard → 프롬프트 아키텍처 + 보안 스캐닝
• PM / Infra-engineer / QA-engineer / Data-engineer / SRE-watchdog / Tech-writer → 조직 규모의 역할

채널 게이트웨이 — 4개 활성화(텔레그램: 3개 그룹, 디스코드: 1개 멘션 제한 길드, 왓츠앱: 오픈 DM, WebChat), 2개 비활성화(Signal, SMS). 이메일은 게이트웨이가 아닌 외부 스킬(iCloud SMTP)로 작동.

리소스 범위: 4 vCPUs, 15GB RAM, 49GB 디스크 (63% 사용됨), Node v22.22.2, GCP 상의 Ubuntu 22.04 LTS. 24개 cron 작업 예약됨.

---

호스팅 및 운영 관련 참고 사항:
Oz는 Google Cloud Platform에서 활발히 호스팅되고 있으며 개발자용 MacBook Air에서 로컬로 실행됩니다. 기본 코드베이스와 저장소는 비공개로 유지됩니다.