OpenClaw 2026년 4월 17일

OpenClaw 구조화 로그, 디스크 예산, LaunchAgent 로그 로테이션(임대 Mac mini, 2026)

VmMac 엔지니어링 팀 2026년 4월 17일 약 17분

렌탈 Apple Silicon Mac mini에서 OpenClaw를 운용하는 플랫폼 엔지니어는 홍콩·일본·한국·싱가포르·미국의 VmMac에서 결국 같은 벽을 맞습니다. launchctl print는 여전히 running인데 게이트웨이가 “죽은 것처럼 보이거나”, stdout을 플러시하지 못해 Webhook이 조용히 500을 반환하는 상황입니다. 본 2026 글은 마케팅이 아니라 구조화 로그, 디스크 쿼터, LaunchAgent StandardOutPath 위생, 재부팅과 멀티 에이전트 버스트를 견디는 로테이션 의미에 대한 운영 계약입니다. Mac mini 설치 및 배포, 에이전트에 의한 재시작 후 게이트웨이 복구, 데몬 및 포트 문제 해결, Webhook과 cron 트리거와 함께 읽어 VmMac 베어 메탈에서의 실제 운영과 관측 가능성을 맞추세요.

2026 세션 규율로 헤드리스와 GUI 레인을 이미 나눴다고 가정하고, 여기서는 바이트가 디스크 어디에 쓰이는지와 대상이 사라지거나 가득 찰 때 launchd가 어떻게 행동하는지만 다룹니다.

비밀·환경 변수가 LaunchAgent plist에 어떻게 실리는지까지 맞춰보려면 OpenClaw 비밀·환경·plist(Mac mini, 2026)도 함께 보세요.

launchd 아래 StandardOutPath／StandardErrorPath 함정

LaunchAgent가 ~/Library/Logs/나 /usr/local/var/log/를 가리키면 티켓에서 지배적인 실패는 세 가지입니다. 재이미징 후 디렉터리 미생성, 작업 사용자 변경으로 인한 권한 드리프트, 단일 파일의 무제한 증가로 여유 공간 SLO를 깨는 경우입니다. launchd는 종종 잡을 살려 두지만, 가득 찬 디스크의 백프레셔는 지연·JSON 중간 손실·헬스 체크 타임아웃으로 나타나며 실제로는 쓰기에서 프로세스가 블록됩니다.

  • 프로비저닝 단계에서 경로를 미리 만들고 첫 수동 성공에만 의존하지 않습니다.
  • stdout과 stderr를 분리해 오류 급증이 JSONL을 망가뜨리지 않게 합니다.
  • 메이저 설정마다 경로에 버전을 붙여 보존 정책을 섞지 않고 diff 가능하게 합니다.

디스크 예산: 에이전트·게이트웨이 로그의 호스트별 쿼터

공유 Mac mini 풀에서는 상세 에이전트 트레이싱을 켜기 전에 하드 예산을 할당합니다. OpenClaw와 Xcode 사이드카를 동시에 돌리는 512 GB 호스트의 실용적인 시작 분할:

슬라이스 예약 알림 임계값 소유자
게이트웨이 JSONL 롤링 20 GB 사용 16 GB 플랫폼
에이전트별 디버그 에이전트당 8 GB 6 GB 팀 체크아웃
시스템 + Xcode 캐시 나머지 여유 < 40 GB 공유 정책
중단 규칙: 연속 이틀 밤 로테이션 후에도 여유가 35 GB 미만이면 용량이 부족합니다. 로그 상세도를 맹목적으로 내리기 전에 다른 VmMac 리전에 호스트를 추가하세요.

로테이션: copytruncate vs Reopen vs 앱 내

