하위 에이전트

서브 에이전트는 기존 에이전트 실행에서 생성되는 백그라운드 에이전트 실행입니다. 각 에이전트는 자체 세션(agent:<agentId>:subagent:<uuid>)에서 실행되며, 완료되면 요청자 채팅 채널에 결과를 알립니다. 모든 서브 에이전트 실행은 백그라운드 작업으로 추적됩니다.

목표:

• 기본 실행을 차단하지 않고 조사, 장시간 작업, 느린 도구 작업을 병렬화합니다.
• 서브 에이전트를 기본적으로 격리합니다(세션 분리, 선택적 샌드박싱).
• 도구 표면을 오용하기 어렵게 유지합니다. 서브 에이전트에는 기본적으로 세션 또는 메시지 도구가 제공되지 않습니다.
• 오케스트레이터 패턴을 위한 구성 가능한 중첩 깊이를 지원합니다.

슬래시 명령어

/subagents는 현재 세션의 서브 에이전트 실행을 검사합니다.

/subagents list/subagents log <id|#> [limit] [tools]/subagents info <id|#>

/subagents info는 실행 메타데이터(상태, 타임스탬프, 세션 ID, 트랜스크립트 경로, 정리)를 표시합니다. /subagents log는 실행의 최근 채팅 턴을 출력합니다. 도구 호출/결과 메시지(기본적으로 생략됨)를 포함하려면 tools 토큰을 추가하세요. 에이전트 턴 내에서 범위가 제한되고 안전 필터링된 회상 보기를 사용하려면 sessions_history를 사용하고, 원본 전체 트랜스크립트는 디스크의 트랜스크립트 경로에서 검사하세요.

스레드 바인딩 제어

다음 명령어는 영구 스레드 바인딩이 있는 채널에서 작동합니다. 아래의 스레드를 지원하는 채널을 참조하세요.

/focus <subagent-label|session-key|session-id|session-label>/unfocus/agents/session idle <duration|off>/session max-age <duration|off>

생성 동작

에이전트는 sessions_spawn 도구로 백그라운드 서브 에이전트를 시작합니다. 완료 결과는 내부 상위 세션 이벤트로 반환되며, 상위/요청자 에이전트가 사용자에게 표시되는 업데이트가 필요한지 결정합니다.

컨텍스트 모드

호출자가 현재 트랜스크립트를 포크하도록 명시적으로 요청하지 않는 한 네이티브 서브 에이전트는 격리된 상태로 시작합니다.

fork는 제한적으로 사용하세요. 이는 컨텍스트에 민감한 위임을 위한 것이며, 명확한 작업 프롬프트 작성을 대신하지 않습니다.

도구: sessions_spawn

전역 subagent 레인에서 deliver: false로 서브 에이전트 실행을 시작한 다음, 알림 단계를 실행하고 알림 응답을 요청자 채팅 채널에 게시합니다.

사용 가능 여부는 호출자의 유효 도구 정책에 따라 달라집니다. 기본 제공 coding 프로필에는 sessions_spawn이 포함되며, messaging 및 minimal에는 포함되지 않습니다. full은 모든 도구를 허용합니다. 더 제한적인 프로필을 사용하면서도 작업을 위임해야 하는 에이전트에는 tools.alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"]를 추가하거나 tools.profile: "coding"을 사용하세요. 프로필 단계 후에도 채널/그룹, 제공자, 샌드박스 및 에이전트별 허용/거부 정책에서 도구를 제거할 수 있습니다. 유효 도구 목록을 확인하려면 동일한 세션에서 /tools를 사용하세요.

기본값:

• 모델: agents.defaults.subagents.model(또는 에이전트별 agents.list[].subagents.model)을 설정하지 않으면 네이티브 서브 에이전트는 호출자의 모델을 상속합니다. ACP 런타임 생성은 구성된 서브 에이전트 모델이 있으면 동일한 모델을 사용하고, 그렇지 않으면 ACP 하네스가 자체 기본값을 유지합니다. 명시적인 sessions_spawn.model이 항상 우선합니다.
• 사고: agents.defaults.subagents.thinking(또는 에이전트별 agents.list[].subagents.thinking)을 설정하지 않으면 네이티브 서브 에이전트는 호출자의 설정을 상속합니다. ACP 런타임 생성은 선택한 모델에 대해 agents.defaults.models["provider/model"].params.thinking도 적용합니다. 명시적인 sessions_spawn.thinking이 항상 우선합니다.
• 실행 제한 시간: agents.defaults.subagents.runTimeoutSeconds가 설정된 경우 OpenClaw가 이를 사용하고, 그렇지 않으면 0(제한 시간 없음)으로 대체합니다. sessions_spawn은 호출별 제한 시간 재정의를 허용하지 않습니다.
• 작업 전달: 네이티브 서브 에이전트는 처음 표시되는 [Subagent Task] 메시지에서 위임된 작업을 받습니다. 서브 에이전트 시스템 프롬프트에는 작업의 숨겨진 중복본이 아니라 런타임 규칙과 라우팅 컨텍스트가 포함됩니다.

