Raspberry Pi

Raspberry Pi üzerinde kalıcı, her zaman açık bir OpenClaw Gateway çalıştırın. Pi yalnızca Gateway olduğundan (modeller bulutta API üzerinden çalışır), mütevazı bir Pi bile iş yükünü iyi taşır — tipik donanım maliyeti tek seferlik $35–80 aralığındadır, aylık ücret yoktur.

Donanım uyumluluğu

Minimum: 1 GB RAM, 1 çekirdek, 500 MB boş disk, 64 bit işletim sistemi. Önerilen: 2 GB+ RAM, 16 GB+ SD kart (veya USB SSD), Ethernet.

Ön koşullar

• 2 GB+ RAM’e sahip Raspberry Pi 4 veya 5 (4 GB önerilir)
• MicroSD kart (16 GB+) veya USB SSD (daha iyi performans)
• Resmi Pi güç adaptörü
• Ağ bağlantısı (Ethernet veya WiFi)
• 64 bit Raspberry Pi OS (gerekli -- 32 bit kullanmayın)
• Yaklaşık 30 dakika

Kurulum

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

Performans ipuçları

USB SSD kullanın -- SD kartlar yavaştır ve yıpranır. USB SSD performansı ciddi biçimde artırır. Pi USB önyükleme kılavuzuna bakın.

Modül derleme önbelleğini etkinleştirin -- Daha düşük güçlü Pi ana makinelerinde tekrarlanan CLI çağrılarını hızlandırır:

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, rutin Gateway yeniden başlatmalarını süreç içinde tutar; bu da ek süreç aktarımlarını önler ve küçük ana makinelerde PID takibini basit tutar.

Bellek kullanımını azaltın -- Başsız kurulumlarda GPU belleğini serbest bırakın ve kullanılmayan servisleri devre dışı bırakın:

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

Kararlı yeniden başlatmalar için systemd drop-in -- Bu Pi çoğunlukla OpenClaw çalıştırıyorsa bir servis drop-in’i ekleyin:

systemctl --user edit openclaw-gateway.service

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

Ardından systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service çalıştırın. Başsız bir Pi’de, kullanıcı servisi oturum kapatıldıktan sonra da yaşamaya devam etsin diye lingering’i bir kez etkinleştirin: sudo loginctl enable-linger "$(whoami)".

Önerilen model kurulumu

Pi yalnızca Gateway’i çalıştırdığı için bulutta barındırılan API modellerini kullanın:

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

Pi üzerinde yerel LLM’ler çalıştırmayın — küçük modeller bile kullanışlı olamayacak kadar yavaştır. Model işini Claude veya GPT’ye bırakın.

ARM ikili dosya notları

Çoğu OpenClaw özelliği ARM64 üzerinde değişiklik gerektirmeden çalışır (Node.js, Telegram, WhatsApp/Baileys, Chromium). Zaman zaman ARM derlemeleri bulunmayan ikili dosyalar genellikle Skills tarafından gönderilen isteğe bağlı Go/Rust CLI araçlarıdır. Kaynaktan derlemeye geçmeden önce eksik ikili dosyanın yayın sayfasında linux-arm64 / aarch64 yapıtlarını doğrulayın.

Kalıcılık ve yedekler

OpenClaw durumu şunların altında bulunur:

• ~/.openclaw/ — openclaw.json, ajan başına auth-profiles.json, kanal/sağlayıcı durumu, oturumlar.
• ~/.openclaw/workspace/ — ajan çalışma alanı (SOUL.md, bellek, yapıtlar).

Bunlar yeniden başlatmalardan sonra korunur. Taşınabilir bir anlık görüntü almak için:

openclaw backup create

Bunları bir SSD üzerinde tutarsanız, SD karta kıyasla hem performans hem de ömür artar.

Sorun giderme

Bellek yetersiz -- free -h ile swap’ın etkin olduğunu doğrulayın. Kullanılmayan servisleri devre dışı bırakın (sudo systemctl disable cups bluetooth avahi-daemon). Yalnızca API tabanlı modeller kullanın.

Yavaş performans -- SD kart yerine USB SSD kullanın. CPU kısıtlamasını vcgencmd get_throttled ile kontrol edin (0x0 döndürmelidir).

Servis başlamıyor -- Günlükleri journalctl --user -u openclaw-gateway.service --no-pager -n 100 ile kontrol edin ve openclaw doctor --non-interactive çalıştırın. Bu başsız bir Pi ise lingering’in etkin olduğunu da doğrulayın: sudo loginctl enable-linger "$(whoami)".

ARM ikili dosya sorunları -- Bir skill “exec format error” ile başarısız olursa ikili dosyanın ARM64 derlemesi olup olmadığını kontrol edin. Mimarisi uname -m ile doğrulayın (aarch64 göstermelidir).

WiFi kopuyor -- WiFi güç yönetimini devre dışı bırakın: sudo iwconfig wlan0 power off.

Sonraki adımlar

• Kanallar -- Telegram, WhatsApp, Discord ve daha fazlasını bağlayın
• Gateway yapılandırması -- tüm yapılandırma seçenekleri
• Güncelleme -- OpenClaw’u güncel tutun

İlgili

• Kurulum genel bakışı
• Linux sunucusu
• Platformlar