Raspberry Pi

Kalıcı ve her zaman açık bir OpenClaw Gateway'i Raspberry Pi üzerinde çalıştırın. Pi yalnızca ağ geçidi olduğundan (modeller API aracılığıyla bulutta çalışır), mütevazı bir Pi bile iş yükünü rahatlıkla kaldırır -- tipik donanım maliyeti tek seferlik $35-80 tutarındadır ve aylık ücret yoktur.

Donanım uyumluluğu

Asgari: 1 GB RAM, 1 çekirdek, 500 MB boş disk alanı, 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)
• Resmî Pi güç kaynağı
• Ağ bağlantısı (Ethernet veya WiFi)
• 64 bit Raspberry Pi OS (zorunludur -- 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 # Saat dilimini ayarlayın (cron ve anımsatıcılar için önemlidir)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 # Düşük RAM'li cihazlar için takas eğilimini azaltınecho '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 zamanla aşınır. USB SSD performansı önemli ölçüde artırır ve daha fazla yazma döngüsüne dayanır; işletim sistemini SD kartta tutuyorsanız OPENCLAW_STATE_DIR için SSD'yi kullanın. Pi USB önyükleme kılavuzuna bakın.

Modül derleme önbelleğini etkinleştirin -- Düşük güçlü Pi ana makinelerinde yinelenen CLI çağrılarını hızlandırır. OPENCLAW_NO_RESPAWN=1, rutin Gateway yeniden başlatmalarını işlem içinde tutarak ek süreç aktarımlarını önler ve küçük ana makinelerde PID takibini basit tutar:

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

/tmp değil, /var/tmp kullanın -- bazı dağıtımlar önyükleme sırasında /tmp öğesini temizleyerek hazırlanmış önbelleği siler.

Bellek kullanımını azaltın -- Başsız kurulumlarda GPU belleğini serbest bırakın ve kullanılmayan hizmetleri 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 ek yapılandırması -- Bu Pi çoğunlukla OpenClaw çalıştırıyorsa bir hizmet ek yapılandırması 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. Başsız bir Pi'de, kullanıcı hizmetinin oturum kapatıldıktan sonra çalışmayı sürdürmesi için kalıcılığı bir kez etkinleştirin: sudo loginctl enable-linger "$(whoami)".

Önerilen model kurulumu

Pi yalnızca Gateway'i çalıştırdığından bulutta barındırılan API modellerini kullanın -- yerel LLM'leri Pi üzerinde çalıştırmayın; küçük modeller bile kullanışlı olamayacak kadar yavaştır:

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

ARM ikili dosya notları

OpenClaw özelliklerinin çoğu ARM64 üzerinde değişiklik yapılmadan çalışır (Node.js, Telegram, WhatsApp/Baileys, Chromium). Zaman zaman ARM derlemeleri bulunmayan ikili dosyalar genellikle Skills tarafından sunulan isteğe bağlı Go/Rust CLI araçlarıdır. Mimarinin uname -m ile doğrulayın (aarch64 göstermelidir), ardından kaynaktan derlemeye başvurmadan önce eksik ikili dosyanın sürüm sayfasında linux-arm64 / aarch64 yapıtlarını kontrol edin.

Kalıcılık ve yedeklemeler

OpenClaw durumu şurada bulunur:

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

Bunlar yeniden başlatmalardan etkilenmez ve hem performans hem de kullanım ömrü açısından SD kart yerine SSD kullanılmasından yarar görür. Şu komutla taşınabilir bir anlık görüntü alın:

openclaw backup create

Sorun giderme

Bellek yetersizliği -- Takas alanının etkin olduğunu free -h ile doğrulayın. Kullanılmayan hizmetleri 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 hız kısıtlamasını vcgencmd get_throttled ile kontrol edin (0x0 döndürmelidir).

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

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

WiFi bağlantısı kesiliyor -- 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 konular

• Kuruluma genel bakış
• Linux sunucusu
• Platformlar