Raspberry Pi

Kalıcı, her zaman açık bir OpenClaw Gateway'i Raspberry Pi üzerinde çalıştırın. Pi yalnızca gateway olduğu için (modeller API üzerinden bulutta çalışır), mütevazı bir Pi bile iş yükünü rahatça karşılar; 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üç kaynağı
• 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 -y
sudo 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 nodejs
node --version

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

# Reduce swappiness for low-RAM devices
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

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

openclaw onboard --install-daemon

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --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 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

Bellek kullanımını azaltın -- Başsız kurulumlar için 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.txt
sudo systemctl disable bluetooth

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

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

Ardından systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service çalıştırın. Başsız bir Pi'de, kullanıcı hizmetinin oturum kapatıldıktan sonra da çalışmayı sürdürmesi için lingering'i bir kez etkinleştirin: sudo loginctl enable-linger "$(whoami)".

# Önerilen model kurulumu

Pi yalnızca gateway ç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"]
      }
    }
  }
}

Yerel LLM'leri Pi üzerinde ç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 olmayan 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 bir ikili dosyanın yayın sayfasında linux-arm64 / aarch64 yapıtlarını doğrulayın.

# Kalıcılık ve yedeklemeler

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 etkilenmez. Taşınabilir bir anlık görüntü almak için:

openclaw backup create

Bunları SSD üzerinde tutarsanız, SD karta kıyasla hem performans hem de ömür iyileşir.

# Sorun giderme

Bellek yetersiz -- Swap'ı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 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 ç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. Mimarileri 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