허용된 네이티브 서브 에이전트 생성은 도구 결과에 해석된 하위 모델 메타데이터를 포함합니다. resolvedModel에는 적용된 모델 참조가 포함되고, 참조에 제공자 접두사가 있는 경우 resolvedProvider에는 제공자 접두사가 포함됩니다.

위임 프롬프트 모드

agents.defaults.subagents.delegationMode는 프롬프트 안내만 제어하며, 도구 정책을 변경하거나 위임을 강제하지 않습니다.

• suggest(기본값): 더 크거나 느린 작업에 서브 에이전트를 사용하도록 권하는 표준 프롬프트 안내를 유지합니다.
• prefer: 기본 에이전트가 신속하게 응답을 유지하고 직접 응답보다 복잡한 모든 작업을 sessions_spawn을 통해 위임하도록 안내합니다.

에이전트별 재정의: agents.list[].subagents.delegationMode.

{  agents: {    defaults: {      subagents: {        delegationMode: "prefer",        maxConcurrent: 4,      },    },    list: [      {        id: "coordinator",        subagents: { delegationMode: "prefer" },      },    ],  },}

도구 매개변수

작업 이름 및 대상 지정

taskName은 세션 키가 아니라 오케스트레이션을 위한 모델 대상 핸들입니다. 코디네이터가 나중에 해당 하위 항목을 검사해야 할 수 있는 경우 review_subagents, linux_validation, docs_update 같은 안정적인 하위 이름에 사용합니다.

대상 확인은 정확히 일치하는 taskName과 모호하지 않은 접두사를 허용합니다. 일치는 번호가 지정된 /subagents 대상에서 사용하는 것과 동일한 활성/최근 대상 범위로 한정되므로, 오래전에 완료된 하위 항목 때문에 재사용한 핸들이 모호해지지 않습니다. 활성 상태이거나 최근의 하위 항목 두 개가 동일한 taskName을 공유하면 대상이 모호합니다. 대신 목록 인덱스, 세션 키 또는 실행 ID를 사용합니다.

예약 대상 last와 all은 이미 제어 의미를 가지므로 유효한 taskName 값이 아닙니다.

도구: sessions_yield

현재 모델 턴을 종료하고 런타임 이벤트, 주로 하위 에이전트 완료 이벤트가 다음 메시지로 도착할 때까지 기다립니다. 필요한 하위 작업을 생성한 후, 해당 작업이 완료되기 전에는 요청자가 최종 답변을 작성할 수 없을 때 사용합니다.

sessions_yield는 대기 기본 요소입니다. 하위 항목 완료를 감지하기 위해 subagents, sessions_list, sessions_history, 셸 sleep 또는 프로세스 폴링을 반복하는 방식으로 대체하지 마세요.

세션의 유효 도구 목록에 sessions_yield가 포함된 경우에만 사용합니다. 일부 최소 또는 사용자 지정 도구 프로필은 sessions_yield 없이 sessions_spawn과 subagents만 노출할 수 있습니다. 이 경우 완료를 기다리기 위한 폴링 루프를 임의로 만들지 마세요.

활성 하위 항목이 있으면 OpenClaw는 런타임에서 생성된 간결한 Active Subagents 프롬프트 블록을 일반 턴에 삽입합니다. 이를 통해 요청자는 폴링 없이 현재 하위 세션, 실행 ID, 상태, 레이블, 작업 및 taskName 별칭을 확인할 수 있습니다. 해당 블록의 작업 및 레이블 필드는 사용자/모델이 제공한 생성 인수에서 비롯될 수 있으므로 명령이 아닌 데이터로 인용됩니다.

도구: subagents

요청자 세션이 소유한 생성된 하위 에이전트 실행을 나열합니다. 범위는 현재 요청자로 한정되며, 하위 항목은 자신이 제어하는 하위 항목만 볼 수 있습니다.

