운영 현장에서 OpenClaw 게이트웨이는프로세스 PID는 살아 있는데 메시지가 오지 않는「가짜 온라인」처럼 보일 때가 많습니다. 원인은 대개 토큰·프록시·DNS·채널 배선 중 하나가 어긋난 것인데, 이때 곧바로 launchctl kickstart -k만 반복하면 로그 근거가 사라져 재발 때 더 느려집니다. 이 글은로그 채증 → channels status --probe → health --json 순으로 맹목 재시작 전에 분기하는 표를 한글로 묶고, 싱가포르·도쿄·서울·홍콩·미동·미서에 깔린 Mac mini M4 클라우드 Mac에서 같은 런북을 짧게 반복하는 착지 패턴도 덧붙입니다. 베이스라인 설치·토큰 위생은 더 알아보기: Node 22·게이트웨이 1008·channels 점검 FAQ와 같이 보시면 분기가 더 빨라집니다.
1. 로그 채증: 가짜 온라인을 글로 고정하기
게이트웨이 표준 출력·파일 로그에서같은 분 단위로 (1) 인증 실패·토큰 만료, (2) 업스트림 TLS 핸드셰이크 오류, (3) 채널별 ping/pong 타임아웃, (4) 프록시가 넘긴 Connection: close 흔적을 각각 한 줄이라도 찾아 표에 붙여 넣으십시오. doctor 출력과동일 호스트·동일 셸에서 찍은 date·타임존도 함께 넣으면, 나중에 「재시작으로 우연히 복구」했는지 「설정을 고쳐서 복구」했는지 감사하기 쉽습니다. 클라우드 Mac에서 SSH 세션과 launchd 데몬이 서로 다른 PATH·환경 변수를 보면 로그만으로도 split-brain이 드러납니다.
2. channels status --probe가 말해 주는 것
문서에 따라 channels status --probe(또는 동등한 프로브 플래그)를 켜면, 설정 파일에만 존재하는 채널과실제로 핸드셰이크에 성공한 채널이 갈라져 보입니다. 여기서 한쪽만 빨간색이면 재시작보다자격 증명·웹훅 URL·아웃바운드 방화벽을 먼저 의심하십시오. 프로브가 모두 초록인데도 메시지가 없다면 큐·라우팅 레이어(업스트림 봇 플랫폼 상태) 쪽으로 시선을 옮기고, 게이트웨이만 반복 재기동하지 마십시오. 리전별 egress 차이는 더 알아보기: 여섯 리전 Mac mini M4 지연·스토리지·임대 비용 FAQ에서 한 번에 비교할 수 있습니다.
3. health --json로 프로세스 건강과 채널 건강을 분리
health --json은 사람이 읽는 한 줄 요약보다기계가 비교하기 좋은 스냅샷을 줍니다. 필드마다 (a) 로컬 디스크·메모리 같은 OS 지표, (b) 게이트웨이가 스스로 보는 채널 하트비트, (c) 외부 의존성 ping을 나누어 적어 두면, 온콜 도구가 JSON diff로 경보를 낼 수 있습니다. (a)만 나쁘면 스왑·디스크 정리나 인스턴스 사이즈 업,(b)만 나쁘면 채널 재연결,(c)만 나쁘면 DNS·SNI·프록시 정책을 고치는 식으로재시작 이전에 조치 목록이 자연스럽게 갈라집니다.
4. 맹목 재시작 대신 무엇을 할지: 짧은 FAQ
아래는 회의 없이 붙여 넣기 좋은결정 가지입니다. 한 항목이라도 불확실하면 로그 채증을 한 단계 더 거친 뒤 재시작하십시오.
- Q. 프로브는 실패하는데 health OS 지표는 정상이다. A. 아웃바운드·자격 증명·채널 URL을 고치고, 게이트웨이는 재시작하지 않아도 됩니다.
- Q. health에서 메모리·파일 디스크립터가 한계에 닿았다. A. 워크로드 누수 가능성이 높으니 재시작은 임시 완화일 뿐, 근본은 버전 업·설정 조정입니다.
- Q. 둘 다 정상인데 사용자만 못 붙는다. A. 엣지 TLS 종료·회사 프록시·Tailscale split DNS를 의심하십시오. 게이트웨이 재시작은 증상을 가릴 뿐입니다.
- Q. 배포 직후에만 터진다. A. 롤백 전에 동일 JSON을 직전 릴리스와 diff하고, 환경 변수 이름 오타를 먼저 잡으십시오.
5. 싱가포르·일본·한국·홍콩·미동·미서: 빠른 개통과 단기·중기 임대 착지
동일 런북을 여섯 메트로에 복제할 때는같은 Node 메이저·같은 CLI 빌드·같은 프로브 명령 문자열만 고정하고, 리전마다 달라도 되는 것은 egress IP·DNS만으로 제한하십시오. APAC(싱가포르·도쿄·서울·홍콩)은 낮 시간대 트래픽이 겹치기 쉬우니, 장애 연습을 주간 피크에 맞춰 짧은 스파이크로 돌리면 회선 병목을 미리 볼 수 있습니다. 미동·미서는 북미 SaaS 업스트림과 가깝지만 지연은 APAC 사용자에게 불리하므로, 게이트웨이를 사용자 쪽에 두고 빌드 노드만 미국에 두는시트 분리가 흔합니다. PoC는 일·주 단위, 파일럿 이후는 월·분기로 늘리는 비용 곡선은 더 알아보기: 2주~2개월 PoC/MVP 클라우드 Mac 플레이북 FAQ에 정리되어 있습니다.
vpszap 클라우드에서는 증거가 흔들리지 않게 남습니다
위 절차는가상화 없이 물리 Mac mini M4 한 대를 독점할 때 특히 잘 맞습니다. CPU·메모리·NVMe를 이웃과 나누지 않아 프로브 결과가 날마다 달라지는 일이 줄고, 약 5분 안에 SSH와 VNC를 함께 받아 GUI로도 동일 호스트를 확인할 수 있습니다. 과금은 일·주·월·분기이며 장기 약정이 없어 메트로별로 게이트웨이 샌드박스를 잠깐 띄웠다가 접는 비용 실험에 적합합니다. Apple Silicon 단일 아키텍처이므로 JSON 헬스 스냅샷을 리전 간에 비교하기도 수월합니다.
증거 기반 런북을 실제 하드웨어에 붙이고 싶다면 vpszap 클라우드 Mac mini 홈에서 가까운 메트로를 고르십시오.