2026 OpenClaw 수호 통합 실전
대여 Mac Mini에서 헬스 체크·이상 Webhook 알림 재현 절차
대여 Mac Mini에서 OpenClaw를 상시 구동할 때 가장 큰 리스크는 세션 끊김·프로세스 유실·알림 공백입니다. 이 글은 설치·기동, launchd 수호, 헬스 프로브, 이상 Webhook, 종료 코드 표를 한 런북으로 묶어 재현 순서를 고정합니다. 배포 보조 흐름은 Ollama·상시 가동 글과 cron·워치독 글을 함께 보세요.
① 운영 시 자주 막히는 지점
- SSH만 켜 두고 프로세스가 로그아웃과 함께 종료되는 경우.
- 포트는 열렸으나 내부 헬스 경로가 죽었는데 외부에서 알 수 없는 경우.
- 알림 채널이 여러 개인데 페이로드 형식이 제각각이라 on-call이 놓치는 경우.
② 수호 방식 비교 한눈에
| 방식 | 적합한 경우 | 주의 |
|---|---|---|
| 수동 nohup | 단기 테스트 | 재부팅·세션 종료에 취약 |
| cron 보조 | 주기 점검·워치독 | 상단에서 안내한 cron·워치독 글과 병행 |
| launchd LaunchAgent | 로그인 사용자 상시 | plist·로그 경로 표준화 |
③ 재현 단계 체크리스트
- 설치·기동: 패키지 매니저 또는 공식 절차로 OpenClaw를 올리고
openclaw doctor로 의존성·포트·모델 경로를 확인합니다. - launchd:
~/Library/LaunchAgents/에 plist를 두고RunAtLoad·KeepAlive·표준출력·표준에러를 파일로 남깁니다. - 프로브 스크립트: 분 단위 혹은 launchd의
StartInterval로 별도 에이전트를 두어 메인 프로세스와 HTTP 응답을 검사합니다. - Webhook: 프로브 실패 시에만 POST하도록 가드하고 동일 JSON 스키마를 유지합니다.
- 런북 고정: 종료 코드 표를 팀 위키에 붙여 대응 시간을 줄입니다.
④ 헬스 프로브 설계
로컬 루프백에 노출한 관리용 HTTP가 있으면 curl -fsS --max-time 3 URL 한 줄로 성공·실패를 이진화합니다. 없다면 pgrep -f 패턴과 최근 로그 타임스탬프를 함께 보세요. 실패 시 exit 1만 반환하면 launchd·모니터링이 같은 규칙으로 잡습니다.
⑤ 이상 Webhook JSON 필드 예시
슬랙·디스코드·사내 게이트웨이 공통으로 아래 필드를 맞추면 파서 한 벌로 처리할 수 있습니다.
{
"event": "openclaw.health_failed",
"severity": "critical",
"host": "runmini-mac-node",
"ts": "2026-03-24T12:00:00Z",
"probe": "http_127_0_0_1_health",
"exit_code": 22,
"message": "curl HTTP non-2xx",
"runbook_url": "https://runmini.com/ko/blog/articles/2026-openclaw-zu-yong-mac-mini-shou-hu-launchd-healthcheck-webhook.html#exit"
}
전송 예: curl -H "Content-Type: application/json" -d @payload.json YOUR_WEBHOOK_URL
⑥ curl·셸에서 자주 보는 종료 코드
| 코드 | 의미(요지) | 점검 |
|---|---|---|
| 1 | 일반 실패 | 스크립트 set -e·조건 분기 |
| 2 | 셸 내장 misuse | 문법·중괄호 누락 |
| 6 | 호출한 명령 없음 | PATH·심볼릭 링크 |
| 7 | 인자 오류 | curl URL·인증서 플래그 |
| 22 | curl -f 비HTTP성공 | 서비스 다운·프록시 |
| 124 | timeout 초과 | 네트워크·부하 |
| 126·127 | 실행 불가·명령 없음 | chmod·설치 경로 |
| 130·137 | SIGINT·SIGKILL | 수동 중지·OOM 킬 |
바로 쓰는 수치·규칙 3줄
- 프로브 타임아웃 3초·실패 시에만 Webhook 1회·재전송은 지수 백오프.
- launchd 로그는 일별 로테이션 경로로 고정해 원인 추적 시간을 줄입니다.
- 노드 확보는 로그인 없이 구매 페이지에서 플랜을 고르고 운영 런북을 이어 가세요.
마무리
수호·프로브·알림을 같은 스키마로 묶으면 대여 맥에서도 온콜 피로가 줄고 장애 패턴이 눈에 들어옵니다. 지금 노드가 필요하면 아래 CTA에서 Mac Mini 대여로 이어지는 바로 구매 흐름을 이용하세요.