Raspberry Pi

Uruchom trwały, zawsze włączony OpenClaw Gateway na Raspberry Pi. Ponieważ Pi jest tylko bramą (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 -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

Wskazówki dotyczące wydajności

Użyj USB SSD -- karty SD są wolne i zużywają się. USB SSD znacząco poprawia wydajność. Zobacz przewodnik rozruchu 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 secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

OPENCLAW_NO_RESPAWN=1 utrzymuje rutynowe restarty Gateway w tym samym procesie, co pozwala uniknąć dodatkowych przekazań między procesami i upraszcza śledzenie PID na małych hostach.

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

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

Drop-in systemd dla stabilnych restartów -- jeśli ten Pi działa głównie z OpenClaw, dodaj drop-in usługi:

systemctl --user edit openclaw-gateway.service

[Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

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

Zalecana konfiguracja modelu

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

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

Nie uruchamiaj lokalnych LLM-ów na Pi — nawet małe modele są zbyt wolne, by były użyteczne. Pozwól Claude lub GPT wykonać 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 buildów ARM, to zwykle opcjonalne narzędzia CLI w Go/Rust dostarczane przez Skills. Przed przejściem do budowania ze źródeł sprawdź stronę wydań brakującego binarium 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 poszczególnych agentów, stan kanałów/dostawców, sesje.
• ~/.openclaw/workspace/ — obszar roboczy agenta (SOUL.md, pamięć, artefakty).

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

openclaw backup create

Jeśli trzymasz je na SSD, poprawisz zarówno wydajność, jak i żywotność 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 wyłącznie modeli opartych na API.

Niska wydajność -- użyj USB SSD zamiast karty SD. Sprawdź dławienie CPU za pomocą vcgencmd get_throttled (powinno zwrócić 0x0).

Usługa się nie uruchamia -- sprawdź logi poleceniem journalctl --user -u openclaw-gateway.service --no-pager -n 100 i uruchom openclaw doctor --non-interactive. Jeśli to headless Pi, sprawdź też, 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 binarium ma build 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