필요할 때 상태 확인 및 디버깅에 subagents를 사용합니다. 완료 이벤트를 기다릴 때는 sessions_yield를 사용합니다.

스레드 바인딩 세션

채널에서 스레드 바인딩이 활성화된 경우 하위 에이전트를 스레드에 계속 바인딩할 수 있으므로, 해당 스레드의 후속 사용자 메시지가 동일한 하위 에이전트 세션으로 계속 라우팅됩니다.

스레드를 지원하는 채널

대화 바인딩 어댑터를 등록한 채널은 영구적인 스레드 바인딩 하위 에이전트 세션 (thread: true를 사용한 sessions_spawn)을 지원합니다. 이 기능을 지원하는 번들 채널은 Discord, iMessage, Matrix, Telegram입니다. Discord와 Matrix는 기본적으로 하위 스레드를 만들며, Telegram과 iMessage는 기본적으로 현재 대화를 바인딩합니다. 활성화, 시간 제한 및 spawnSessions에는 채널별 threadBindings 구성 키를 사용합니다.

빠른 흐름

수동 제어

구성 스위치

• 전역 기본값: session.threadBindings.enabled, session.threadBindings.idleHours, session.threadBindings.maxAgeHours.
• 채널 재정의 및 생성 자동 바인딩 키는 어댑터마다 다릅니다. 위의 스레드를 지원하는 채널을 참조하세요.

현재 어댑터 세부 정보는 구성 참조 및 슬래시 명령어를 참조하세요.

허용 목록

요청자 세션이 샌드박스에서 실행되는 경우 sessions_spawn은 샌드박스 없이 실행되는 대상을 거부합니다.

검색

현재 sessions_spawn에 허용된 에이전트 ID를 확인하려면 agents_list를 사용합니다. 응답에는 나열된 각 에이전트의 유효 모델과 내장 런타임 메타데이터가 포함되므로 호출자가 OpenClaw, Codex 앱 서버 및 구성된 기타 네이티브 런타임을 구분할 수 있습니다.

allowAgents 항목은 agents.list[]에 구성된 에이전트 ID를 가리켜야 합니다. ["*"]는 구성된 모든 대상 에이전트와 요청자를 의미합니다. 에이전트 구성이 삭제되었지만 해당 ID가 allowAgents에 남아 있으면 sessions_spawn은 그 ID를 거부하고 agents_list는 이를 생략합니다. 오래된 허용 목록 항목을 정리하려면 openclaw doctor --fix를 실행하거나, 대상이 기본값을 상속하면서도 계속 생성 가능해야 하는 경우 최소한의 agents.list[] 항목을 추가합니다.

자동 보관

• 하위 에이전트 세션은 agents.defaults.subagents.archiveAfterMinutes 후 자동으로 보관됩니다(기본값 60).
• 보관은 sessions.delete를 사용하며 기록 이름을 *.deleted.<timestamp>로 변경합니다(동일한 폴더).
• cleanup: "delete"는 알림 직후 보관합니다(이름 변경을 통해 기록은 계속 보존).
• 자동 보관은 최선형 방식으로 수행됩니다. Gateway가 다시 시작되면 대기 중인 타이머는 손실됩니다.
• 구성된 실행 시간 제한은 자동 보관을 수행하지 않으며 실행만 중지합니다. 세션은 자동 보관될 때까지 유지됩니다.
• 자동 보관은 깊이 1과 깊이 2 세션에 동일하게 적용됩니다.
• 브라우저 정리는 보관 정리와 별개입니다. 기록/세션 레코드를 유지하더라도 실행이 끝나면 추적 중인 브라우저 탭/프로세스를 최선형 방식으로 닫습니다.

중첩 하위 에이전트

기본적으로 하위 에이전트는 자체 하위 에이전트를 생성할 수 없습니다 (maxSpawnDepth: 1). 한 단계 중첩을 활성화하려면 maxSpawnDepth: 2로 설정합니다. 이는 오케스트레이터 패턴입니다. 메인 → 오케스트레이터 하위 에이전트 → 작업자 하위-하위 에이전트.

