Ana içeriğe atla
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

Pi modeliRAMÇalışır mı?Notlar
Pi 54/8 GBEn iyiEn hızlı, önerilir.
Pi 44 GBİyiÇoğu kullanıcı için ideal denge.
Pi 42 GBUygunSwap ekleyin.
Pi 41 GBSınırdaSwap ve minimal yapılandırmayla mümkün.
Pi 3B+1 GBYavaşÇalışır ama ağırdır.
Pi Zero 2 W512 MBHayırÖnerilmez.
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

1

İşletim sistemini yazın

Raspberry Pi OS Lite (64-bit) kullanın — başsız bir sunucu için masaüstü gerekmez.
  1. Raspberry Pi Imager uygulamasını indirin.
  2. İşletim sistemini seçin: Raspberry Pi OS Lite (64-bit).
  3. Ayarlar iletişim kutusunda önceden yapılandırın:
    • Ana makine adı: gateway-host
    • SSH’yi etkinleştir
    • Kullanıcı adı ve parola belirle
    • WiFi yapılandır (Ethernet kullanılmıyorsa)
  4. SD kartınıza veya USB sürücünüze yazın, takın ve Pi’yi başlatın.
2

SSH ile bağlanın

ssh user@gateway-host
3

Sistemi güncelleyin

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
4

Node.js 24’ü kurun

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

Swap ekleyin (2 GB veya daha azı için önemli)

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
6

OpenClaw’u kurun

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

İlk kurulumu çalıştırın

openclaw onboard --install-daemon
Sihirbazı izleyin. Başsız cihazlar için OAuth yerine API anahtarları önerilir. Başlamak için en kolay kanal Telegram’dır.
8

Doğrulayın

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

Control UI’ya erişin

Bilgisayarınızda Pi’den bir pano URL’si alın:
ssh user@gateway-host 'openclaw dashboard --no-open'
Ardından başka bir terminalde bir SSH tüneli oluşturun:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Yazdırılan URL’yi yerel tarayıcınızda açın. Her zaman açık uzaktan erişim için Tailscale entegrasyonu bölümüne bakın.

​
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
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.txt
sudo 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=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ı 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

​
İlgili