Raspberry Pi

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

Kompatibilitas perangkat keras

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

Prasyarat

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

Penyiapan

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Atur zona waktu (penting untuk cron dan pengingat)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 # Kurangi swappiness untuk perangkat dengan RAM rendahecho '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

Kiat kinerja

Gunakan SSD USB -- kartu SD lambat dan cepat aus. SSD USB meningkatkan kinerja secara drastis dan mampu bertahan lebih banyak siklus penulisan; gunakan SSD tersebut untuk OPENCLAW_STATE_DIR jika Anda tetap menyimpan OS di SD. Lihat panduan boot USB Pi.

Aktifkan cache kompilasi modul -- Mempercepat pemanggilan CLI berulang pada host Pi berdaya rendah. OPENCLAW_NO_RESPAWN=1 membuat mulai ulang rutin Gateway tetap berlangsung dalam proses yang sama, sehingga menghindari serah-terima proses tambahan dan menjaga pelacakan PID tetap sederhana pada host kecil:

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

Gunakan /var/tmp, bukan /tmp -- beberapa distribusi menghapus isi /tmp saat boot, yang menghilangkan cache yang telah dipanaskan.

Kurangi penggunaan memori -- Untuk penyiapan tanpa monitor, 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 mulai ulang yang stabil -- Jika Pi ini sebagian besar digunakan untuk 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

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

Penyiapan model yang direkomendasikan

Karena Pi hanya menjalankan gateway, gunakan model API yang dihosting di cloud -- jangan jalankan LLM lokal pada Pi karena model kecil sekalipun terlalu lambat untuk digunakan:

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

Catatan biner ARM

Sebagian besar fitur OpenClaw berfungsi di ARM64 tanpa perubahan (Node.js, Telegram, WhatsApp/Baileys, Chromium). Biner yang terkadang tidak memiliki versi ARM biasanya berupa alat CLI Go/Rust opsional yang disertakan oleh Skills. Verifikasi arsitektur dengan uname -m (seharusnya menampilkan aarch64), lalu periksa halaman rilis biner yang tidak tersedia untuk artefak linux-arm64 / aarch64 sebelum beralih ke kompilasi dari sumber.

Persistensi dan pencadangan

Status OpenClaw berada di:

• ~/.openclaw/ -- openclaw.json, auth-profiles.json per agen, status saluran/penyedia, sesi.
• ~/.openclaw/workspace/ -- ruang kerja agen (SOUL.md, memori, artefak).

Data tersebut tetap tersimpan setelah mulai ulang dan akan memperoleh manfaat dari penggunaan SSD dibandingkan kartu SD, baik dari sisi kinerja maupun umur pakai. Buat snapshot portabel dengan:

openclaw backup create

Pemecahan masalah

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

Kinerja lambat -- Gunakan SSD USB sebagai pengganti kartu SD. Periksa pembatasan CPU dengan vcgencmd get_throttled (seharusnya menghasilkan 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 adalah Pi tanpa monitor, verifikasi juga bahwa lingering telah diaktifkan: sudo loginctl enable-linger "$(whoami)".

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

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

Langkah berikutnya

• Saluran -- hubungkan Telegram, WhatsApp, Discord, dan lainnya
• Konfigurasi Gateway -- semua opsi konfigurasi
• Pembaruan -- jaga agar OpenClaw tetap mutakhir

Terkait

• Ikhtisar instalasi
• Server Linux
• Platform