서브에이전트 풀로 실현하는 / 병렬 코딩 아키텍처 마스터 가이드
OpenClaw 는 최대 8 개의 서브에이전트를 동시에 격리 생성하여 병렬 실행을 가능하게 하며, 오케스트레이터가 작업을 동적으로 분해하고 결과를 자동 합성함으로써 단일 개발자의 인지 부담을 체계적으로 분산시킨다. 각 에이전트는 독립적 네임스페이스에서 실행되어 파일 경합 조건을 원천 차단하며, ACP 채널바인딩을 통해 작업 결과를 안정적으로 라우팅한다.
이 글의 핵심 주장과 근거
병렬 코딩을 위한 서브에이전트 풀 아키텍처의 핵심 원리
OpenClaw 의 서브에이전트 풀은 sessions_spawn 명령어를 통해 하나의 부모 세션에서 최대 8 개의 서브에이전트를 동시에 배경 세션에 격리 생성하는 메커니즘이다. 각 서브에이전트는 agent:<agentId>:subagent:<uuid> 형식의 독립적 네임스페이스에서 실행되어 부모 세션의 LLM 컨텍스트와 물리적으로 완전히 분리된다. 이 격리 구조는 서로 다른 서브에이전트가 동일한 파일을 동시에 수정하는 경합 조건을 원천 차단하며, 각 작업마다 독립된 메모리와 고정된 CPU 할당량을 부여함으로써 병렬 실행을 안정적으로 가능하게 한다.
FanOut/FanIn 2 단계 실행 체계의 작동 방식
이 아키텍처는 오케스트레이터가 작업을 동적으로 분해하여 다수의 서브에이전트에게 동시에 위임하는 Fan-Out 단계와, 각 서브에이전트의 작업 결과를 자동 취합하여 최종 출력으로 합성하는 Fan-In 단계로 구성된다. 중앙 조정자는 원본 작업을 수신한 뒤 하위 작업 목록을 사전에 고정하지 않고 입력의 성격에 따라 실시간으로 최적의 분해 방식을 판단하여 각 서브에이전트에게 역할별 태스크를 위임한다. 리프 작업은 절대 수행하지 않으며 위임과 종합만 담당하는 오케스트레이터는 동적 태스크 분해를 통해 유연한 워크플로우를 제공한다.
결함 격리와 ACP 채널바인딩을 통한 안정성 보장
개별 서브에이전트의 실패나 비정상 출력이 전체 시스템에 파급되지 않도록 각 에이전트의 실행 영역을 독립적 네임스페이스에서 격리 실행하는 설계 원칙이 적용된다. 실패 시 자동 재배치 및 복구 메커니즘이 동작하여 무중단 서비스를 보장하며, 서브에이전트의 격리된 작업 결과를 8 단계 우선순위 체계를 통해 결정적으로 부모의 채팅 채널로 라우팅한다. ACP 바인딩 라우팅은 동일 채널 우선 매칭부터 부모 채널, 길드 및 역할, 팀 단위 기본값, 폴백 기본값까지 계층적으로 메시지를 전달하여 모든 작업 결과의 정합성과 전달 정확성을 구조적으로 보장한다. > 이 주제의 전체 맥락 방향성은 **바이브코딩에서 오픈클로까지** 원본 글에 세밀하게 정리되어 있습니다. 더 깊게 탐구하고 싶다면 관련 내부 대표 문서(Pillar/Entity)를 참조하세요.