OpenClaw CLI 오케스트레이션 아키텍처와 AI 에이전트 팀링크 메커니즘 심층 분석
OpenClaw는 SOUL.md, USER.md, MEMORY.md, AGENTS.md 등 마크다운 파일을 활용하여 AI 에이전트의 정체성·대상·메모리 연속성을 선언적으로 정의하고, AGENTS.md에서 모든 에이전트·스킬·도구를 전역 등록하여 워크스페이스 단위의 통합 관리 체계를 구축한다. 이 구조는 코드 작성 대신 파일 편집으로 팀 구성을 가능하게 하며, 버전 관리와 가독성을 핵심 장점으로 제공한다.
이 글의 핵심 주장과 근거
OpenClaw 아키텍처 개요 및 핵심 개념
OpenClaw는 마크다운 파일을 기반으로 한 선언적 오케스트레이션을 통해 AI 에이전트 팀을 구성하는 구조를 제공한다. 이 아키텍처는 워크스페이스, SOUL.md, USER.md, MEMORY.md 등을 포함하며, 각 파일은 에이gent의 정체성, 대상, 메모리 연속성을 정의한다. 특히 AGENTS.md는 모든 에이전트와 스킬, 도구를 명시적으로 등록하여 전역적인 관리 대상을 형성한다. 이러한 설계로 개발자는 코드 대신 파일을 작성함으로써 팀 구성을 가독성 있게 그리고 버전 관리를 가능하게 만든다.
YAML 선언적 구성과 에이전트 팀 설정
YAML을 활용한 선언적 구성은 workspace, auth profile, channel binding 등 필요한 요소들을 한 파일에 명시할 수 있게 한다. 이를 통해 여러 격리된 AI 에이전트를 하나의 Gateway에서 동시에 실행할 수 있으며, 각 에이전트는 독립된 권한과 채널 설정을 유지한다. 또한 YAML 파일은 버전 관리하기 쉬워 팀 기반 개발 프로세스와 완벽히 부합한다.
ACP 하네시와 서브에이전트 실행 메커니즘
OpenClaw는 sessions_spawn(runtime: 'acp')를 통해 Codex, Claude Code, Pi 등 다양한 ACP 하네시를 통합하여 실행한다. Discord에서는 기본적으로 thread‑bound persistent 세션으로 라우팅되어 사용자의 요청을 적절한 에이전트로 자동 전환한다. 서브에이전트는 부모 워크스페이스 디렉토리를 자동 상속받아 코드와 설정 파일을 그대로 사용할 수 있으며, 격리된 실행 환경을 보장한다.
메모리와 주기적 작업 관리
Daily notes(memory/YYYY-MM-DD.md)와 장기 메모리(MEMORY.md)는 세션 재시작 후에도 이전 작업과 결정을 기억하도록 한다. Gateway의 Cron 작업은 이메일, 캘린더, 날씨 확인 등을 주기적으로 수행하며, Heartbeat 메카니즘은 여러 체크를 한 번에 배치해 API 호출을 최소화한다. 이러한 시스템은 자동화된 프로액티브 모니터링을 가능하게 한다.