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

Model Pi	RAM	Berfungsi?	Catatan
Pi 5	4/8 GB	Terbaik	Paling cepat, direkomendasikan.
Pi 4	4 GB	Baik	Pilihan ideal bagi sebagian besar pengguna.
Pi 4	2 GB	Cukup	Tambahkan swap.
Pi 4	1 GB	Terbatas	Dapat digunakan dengan swap dan konfigurasi minimal.
Pi 3B+	1 GB	Lambat	Berfungsi, tetapi kurang responsif.
Pi Zero 2 W	512 MB	Tidak	Tidak direkomendasikan.

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

Flas OS

Gunakan Raspberry Pi OS Lite (64-bit) — desktop tidak diperlukan untuk server tanpa monitor.

Unduh Raspberry Pi Imager.
Pilih OS: Raspberry Pi OS Lite (64-bit).
Dalam dialog pengaturan, lakukan prakonfigurasi:
- Nama host: gateway-host
- Aktifkan SSH
- Tetapkan nama pengguna dan kata sandi
- Konfigurasikan WiFi (jika tidak menggunakan Ethernet)
Flas ke kartu SD atau drive USB, masukkan perangkat tersebut, lalu nyalakan Pi.

Hubungkan melalui SSH

ssh user@gateway-host

Perbarui sistem

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

# Atur zona waktu (penting untuk cron dan pengingat)
sudo timedatectl set-timezone America/Chicago

Instal Node.js 24

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

Tambahkan swap (penting untuk RAM 2 GB atau kurang)

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

# Kurangi swappiness untuk perangkat dengan RAM rendah
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

Instal OpenClaw

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

Jalankan orientasi awal

openclaw onboard --install-daemon

Ikuti wisaya. Kunci API lebih direkomendasikan daripada OAuth untuk perangkat tanpa monitor. Telegram adalah saluran termudah untuk memulai.

Verifikasi

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

Akses Antarmuka Kontrol

Di komputer Anda, dapatkan URL dasbor dari Pi:

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

Kemudian buat terowongan SSH di terminal lain:

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

Buka URL yang dicetak di peramban lokal Anda. Untuk akses jarak jauh yang selalu aktif, lihat integrasi Tailscale.

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 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

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.txt
sudo 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=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=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

Install overview

Maintenance

Containers

Hosting

Advanced setup

Kompatibilitas perangkat keras

Prasyarat

Penyiapan

Kiat kinerja

Penyiapan model yang direkomendasikan

Catatan biner ARM

Persistensi dan pencadangan

Pemecahan masalah

Langkah berikutnya

Terkait

​Kompatibilitas perangkat keras

​Prasyarat

​Penyiapan

​Kiat kinerja

​Penyiapan model yang direkomendasikan

​Catatan biner ARM

​Persistensi dan pencadangan

​Pemecahan masalah

​Langkah berikutnya

​Terkait

Kompatibilitas perangkat keras

Prasyarat

Penyiapan

Kiat kinerja

Penyiapan model yang direkomendasikan

Catatan biner ARM

Persistensi dan pencadangan

Pemecahan masalah

Langkah berikutnya

Terkait