하위 에이전트

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

목표:

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

슬래시 명령어

/subagents은 현재 세션의 하위 에이전트 실행을 검사합니다.

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

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

Control UI에서 최근 하위 실행이 있는 상위 세션에는 펼칠 수 있는 사이드바 행이 표시됩니다. 중첩된 행에는 하위 실행의 상태와 실행 시간이 표시되며, 하나를 선택하면 상위 계층 구조를 유지한 채 해당 하위 실행의 채팅이 열립니다.

스레드 바인딩 제어

다음 명령어는 지속적 스레드 바인딩을 지원하는 채널에서 작동합니다. 아래의 스레드를 지원하는 채널을 참조하십시오.

/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_spawn 및 subagents을 노출하지만 sessions_yield은 노출하지 않을 수 있습니다. 이 경우 완료를 기다리기 위한 폴링 루프를 임의로 만들지 마십시오.

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

도구: subagents

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

필요할 때 상태를 확인하고 디버깅하려면 subagents을 사용하십시오. 완료 이벤트를 기다리려면 sessions_yield을 사용하십시오.

스레드 바인딩 세션

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

스레드 지원 채널

대화 바인딩 어댑터를 등록한 채널은 영구 스레드 바인딩 하위 에이전트 세션 (sessions_spawn 및 thread: true)을 지원합니다. 해당 기능을 지원하는 번들 채널은 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는 가능하면 해당 세션의 요청자로 대체합니다.

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

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

알림 컨텍스트

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

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

통계 줄

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

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

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

sessions_history을 선호하는 이유

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

• 범용 로그 수정이 비활성화된 경우에도 자격 증명/토큰과 유사한 텍스트를 수정합니다.
• 긴 텍스트 블록을 잘라내고(블록당 4000자), 사고 서명, 추론 재생 페이로드 및 인라인 이미지 데이터를 삭제합니다.
• 80 KB 응답 상한을 적용하며, 너무 큰 행은 [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: ["gateway", "cron"],        // 허용이 설정되면 허용 전용이 됨(거부는 여전히 우선함)        // 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가 다시 시작되면 대기 중인 "announce back" 작업이 유실됩니다.
• 하위 에이전트는 여전히 동일한 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 스레드 지침에 유지되며, 부모 전용 페르소나, ID 및 사용자 파일은 턴 범위 협업 지침으로 주입되므로 자식이 이를 복제하지 않습니다.
• 최대 중첩 깊이는 5입니다(maxSpawnDepth 범위: 1-5). 대부분의 사용 사례에는 깊이 2를 권장합니다.
• maxChildrenPerAgent은 세션당 활성 자식 수를 제한합니다(기본값 5, 범위 1-20).

관련 항목

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