{  agents: {    defaults: {      subagents: {        maxSpawnDepth: 2, // 하위 에이전트가 하위 항목을 생성하도록 허용(기본값: 1, 범위 1-5)        maxChildrenPerAgent: 5, // 에이전트 세션당 최대 활성 하위 항목 수(기본값: 5, 범위 1-20)        maxConcurrent: 8, // 전역 동시 실행 레인 제한(기본값: 8)        runTimeoutSeconds: 900, // sessions_spawn의 기본 시간 제한(0 = 시간 제한 없음)        announceTimeoutMs: 120000, // 호출별 Gateway 알림 시간 제한      },    },  },}

깊이 수준

알림 체인

결과는 체인을 따라 상위로 전달됩니다.

1. 깊이 2 작업자가 완료되면 → 부모(깊이 1 오케스트레이터)에게 알립니다.
2. 깊이 1 오케스트레이터가 알림을 받고 결과를 종합하여 완료한 뒤 → 메인에 알립니다.
3. 메인 에이전트가 알림을 받고 사용자에게 전달합니다.

각 수준에서는 직계 자식의 알림만 볼 수 있습니다.

깊이별 도구 정책

• 역할과 제어 범위는 생성 시 세션 메타데이터에 기록됩니다. 따라서 평면화되거나 복원된 세션 키가 실수로 오케스트레이터 권한을 다시 얻지 않습니다.
• 깊이 1(오케스트레이터, maxSpawnDepth >= 2인 경우): 자식을 생성하고 상태를 확인할 수 있도록 sessions_spawn, subagents, sessions_list, sessions_history를 받습니다. 그 밖의 세션/시스템 도구는 계속 거부됩니다.
• 깊이 1(리프, maxSpawnDepth == 1인 경우): 세션 도구가 없습니다(현재 기본 동작).
• 깊이 2(리프 작업자): 세션 도구가 없습니다. 깊이 2에서는 sessions_spawn이 항상 거부됩니다. 자식을 더 생성할 수 없습니다.

에이전트별 생성 제한

각 에이전트 세션은 깊이에 관계없이 동시에 최대 maxChildrenPerAgent (기본값 5)개의 활성 자식을 둘 수 있습니다. 이를 통해 단일 오케스트레이터에서 제어 불가능하게 작업이 확산되는 것을 방지합니다.

연쇄 중지

깊이 1 오케스트레이터를 중지하면 모든 깊이 2 자식도 자동으로 중지됩니다.

• 메인 채팅에서 /stop을 실행하면 모든 깊이 1 에이전트가 중지되고 해당 깊이 2 자식까지 연쇄적으로 중지됩니다.

인증

하위 에이전트 인증은 세션 유형이 아닌 에이전트 ID를 기준으로 확인됩니다.

• 하위 에이전트 세션 키는 agent:<agentId>:subagent:<uuid>입니다.
• 인증 저장소는 해당 에이전트의 agentDir에서 로드됩니다.
• 메인 에이전트의 인증 프로필은 대체 수단으로 병합되며, 충돌 시 에이전트 프로필이 메인 프로필보다 우선합니다.

병합은 추가 방식이므로 메인 프로필은 항상 대체 수단으로 사용할 수 있습니다. 에이전트별로 인증을 완전히 격리하는 기능은 아직 지원되지 않습니다.

알림

하위 에이전트는 알림 단계를 통해 결과를 보고합니다.

• 알림 단계는 요청자 세션이 아닌 하위 에이전트 세션 내부에서 실행됩니다.
• 하위 에이전트가 정확히 ANNOUNCE_SKIP으로 응답하면 아무것도 게시되지 않습니다.
• 최신 어시스턴트 텍스트가 정확한 무응답 토큰 NO_REPLY / no_reply이면 이전에 표시된 진행 상황이 있더라도 알림 출력이 억제됩니다.

전달 방식은 요청자의 깊이에 따라 달라집니다.

• 최상위 요청자 세션은 외부 전달(deliver=true)이 설정된 후속 agent 호출을 사용합니다.
• 중첩된 요청자 하위 에이전트 세션은 오케스트레이터가 세션 내에서 자식 결과를 종합할 수 있도록 내부 후속 주입(deliver=false)을 받습니다.
• 중첩된 요청자 하위 에이전트 세션이 사라진 경우, 가능하면 OpenClaw는 해당 세션의 요청자를 대신 사용합니다.

최상위 요청자 세션의 경우 완료 모드 직접 전달은 먼저 연결된 대화/스레드 경로와 훅 재정의를 확인한 다음, 누락된 채널 대상 필드를 요청자 세션에 저장된 경로로 채웁니다. 이렇게 하면 완료 출처가 채널만 식별하더라도 올바른 채팅/주제로 완료 결과가 전달됩니다.

중첩된 완료 결과를 구성할 때 자식 완료 집계 범위는 현재 요청자 실행으로 한정되므로 이전 실행의 오래된 자식 출력이 현재 알림에 유입되지 않습니다. 채널 어댑터에서 지원하는 경우 알림 응답은 스레드/주제 경로를 보존합니다.

알림 컨텍스트

알림 컨텍스트는 안정적인 내부 이벤트 블록으로 정규화됩니다.

최종적으로 실패한 실행은 캡처된 응답 텍스트를 재생하지 않고 실패 상태를 보고합니다. 도구/도구 결과 출력은 자식 결과 텍스트로 승격되지 않습니다.

통계 줄

알림 페이로드 끝에는 래핑된 경우에도 통계 줄이 포함됩니다.

• 런타임(예: runtime 5m12s).
• 토큰 사용량(입력/출력/합계).
• 모델 가격이 구성된 경우 예상 비용(models.providers.*.models[].cost).
• 메인 에이전트가 sessions_history를 통해 기록을 가져오거나 디스크의 파일을 검사할 수 있도록 sessionKey, sessionId, 트랜스크립트 경로.

내부 메타데이터는 오케스트레이션 전용이며, 사용자 대상 응답은 일반적인 어시스턴트 문체로 다시 작성해야 합니다.

sessions_history를 선호하는 이유

sessions_history는 에이전트 턴 내에서 자식의 트랜스크립트를 읽는 데 더 안전한 오케스트레이션 경로입니다.

• 범용 로그 삭제 처리가 비활성화된 경우에도 자격 증명/토큰과 유사한 텍스트를 삭제 처리합니다.
• 긴 텍스트 블록을 블록당 4000자로 잘라내고 사고 서명, 추론 재생 페이로드 및 인라인 이미지 데이터를 제거합니다.
• 응답 크기를 80KB로 제한하며, 크기가 초과된 행은 [sessions_history omitted: message too large]로 대체됩니다.
• 이전 트랜스크립트 창을 역방향으로 페이지 탐색하려면 nextOffset이 있을 때 이를 사용하세요.
• sessions_history는 메시지 텍스트에서 추론 태그, <relevant-memories> 스캐폴딩 또는 도구 호출 XML을 제거하지 않습니다. 단지 삭제 처리되고 크기가 제한될 뿐, 원시 트랜스크립트 형식에 가까운 구조화된 콘텐츠 블록을 반환합니다. /subagents log는 구조화된 블록 대신 일반 채팅 줄을 렌더링하므로 더 강력한 산문 정리 도구를 적용하여 추론 태그, 메모리 스캐폴딩 및 도구 호출 XML을 제거합니다.
• 바이트 단위로 완전한 트랜스크립트가 필요할 때는 디스크의 원시 트랜스크립트를 검사하는 것이 대체 수단입니다.

도구 정책

하위 에이전트는 먼저 부모 또는 대상 에이전트와 동일한 프로필 및 도구 정책 파이프라인을 사용합니다. 그런 다음 OpenClaw가 하위 에이전트 제한 계층을 적용합니다.

하위 에이전트는 깊이나 역할과 관계없이 항상 gateway, agents_list, session_status, cron을 사용할 수 없습니다. 이들은 시스템 수준/대화형 도구이거나 메인 에이전트가 조정해야 하는 도구입니다. 리프 하위 에이전트 (기본 깊이 1 동작 및 항상 깊이 2)는 추가로 subagents, sessions_list, sessions_history, sessions_spawn을 사용할 수 없습니다. 하위 에이전트는 message 도구를 절대 받지 않습니다. 이 도구는 이 거부 목록에서 필터링되는 것이 아니라 생성 시 비활성화됩니다. 또한 하위 에이전트가 알림 체인을 통해서만 통신하도록 sessions_send도 계속 거부됩니다.

여기에서도 sessions_history는 범위와 크기가 제한되고 정리된 회상 보기로 유지되며, 원시 트랜스크립트 덤프가 아닙니다.

maxSpawnDepth >= 2이면 깊이 1 오케스트레이터 하위 에이전트는 자식을 관리할 수 있도록 추가로 sessions_spawn, subagents, sessions_list, sessions_history를 받습니다.

구성을 통한 재정의

{  agents: {    defaults: {      subagents: {        maxConcurrent: 1,      },    },  },  tools: {    subagents: {      tools: {        // deny wins        deny: ["gateway", "cron"],        // if allow is set, it becomes allow-only (deny still wins)        // allow: ["read", "exec", "process"]      },    },  },}

tools.subagents.tools.allow는 최종 허용 전용 필터입니다. 이미 확인된 도구 집합의 범위를 좁힐 수 있지만 tools.profile에서 제거된 도구를 다시 추가할 수는 없습니다. 예를 들어 tools.profile: "coding"에는 web_search/web_fetch가 포함되지만 browser 도구는 포함되지 않습니다. 코딩 프로필 하위 에이전트가 브라우저 자동화를 사용할 수 있게 하려면 프로필 단계에서 브라우저를 추가하세요.

{  tools: {    profile: "coding",    alsoAllow: ["browser"],  },}

하나의 에이전트에만 브라우저 자동화를 제공하려면 에이전트별 agents.list[].tools.alsoAllow: ["browser"]를 사용하세요.

동시 실행

하위 에이전트는 전용 프로세스 내 큐 레인을 사용합니다.

• 레인 이름: subagent
• 동시 실행 수: agents.defaults.subagents.maxConcurrent(기본값 8)

활성 상태 및 복구

OpenClaw는 endedAt이 없다는 사실을 하위 에이전트가 아직 활성 상태라는 영구적인 증거로 취급하지 않습니다. 오래된 실행 유효 기간(2시간 또는 구성된 실행 제한 시간에 짧은 유예 기간을 더한 값 중 더 긴 값)보다 오래된 미종료 실행은 /subagents list, 상태 요약, 하위 항목 완료 게이트 및 세션별 동시 실행 검사에서 더 이상 활성/대기 중으로 계산되지 않습니다.

Gateway 재시작 후 오래된 미종료 복원 실행은 해당 자식 세션에 abortedLastRun: true가 표시되어 있지 않으면 정리됩니다. 재시작으로 중단된 실행은 하위 에이전트 고아 복구 흐름을 위해 등록 상태로 유지됩니다. 오래된 실행은 재개 없이 완료 처리되며, 최신 자식 세션은 중단 표시가 제거되기 전에 합성된 재개 메시지를 받습니다.

자동 재시작 복구는 자식 세션별로 제한됩니다. 동일한 하위 에이전트 자식이 짧은 재고착 유효 기간 안에 고아 복구 대상으로 반복해서 승인되면 OpenClaw는 해당 세션에 복구 툼스톤을 저장하고 이후 재시작 시 자동 재개를 중단합니다. 작업 레코드를 조정하려면 openclaw tasks maintenance --apply를 실행하고, 툼스톤이 설정된 세션에서 오래된 중단 복구 플래그를 제거하려면 openclaw doctor --fix를 실행하세요.

중지

• 요청자 채팅에서 /stop을 보내면 요청자 세션이 중단되고 해당 세션에서 생성된 모든 활성 하위 에이전트 실행이 중지되며, 중첩된 자식까지 연쇄적으로 중지됩니다.

제한 사항

• 하위 에이전트 알림은 최선형으로 처리됩니다. Gateway가 재시작되면 대기 중인 "결과 알림" 작업이 유실됩니다.
• 하위 에이전트는 여전히 동일한 Gateway 프로세스 리소스를 공유하므로 maxConcurrent를 안전장치로 취급하세요.
• sessions_spawn은 항상 논블로킹 방식입니다. 즉시 { status: "accepted", runId, childSessionKey }를 반환합니다.
• 하위 에이전트 컨텍스트에는 AGENTS.md와 TOOLS.md만 주입됩니다(SOUL.md, IDENTITY.md, USER.md, MEMORY.md, HEARTBEAT.md, BOOTSTRAP.md는 주입되지 않음). Codex 네이티브 하위 에이전트에도 동일한 경계가 적용됩니다. TOOLS.md는 상속된 Codex 스레드 지침에 유지되며, 부모 전용 페르소나, 정체성, 사용자 파일은 하위 에이전트가 이를 복제하지 않도록 턴 범위의 협업 지침으로 주입됩니다.
• 최대 중첩 깊이는 5입니다(maxSpawnDepth 범위: 1-5). 대부분의 사용 사례에는 깊이 2를 권장합니다.
• maxChildrenPerAgent는 세션별 활성 하위 에이전트 수를 제한합니다(기본값 5, 범위 1-20).

관련 항목

• 세션 도구 및 상태 변경
• ACP 에이전트
• 에이전트 전송
• 백그라운드 작업
• 다중 에이전트 샌드박스 도구