2026년 OpenClaw Gateway OpenAI 호환 HTTP API chat completions models CLI 인증 트러블슈팅

/v1/models·/v1/chat/completions와 CLI가 같이 맞아야 합니다. 한쪽만 초록이면 타임아웃·간헐 401이 납니다. openclaw gateway status --require-rpc로 유휴 스톨과 인증을 가릅니다. Webhook 401·타임아웃, Gateway audit.

1. /v1/models/v1/chat/completions

GET /v1/models 후 스트림을 겁니다. 모델만 실패하면 경로·접두·가상 호스트를 의심하고, 동일 호스트 curl로 루프백을 맞춥니다. CLI만 초록이면 인그레스, 둘 다 실패면 프로세스·자격을 봅니다.

2. Authorization을 Gateway 검증과 맞추기

Bearer 스킴을 문서화하고 헤더 없음·스킴 오류·시각 틀어진 JWT 샘플을 남깁니다. CLI 비밀과 맞춘 뒤 모델을 헤더 유·무로 두 번 호출합니다.

3. openclaw gateway status --require-rpc

--require-rpc는 HTTP가 쓰는 RPC에 답을 강제합니다. 배포 직후 실행하고, status 통과·HTTP만 401이면 프록시 헤더·URL과 curl 불일치를 봅니다.

4. 스트리밍 타임아웃 재현

긴 간격 프롬프트로 유휴 TCP를 재현하고 프록시 curl을 비교합니다. RAM 포화는 플러시를 늦추니 무거운 작업은 분리합니다.

5. 401 매트릭스

네 행 표(익명·베어러·논스트림·스트림)에 원문을 붙입니다. 스트림만 401이면 중간 재인증, 전부 실패면 gateway.auth·핫 리로드, SDK 헤더 누락을 봅니다. 2026.5.x는 Node 단일·doctor 스냅샷, 고메모리 Mac은 바인드·스트림 제한·--require-rpc 게이트 권장.

macOS·Mac mini와 맞는 이유

통합 메모리·NVMeGatekeeper·SIP·FileVault는 상시 Gateway에 유리합니다. Macstripe 홈에서 리전·용량을 맞추고 Mac mini M4로 앵커를 고정하세요.