페인포인트: 프로세스가 살아 있어도 게이트웨이는 거짓 양호일 수 있습니다
페인1: PID만으로 합격. 슈퍼바이저가 자식을 재시작 루프에 둘 수 있습니다. 게이트웨이 운용·doctor 순서를 따르세요.
페인2: linger 누락. SSH 종료 후 systemd --user 세션이 사라집니다.
페인3: force와 제거 혼동.gateway install --force는 산출물 복구에 가깝고 제거는 통합면을 걷어냅니다.
페인4: launchd 로그 경로.상시 헬스 참고.
페인5: 프록시 무시.TLS 역프록시 먼저.
페인6: 전형적인 세트 실수. JSON만 보관하고 plist/unit SHA256을 생략하거나, 공용 계정에 loginctl enable-linger를 켜거나, loopback에서만 RPC를 검증하면 불안정처럼 보입니다. gateway install --force를 semver와 같은 티켓에 4.x+doctor, WSL2, 스냅샷과 MCP 콜드 재시작과 연결하고 CLI/게이트웨이 semver, doctor 요약 해시, linger, RPC p95, 인증서 notAfter, 슈퍼바이저 재시작 횟수, 로그 볼륨 여유를 기록합니다.
공식 사다리와 RPC 프로브
openclaw status→게이트웨이 상태→로그→openclaw doctor(fix 없이). doctor --fix는 스냅샷 이후 창에서만. RPC는 클라이언트와 동일 DNS/SNI.
티켓에 UTC, 이중 semver, doctor 요약 해시, linger, 공용 DNS 기준 RPC p95, 인증서 notAfter, 재시작 횟수, 로그 여유를 함께 적습니다. 루프백만 보면 SNI를 놓치기 쉽고, npm/Docker 공존 시 권위 경로를 상단에 명시하세요.
macOS launchd
gateway install --force 후 plist ProgramArguments를 다시 diff합니다.
사용자 도메인과 시스템 도메인 혼동, ThrottleInterval 과다로 인한 이상 감지 지연, StandardOutPath 로테이션 실패는 launchd 특유의 2차 장애입니다. launchctl print의 exit 정보와 로그 inode를 스냅샷에 넣고 gateway install --force 직후 plist를 diff하세요.
systemd --user와 loginctl enable-linger
loginctl enable-linger로 Linger=yes 확인, 콘솔 없이 재부팅 테스트.
daemon-reload 직후 journalctl 타임스탬프로 레이스를 배제하고, 네트워크 홈·VPN 마운트 순서와 ControlMaster 없는 slice 검증을 체크리스트에 넣습니다.
2026 정량 필드·임계값
리슨 주소는 openclaw gateway status 출력을 기준으로 하고, 문서의 18789는 참고만 한다. Node major는 openclaw doctor 하한과 티켓에 고정하고, 로그 파티션은 ≥15% 여유를 유지한다. linger 후 콜드 리부트 1회와 프로덕션과 동일 DNS·TLS의 RPC 1회를 의무화하며, 스냅샷에 plist/unit SHA256과 which openclaw를 둔다.
| 필드 | 예시 | 목적 |
|---|---|---|
| CLI／게이트웨이 semver | 2026.4.x | 사건과 바이너리 연결 |
| plist 또는 unit SHA256 | 64 hex | force 이후 무발화 diff |
Linger | yes／no | 헤드리스 상주 증명 |
| RPC p95 | 예: 사내 엣지 <300 ms | 네트워크와 앱 계층 분리 |
| 로그 볼륨 여유 | ≥15% | 증거 보존 |
gateway install --force와 단계
# 1) openclaw status
# 2) openclaw gateway status
# 3) 채널 ID로 로그 필터
# 4) openclaw doctor
# 5) gateway install --force
# 6) systemctl --user daemon-reload && systemctl --user restart SERVICE
# 7) loginctl enable-linger USER
- JSON·비밀·unit·프록시 조각 스냅샷.
- 사다리를 fix 없이 수행.
- 국소 손상이면 force.
- 슈퍼바이저 리로드 및 MCP 콜드.
- linger와 헤드리스 검증.
- 합성 RPC·채널 프로브.
- 경로 충돌이면 단일 채널로 재설치.
매트릭스 FAQ SFTPMAC
| 상황 | 행동 | 증거 | 리스크 |
|---|---|---|---|
| RPC 실패·프로세스 생존 | 사다리→재시작 | 로그+SNI | 루프백 오판 |
| 산출물 손상 | force repair | doctor 경고 | 핫픽스 소실 |
| SSH 종료 시 중지 | linger | Linger=no | 스코프 오류 |
| npm·Docker 혼재 | 하나 제거 | which 모호 | 긴 다운타임 |
SSH 끊기면 멈추나요
linger와 계정 분리를 확인하세요.
force는 제거인가요
아닙니다.
프로세스만으로 충분한가요
아니요 RPC와 TLS 경계가 필요합니다.
요약: 게이트웨이는 시스템 전체 문제입니다.
한계: 자체 호스팅은 패치·디스크 부담이 남습니다. SFTPMAC 원격 Mac은 SFTP/rsync와 상시를 묶습니다.
연결: 자체 운용의 가치를 인정한 뒤, 워크스테이션 분산 비용을 짚고 호스팅 Mac의 재현성으로 마무리합니다.
버전·스냅샷·linger·RPC를 한 패널에.