Raspberry Pi

상시 실행되는 지속형 OpenClaw Gateway를 Raspberry Pi에서 실행하세요. Pi는 게이트웨이일 뿐이므로(모델은 API를 통해 클라우드에서 실행됨), 보급형 Pi도 작업 부하를 잘 처리합니다 — 일반적인 하드웨어 비용은 일회성 $35–80이며, 월 요금은 없습니다.

하드웨어 호환성

최소: 1 GB RAM, 1코어, 500 MB 여유 디스크, 64비트 OS. 권장: 2 GB+ RAM, 16 GB+ SD 카드(또는 USB SSD), 이더넷.

사전 요구 사항

• 2 GB+ RAM을 갖춘 Raspberry Pi 4 또는 5(4 GB 권장)
• MicroSD 카드(16 GB+) 또는 USB SSD(더 나은 성능)
• 공식 Pi 전원 공급 장치
• 네트워크 연결(이더넷 또는 WiFi)
• 64비트 Raspberry Pi OS(필수 -- 32비트를 사용하지 마세요)
• 약 30분

설정

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Set timezone (important for cron and reminders)sudo timedatectl set-timezone America/Chicago

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt install -y nodejsnode --version

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Reduce swappiness for low-RAM devicesecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

curl -fsSL https://openclaw.ai/install.sh | bash

openclaw onboard --install-daemon

openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

ssh user@gateway-host 'openclaw dashboard --no-open'

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

성능 팁

USB SSD 사용 -- SD 카드는 느리고 마모됩니다. USB SSD는 성능을 크게 개선합니다. Pi USB 부팅 가이드를 참조하세요.

모듈 컴파일 캐시 활성화 -- 저전력 Pi 호스트에서 반복적인 CLI 호출 속도를 높입니다:

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

OPENCLAW_NO_RESPAWN=1은 일반적인 Gateway 재시작을 프로세스 내에서 유지하여, 추가 프로세스 핸드오프를 피하고 작은 호스트에서 PID 추적을 단순하게 유지합니다.

메모리 사용량 줄이기 -- 헤드리스 설정에서는 GPU 메모리를 확보하고 사용하지 않는 서비스를 비활성화하세요:

echo 'gpu_mem=16' | sudo tee -a /boot/config.txtsudo systemctl disable bluetooth

안정적인 재시작을 위한 systemd 드롭인 -- 이 Pi가 주로 OpenClaw를 실행한다면 서비스 드롭인을 추가하세요:

systemctl --user edit openclaw-gateway.service

[Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

그런 다음 systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service를 실행합니다. 헤드리스 Pi에서는 사용자 서비스가 로그아웃 후에도 유지되도록 lingering도 한 번 활성화하세요: sudo loginctl enable-linger "$(whoami)".

권장 모델 설정

Pi는 Gateway만 실행하므로, 클라우드 호스팅 API 모델을 사용하세요:

{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet-4-6",        "fallbacks": ["openai/gpt-5.4-mini"]      }    }  }}

Pi에서 로컬 LLM을 실행하지 마세요 — 작은 모델도 유용하게 쓰기에는 너무 느립니다. 모델 작업은 Claude 또는 GPT에 맡기세요.

ARM 바이너리 참고 사항

대부분의 OpenClaw 기능은 ARM64에서 변경 없이 작동합니다(Node.js, Telegram, WhatsApp/Baileys, Chromium). ARM 빌드가 가끔 없는 바이너리는 일반적으로 Skills가 제공하는 선택적 Go/Rust CLI 도구입니다. 소스에서 빌드하기 전에 누락된 바이너리의 릴리스 페이지에서 linux-arm64 / aarch64 아티팩트를 확인하세요.

지속성 및 백업

OpenClaw 상태는 다음 위치에 있습니다:

• ~/.openclaw/ — openclaw.json, 에이전트별 auth-profiles.json, 채널/제공자 상태, 세션.
• ~/.openclaw/workspace/ — 에이전트 작업 영역(SOUL.md, 메모리, 아티팩트).

이 데이터는 재부팅 후에도 유지됩니다. 다음으로 휴대 가능한 스냅샷을 만드세요:

openclaw backup create

이를 SSD에 보관하면 SD 카드보다 성능과 수명이 모두 향상됩니다.

문제 해결

메모리 부족 -- free -h로 스왑이 활성 상태인지 확인하세요. 사용하지 않는 서비스를 비활성화하세요(sudo systemctl disable cups bluetooth avahi-daemon). API 기반 모델만 사용하세요.

느린 성능 -- SD 카드 대신 USB SSD를 사용하세요. vcgencmd get_throttled로 CPU 스로틀링을 확인하세요(0x0을 반환해야 함).

서비스가 시작되지 않음 -- journalctl --user -u openclaw-gateway.service --no-pager -n 100으로 로그를 확인하고 openclaw doctor --non-interactive를 실행하세요. 헤드리스 Pi라면 lingering이 활성화되어 있는지도 확인하세요: sudo loginctl enable-linger "$(whoami)".

ARM 바이너리 문제 -- Skills가 "exec format error"로 실패하면 해당 바이너리에 ARM64 빌드가 있는지 확인하세요. uname -m으로 아키텍처를 확인하세요(aarch64가 표시되어야 함).

WiFi 끊김 -- WiFi 전원 관리를 비활성화하세요: sudo iwconfig wlan0 power off.

다음 단계

• 채널 -- Telegram, WhatsApp, Discord 등 연결
• Gateway 구성 -- 모든 구성 옵션
• 업데이트 -- OpenClaw를 최신 상태로 유지

관련 항목

• 설치 개요
• Linux 서버
• 플랫폼