Raspberry Pi

Jalankan OpenClaw Gateway yang persisten dan selalu aktif di Raspberry Pi. Karena Pi hanya berfungsi sebagai Gateway (model berjalan di cloud melalui API), bahkan Pi sederhana dapat menangani beban kerja dengan baik — biaya perangkat keras biasanya $35–80 sekali bayar, tanpa biaya bulanan.

Kompatibilitas perangkat keras

Minimum: RAM 1 GB, 1 core, disk kosong 500 MB, OS 64-bit. Direkomendasikan: RAM 2 GB+, kartu SD 16 GB+ (atau USB SSD), Ethernet.

Prasyarat

• Raspberry Pi 4 atau 5 dengan RAM 2 GB+ (4 GB direkomendasikan)
• Kartu MicroSD (16 GB+) atau USB SSD (performa lebih baik)
• Catu daya resmi Pi
• Koneksi jaringan (Ethernet atau WiFi)
• Raspberry Pi OS 64-bit (wajib -- jangan gunakan 32-bit)
• Sekitar 30 menit

Penyiapan

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

Tips performa

Gunakan USB SSD -- Kartu SD lambat dan cepat aus. USB SSD meningkatkan performa secara drastis. Lihat panduan boot USB Pi.

Aktifkan cache kompilasi modul -- Mempercepat pemanggilan CLI berulang di host Pi berdaya rendah:

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 menjaga restart rutin Gateway tetap dalam proses yang sama, sehingga menghindari handoff proses tambahan dan menjaga pelacakan PID tetap sederhana pada host kecil.

Kurangi penggunaan memori -- Untuk penyiapan tanpa antarmuka, bebaskan memori GPU dan nonaktifkan layanan yang tidak digunakan:

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

Konfigurasi tambahan systemd untuk restart stabil -- Jika Pi ini sebagian besar menjalankan OpenClaw, tambahkan konfigurasi tambahan layanan:

systemctl --user edit openclaw-gateway.service

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

Lalu systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Pada Pi tanpa antarmuka, aktifkan juga lingering satu kali agar layanan pengguna tetap berjalan setelah logout: sudo loginctl enable-linger "$(whoami)".

Penyiapan model yang direkomendasikan

Karena Pi hanya menjalankan Gateway, gunakan model API yang di-host di cloud:

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

Jangan jalankan LLM lokal di Pi — bahkan model kecil terlalu lambat untuk berguna. Biarkan Claude atau GPT menangani pekerjaan model.

Catatan biner ARM

Sebagian besar fitur OpenClaw berfungsi di ARM64 tanpa perubahan (Node.js, Telegram, WhatsApp/Baileys, Chromium). Biner yang kadang tidak memiliki build ARM biasanya adalah alat CLI Go/Rust opsional yang dikirim oleh Skills. Verifikasi halaman rilis biner yang hilang untuk artefak linux-arm64 / aarch64 sebelum kembali ke membangun dari sumber.

Persistensi dan cadangan

State OpenClaw berada di bawah:

• ~/.openclaw/ — openclaw.json, auth-profiles.json per agen, state channel/penyedia, sesi.
• ~/.openclaw/workspace/ — workspace agen (SOUL.md, memori, artefak).

Ini bertahan setelah reboot. Ambil snapshot portabel dengan:

openclaw backup create

Jika Anda menyimpannya di SSD, performa dan umur pakai meningkat dibandingkan kartu SD.

Pemecahan masalah

Kehabisan memori -- Verifikasi swap aktif dengan free -h. Nonaktifkan layanan yang tidak digunakan (sudo systemctl disable cups bluetooth avahi-daemon). Gunakan hanya model berbasis API.

Performa lambat -- Gunakan USB SSD alih-alih kartu SD. Periksa throttling CPU dengan vcgencmd get_throttled (seharusnya mengembalikan 0x0).

Layanan tidak dapat dimulai -- Periksa log dengan journalctl --user -u openclaw-gateway.service --no-pager -n 100 dan jalankan openclaw doctor --non-interactive. Jika ini Pi tanpa antarmuka, verifikasi juga bahwa lingering aktif: sudo loginctl enable-linger "$(whoami)".

Masalah biner ARM -- Jika sebuah skill gagal dengan "exec format error", periksa apakah biner tersebut memiliki build ARM64. Verifikasi arsitektur dengan uname -m (seharusnya menampilkan aarch64).

WiFi terputus -- Nonaktifkan manajemen daya WiFi: sudo iwconfig wlan0 power off.

Langkah berikutnya

• Channel -- hubungkan Telegram, WhatsApp, Discord, dan lainnya
• Konfigurasi Gateway -- semua opsi konfigurasi
• Memperbarui -- jaga OpenClaw tetap mutakhir

Terkait

• Ikhtisar instalasi
• Server Linux
• Platform