세션 분할과 도구 공개가 겹칠 때
sessions_spawn이 안 보임. 문서에는 있는데 런타임 도구 목록에 없을 때 버전·기능 플래그·세션 단위 허용 불일치가 흔합니다. 설치와 doctor로 기준선을 잡고 루프백과 설정 파일을 맞춥니다.
allowAgents 중첩. 부모에서 넓혔다가 자식만 적용되어 부모 경로 spawn이 막히는 경우가 있습니다. 최종 도구 집합을 표로 만들고 병합 규칙을 코드와 일치시킵니다.
함수 호출 모델. 도구 미지원 모델로 떨어지면 멈춘 것처럼 보입니다. 폴백 표에 도구 가능 여부 열을 필수로 둡니다.
doctor 녹색인데 깨지는 경로. 공개 URL에서는 헤더 변조로 도구만 죽을 수 있습니다. 리버스 프록시 버퍼·타임아웃을 함께 봅니다. 웹훅은 프로덕션 강화 SSRF 로그와 상관합니다. 채널 혼선은 2026.3 멀티채널 분리 지침을 함께 읽습니다.
2026.3 멀티채널·멀티세션
2026.3은 채널 간 기본값이 강해 단일 세션 가정이 잘 깨집니다.sessions_spawn 노출은 환경마다 다르므로 버전·설정 경로·기동 유닛을 스테이징·프로덕션에서 diff 고정하고 PR에서 모델명과 allowAgents를 필수 리뷰로 둡니다.
spawn이 없을 때 순서
openclaw status로 프로세스와 설정 로드 원본을 보고 이어서 models 계열 출력으로 도구 호출 가능 여부를 봅니다. CLI와 게이트웨이 버전 불일치는 컨테이너 태그와 설정 마운트를 함께 의심합니다. 레이스 의심은 상관 ID로 루프백 재현 후 마지막에 게이트웨이 doctor JSON을 채널 진단과 맞춥니다.
allowAgents 중첩 유지
JSON 깊이에 의미가 달라지므로 행에 에이전트 ID, 열에 spawn 등 권한, 끝에 설정 파일·줄 번호를 적은 표를 환경마다 한 장 둡니다. 복붙 운용은 한쪽만 오래된 제한이 남으므로 템플릿화하고 CI에서 검증합니다.
함수 호출과 삼층 책임
모델·게이트웨이·채널에서 도구가 갈립니다. 스트리밍일 때 청크 경계에서 인수 JSON이 깨지기 쉬우므로 프록시 설정을 함께 의심합니다.
status·models·doctor·로그
status로 생존·바인딩, models로 프로필·도구 힌트, doctor로 의존성·채널 누락(층별 절차), 로그로 게이트웨이·리버스 프록시·웹훅을 상관 ID로 묶고 외부 거부는 SSRF 강화와 한 줄 대조. 이 네 순서를 고정하면 온콜이 빨라집니다.
판단 매트릭스
리뷰용 짧은 표입니다.
| 증상 | 먼저 | 다음 | 글 |
|---|---|---|---|
| spawn 없음 | status·버전 | models·allowAgents | 설치·게이트웨이 |
| 자식만 실패 | 중첩 | 자식 모델 | 강화 |
| 공개 URL만 실패 | 프록시 헤더 | 타임아웃 | nginx·Caddy |
| 채널 혼선 | 워커 분리 | 도구 경합 | 멀티채널 |
SLO 예: spawn p95 5초, 변경마다 doctor, PR에 설정 diff.
7단 체크(주석 예)
비밀은 채팅에 붙이지 않습니다.
# 1) 버전·doctor 기준선
# openclaw version
# openclaw doctor --json > /tmp/oc-doctor.json
# 2) 프로세스·설정
# openclaw status
# rg -n "allowAgents" /path/to/config
# 3) 모델·도구
# openclaw models
# 4) 루프백 health
# curl -sS http://127.0.0.1:18789/health
# 5) 공개 호스트명 동일 시험
# curl -N https://your.host.example/health
# 6) request id 공유
# 7) SSRF·웹훅 거부 로그 대조
검증 스크립트는 프로덕션 키를 섞지 않는 별 저장소에 둡니다.
관측과 롤백
spawn 성공률과 자식 세션 수명을 메트릭으로 두고 롤백은 모델·allowAgents·게이트웨이 버전 중 하나만 되돌립니다. 병렬 spawn과 PDF 공존은 열 한계가 먼저 와서 단일 테넌트면 SFTPMAC 호스팅 리모트 Mac이 맞습니다.
FAQ
sessions_spawn은 항상 있나요?
버전·설정·allowAgents 조합입니다. 없으면 status·models 후 설치 글 doctor까지 돌아갑니다.
부모 allowAgents만 고치면 되나요?
자식과 병합 규칙을 확인하고 표로 최종 도구 집합을 봅니다.
정리: sessions_spawn 부재는 버전·정책 조합일 수 있습니다. 네 층으로 잡고 프로덕션 경계와 멀티채널을 같은 릴리스에서 관리하세요.
한계: 프로바이더는 자체 추적.SFTPMAC 호스팅 리모트 Mac은 격리 SFTP와 OpenClaw 인그레스 용도에 맞습니다.
도구 부하를 리모트 Mac에 올릴 때는 SFTPMAC을 보세요.