페인 포인트: 증거 없는 단정 금지
1: 스레 제목을 릴리스 노트로 취급하지 않습니다.
2: 메모리만 보고 JSONL 부하를 놓치지 않습니다.
3: 채널 정체에 즉시 강제 종료하지 않습니다.
4: 게이트웨이보다 리버스 프록시를 먼저 의심합니다.
5: 롤백 전 스냅샷을 생략하지 않습니다.
증상 묶음(공개 토론과 정렬)
2026.4.5 주변 공개 토론에서는 설정이 무시된 것처럼 보인다, RSS가 서서히 오른다, JSONL이 커질 때 채널이 무겁다, 프록시 경로에서 WebSocket 인증이 흔들린다는 서술이 반복됩니다. 이들은 관측 묶음이며 단일 근본 원인을 자동으로 의미하지 않습니다.
설정: 실제 로드 경로와 해시를 확인하고 4.x doctor와 게이트웨이 doctor 래더를 실행합니다. 설치 이슈는 daemon 재설치 런북으로 돌아갑니다.
메모리·자식 프로세스:MCP stdio와 재시작을 참고해 프로세스와 핸들을 봅니다.
JSONL:유지보수 창에서 로테이션하고 샘플을 보존합니다. 홈이 동기 폴더면 고속 로컬 볼륨으로 옮깁니다.
WebSocket:TLS와 헤더를 확인하고 페어링·버전 드리프트를 배제합니다. 직결과 프록시를 반드시 분리 테스트합니다.
롤백:스냅샷 절차로 유닛·환경 변수·토큰을 저장한 뒤 4.4.x를 카나리에 고정하고 확대 여부를 판단합니다.
의사결정 매트릭스
| 경로 | 선택 시점 | 이점 | 리스크 |
|---|---|---|---|
| 2026.4.5 유지+위생 | JSONL 로테이션과 MCP 재기동 후 완화 | 최신 수정 유지 | 관측 부담 |
| 설정만 고정 | doctor가 필드 rename을 지적 | 최소 폭발 반경 | 바이너리 이슈면 재발 |
| 4.4.x semver 고정 | 카나리에서 재현성 높음 | 규제 워크로드에 유리 | 기술 부채 |
| 스냅샷 전체 복원 | 상태 손상 의심 | 일괄 복귀 | 다운타임 |
실행 단계(6단계)
# 증거 번들 예시(경로는 환경에 맞게 수정)
# date > /tmp/openclaw-incident.txt
# ps aux | grep -i openclaw >> /tmp/openclaw-incident.txt
# shasum openclaw.json >> /tmp/openclaw-incident.txt
# ls -lh ./sessions/*.jsonl >> /tmp/openclaw-incident.txt
1단계:버전, 유닛, 환경 변수, 설정 해시, 중요 토큰을 저장합니다.
2단계:status→gateway→logs→doctor 순으로 로그를 수집합니다.
3단계:디스크 JSON과 런타임 프로브를 일치시키고 cliBackends 유사 키를 스키마 예시로 재검증합니다.
4단계:JSONL 크기를 측정하고 로테이션 전후 지연·핸들을 비교합니다.
5단계:WebSocket은 직결과 프록시를 분리 검증하고 인증서 체인·쿠키·Authorization을 확인합니다.
6단계:증거가 정리된 뒤에도 지속되면 4.4.x를 카나리에 고정하고 24시간 RSS·재연결률을 관측한 뒤 전면 적용을 결정합니다.
지표화 요약
RSS, JSONL 바이트, WebSocket 재연결, 채널 P95, semver·인증서 변경을 동일 타임라인에 올립니다. 완화 조치는 스스로 증명해야 합니다. 원격 Mac에서는 빌드 산출물과 로그의 동시 IO 경쟁을 피하고 세션 출력을 빠른 볼륨으로 옮기면 재현성이 좋아집니다.
FAQ와 SFTPMAC 매니지드 remote Mac이 맞는 이유
cliBackends 이슈는 공식 결함인가요?
doctor와 해시로 실효 설정을 증명한 뒤 판단하세요.
거대 JSONL을 즉시 삭제해도 되나요?
백업과 로테이션을 권장합니다.
WebSocket 실패 시 곧바로 다운그레이드할까요?
직결·프록시 분리 검증을 먼저 수행하세요.
4.4.x는 언제 고정하나요?
규제 요구와 재현성, 스냅샷·연습된 롤백 창이 있을 때입니다.
요약:관측 증상을 로그로 내려 위생 조치와 프록시 검증을 거친 뒤 semver 고정을 선택합니다.
한계:다양한 스토리지와 기업 프록시에서는 지속 조율이 필요합니다.
대비:SFTPMAC 매니지드 remote Mac은 디스크·네트워크 변동을 줄인 검증 환경을 얻기 쉬워 JSONL과 채널 지연 실험을 빠르게 반복할 수 있습니다.
스냅샷, doctor 래더, JSONL 로테이션, TLS 검증을 묶어 운영하세요.