brief

OpenClaw CLI 오케스트레이션 아키텍처와 AI 에이전트 팀링크 메커니즘

핵심 요약

OpenClaw는 마크다운으로 선언적 오케스트레이션을 정의하고, YAML 설정을 통해 여러 격리된 서브에이전트를 관리하며 ACP 하네시를 via sessions_spawn 로 통합한다. 또한 메모리와 heartbeat 메커니즘으로 지속적인 맥락을 유지한다.

이 글의 핵심 주장과 근거

핵심 주장

하트비트 시퀀스 번호의 단조 증가 검증은 누락 감지 시 연결을 즉시 재설정하여 세션 분열 발생 가능성을 실시간 차단한다

출처: [1] OpenClaw CLI Getting Started

핵심 주장

OpenClaw 의 하트비트 메커니즘은 HEARTBEAT.md 에 정의된 태스크를 2-4 회/일 순환하며 실행하는 반면, 크론 스케줄링은 정확한 시간 제어와 세션 격리가 필요한 작업에 사용됨

직접 근거: [1] ZeroInput 직접 경험 (OpenClaw Runtime Architecture Documentation)

OpenClaw 아키텍처의 핵심 구조

OpenClaw는 전적으로 마크다운 파일을 이용해 오케스트레이션을 정의한다. 이 마크다운은 에이전트 팀 구성을 선언하며, workspace 디렉터리 안에 SOUL.md와 USER.md 로 정체성과 대상 정보를 저장한다. Gateway 데몬은 모든 세션과 cron 작업을 관리하는 중앙 허브 역할을 하며, memory 시스템은 daily notes와 MEMORY.md 를 통해 세션 재시작 후에도 이전 결정을 기억한다. 이러한 구조는 선언적이며 코드 없이도 복잡한 멀티‑에이전트 워크플로우를 설계할 수 있게 한다.

YAML 기반 에이전트 팀 선언과 라우팅 메커니즘

Agent Teams는 YAML 파일을 통해 workspace, 인증 프로파일, 채널 바인딩을 명시적으로 설정한다. 이 YAML 은 multi‑agent routing 시스템에 전달되어 사용자 요청을 Pi, Claude Code, Codex, Cursor 등 다양한 ACP 하네시 중 하나로 라우팅한다. 특히 thread‑bound 요청은 Discord 스레드에 연결된 지속적인 세션으로 자동 전환되며, 필요 시 sessions_spawn(runtime: 'acp') 로 격리된 서브에이전트를 생성한다. 이렇게 함으로써 개발자는 각 에이전트의 역할과 자원을 명시적으로 분리하고, 전체 흐름을 한 눈에 파악할 수 있다.

서브에이전트와 메모리 연속성의 시너지

sessions_spawn 으로 생성된 서브에이gent는 자동으로 부모 워크스페이스 디렉터리를 상속받아 코드와 데이터 접근성을 보장한다. 동시에 memory 시스템은 daily notes 파일과 장기 MEMORY.md 를 활용해 과거 대화, 결정, 학습된 통찰을 기록한다. 매 일정 간격의 heartbeat 체크에서는 이 메모리들을 검토하고 중요한 정보를 MEMORY.md 로 요약해 업데이트한다. 이러한 메커니즘은 에이gent가 지속적인 맥락을 유지하면서도 격리된 환경에서 안전하게 동작하도록 지원한다.