메인 콘텐츠로 건너뛰기

​
Raspberry Pi

Raspberry Pi에서 지속적이고 항상 켜져 있는 OpenClaw Gateway를 실행하세요. Pi는 gateway 역할만 하고(모델은 API를 통해 클라우드에서 실행됨), 비교적 사양이 낮은 Pi도 이 작업을 충분히 처리할 수 있습니다.

​
사전 요구 사항

  • 2 GB+ RAM의 Raspberry Pi 4 또는 5(4 GB 권장)
  • MicroSD 카드(16 GB+) 또는 USB SSD(더 나은 성능)
  • 공식 Pi 전원 공급 장치
  • 네트워크 연결(Ethernet 또는 WiFi)
  • 64-bit Raspberry Pi OS(필수 — 32-bit 사용 금지)
  • 약 30분

​
설정

1

OS 플래시

헤드리스 서버에는 데스크톱이 필요 없으므로 **Raspberry Pi OS Lite (64-bit)**를 사용하세요.
  1. Raspberry Pi Imager를 다운로드합니다.
  2. OS로 **Raspberry Pi OS Lite (64-bit)**를 선택합니다.
  3. 설정 대화상자에서 다음을 미리 구성합니다.
    • 호스트 이름: gateway-host
    • SSH 활성화
    • 사용자 이름과 비밀번호 설정
    • WiFi 구성(Ethernet을 사용하지 않는 경우)
  4. SD 카드 또는 USB 드라이브에 플래시하고, 삽입한 뒤 Pi를 부팅합니다.
2

SSH로 연결

ssh user@gateway-host
3

시스템 업데이트

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# 시간대 설정(cron 및 리마인더에 중요)
sudo timedatectl set-timezone America/Chicago
4

Node.js 24 설치

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

스왑 추가(2 GB 이하에서 중요)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# 저메모리 디바이스용 swappiness 감소
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

OpenClaw 설치

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

온보딩 실행

openclaw onboard --install-daemon
마법사를 따르세요. 헤드리스 디바이스에는 OAuth보다 API 키를 권장합니다. 시작 채널로는 Telegram이 가장 쉽습니다.
8

확인

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
9

Control UI에 액세스

컴퓨터에서 Pi로부터 dashboard URL을 가져옵니다:
ssh user@gateway-host 'openclaw dashboard --no-open'
그런 다음 다른 터미널에서 SSH 터널을 만듭니다.
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
로컬 브라우저에서 출력된 URL을 여세요. 항상 켜진 원격 액세스에는 Tailscale integration을 참조하세요.

​
성능 팁

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 secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
메모리 사용량 줄이기 — 헤드리스 설정에서는 GPU 메모리를 줄이고 사용하지 않는 서비스를 비활성화하세요. 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

​
문제 해결

메모리 부족 — 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 바이너리 문제 — Skill이 “exec format error”로 실패하면 해당 바이너리에 ARM64 빌드가 있는지 확인하세요. uname -m으로 아키텍처를 확인하세요(aarch64가 표시되어야 함). WiFi 끊김 — WiFi 전원 관리를 비활성화하세요: sudo iwconfig wlan0 power off.

​
다음 단계