고통 분해: 거부는 모욕이 아니다
고통 1: 도구 실패를 모델 퇴보로 단정한다. 대개 정책 거부다.
고통 2: 업그레이드 후에도 서비스 유닛을 방치한다. launchd·systemd가 낡은 진입을 가리키면 RPC 불일치가 난다.
고통 3: 채널 침묵을 곧바로 커넥터 탓한다. 세션 ID와 라우팅 키를 먼저 고정하라.
고통 4: doctor 출력을 가볍게 본다. 복구는 비밀과 기동 의미를 건드린다.
위협 모델과 증거 층
설정 자동화: 모델은 빠르지만 설정은 제어 평면이다. 호환 셈이나 느슨한 검증을 여는 패치는 감사로 막아야 한다.
프로세스 무결성: 단일 정식 진입은 부분 업그레이드 뒤 여러 번들이 공존할 때 혼선을 줄인다.
전송: TLS, WebSocket, 토큰 전달은 리버스 프록시 런북의 주제다. 감사 실패와 섞지 말라.
세션: 공유 라우팅 상태는 하우스키핑 턴에서도 유지되어야 한다. 합성 이벤트가 메타데이터를 망가뜨리면 오배송·침묵이 생긴다.
결정 행렬
| 증상 | 1차 | 2차 |
|---|---|---|
| 패치 거부 | 감사 대 패치 JSON | 사람 승인 최소 변경 |
| 업그레이드 후 RPC·doctor 이상 | 서비스 Exec 줄 | 포트 충돌·중복 게이트웨이 |
| 무작위 침묵 | 합성 턴 주변 라우팅 로그 | MCP 자식·FD |
| RSS·거대 JSONL | 세션 로테이션 | 핀·롤백 |
절차: 명령이 닻이다
# 1) 버전 기록
# openclaw --version
# openclaw gateway --version
# 2) 보안 감사
# openclaw security audit
# 3) 서비스 정의로 진입 확인
# macOS: launchctl print ...
# Linux: systemctl cat openclaw-gateway.service
# 4) 공식 래더
# openclaw status
# openclaw gateway status
# openclaw logs
# openclaw doctor
1단계: 자동 패치를 프로덕션에 받기 전 시맨틱 버전과 해시를 얼린다.
2단계: 실패 시 감사 보고서와 패치를 나란히 놓고 필드별로 비교한다.
3단계: 진입이 의심되면 템플릿에서 유닛을 재생성하고 doctor를 다시 돌린다.
4단계: 라우팅 이상에서는 heartbeat·cron·exec 시각과 사용자 증상을 상관한다.
5단계: MCP는 전용 글을 따르고 stdio 누수 시 콜드 재시작을 검토한다.
6단계: 롤백마다 핀과 스냅샷 위치를 남긴다.
지표 기준선
RSS, RPC 지연 분위, 재연결, 세션 파일 증가율을 추적한다. 업그레이드 창 밖 스파이크는 감사·진입 확인부터 시작한다.
운영 메모
설정은 클라우드 IAM만큼 엄격하게 다루고, 스테이징에서 정책 거부를 먼저 본다.
리버스 프록시 담당과 릴리스 달력을 맞추고 TLS·WebSocket 오류를 게이트웨이 결함으로 오인하지 말라.
결정은 버전 관리에 남기고 감사 해시에 링크한다.
온콜은 감사 JSON과 stderr를 읽을 수 있게 교차 훈련한다.
Telegram·WhatsApp이 잦은 마이너 뒤 불안정하면 4.x 런북을 병행하고 토큰 순환과 시맨틱 버전을 분리한다.
로컬 추론 엔드포인트와 병행할 때 CPU 병목이 증상을 키우지 않는지 본다.
거대 JSONL은 4.5 글의 저장 논점이고 라우팅 논점과 혼동하지 말라.
관측 벤더의 AI 대시보드는 설정 수집이 과한지 먼저 검증한다.
데이터 상주 규제가 있으면 세션 아카이브 위치를 법무와 맞춘다.
성능 테스트는 거대 프롬프트로 라우팅 테이블을 압박하고 프록시 뒤 프레임 한도와 충돌하는지 본다.
카오스 실험은 결산 기간을 피해 일정을 잡는다.
문서는 짧은 영상으로도 보강해 절차를 사람에게 묶지 않는다.
거부된 패치가 주말 장애를 막은 사례는 경영진용으로 기록해 안전 게이트 투자를 정당화한다.
FAQ와 호스트형 원격 Mac
감사를 끄면 되나요?
단기 통과와 바꿔 가시성을 잃는다. 승인·스테이징·좁은 패치를 써라.
진입 드리프트 증명은?
실행 argv, 유닛, 릴리스의 정식 진입을 대조하고 필요 시 디스크 해시를 비교한다.
요약: 2026.4.14는 설정 자동화가 보안 이야기 안에 머물러야 함을 다시 말한다.
한계: 셀프호스트는 스냅샷·비밀 순환·유닛 관리가 당신의 책임이다.
맺음말: SFTPMAC 호스트형 원격 Mac은 Apple 호환 하드와 예측 가능한 유지보수 창으로 게이트웨이와 파일 전달을 안정적으로 돌리려는 팀에 맞는 선택이다.
감사 기준선·서비스 정의·세션 거버넌스를 하나의 버전형 런북에 모으세요.