8GB Mac mini OpenClaw|Swap·통합 메모리 최적화 (2026)
A base Mac mini with 8 GB or 16 GB unified memory is a popular home lab for 24/7 OpenClaw gateways — family WhatsApp bots, cron alerts, or a solo founder’s always-on assistant. Linux tutorials rarely mention macOS memory compression, swap on APFS, or Apple Silicon unified memory where the Gateway (Node.js) and Ollama / MLX local models fight over the same pool.
대부분의 「OpenClaw가 안 켜진다」 글은 CPU 한계가 아니라 RAM 예산 문제입니다. Gateway 기준선만 최근 릴리스 후 콜드 스타트에서 약 400–700MB+ RSS에 달할 수 있습니다( OpenClaw gateway RSS 논의), 플러그인·세션·7B 로컬 모델 로드 전입니다.
이 가이드는 데이터센터 Xeon 랙이 아닌 Apple 생태계 구축자용입니다. M1/M2/M3/M4 Mac mini에서 메모리를 측정·제한·스케줄하는 방법과 링크: OpenClaw 멀티 에이전트 라우팅 가이드 (추가 agent의 RAM 비용), DeepSeek-R1 / 로컬 양자화, and 원격 SSH 운영. 하드웨어 동향: Computex 2026 에이전트 인프라.
소개
이 글은 통합 메모리 예산, RAM 티어, macOS 8단계 런북, 활성 상태 보기 신호, 문제 해결, 상시 OpenClaw용 FAQ 6개를 다룹니다.
통합 메모리: 하나의 풀, 두 개의 무거운 워크로드
Apple은 통합 메모리를 다음에서 설명합니다 Apple Silicon 개요 — CPU, GPU, Neural Engine이 별도 VRAM 없이 같은 메모리에 접근합니다.
| 소비자 | 일반적인 RAM 사용량 | Mac mini에서 조정 가능? |
|---|---|---|
| macOS + WindowServer | 2–4 GB | GUI 로그인 항목 줄이기 |
| OpenClaw Gateway (Node) | 0.4–1.5 GB+ RSS | 힙 상한, 플러그인 축소 |
| 추가 OpenClaw agent마다 | +세션, +워크스페이스 인덱스 | 8GB에서는 agentId 최소화 |
| Ollama 7B Q4 | 약 4–5GB 모델 상주 | 더 작은 quant / 클라우드 API |
| Ollama 3B Q4 | ~2–3 GB | 8GB에서 권장 |
| 스왑 여유 | SSD 여유 필요 | APFS 15–20GB 여유 |
┌─────────────────────────────────────────┐ │ Apple Silicon 통합 메모리 │ │ ┌─────────────┐ ┌─────────────────┐ │ │ │ OpenClaw │ │ Ollama / MLX │ │ │ │ Gateway │◀──▶│ local LLM │ │ │ │ (Node V8) │ │ (model weights) │ │ │ └─────────────┘ └─────────────────┘ │ │ macOS 압축 + swap │ └─────────────────────────────────────────┘
RAM 티어: 8GB vs 16GB 현실적 구성
| 구성 | OpenClaw 운영 | 로컬 LLM | 멀티 에이전트 |
|---|---|---|---|
| 8 GB | 기본 agent 1개, 최소 플러그인 | 3B–7B Q4만 또는 API 전용 | 피하기 — 16GB 이후 bindings |
| 16 GB | agent 1–2개, 적당한 cron | 7B Q4 + Gateway 여유 | 모니터링 시 가능 |
| 24 GB+ | agent 2–3개, 메모리 검색 | 7B–13B quant, MLX 실험 | 홈랩 "스튜디오" 구성에 적합 |
| 32 GB+ | 무거운 cron + 채널 | 직렬화 시 여러 모델 | 24GB와 유사하나 여유 큼 |
- RAM이 8GB이면 → Gateway 24/7, 추론은 클라우드 API 또는 소형 Ollama 1개 — 둘 다 무겁게는 불가.
- RAM이 16GB이면 → 7B Q4 + 단일 Gateway가 Apple Silicon 홈랩 스위트 스팟.
- 3개 이상 격리 agent가 필요하면 → RAM 업그레이드 또는 Gateway와 Ollama를 Mac mini 2대로 분리(두 번째 박스 SSH).
단계별 런북 (macOS)
1단계 — 메모리 압력 기준선
활성 상태 보기 → 메모리를 엽니다. 메모리 압력(녹/노/빨)과 사용된 스왑을 확인하세요.
vm_stat | head -12
sysctl vm.swapusage
memory_pressure 2>/dev/null || true
노/빨 압력은 macOS가 이미 압축 또는 스왑 중 — OpenClaw 추가 전에 해결하세요.
2단계 — OpenClaw Gateway RSS 측정
ps aux | grep -i '[o]penclaw' | awk '{print $2,$4,$6/1024"MB",$11}'
커뮤니티 기준: 구버전 약 350MB, 일부 2026.4.x 콜드 스타트 700MB+. RSS가 매일 오르면 플러그인 정리 전 주간 재시작을 예약하세요.
3단계 — Node.js 힙 상한 (wrapper)
LaunchAgent plist의 직접 NODE_OPTIONS는 재생성 시 제거될 수 있습니다. 다음의 wrapper를 사용하세요: OpenClaw Gateway 설치 문서:
cat > ~/bin/openclaw-memwrap.sh << 'EOF'
#!/bin/bash
export NODE_OPTIONS="--max-old-space-size=2048"
exec /opt/homebrew/bin/openclaw "$@"
EOF
chmod +x ~/bin/openclaw-memwrap.sh
OPENCLAW_WRAPPER="$HOME/bin/openclaw-memwrap.sh" openclaw gateway install --force
openclaw doctor
8GB에서는 힙 1536–2048MB, 16GB에서는 3072–4096MB를 시도하세요. OOM은 ~/Library/Logs/ 또는 콘솔.app에서 확인.
4단계 — lean OpenClaw 설정
~/.openclaw/openclaw.json 편집:
- RAM 업그레이드 전
agents.list1개 - 미사용 channels 및 cron 비활성화
- 8GB에서는 memory search / dreaming 플러그인 연기 (메모리 설정)
- 필요하지 않으면 agent-to-agent 끄기 (멀티 에이전트 문서)
openclaw gateway restart
5단계 — 통합 메모리에 맞게 Ollama/로컬 모델 크기 조정
ollama pull llama3.2:3b-instruct-q4_K_M
ollama ps
OpenClaw 모델 설정을 API 또는 로컬 엔드포인트로 지정 — OpenClaw 문서. Gateway 상주 중 8GB에서 13B+ 로드 금지 — macOS가 스왑하고 Telegram webhook이 지연됩니다. 참고: DeepSeek-R1 로컬 양자화.
6단계 — 스왑 및 SSD 관리 (압축 친화)
- 부트 볼륨에 ≥20GB 여유(스왑은 APFS)
- 헤드리스 mini는 유선 Ethernet — GUI 세션의 Wi‑Fi 디버그는 RAM 소모
- 에이전트 피크 시 Time Machine 스냅샷으로 디스크 채우지 않기
- 홈랩 링크에서 송신(egress)을 안정화해 재시도가 Gateway 버퍼를 키우지 않게 하세요(불안정한 대역은 메모리 피크를 키웁니다)
while sleep 60; do date; sysctl vm.swapusage; done
7단계 — 동시 작업 제한 (Node는 스레드 풀이 아님)
| 조절 | 조치 |
|---|---|
| Agents | openclaw agents list — 8GB에서는 1 유지 |
| Cron | 작업 분산 — :00에 10개 동시 실행 피하기 |
| Channels | 안정 전 WhatsApp 계정 1개 |
| Local tools | Gateway 호스트에서 무거운 브라우저 도구 거부 |
| Ollama | 실행 환경에 OLLAMA_NUM_PARALLEL=1 |
launchctl setenv OLLAMA_NUM_PARALLEL 1
8단계 — 헤드리스 24/7 운영
- 시스템 설정 → 에너지 → 전원 어댑터 연결 시 절전 방지
- 관리는 SSH, 상시 VNC 아님 (SSH 가이드)
openclaw gateway stop --disablebefore major macOS upgrades, re-enable after
활성 상태 보기 치트시트
| 열 / 게이지 | 확인 포인트 |
|---|---|
| Memory Pressure | 녹=정상; 노/빨=RAM 추가 또는 모델 축소 |
| Swap Used | 지속 증가=스래싱 — 힙 또는 모델 축소 |
| OpenClaw / node | 24시간 RSS 추세 |
| ollama | 모델 로드 시 스파이크 — 7B는 2–5GB 예상 |
문제 해결
JavaScript heap out of memory
패턴: Gateway가 FATAL ERROR: Reached heap limit로 종료. 해결: 동시 cron 축소; wrapper --max-old-space-size; 16GB 업그레이드; Ollama를 두 번째 머신으로.
Telegram/WhatsApp replies lag but CPU low
패턴: vm.swapusage 증가, 메모리 압력 노랑. 해결: 클라우드 모델 사용 시 Ollama 중지; 3B quant; Gateway 플러그인 축소; 주간 mini 재부팅.
Ollama loads then Gateway killed
패턴: macOS 메모리 압축 한계, jetsam. 해결: 직렬화 — 낮에는 Gateway API만, 밤에 로컬 추론 배치; 8GB에서 7B+3 agents 금지.
Gateway RSS grows without traffic
패턴: 일부 버전에서 시작 시 플러그인 스캔 회귀. 해결: 안정 OpenClaw 버전 고정; 모니터링 RSS 이슈 트래커; cron으로 Gateway 재시작.
FAQ
systemd cgroup과 vm.swappiness. macOS는 압축+APFS swap — 활성 상태 보기, 힙 상한, 더 적은 agent로 조정.결론
Mac mini OpenClaw 메모리 최적화는 통합 메모리 예산화입니다: Node Gateway 제한, 로컬 LLM 맞춤, 스왑 가시 SSD 여유, 8GB에서 멀티 에이전트 억제. 16GB가 7B Q4+24/7 Gateway 실용 하한, 8GB는 API 중심 타이트 구성에 가능.
vm_stat과 활성 상태 보기로 측정하고 메모리 wrapper로 Gateway 설치, 다음 가이드와 정렬: OpenClaw 라우팅 and 양자화 guides.
공식: OpenClaw Gateway CLI · GitHub openclaw/openclaw.
관련 글: 2026 AI 코딩 연산 가이드: Cursor vs Copilot vs Claude Code
Mac mini에서 OpenClaw 실행
Node 힙을 제한하고 로컬 모델을 맞추며 swap을 가시화하세요 — 공식 Gateway CLI와 업스트림 저장소로 시작합니다.