Raspberry Pi

Uruchom trwały, zawsze włączony OpenClaw Gateway na Raspberry Pi. Ponieważ Pi jest tylko gatewayem (modele działają w chmurze przez API), nawet skromny Pi dobrze radzi sobie z obciążeniem — typowy koszt sprzętu to 35–80 USD jednorazowo, bez opłat miesięcznych.

# Zgodność sprzętowa

Minimum: 1 GB RAM, 1 rdzeń, 500 MB wolnego miejsca na dysku, 64-bitowy system operacyjny. Zalecane: 2 GB+ RAM, karta SD 16 GB+ (lub USB SSD), Ethernet.

# Wymagania wstępne

• Raspberry Pi 4 lub 5 z 2 GB+ RAM (zalecane 4 GB)
• Karta MicroSD (16 GB+) lub USB SSD (lepsza wydajność)
• Oficjalny zasilacz Pi
• Połączenie sieciowe (Ethernet lub WiFi)
• 64-bitowy Raspberry Pi OS (wymagany -- nie używaj wersji 32-bitowej)
• Około 30 minut

# Konfiguracja

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

# Wskazówki dotyczące wydajności

Użyj USB SSD -- Karty SD są wolne i zużywają się. USB SSD radykalnie poprawia wydajność. Zobacz przewodnik uruchamiania Pi z USB.

Włącz pamięć podręczną kompilacji modułów -- Przyspiesza powtarzane wywołania CLI na słabszych hostach Pi:

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

Zmniejsz użycie pamięci -- W konfiguracjach bez monitora zwolnij pamięć GPU i wyłącz nieużywane usługi:

echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

Drop-in systemd dla stabilnych restartów -- Jeśli ten Pi służy głównie do uruchamiania OpenClaw, dodaj drop-in usługi:

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

Następnie systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Na Pi bez monitora włącz także raz lingering, aby usługa użytkownika przetrwała wylogowanie: sudo loginctl enable-linger "$(whoami)".

# Zalecana konfiguracja modelu

Ponieważ Pi uruchamia tylko Gateway, użyj modeli API hostowanych w chmurze:

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

Nie uruchamiaj lokalnych LLM na Pi — nawet małe modele są zbyt wolne, aby były użyteczne. Pozwól Claude lub GPT wykonywać pracę modelu.

# Uwagi dotyczące binariów ARM

Większość funkcji OpenClaw działa na ARM64 bez zmian (Node.js, Telegram, WhatsApp/Baileys, Chromium). Binarne pliki, którym czasami brakuje kompilacji ARM, to zwykle opcjonalne narzędzia CLI Go/Rust dostarczane przez Skills. Przed przejściem do budowania ze źródeł sprawdź stronę wydań brakującego pliku binarnego pod kątem artefaktów linux-arm64 / aarch64.

# Trwałość i kopie zapasowe

Stan OpenClaw znajduje się w:

• ~/.openclaw/ — openclaw.json, auth-profiles.json dla każdego agenta, stan kanałów/dostawców, sesje.
• ~/.openclaw/workspace/ — obszar roboczy agenta (SOUL.md, pamięć, artefakty).

Przetrwają one restarty. Utwórz przenośną migawkę za pomocą:

openclaw backup create

Jeśli trzymasz je na SSD, poprawisz zarówno wydajność, jak i trwałość w porównaniu z kartą SD.

# Rozwiązywanie problemów

Brak pamięci -- Sprawdź, czy swap jest aktywny, używając free -h. Wyłącz nieużywane usługi (sudo systemctl disable cups bluetooth avahi-daemon). Używaj tylko modeli opartych na API.

Niska wydajność -- Użyj USB SSD zamiast karty SD. Sprawdź ograniczanie CPU poleceniem vcgencmd get_throttled (powinno zwrócić 0x0).

Usługa nie uruchamia się -- Sprawdź logi poleceniem journalctl --user -u openclaw-gateway.service --no-pager -n 100 i uruchom openclaw doctor --non-interactive. Jeśli to Pi bez monitora, sprawdź także, czy lingering jest włączony: sudo loginctl enable-linger "$(whoami)".

Problemy z binariami ARM -- Jeśli skill kończy się błędem "exec format error", sprawdź, czy plik binarny ma kompilację ARM64. Zweryfikuj architekturę poleceniem uname -m (powinno pokazać aarch64).

Zrywanie WiFi -- Wyłącz zarządzanie energią WiFi: sudo iwconfig wlan0 power off.

# Następne kroki

• Kanały -- połącz Telegram, WhatsApp, Discord i więcej
• Konfiguracja Gateway -- wszystkie opcje konfiguracji
• Aktualizowanie -- utrzymuj OpenClaw w aktualnej wersji

# Powiązane

• Omówienie instalacji
• Serwer Linux
• Platformy