Raspberry Pi에서 OpenClaw 실행
목표
Raspberry Pi에서 지속적이고 항상 켜져 있는 OpenClaw Gateway를 약 $35-80의 1회 비용(월 사용료 없음)으로 실행합니다. 다음 용도에 적합합니다.- 24/7 개인 AI 어시스턴트
- 홈 오토메이션 허브
- 저전력 상시 가동 Telegram/WhatsApp 봇
하드웨어 요구 사항
| Pi Model | RAM | Works? | Notes |
|---|---|---|---|
| Pi 5 | 4GB/8GB | ✅ Best | 가장 빠름, 권장 |
| Pi 4 | 4GB | ✅ Good | 대부분 사용자에게 가장 좋은 균형점 |
| Pi 4 | 2GB | ✅ OK | 동작함, swap 추가 권장 |
| Pi 4 | 1GB | ⚠️ Tight | swap과 최소 설정으로 가능 |
| Pi 3B+ | 1GB | ⚠️ Slow | 동작하지만 느림 |
| Pi Zero 2 W | 512MB | ❌ | 권장하지 않음 |
권장: 2GB+ RAM, 64-bit OS, 16GB+ SD 카드(또는 USB SSD)
준비물
- Raspberry Pi 4 또는 5 (2GB+ 권장)
- MicroSD 카드(16GB+) 또는 USB SSD(더 나은 성능)
- 전원 공급 장치(공식 Pi PSU 권장)
- 네트워크 연결(Ethernet 또는 WiFi)
- 약 30분
1) OS 플래시
헤드리스 서버에는 데스크톱이 필요 없으므로 Raspberry Pi OS Lite (64-bit) 를 사용하세요.- Raspberry Pi Imager 다운로드
- OS 선택: Raspberry Pi OS Lite (64-bit)
- 톱니바퀴 아이콘(⚙️)을 클릭해 사전 설정
- hostname 설정:
gateway-host - SSH 활성화
- username/password 설정
- WiFi 설정(Ethernet을 사용하지 않는 경우)
- hostname 설정:
- SD 카드 / USB 드라이브에 플래시
- Pi에 삽입하고 부팅
2) SSH로 접속
3) 시스템 설정
4) Node.js 22 설치 (ARM64)
5) Swap 추가 (2GB 이하에서 중요)
swap은 out-of-memory 크래시를 방지합니다.6) OpenClaw 설치
옵션 A: 표준 설치 (권장)
옵션 B: Hackable 설치 (튜닝/실험용)
7) Onboarding 실행
- Gateway mode: Local
- Auth: API key 권장(OAuth는 헤드리스 Pi에서 까다로울 수 있음)
- Channels: Telegram이 시작하기 가장 쉬움
- Daemon: Yes (systemd)
8) 설치 확인
9) Dashboard 접속
Pi는 헤드리스이므로 SSH 터널을 사용하세요.성능 최적화
USB SSD 사용 (큰 개선)
SD 카드는 느리고 마모됩니다. USB SSD는 성능을 크게 개선합니다.CLI 시작 속도 향상 (module compile cache)
저전력 Pi 호스트에서는 Node의 module compile cache를 활성화해 반복적인 CLI 실행 속도를 높이세요.NODE_COMPILE_CACHE는 이후 실행(status,health,--help)을 빠르게 합니다./var/tmp는/tmp보다 재부팅 후에도 더 잘 유지됩니다.OPENCLAW_NO_RESPAWN=1은 CLI self-respawn으로 인한 추가 startup 비용을 피합니다.- 첫 실행이 캐시를 데우고, 이후 실행에서 효과가 가장 큽니다.
systemd startup tuning (선택 사항)
이 Pi가 대부분 OpenClaw만 실행한다면, service drop-in을 추가해 restart jitter를 줄이고 startup env를 안정적으로 유지하세요.Restart= 정책이 자동 복구에 도움이 되는 방식:
systemd can automate service recovery
메모리 사용량 줄이기
리소스 모니터링
ARM 관련 참고 사항
바이너리 호환성
대부분의 OpenClaw 기능은 ARM64에서 동작하지만, 일부 외부 바이너리는 ARM 빌드가 필요할 수 있습니다.| Tool | ARM64 Status | Notes |
|---|---|---|
| Node.js | ✅ | 매우 잘 동작 |
| WhatsApp (Baileys) | ✅ | 순수 JS, 문제 없음 |
| Telegram | ✅ | 순수 JS, 문제 없음 |
| gog (Gmail CLI) | ⚠️ | ARM 릴리스 여부 확인 필요 |
| Chromium (browser) | ✅ | sudo apt install chromium-browser |
32-bit vs 64-bit
항상 64-bit OS를 사용하세요. Node.js와 많은 최신 도구가 이를 요구합니다. 다음으로 확인하세요.권장 모델 설정
Pi는 Gateway 역할만 하고 모델은 클라우드에서 실행되므로 API 기반 모델을 사용하세요.부팅 시 자동 시작
onboarding wizard가 이를 설정하지만, 확인하려면 다음을 실행하세요.Troubleshooting
메모리 부족 (OOM)
느린 성능
- SD 카드 대신 USB SSD 사용
- 사용하지 않는 서비스 비활성화:
sudo systemctl disable cups bluetooth avahi-daemon - CPU throttling 확인:
vcgencmd get_throttled(0x0이 반환되어야 함)
서비스가 시작되지 않음
ARM 바이너리 문제
skill이 “exec format error”로 실패하면:- 해당 바이너리에 ARM64 빌드가 있는지 확인
- 소스에서 빌드 시도
- 또는 ARM 지원 Docker 컨테이너 사용
WiFi 끊김
WiFi를 사용하는 헤드리스 Pi의 경우:비용 비교
| Setup | One-Time Cost | Monthly Cost | Notes |
|---|---|---|---|
| Pi 4 (2GB) | ~$45 | $0 | + 전력 (~$5/년) |
| Pi 4 (4GB) | ~$55 | $0 | 권장 |
| Pi 5 (4GB) | ~$60 | $0 | 최고 성능 |
| Pi 5 (8GB) | ~$80 | $0 | 과하지만 미래 대비 가능 |
| DigitalOcean | $0 | $6/mo | $72/년 |
| Hetzner | $0 | €3.79/mo | 약 $50/년 |
함께 보기
- Linux guide — 일반 Linux 설정
- DigitalOcean guide — 클라우드 대안
- Hetzner guide — Docker 설정
- Tailscale — 원격 접근
- Nodes — 노트북/휴대폰을 Pi gateway와 페어링