멀티 에이전트 게이트웨이 라우팅 글을 읽었다면, 이번 글은 자식 에이전트 격리에 초점을 둡니다. 원격 Mac에서 2026.4.x 릴리스 노트의 spawn 컨텍스트 옵션을 맞추고 코드 리뷰를 수행한 뒤, 고정 필드로 실패 요약만 부모에게 돌려보냅니다.
적용 시나리오 · 격리 경계 · 재현 절차 · 회신 템플릿 · 게이트 토큰 · 인용 문장 · 전환
적용 시나리오와 문제 인식
- 메인 세션 오염: 큰 diff와 도구 오류가 한 트랜스크립트에 쌓이면 이후 라우팅·비용이 악화됩니다.
- 맥락 트레이드오프: 리뷰는 PR 배경은 필요하지만 무관한 지시 이력까지는 싫을 때 fork로 «현재 요청 측» 조각만 물려 받습니다.
- 가시성·인가: Session 도구가 게이트 기본 거부면 spawn이 «사라진 것처럼» 보이므로 테넌트 스코프와 함께 설계해야 합니다.
병렬 브랜치 리뷰, 의존성·플러그인 스캔, 감사 가능한 요약만 CI나 담당자에게 넘길 때 특히 유용합니다. 채팅 원문 전체를 넘기지 않습니다.
격리 경계를 어떻게 긋나
| 축 | 오케스트레이션(부모) | 자식(fork) | 자식(isolated) |
|---|---|---|---|
| 트랜스크립트 상속 | 라우팅·제품 결정 유지 | 현재 요청 관련 조각 상속, PR 정렬에 유리 | 빈 출발, 무관·민감 이력 차단 |
| 전형적 용도 | 분배·자식 결과 병합·대외 답변 | 맥락이 필요한 리뷰·diff 해석 | 샌드박스 스캔, 신뢰 못 하는 입력 실험 |
| 리스크 | 스폰 깊이·allowAgents로 제한 | 자식에서 재귀 spawn·고권한 쓰기 금지 | 컨텍스트는 최소여도 도구 화이트리스트는 동일 |
최소 재현 절차(2026.4.x)
1) Node.js 22+ 설치 후 node -v 확인. 2) npm i -g [email protected](또는 잠근 2026.4.x)로 올리고 openclaw --version을 노트와 대조. 3) openclaw doctor로 게이트웨이·인증서·디렉터리 권한 교정. 4) 대시보드에서 테넌트 단기 Bearer 발급. HTTP tools/invoke로 spawn을 쏠 경우 게이트에서 sessions_spawn을 최소 허용. 5) 오케스트레이션 에이전트에 Session 도구군을 켜고 maxSpawnDepth·allowAgents 설정. 리뷰 작업에서 sessions_spawn 호출 시 필요하면 context: "fork", task에 PR·경로 범위·금지 행위 명시. 6) 자식 라운드는 sessions_yield 또는 합의된 콜백으로 구조화 요약만 넘기고, 전체 자식 트랜스크립트를 부모에 붓지 않습니다.
2026.4.x 배포 노트의 sessions_spawn 선택 분기 컨텍스트는 위 fork/isolated 선택과 직결됩니다. 노트버전과 CLI를 같은 마이너에 고정해 두면 재현 분쟁이 줄어듭니다.
실패 요약 회신 템플릿(JSON 봉투)
부모는 필드만 병합하고 전체 프롬프트·도구 페이로드는 보관하지 않아 감사·대조가 쉽습니다.
{
"stage": "code_review",
"result": "pass | fail | partial",
"blocking_issues": ["머지 차단 항목"],
"non_blocking": ["권고 수정"],
"tool_error_class": "auth | timeout | schema | upstream",
"retry_hint_sec": 0,
"child_session_key": "<spawn 응답 키>",
"correlation_id": "<게이트 로그와 맞출 ID>"
}게이트웨이 토큰과의 관계
대외적으로는 동일 테넌트 Bearer로 게이트를 칩니다. 자식 에이전트는 subagent lane을 타며, 실제 권한은 게이트웨이와 이어지는 sessions.patch로 리프 행동을 조입니다. 소유자 스코프 관리 도구가 자동 승격되면 안 됩니다. 리프는 gateway 류 고권한 도구와 추가 sessions_spawn을 끄고, 리뷰에 필요한 읽기·정적 분석 도구만 둡니다. 외부 자동화는 CLI openclaw agent --spawn로 컨텍스트 교차 오염이 적은 일회 자식 세션을 쓸 수 있으며, 오케스트레이터 내부 spawn과 상호 보완입니다.
서명·검수용으로 인용할 문장
- 공식 Session 도구는
sessions_spawn을 논블로킹으로 두고runId·childSessionKey를 돌려 게이트 추적을 이어 줍니다. forkvsisolated기준은 런북에 적고 PR 템플릿과 함께 갱신하는 편이 안전합니다.- 오케스트레이션 현장 적용은 깊이 상한과 도구 deny 목록이 버팀목이며, 모델만 작게 바꾸는 것으로는 부족합니다. 도구 재시도·스키마 글과 함께 드라이런하세요.
전환
노트북에서 spawn·요약 체인을 검증한 뒤 동일 설정을 상주 원격 Mac으로 옮겨 장시간 리뷰·게이트 로그 로테이션에 맞춥니다. 로그인 없이 요금·구매·고객센터를 열 수 있습니다.
요약: 2026.4.x를 기준점으로 Node 22·openclaw doctor·게이트 토큰으로 면을 닫고, 코드 리뷰를 fork／isolated 경계가 있는 자식 세션에 넣은 뒤 JSON 봉투로 실패 요약만 올리면 서명 가능한 에이전트 오케스트레이션이 완성됩니다.