entity

OpenClaw의 서브에이전트 격리 실행 모델과 바이브코딩 워크플로우

핵심 요약

OpenClaw ACP Harness는 sessions_spawn으로 서브에이전트를 독립 프로세스로 격리 실행하는 런타임 엔진으로, 채널바인딩의 8단계 우선순위 라우팅과 4단계 세션 수명주기(Spawn→Run→Pause/Resume→Terminate)를 핵심 구조로 한다. 프로세스 격리와 Stateless 설계를 통해 8개 동시 병렬 서브에이전트 실행에서도 하나의 실패가 나머지에 영향을 주지 않으며, 바이브코딩 워크플로우의 완전한 자율성과 연속성을 구조적으로 보장한다.

이 글의 핵심 주장과 근거

핵심 주장

Fan-Out 단계에서 8개의 서브에이전트가 동시에 병렬 생성되더라도 프로세스 격리 덕분에 하나가 실패하더라도 나머지 7개 작업은 정상 진행되며, Fan-In 단계에서 성공·실패 결과가 모두 부모 채널로 자동 라우팅되어 개발자 개입 없이 다중 에이전트 동시 실행의 안전성을 구조적으로 보장한다.

출처: [1] OpenClaw Architecture Deep Dive

ACP Harness의 런타임 아키텍처와 격리 실행의 핵심 원리

ACP Harness는 OpenClaw의 런타임 엔진으로, sessions_spawn을 통해 각 서브에이전트를 격리된 프로세스 환경에서 실행하는 핵심 인프라 역할을 한다. agent:<agentId>:subagent:<uuid> 형식의 독립 네임스페이스가 생성되며, 각 서브에이전트는 pseudo-terminal 또는 OS 수준 샌드박스 환경에서 독립 프로세스로 실행된다. 이 구조는 부모 세션의 작업 디렉토리, 환경 변수, LLM 컨텍스트와 물리적으로 완전히 분리함을 의미한다. 각 서브에이전트는 ~/openclaw-agents/<name>/ 전용 디렉토리 수준에서 독립적 파일 시스템 영역을 보유하여 파일 수준 분리를 실현하며, 이로 인해 두 개 이상의 에이전트가 동일한 파일이나 패키지를 동시에 수정할 때 발생하는 경합 상태를 프로세스 격리 수준에서 원천 차단한다. ACP Harness의 격리 모델은 Discord와 같은 공유 채팅 환경에서도 안정적으로 동작한다. thread: true 옵션을 사용하여 스레드 바운드 지속적 세션을 생성함으로써 인간 사용자와의 자연스러운 상호작용을 유지하면서도 내부 에이전트 오케스트레이션은 완전히 격리된다. 메모리 파일 접근 권한도 제한되며, 각 서브에이전트는 명시적으로 전달된 워크스페이스 디렉토리만 접근할 수 있어 데이터 유출 위험을 최소화한다. 이러한 다층적 격리 구조는 바이브코딩 워크플로우에서 여러 에이전트가 동시에 다양한 작업을 수행하더라도 서로의 실행 환경에 영향을 주지 않는 안전한 병렬 처리를 가능하게 한다.

ACP 채널바인딩과 8단계 우선순위 라우팅 체계

ACP 채널바인딩은 channel:<id> 형식의 영구 식별자를 통해 ACP 세션을 특정 통신 채널에 연결하는 메시지 전달 인프라이다. 8단계 우선순위 체계는 동일 채널 우선→부모 채널→길드+역할→길드→팀→계정→채널 기본값→폴백 기본값 순서로 동작하며, 이 라우팅 구조는 LLM 토큰 비용이 전혀 발생하지 않는 결정적 메시지 경로를 설정한다. 다중 에이전트 간 메시지 전달의 예측 가능성이 구조적으로 보장되는 이유가 바로 여기에 있다. ACP 프로토콜은 메시지의 구조적 직렬화를 담당하고, 채널바인딩이 올바른 수신자에게의 전달을 담당하는 계층적 분리를 실현한다. 이 분리 덕분에 OpenClaw ACP, Codex, Claude 등 다양한 ACP 호환 에이전트를 혼용하더라도 통신 방식의 통일성을 유지하는 모듈성이 가능해진다. 특히 Fan-In 단계에서 성공과 실패 결과가 모두 부모 채널로 자동 라우팅되어 개발자의 개입 없이도 다중 에이전트 동시 실행의 안전성을 구조적으로 보장한다. 바이브코딩 워크플로우에서 각 서브에이전트가 독립적으로 생성·실행되고 결과를 부모 세션으로 푸시하는 이 과정에서, 채널바인딩의 결정적 라우팅이 메시지 전달의 신뢰성을 담보한다.

ACP 세션 수명주기와 Stateless 설계 원칙

