OpenClaw 2026년 5월 21일 약 20분 v2026.5.18 Subagent

OpenClaw v2026.5.18 서브에이전트
Spawn 레지스트리 · 큐 · handoff

원격 Mac(VNC) 순차 도입 · 판단표 · 20분 검수

서버 랙과 네트워크로 OpenClaw 서브에이전트와 Gateway 오케스트레이션

v2026.5.18(2026-05-18 안정 rollup)은 서브에이전트를 「spawn 됨」에서 「추적·대기열·회송 가능」으로 올립니다. spawn은 레지스트리 초기 기록이 성공한 뒤에만 accepted로 보고되고, 주 세션은 queued follow-upsmanual-turn 우선을 지원하며, 자식 run 종료는 completion handoff로 originating session에 돌아갑니다. session lock과 sandbox-peer 소유권도 강화됩니다. 원격 Mac에서 「자식은 돌았는데 주 채팅에 결론이 없다」「accepted인데 목록이 비다」「Codex 네이티브 자식이 orphaned」——이런 증상에는 8단계 런북20분 VNC 검수표를 쓰세요. Subagent와 ACP·Active Memory 경계를 나누고 Gateway와 동일 macOS 사용자 VNC로 콘솔·로그를 맞춥니다. 연계: 무응답 분석, launchd 상주, v2026.5.7 플러그인 공개, 다중 프로젝트 격리, 헤드리스 Linux 대 macOS+VNC.

01

통증 분해: 5.18이 고치는 것은 「유령 spawn」과 handoff 단절

5.12–5.17 현장에서 서브에이전트 장애의 상당수는 모델 품질이 아니라 오케스트레이션 상태 불일치입니다. 레지스트리 미기록인데 accepted, 완료 이벤트가 주 세션에 없음, Codex app-server 네이티브 자식과 OpenClaw child session 불일치——재현 경로는 정해져 있습니다.

  1. 01

    기록 실패인데 성공 표시(수정됨): 5.18은 초기 registry save → accepted 순서를 강제합니다. 실패 시 spawn 오류를 반환해 목록에 없는 유령 작업을 줄입니다.

  2. 02

    handoff 미도달: originating run session으로의 completion handoff와 sandbox-peer announcement 경로가 5.18에서 보강됩니다.

  3. 03

    follow-up 경합: queued follow-ups와 manual-turn 우선으로 IM에서 「끼어들기」와 백그라운드 자식의 순서를 예측 가능하게 합니다.

  4. 04

    Codex 네이티브 orphaned: stale childless 미러 복구와 registry 행 취소는 OpenClaw 순수 spawn과 별도 증거 꾸러미로 기록하세요.

  5. 05

    원격 Mac 특수: SSH 사용자와 VNC 데스크톱 사용자가 다르면 spawn 목록·권한 대화상자가 안 보여 「5.18 회귀」로 오판합니다.

02

판단표: SSH, VNC, 서브에이전트 검수면

검수SSH만VNC 권장합격
openclaw --version / doctor가능선택CLI ≥ 2026.5.18, doctor 차단 없음
spawn 후 registry 가시성로그+CLI콘솔/자식 목록30초 내 행 표시
completion handoff주 transcript동일 사용자 Network주 채널에 요약/결과
queued follow-up 끼어들기priority 로그IM 두 지령manual-turn 선행
Codex 네이티브trajectory/doctorOAuth·권한 UIorphaned 경고 없음
subagents 설정 정리doctor --fix설정 diff무효 timeoutMs 제거

최소 비용: SSH로 증거, VNC로 동일 사용자 재현. 한쪽만 쓰지 마세요.

ACP는 「현재 IM을 coding runtime에 bind」, Subagent는 「병렬 자식 run + 레지스트리 + handoff」입니다. Active Memory는 주 응답 전 검색 삽입이지 새 run spawn이 아닙니다.

03