macOS 팀은 Linux logrotate 패턴을 차용하기 쉽습니다. copytruncate는 reopen 시그널이 필요 없어 매력적이지만 버스트 Webhook에서는 JSON을 객체 중간에서 자를 수 있습니다. 게이트웨이가 지원하면 크기 기반 + 원자적 rename을 선호하고, cron 템포와 조용한 구간을 맞추는 사이드카 로테이터도 선택지입니다. 내부 ADR에 결정을 남겨 온콜이 한 분기에 두 번 “로테이션 수정”을 하지 않게 하세요.

테스트 매트릭스: 로테이션 중 p95 Webhook 페이로드의 10× 버스트를 재생하고, 소비자가 잘못된 JSON을 보면 그 부하에 전략이 틀린 것입니다——logrotate 탓이 아닙니다.

LaunchAgent plist 강화 체크리스트

  1. WorkingDirectory를 쓰기 가능한 상태 디렉터리로 명시하고 비대화 세션의 $HOME 모호성을 제거합니다.
  2. ThrottleInterval을 조정해 크래시 루프가 로그 폭풍을 키우지 않게 합니다.
  3. EnvironmentVariables에 로그 레벨과 리전 태그(VMMAC_REGION=jp)를 구조화 필드에 넣습니다.
  4. 어떤 사용자 도메인이 에이전트를 로드하는지(launchctl bootstrap gui/$UID 등)를 소프트 의존성으로 문서화합니다.
  5. ExitTimeOut을 게이트웨이 복구의 정상 종료 리듬에 맞춥니다.

로그는 “정상”인데 헬스가 실패할 때 6단계

  1. OpenClaw 자체를 건드리기 전에 여유 공간과 inode를 확인합니다.
  2. plist 경로가 존재하고 잡을 로드하는 사용자 도메인과 일치하는지 검증합니다.
  3. stdout JSONL과 stderr를 따로 마지막 200줄 tail합니다.
  4. 인그레스 층의 Webhook 타임스탬프와 상관합니다.
  5. 카나리아 에이전트만으로 제어된 버스트를 재현합니다.
  6. 보존 변경과 문서화된 SLO 업데이트로 앞으로 롤합니다.

게이트웨이 복구 스크립트가 터미널에서는 성공하고 CI에서는 실패할 때 원인은 종종 상대 로그 경로나 환경 변수 누락으로 실효 로그 디렉터리가 바뀌는 경우입니다. stdout 수정을 데몬 문제 해결의 권한 매트릭스와 함께 검증하고, TCC가 보조 작성자를 여전히 막는데 승리를 선언하지 마세요.

FAQ: Mac mini의 OpenClaw 로그와 디스크

StandardOutPath를 무한히 늘려도 되나요? 기술적으로는 가능하지만 운영상 디스크를 가득 채우고 쓰기를 정체시킵니다——상한과 로테이션을 두세요.

copytruncate는 괜찮나요? 버스트에서 JSON 무결성을 증명할 수 있을 때만. 그렇지 않으면 더 안전한 로테이션을 쓰세요.

“게이트웨이 다운” 페이지와의 관계? 흔히 디스크 또는 경로 드리프트입니다. 바이너리를 다시 배포하기 전에 로그를 확인하세요.

2026년에도 로그 집약 OpenClaw에 Mac mini M4가 맞는 이유

Apple Silicon Mac mini는 빠른 NVMe와 충분한 지속 쓰기 처리량으로 구조화 로그를 “이론 체크”가 아니게 만들고, 상시 에이전트에서도 열을 안정적으로 유지합니다. 다섯 지역에서 렌탈하면 보존 정책을 가진 팀 옆에 카나리아 게이트웨이를 두기 쉽습니다. 로그 경로를 API 계약처럼——버전·테스트·지루함——다루면 OpenClaw는 조용할 때뿐 아니라 트래픽 급증 시에도 관측 가능합니다.

로그 안전 카나리아 호스트 구축

가장 가까운 VmMac 리전에 Mac mini를 추가해 프로덕션 보존을 바꾸기 전에 웹훅 버스트 하에서 로테이션을 검증합니다.