ACP Harness의 세션 수명주기는 Spawn→Run→Pause/Resume→Terminate의 네 단계로 구성된다. Spawn 단계에서는 격리 프로세스가 생성되고 PTY가 할당되며 채널 바인딩이 등록된다. Run 단계에서 작업이 실행되며 stdout과 stderr가 채널을 통해 스트리밍된다. Pause/Resume 단계에서는 /tmp/openclaw/sessions/<id> 경로에 세션 상태가 저장되어 비정상 종료 시에도 복구가 가능하다. Terminate 단계에서는 SIGTERM으로 우아하게 종료되며, timeout이 설정된 경우 강제 종료된다. 모든 단계가 명시적 API로 관리되어 개발자가 세션의 상태를 정밀하게 제어할 수 있다. Stateless 설계 원칙은 각 서브에이전트가 자체 상태를 보유하지 않고 모든 컨텍스트를 태스크 프롬프트에 명시적으로 전달받아야 한다는 규칙이다. 이 원칙은 에이전트 간 의존성을 제거하여 부모 세션의 LLM 컨텍스트가 서브에이전트에 오염되는 컨텍스트 분열을 원천 차단한다. 바이브코딩 워크플로우에서 이는 각 서브에이전트가 어떤 상태에서 시작하든 항상 동일한 실행 결과를 보장받을 수 있음을 의미한다. 또한 deleteAfterRun=true 플래그가 적용된 세션은 작업 완료 후 프로세스가 종료되고 관련 파일 시스템이 자동 정리되어 고아 프로세스가 남지 않으며, Stateless Reconnect는 resumeSessionId를 통해 비정상 종료된 세션을 동일한 채널에서 재구성하여 메모리상의 컨텍스트를 복구 시점까지 유지한다.

Fan-Out/Fan-In 패턴과 바이브코딩 워크플로우의 자율성

Fan-Out/Fan-In 패턴은 오케스트레이터가 하나의 상위 작업을 여러 하위 작업으로 분해하여 다중 서브에이전트에게 동시 생성하고, 독립 네임스페이스에서 병렬 실행한 후 결과를 회수하는 다중 에이전트 실행 패턴이다. Fan-Out 단계에서 8개의 서브에이전트가 동시에 병렬 생성되더라도 프로세스 격리 덕분에 하나가 실패하더라도 나머지 7개 작업은 정상 진행되며, Fan-In 단계에서 성공과 실패 결과가 모두 부모 채널로 자동 라우팅된다. 바이브코딩 워크플로우는 OpenClaw의 ACP Harness가 제공하는 격리 실행 모델을 기반으로 완전한 자율성을 확보한다. sessions_spawn을 통해 생성된 서브에이전트는 복잡한 코딩 작업을 독립적으로 수행한 후 결과를 부모 세션으로 푸시하며, 이 과정에서 프로세스 격리와 채널바인딩이 실행의 안전성과 메시지 전달의 신뢰성을 동시에 보장한다. 또한 lightContext=true 옵션을 통해 관련 메모리 조각을 주입하여 항상 최신의 온보딩 노트를 반영한 상태에서 작업이 실행된다. 이러한 메커니즘이 결합되면 인간 개발자의 개입 없이도 복잡한 소프트웨어 프로젝트의 기획부터 실행까지 완전한 자동화가 가능하며, 각 반복 작업이 샌드박스 환경에서 격리되어 실행되므로 프로토타입의rapid prototyping과 안전한 테스트를 동시에 달성할 수 있다.

이 주제의 최종 원문 탐색하기

이 지식 허브의 가장 깊고 권위 있는 아키텍처 원문과 전체 맥락은 [여기에서 확인하실 수 있습니다](https://brunch.co.kr/@955079bf143b468/19).

자주 묻는 질문

ACP Harness의 격리 실행 모델은 왜 필요한가요?

ACP Harness가 각 서브에이전트를 독립 프로세스 환경에서 격리 실행하는 것은 보안성, 안정성, 컨텍스트 분열 방지의 세 가지 목적을 동시에 달성하기 위함이다. 하나의 에이전트가 실패하거나 의도치 않게 동작해도 다른 세션이나 부모 세션에 영향을 미치지 않으며, 물리적 프로세스 격리 덕분에 경합 상태도 원천 차단된다.

8단계 채널바인딩 라우팅은 구체적으로 어떻게 작동하나요?

8단계 우선순위 체계는 동일 채널 우선→부모 채널→길드+역할→길드→팀→계정→채널 기본값→폴백 기본값 순서로 메시지를 라우팅한다. 이 구조의 핵심 장점은 LLM 토큰 비용이 전혀 발생하지 않는 결정적 라우팅이라는 점이다. 모든 에이전트가 동일한 경로 규칙을 따르므로 메시지 전달의 예측 가능성이 구조적으로 보장된다.

Stateless 설계 원칙이 바이브코딩 워크플로우에 어떤 영향을 줍니까?

Stateless 설계 원칙에 따라 각 서브에이전트는 모든 실행 컨텍스트를 태스크 프롬프트에 명시적으로 포함해야 한다. 이 규칙은 에이전트 간 상태 의존성을 완전히 제거하여, 부모 세션의 LLM 컨텍스트가 서브에이전트에 오염되는 컨텍스트 분열을 원천 차단한다. 각 서브에이전트는 어떤 상태에서 시작하든 항상 동일한 입력에서 동일한 결과를 보장받을 수 있다.

Fan-Out/Fan-In 패턴에서 8개 서브에이전트가 동시에 실패하면 어떻게 되나요?

프로세스 격리 덕분에 8개 서브에이전트가 동시에 생성·실행되더라도 그중 하나가 실패하더라도 나머지 7개 작업은 정상 진행된다. Fan-In 단계에서 성공과 실패 결과가 모두 부모 채널로 자동 라우팅되어 개발자의 개입 없이 다중 에이전트 동시 실행의 안전성이 구조적으로 보장된다. deleteAfterRun 플래그로 실패한 세션도 자동 정리된다.