8단계 런북: 백업부터 handoff 증명까지

  1. 01

    동결·백업: 설정 디렉터리, openclaw --version, Gateway 빌드, 노드 ID. 다프로젝트는 격리 글 선행.

  2. 02

    5.18 업그레이드:openclaw doctor. subagents 정리·plugin registry repair 확인.

  3. 03

    최소 spawn 연기: 짧은 종료 조건 자식 하나. accepted 전 registry 행 존재.

  4. 04

    handoff 검증: 주 세션에 읽을 수 있는 완료 요약. 없으면 handoff/announcement/session lock 로그.

  5. 05

    큐 follow-up: 자식 실행 중 끼어들기 지령으로 manual-turn 우선. cron과 혼합 금지.

  6. 06

    Codex 경로: app-server 사용 시 네이티브 자식↔OpenClaw child 대응표 별도.

  7. 07

    상주·재시작: launchd 재시작 후 keep registry 행 의도 확인.

  8. 08

    롤백 증거: 전후 로그·transcript를 티켓에. CLI/Gateway 판단과 연결.

bash
openclaw --version
openclaw doctor
openclaw status
# 테스트 채널에서 짧은 subagent 후:
# rg -i "subagent|handoff|registry|spawn" /path/to/gateway.log | tail -n 80
04

변경 티켓에 붙일 네 가지 결론

  • 결론 1: 「spawn accepted」에는 레지스트리 초기 기록 성공 로그/UI 행을 첨부.
  • 결론 2: handoff 합격은 originating session의 가시 응답. 자식 채널 로그만으로 불가.
  • 결론 3: queued follow-ups는 두 지령 실발로 검증.
  • 결론 4: Codex 네이티브와 OpenClaw spawn 증거 꾸러미 분리.

횡단 수정(Telegram 격리 폴링, Discord 최종 회신, Gateway 재시작 pending drain)으로 handoff 성공인데 IM에 최종 문이 없을 수 있습니다. 먼저 무응답 분석 채널 배달 절을 보고 registry로 돌아가세요.

05

고정 순서 분석: spawn / handoff / 침묵

  1. A

    CLI·Gateway 5.18선인지. doctor subagents 잔여 키.

  2. B

    spawn 후 목록 공백이면 기록 실패·사용자 불일치 우선.

  3. C

    handoff/announcement/session lock 로그. final delivery 횡단 수정 확인.

  4. D

    Telegram forum topic, Discord progress 등 채널층.

  5. E

    CPU/메모리 포화 시 session lock 대기 증가. 병렬 spawn 축소 후 모델.

06

20분 VNC 검수표(SSH 로그 교차)

항목VNCSSH합격
콘솔 버전About/Network 200기동 로그CLI 5.18 일치
spawn 후 목록UI 행registry 로그30초 이내
handoff주 채널 최종 문handoff 키워드요약 가독
manual-turn두 지령 순서priority 로그끼어들기 선행
동일 사용자데스크톱=데몬whoami교차 없음

임대 Mac에서는 VNCMac 노드에 Gateway·브라우저·「개인정보 보호 및 보안」을 동일 VNC 세션에 두면 SSH만으로는 보이지 않는 대화상자 누락을 줄입니다. Windows 주력 팀은 「SSH 로그 + VNC 권한」 이궤를 Linux 대 macOS+VNC 절차에 고정하세요.

관련

관련 글

FAQ

자주 묻는 질문

레지스트리 초기 기록과 originating session을 먼저 보세요. 5.18부터 기록 실패는 spawn 오류로 수렴합니다.

다릅니다. ACP는 IM을 coding runtime에 올리고, Subagent는 병렬 자식 run+레지스트리+handoff입니다.

CLI·로그는 SSH 가능. spawn 목록·권한 UI는 데몬과 동일 사용자 VNC에서.

doctor로 subagents 무효 timeoutMs 등 정리. 모델은 primary/fallback. 반드시 백업.

맺음말

v2026.5.18은 병렬 자동화를 감사 가능한 오케스트레이션으로 옮깁니다. 레지스트리·큐·handoff 중 하나가 끊기면 IM에서 「AI 무응답」으로 보입니다——무응답 분석과 본문의 역할 분담입니다.

자체 Mac은 슬립·대역폭·session lock 대기를 안습니다. 임대 Mac에서는 Gateway와 콘솔을 동일 VNC 데스크톱에 두어 검수를 20분 규모로 압축할 수 있습니다.

6절과 같은 그래픽 검수VNCMac: 구매 페이지, 연결 도움말 센터(SSH-VNC).