Raspberry Pi

Raspberry Pi üzerinde kalıcı, sürekli açık bir OpenClaw Gateway çalıştırın. Pi yalnızca Gateway görevini üstlendiğinden (modeller API aracılığıyla bulutta çalışır), mütevazı bir Pi bile iş yükünü rahatlıkla karşılar -- tipik donanım maliyeti tek seferlik 35-80 ABD dolarıdır ve aylık ücret yoktur.

Donanım uyumluluğu

Minimum: 1 GB RAM, 1 çekirdek, 500 MB boş disk alanı, 64 bit işletim sistemi. Önerilen: 2 GB veya daha fazla RAM, 16 GB veya daha büyük SD kart (ya da USB SSD), Ethernet.

Ön koşullar

• 2 GB veya daha fazla RAM'e sahip Raspberry Pi 4 ya da 5 (4 GB önerilir)
• MicroSD kart (16 GB veya üzeri) ya da 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 # 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 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 SSD'yi OPENCLAW_STATE_DIR için kullanın. 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. OPENCLAW_NO_RESPAWN=1, rutin Gateway yeniden başlatmalarını aynı süreç içinde tutarak ek süreç devirlerini önler ve küçük ana makinelerde PID takibini basitleştirir:

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 yerine /var/tmp kullanın -- bazı dağıtımlar önyükleme sırasında /tmp dizinini temizleyerek ısıtılmış önbelleği siler.

Bellek kullanımını azaltın -- Ekransı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 ağırlıklı olarak OpenClaw çalıştırıyorsa hizmete bir ek yapılandırma 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 komutunu çalıştırın. Ekransız bir Pi'de, kullanıcı hizmetinin oturum kapatıldıktan sonra çalışmayı sürdürmesi için kalıcı kullanıcı hizmetlerini bir kez etkinleştirin: sudo loginctl enable-linger "$(whoami)".

Önerilen model kurulumu

Pi yalnızca Gateway çalıştırdığından bulutta barındırılan API modellerini kullanın -- Pi üzerinde yerel LLM'ler ç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 derlemesi bulunmayan ikili dosyalar genellikle Skills tarafından sağlanan isteğe bağlı Go/Rust CLI araçlarıdır. Mimarinin doğruluğunu uname -m ile denetleyin (aarch64 göstermelidir), ardından kaynaktan derlemeye başvurmadan önce eksik ikili dosyanın sürüm sayfasında linux-arm64 / aarch64 yapılarının bulunup bulunmadığını kontrol edin.

Kalıcılık ve yedeklemeler

OpenClaw durumu şu dizinlerde bulunur:

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

Bunlar yeniden başlatmalardan etkilenmez; hem performans hem de kullanım ömrü açısından SD kart yerine SSD kullanılmasından yararlanır. Taşınabilir bir anlık görüntü oluşturmak için:

openclaw backup create

Sorun giderme

Bellek yetersizliği -- free -h ile takas alanının etkin olduğunu 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. vcgencmd get_throttled ile işlemci kısıtlaması olup olmadığını kontrol edin (0x0 döndürmelidir).

Hizmet başlamıyor -- journalctl --user -u openclaw-gateway.service --no-pager -n 100 ile günlükleri kontrol edin ve openclaw doctor --non-interactive komutunu çalıştırın. Bu ekransız bir Pi ise kalıcı kullanıcı hizmetlerinin etkinleştirildiğini de 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 doğruluğunu uname -m ile denetleyin (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 diğerlerini bağlayın
• Gateway yapılandırması -- tüm yapılandırma seçenekleri
• Güncelleme -- OpenClaw'ı güncel tutun

İlgili içerikler

• Kuruluma genel bakış
• Linux sunucusu
• Platformlar