2026년 OpenClaw 디스크 고갈, JSONL 로테이션, ProxyMac Mac mini 의 APFS purgeable 여유
OpenClaw 를 Mac mini M4 렌탈 노드(홍콩·일본·한국·싱가포르·미국)에 올린 팀이 가끔 마주치는 잔인한 실패 모드가 있습니다. MCP 도구가 타임아웃하고 에이전트가 재시작 루프에 빠지는데 top 은 한가합니다. 원인은 흔히 단순한 디스크 압박입니다. Apple Silicon 데스크톱도 NVMe 할당량은 유한하고, 끊임없는 JSONL 진단(로깅 가이드), 컨테이너 레이어, Xcode DerivedData 잔여물이 실효 여유를 5GB 아래로 밀면 APFS 가 작은 쓰기용 익스텐트조차 내기 어려워지고 자식 프로세스는 ENOSPC 로 끝나며 정중한 배너 없이 조용합니다. 이 글은 OpenClaw 안에서 그것이 어떻게 표면화되는지, df 와 디스크 유틸리티를 어떻게 읽는지, launchd 와 맞는 로테이션 설계, 그리고 헬스 프로브·게이트웨이 복구 플레이북 옆에 둘 알림 배선을 설명합니다.
장시간 소크 테스트에서만 터지는 배포 이슈를 쫓을 때는 CPU 그래프보다 먼저 디스크 차트를 열어 습관을 들이세요. 도움말 센터 온보딩과 요금 티어를 함께 보면 스토리지 확장을 재무와 맞추기 쉽습니다.
사용자가 디스크 차트를 보기 전에 OpenClaw 안에서 ENOSPC 가 어떻게 드러나는가
OpenClaw 는 수십 개의 단명 프로세스를 조율합니다. MCP 서버는 줄 끝 JSON 객체를 붙이고, 임베딩 모델은 ~/Library 아래에 샤드를 캐시하며, TCC 프롬프트가 실패하면 콘솔에 크래시 덤프가 쌓입니다. write(2) 가 공간 부족을 반환하면 Node 가 stderr 를 플러시하기 전에 예외를 던질 수 있어—대시보드에는 «도구 사용 불가»만 보입니다. 멀티시간 스트레스 뒤에만 나타나는 배포 트러블슈팅 증상을 쫓을 때는 디스크 점검을 같은 티켓에 묶으세요.
- 증상 A: MCP 하위 프로세스가 종료 코드 1 과 빈 로그로 끝남.
- 증상 B: 게이트웨이 LaunchAgent 가 크래시 리포트 없이 45–90초 마다 다시 뜸.
- 증상 C: 디스크 유틸은 «50GB 사용 가능»인데
df -h는 다름—APFS 스냅샷이 공손히 거짓말을 함.
이 세 가지는 각각 로그 파이프, PID 1 근처의 재시작 정책, APFS 회계를 가리키므로 같은 런북에서 순서대로 제거하면 재설치 난사를 줄일 수 있습니다.
APFS 여유, purgeable 바이트, Docker·Xcode 가 조용히 터지는 이유
APFS 는 purgeable 캐시에서 여유를 빌려 옵니다—사진 파생물, 타임머신 로컬 스냅샷, 파일 프로바이더 플레이스홀더가 해당합니다. 압박이 오면 테라바이트를 회수하지만, 그 전까지 df 는 92% 사용으로 보이고 파인더는 숨 쉴 공간이 있다고 말할 수 있습니다. tmutil listlocalsnapshots / 와 diskutil apfs listVolumeGroups 를 비교하세요. 컨테이너 런타임은 Data 볼륨 위에 overlayFS 를 올리므로 안 쓰는 이미지를 지우면 CI 집약 호스트에서 18–40GB 가 돌아오는 경우가 흔합니다. OpenClaw 와 모델 캐시를 위해 최소 15GB 의 안정 여유를 상시로 두세요—그보다 빡빡하면 야간 cron 압축 레이스에서 조건 경쟁이 납니다.
디스크 IO 가 포화되면 MCP 지연이 패킷 손실처럼 보이므로, WAN 을 의심하기 전에 iostat 나 Activity Monitor 의 디스크 탭을 함께 보는 것이 정직한 분리입니다.
launchd 와 협력하는 JSONL 로테이션 패턴
JSONL 은 nginx 로그처럼 다루세요. 파일이 150MB 를 넘기면 회전하고, 7 일치 압축 아카이브를 유지하며, 컴플라이언스가 허용하면 차가운 줄은 객체 스토리지로보냅니다. macOS 에서는 단순 경로에 newsyslog, 사용자 에이전트에는 임계값을 넘기기 전에 mv app.log app-$(date +%s).log 를 호출하는 작은 bash 가드로 OpenClaw 로거를 감쌉니다. Linux Ansible 역할을 그대로 복사한 외부 logrotate 바이너리에만 의존하지 마세요—Gatekeeper 경로 드리프트로 팀이 상처 입은 사례가 있습니다. 회전 설정은 설정 버저닝에 Git 으로 추적되는 구성과 맞춥니다.
증상 조회 표: 운영자 언어를 디스크 사실로 번역
| 암호 같은 증상 | 디스크 신호 | 즉시 명령 |
|---|---|---|
| 「6시간 뒤 모델이 멈췄다」 | 볼륨 95% 돌파 | df -h /System/Volumes/Data |
| 「에이전트가 계속 재시작한다」 | JSONL 추가 불가 | ls -lh ~/Library/Logs/OpenClaw/*.jsonl |
| 「다운로드가 사라졌다」 | purgeable 캐시 급회수 | 디스크 유틸리티 퍼스트 에이드 + 스냅샷 정리 |
OpenClaw 를 재설치하기 전 6단계 디스크 트리아지
- 스냅샷 현실:
df,diskutil info,tmutil listlocalsnapshots를 한 티켓 첨부에 묶습니다. - 무거운 트리:
du -hd1 ~로 Logs·Library·워크스페이스에 집중합니다. - JSONL 회전: 위 패턴을 적용한 뒤 launchd 잡이 여전히 기동하는지 확인합니다.
- 오래된 스냅샷 정리: 박스 밖 백업이 있다는 전제 하에만 수행합니다.
- OpenClaw 재시작: 게이트웨이 복구의
launchctl kickstart순서를 따릅니다. - 디스크 알림 추가: 가용 바이트가 20GB 아래로 5분 연속이면 가동률 핑과 함께 울리게 합니다.
용량 계획: 기가바이트를 운영 결정으로 번역
기본 512GB SSD 도 세 팀이 한 대를 쓰면 순식간에 좁아집니다. Xcode 툴체인 40GB, 캐시된 모델 60GB, 야간 통합 아티팩트 90GB—나쁜 주말 하나면 여유 0에 닿습니다. 워크로드 밴드를 명시적으로 나누세요. 대화형 개발자에게 최소 80GB, 독립 스냅샷이 가능한 APFS 볼륨에 CI 스필오버 40GB, APFS 메타데이터 팽창용 비상 버퍼 25GB 미할당. 85% 사용이 6시간 넘게 지속되면 프로바이더 페일오버 패턴으로 에이전트 트래픽을 넘기고 로그를 정리하세요—MCP 가 무너진 뒤가 아니라 그 전에.
미니에 마운트한 SMB 공유도 같은 디스크 풀을 씁니다. JSONL 과 같은 폴더에 수백 메가바이트 PSD 를 쌓지 마세요—보존 정책이 맞을 때만. 규제보내기는 보안 검토가 허용할 때만 외장에 압축하고, 아니면 내부 SSD 위 암호화 스파스 번들에 문서화된 수명을 붙이세요. 기가바이트 결정은 설정 버저닝 저장소 옆에 두어 재무가 다음 티어 요청 이유를 추적할 수 있게 하세요.
디스크 스냅샷은 브랜치 포인터와 같습니다. 이해하면 멋지고, 무시하면 재앙입니다. JSONL 난류에 대해 스냅샷 델타가 작다는 증거가 있기 전에는 무거운 ZFS 스타일 보존을 도입하지 말고, 회전한 평면 파일과 콜드 스토리지보내기에 머무르세요. 아카이브 삭제 전 누가 서명하는지 문서화하지 않으면 감사인은 디스크 압박이 올라간 순간 증거를 버렸다고 가정합니다. 자정 대응 노트에는 컨테이너 UUID 를 추측하지 않도록 diskutil apfs list 푸터를 인쇄해 넣으세요.
FAQ
통합 로깅을 끄나요? /var/db/diagnostics 를 지우는 대신 서브시스템 장황함을 낮추세요.
iCloud 최적화가 OpenClaw 워크스페이스와 겹치나요? 예—바탕화면/문서 최적화가 쓰기를 지연시킬 수 있으니 에이전트 디렉터리는 제외합니다.
RAM 디스크 캐시는? M4 에서 일시 빌드에는 유용하지만 크기는 상한을 두고 도움말 런북에 캡을 문서화하세요.
디스크 집약 에이전트에 ProxyMac Mac mini 가 현실적인 플랫폼인 이유
렌탈 Mac mini M4 는 과구독 하이퍼바이저보다 예측 가능한 마모의 빠른 SSD 를 제공하고, 하드웨어를 배송하지 않고 HK / JP / KR / SG / US 리전을 맞출 수 있으며 APFS 스냅샷을 컴플라이언스 보존에 맞출 수 있습니다. 디스크 위생은 투명한 요금과 짝을 이루고, 운영자는 도움말 센터 경로를 타며, 파인더 정리가 SSH 보다 빠를 때는 VNC 로 GUI 디버깅을 하면 됩니다.
