openclaw gateway status가 이미 Runtime: running인데 Telegram에서는 답이 없고, Chrome 확장 Relay는 회색이며, 로그에 409 Conflict가 보이면 2026년 배포에서 가장 흔한「삼중 증후군」입니다. 제어 면은 정상이나 업무 채널이 닫혀 있습니다. 설치를 마친 뒤 OpenClaw를 7×24 프로덕션으로 올리는 개발자에게 사연 프로브, 증상 대조표, 6단계 검수 Runbook과 FAQ를 제공합니다. 사이트의 반설치 복구, channels probe 전용 글, gateway not ready와 역할을 나누어 잘못된 단계에서 설정을 바꾸지 않도록 합니다.
많은 팀이 「설치 성공」을 「외부 서비스 가능」과 동일시합니다. OpenClaw 2026 아키텍처에서 Gateway 프로세스, 채널(Telegram / WhatsApp 등), 브라우저 Relay는 서로 독립된 세 경로입니다. 첫째는 RPC와 제어 면만 보장하고, 나머지는 Token, Webhook 모드, 페어링, 확장 WebSocket 주소, 리버스 프록시 Upgrade에 의존합니다. 아래 6가지 증상 중 2개 이상이면 본 글 경로를 따르고, 머신 전체 재설치는 피하세요.
Telegram 완전 무응답: Bot은 온라인인데 inbound가 없습니다. 흔히 409(동일 Bot Token 다중 Gateway) 또는 잔존 Webhook이 polling을 막습니다.
로그에 409 Conflict: 동일 BOT_TOKEN을 두 번째 Gateway, 구 컨테이너, 로컬 디버그가 동시 long-polling합니다.
Chrome Relay 배지는 켜지나 탭 없음: 확장이 잘못된 포트/호스트에 연결되거나 Nginx가 Upgrade: websocket을 전달하지 않습니다. 2026.3.22+ relay 드라이버 변경 시 크로스 머신은 공식 변경을 대조하세요.
channels probe 실패, gateway status 정상: 페어링 미승인 또는 dmPolicy 차단이 많으며 Gateway 미설치가 아닙니다. channels probe 전용 글을 참고하세요.
원격 CLI Unauthorized: 설정 키가 gateway.token에서 gateway.auth.token으로 이전되었습니다. openclaw doctor --generate-gateway-token 후 재시작하세요.
18789 EADDRINUSE: 표면 running이나 오래된 PID입니다. 포트 정리 후 gateway restart하세요. 채널 설정을 먼저 대량 변경하지 마세요.
| 보이는 현상 | 본 글 우선(배포 후 삼중) | 전환할 전용 글 |
|---|---|---|
| install.sh 성공, Gateway 없음 | 아니오 | 반설치 복구 |
| gateway status: not ready / OOM | 아니오 | gateway not ready |
| running + Telegram 409 / 무응답 | 예 | 페어링 병행 시 + channels probe |
| running + Relay 끊김 | 예 | 공개 노출 시 + Gateway 보안 / Tailscale 글 |
| models Unauthorized | 일부(Token 키) | 인증 트러블슈팅 |
「Gateway 프로브 OK」는 제어 면이 살아 있다는 뜻일 뿐입니다. 채널과 브라우저 Relay는 각각 검수를 통과해야 배포가 완료됩니다.
순서는 고정입니다. 먼저 Token을 소비하는 Gateway가 한 대뿐임을 증명한 뒤 페어링과 Relay URL을 다룹니다. 409가 남은 채 openclaw gateway restart를 반복하면 로그만 더 어지러워집니다.
사연 프로브(약 5분): openclaw status → openclaw gateway status --deep → openclaw channels status --probe → openclaw doctor --deep. 다른 터미널에서 openclaw logs --follow로 inbound를 확인합니다.
Telegram Token 점검: curl "https://api.telegram.org/bot<TOKEN>/getMe"로 Bot 유효성 확인. Webhook 이력이 있으면 deleteWebhook으로 polling을 복구합니다.
409 제거: 다른 Gateway/디버그(구 Docker, 동료 PC의 동일 Bot)를 중지합니다. 전역에 하나의 인스턴스만 Token을 보유하게 합니다.
페어링과 dmPolicy: openclaw pairing approve telegram <CODE>. probe 실패 시 channels 전용 글에서 dmPolicy를 조정하세요. Gateway를 0.0.0.0에 노출해 시험하지 마세요.
Chrome Relay: 확장의 Gateway URL은 실제 리슨과 일치해야 합니다(로컬은 ws://127.0.0.1:18789 등, 리버스 프록시는 wss://와 Upgrade). 크로스 머신은 2026.3+ relay 변경 영향을 확인합니다.
재시작과 재검: openclaw doctor --fix → openclaw gateway restart → 다시 channels status --probe. macOS 상주는 launchd 글, Linux는 Ubuntu systemd 배포를 참고하세요.
# 배포 후 사연 프로브 + Telegram Webhook 정리 예시 openclaw status openclaw gateway status --deep openclaw channels status --probe openclaw doctor --deep curl -s "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getMe" curl -s "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/deleteWebhook" openclaw pairing approve telegram YOUR_CODE openclaw gateway restart
팁: Gateway가 실제로 리슨하지 않으면 먼저 반설치 복구를 읽고 본 글로 돌아오세요. 잘못된 단계에서 유효 설정을 지우지 마세요.
주의: 진단을 위해 일시적으로 0.0.0.0에 바인딩하는 것은 고위험입니다. 프로덕션은 loopback + Tailscale/터널을 유지하고, Token 교체는 인증 전용 글을 참고하세요.
gateway.auth.token에 통일합니다. 구 키만 바꾸면 「로컬 doctor 통과, 원격 CLI 401」처럼 보입니다.Connection: upgrade가 없으면 「확장은 켜지나 탭 없음」이 흔합니다.절전 노트북이나 CI와 리소스를 나눠 쓰는 공유 Mac에 Gateway를 두면 OS 업데이트나 포트 경합 후 삼중 증후군이 재발합니다. 전용·상시 온라인 macOS 노드가 7×24 채널과 Relay에 더 적합합니다. VPS를 빌리는 감각으로 SSH 유지보수 가능한 Mac 연산과 「사연 프로브」를 표준 이미지에 실을 때 NodeMini Mac Mini 클라우드 대여가 운영상 유리합니다. OpenClaw 원격 모드·iOS CI와 같은 운영 마인드로 「집 Gateway는 자고, 사무실 Bot이 Token을 가져간다」 같은 인위적 409를 줄일 수 있습니다.
3절 Runbook을 따르세요. 먼저 channels status --probe, 이어 409, deleteWebhook, pairing approve를 확인합니다. 노드 사양은 대여 요금을 참고하세요.
channels 전용 글은 페어링과 dmPolicy에 초점을 둡니다. 본 글은 Gateway 기동 후 채널 침묵, Chrome Relay와 409 조합을 다룹니다. 두 글을 연속으로 읽는 것을 권합니다.
일부 버전에서 확장 relay 드라이버가 조정되었습니다. 크로스 머신은 릴리스 노트를 대조하세요. 접속·감사는 헬프 센터를 확인하세요.