brief

서브에이전트 풀이 동시성 한계를 극복하는 / 병렬 실행 아키텍처

핵심 요약

OpenClaw는 execFileAsync/spawn 이중 실행 모드를 통해 3~5개 서브에이전트를 동시에 병렬 실행하며, ACP 8단계 채널바인딩(CID 등록·우선순위 라우팅·dmScope 격리)과 적응형 풀 관리로 동시성 한계를 극복한다. 세션별 쓰기 직렬화와 전역 작업 제한으로 동시성을 제어하고, Fan-Out/Fan-In 패턴으로 결함 격리 체계가 실패한 에이전트를 독립 네임스페이스에서 격리하여 메인 대화를 차단하지 않는다.

서브에이전트의 별도 세션 격리 실행 구조

OpenClaw의 서브에이전트는 메인 에이전트와 완전히 격리된 별도 세션에서 실행되며, 각 서브에이전트는 agent:<agentId>:subagent:<uuid> 형식의 고유 식별자를 부여받는다. 이 격리된 실행 환경은 하나의 서브에이전트가 실패하거나 지연되더라도 다른 에이전트나 메인 인터페이스에 영향을 미치지 않도록 보장한다. ACP Harness는 서브에이전트를 프로세스 단위로 격리 실행하며, ContextEngine 채널 바인딩과 ACP 프로토콜 통신 추상화의 이중 구조를 통해 결함 격리의 안전망을 형성한다. 서브에이전트는 작업을 완료한 후 결과를 채팅 채널에 발표하여 메인 에이전트와 상태를 동기화한다.

execFileAsync/spawn 이중 실행 모드의 비차단 병렬 실행

OpenClaw는 execFileAsync와 spawn이라는 두 가지 실행 모드를 제공하여 다양한 병렬 실행 시나리오를 지원한다. execFileAsync는 V8 이벤트 루프 기반의 비동기 실행 방식으로 shell: false 설정으로 OS 명령어 주입을 원천 차단하고, 비동기 방식으로 V8 이벤트 루프를 차단하지 않는 이중 안전망 구조를 갖는다. spawn 모드는 각 서브에이전트를 독립 프로세스로 생성하여 LMStudio 스트림 출력과 에이전트별 출력 격리를 가능하게 한다. 이 이중 실행 모드를 통해 3~5개 서브에이전트를 동시에 병렬 실행하며, 실패 시 자동 복구(PipelineRetry) 메커니즘이 작동하여 시스템의 안정성을 보장한다.

ACP 8단계 채널바인딩과 적응형 동시성 관리

ACP 8단계 채널바인딩은 CID 등록에서 시작하여 우선순위 라우팅, dmScope 격리, 종료 바인딩에 이르는 폐곡선 구조로 다중 에이전트 환경에서 세션 분열을 방지한다. 8단계 우선순위 라우팅은 세션 내 모든 메시지를 결정적으로 라우팅하여 세션 응집력을 보장한다. 서브에이전트 풀은 시스템 부하를 실시간으로 감지하여 동시 실행 에이전트 수를 동적으로 분배하는 적응형 풀 관리를 지원하며, 동적 스로틀링 메커니즘은 풀 레벨에서 동시 실행 수를 조절하여 시스템 부하 초과 시 신규 에이전트 생성을 억제하고 큐 overflow를 방지한다. 세션별 쓰기 직렬화는 동일한 리소스에 대한 동시 접근을 순차적으로 처리하여 데이터 무결성을 보장한다.

Fan-Out/Fan-In 패턴과 결함 격리 체계

Fan-Out/Fan-In 패턴에서 Fan-Out 단계는 하나의 오케스트레이터가 여러 서브에이전트를 동시에 생성하여 작업을 분산시키는 분산형 실행 구조를 취한다. Fan-In 단계에서는 분산 실행된 각 서브에이전트의 결과를 수집·합성하여 최종 결과를 도출하는 환류 구조가 작동한다. 결함 격리 체계는 실패한 에이전트가 독립 네임스페이스에서 격리되어 다른 에이전트나 메인 프로세스에 영향을 주지 않는 등급 격리 구조를 채택한다. 이러한 Fan-Out/Fan-In 패턴과 결함 격리의 결합은 다중 에이전트 환경에서의 확장성과 안전성을 동시에 달성하는 핵심 설계 원리이다. > 이 주제의 전체 맥락 방향성은 **바이브코딩에서 오픈클로까지** 원본 글에 세밀하게 정리되어 있습니다. 더 깊게 탐구하고 싶다면 관련 내부 대표 문서(Pillar/Entity)를 참조하세요.

자주 묻는 질문

서브에이전트가 실패하거나 지연되면 메인 대화에 어떤 영향이 있나요?

서브에이전트는 별도 세션과 독립 네임스페이스에서 격리되어 실행되므로, 실패나 지연이 발생하더라도 메인 대화에는 영향을 미치지 않습니다. 메인 세션은 계속 작동하며 다른 작업을 처리할 수 있습니다. 결함 격리 체계가 실패한 에이전트를 격리하여 다른 에이전트나 메인 프로세스에 연쇄적 장애가 확산되지 않도록 보장합니다.

동시에 몇 개의 서브에이전트를 실행할 수 있나요?

OpenClaw는 execFileAsync/spawn 이중 실행 모드를 통해 3~5개 서브에이전트를 동시에 병렬 실행할 수 있습니다. 전역 작업 제한과 적응형 풀 관리를 통해 시스템 부하를 실시간으로 감지하여 동시 실행 수를 동적으로 조절하므로, 시스템 과부하를 방지하면서도 최대 병렬 처리를 가능하게 합니다.

서브에이전트의 결과는 어떻게 확인하나요?

서브에이전트는 작업을 완료한 후 결과를 채팅 채널에 발표합니다. ACP 8단계 채널바인딩이 세션 응집력을 보장하면서 결과를 메인 에이전트에게 전달하므로, 사용자와 메인 에이전트는 서브에이전트의 실행 상태와 결과를 실시간으로 확인할 수 있습니다.

여러 서브에이전트가 같은 리소스에 접근할 때 충돌은 어떻게 방지하나요?

세션별 쓰기 직렬화를 통해 동일한 리소스에 대한 동시 접근을 순차적으로 처리하여 데이터 무결성을 보장합니다. 동적 스로틀링 메커니즘이 풀 레벨에서 동시 실행 수를 조절하여 시스템 부하 초과 시 신규 에이전트 생성을 억제하고, ACP 8단계 우선순위 라우팅이 메시지를 결정적으로 라우팅하여 충돌을 예방하는 핵심 메커니즘입니다.

execFileAsync와 spawn 모드는 어떤 상황에서 각각 사용하나요?

execFileAsync는 V8 이벤트 루프 기반 비동기 실행으로 OS 명령어 주입을 원천 차단하는 안전한 실행이 필요할 때 사용되며, spawn은 각 서브에이전트를 독립 프로세스로 생성하여 LMStudio 스트림 출력과 에이전트별 출력 격리가 필요할 때 사용됩니다. 두 모드는 ACP 채널바인딩을 통해 통합된 결함 격리 체계를 공유합니다.