Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Pi modeliRAMÇalışır mı?Notlar
Pi 54/8 GBEn iyiEn hızlı, önerilir.
Pi 44 GBİyiÇoğu kullanıcı için en uygun nokta.
Pi 42 GBUygunSwap ekleyin.
Pi 41 GBSınırlıSwap 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üç kaynağı
  • 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 yazdırın

Masaüstü gerekmeyen başsız bir sunucu için Raspberry Pi OS Lite (64-bit) kullanın.
  1. Raspberry Pi Imager uygulamasını indirin.
  2. İşletim sistemi 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ştirin
    • Kullanıcı adı ve parola belirleyin
    • WiFi’yi yapılandırın (Ethernet kullanmıyorsanız)
  4. SD kartınıza veya USB sürücünüze yazdırı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'ye 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 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
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

​
İlgili