Raspberry Pi

Uruchom trwały, działający bez przerwy Gateway OpenClaw na Raspberry Pi. Ponieważ Pi pełni jedynie funkcję Gateway (modele działają w chmurze przez API), nawet podstawowy model Pi dobrze radzi sobie z tym obciążeniem — typowy jednorazowy koszt sprzętu wynosi 35–80 USD, 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: co najmniej 2 GB RAM, karta SD o pojemności co najmniej 16 GB (lub dysk SSD USB), Ethernet.

Wymagania wstępne

• Raspberry Pi 4 lub 5 z co najmniej 2 GB RAM (zalecane 4 GB)
• Karta microSD (co najmniej 16 GB) lub dysk SSD USB (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żywaj dysku SSD USB — karty SD są wolne i zużywają się. Dysk SSD USB znacząco zwiększa wydajność i wytrzymuje więcej cykli zapisu; użyj go dla OPENCLAW_STATE_DIR, jeśli system operacyjny pozostaje na karcie SD. Zobacz przewodnik uruchamiania Pi z USB.

Włącz pamięć podręczną kompilacji modułów — przyspiesza wielokrotne wywołania CLI na mniej wydajnych hostach Pi. OPENCLAW_NO_RESPAWN=1 sprawia, że rutynowe ponowne uruchomienia Gateway odbywają się w tym samym procesie, co pozwala uniknąć dodatkowego przekazywania między procesami i upraszcza śledzenie PID na małych hostach:

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

Używaj /var/tmp, a nie /tmp — niektóre dystrybucje czyszczą /tmp podczas uruchamiania, co usuwa przygotowaną pamięć podręczną.

Zmniejsz zuż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.txtsudo systemctl disable bluetooth

Nadpisanie systemd zapewniające stabilne ponowne uruchamianie — jeśli to Pi służy głównie do uruchamiania OpenClaw, dodaj nadpisanie 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 wykonaj systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Na Pi bez monitora włącz również raz pozostawanie procesu użytkownika po wylogowaniu, aby usługa użytkownika nadal działała: sudo loginctl enable-linger "$(whoami)".

Zalecana konfiguracja modelu

Ponieważ Pi uruchamia tylko Gateway, korzystaj z modeli API hostowanych w chmurze — nie uruchamiaj lokalnych modeli LLM na Pi, ponieważ nawet małe modele są zbyt wolne, aby były użyteczne:

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

Uwagi dotyczące plików binarnych ARM

Większość funkcji OpenClaw działa na ARM64 bez zmian (Node.js, Telegram, WhatsApp/Baileys, Chromium). Pliki binarne, dla których czasami brakuje kompilacji ARM, to zazwyczaj opcjonalne narzędzia CLI napisane w Go lub Rust i dostarczane przez Skills. Sprawdź architekturę za pomocą uname -m (wynikiem powinno być aarch64), a następnie poszukaj artefaktów linux-arm64 / aarch64 na stronie wydań brakującego pliku binarnego, zanim zdecydujesz się na kompilację ze źródeł.

Trwałość danych i kopie zapasowe

Stan OpenClaw znajduje się w:

• ~/.openclaw/ — openclaw.json, pliki auth-profiles.json poszczególnych agentów, stan kanałów i dostawców oraz sesje.
• ~/.openclaw/workspace/ — przestrzeń robocza agenta (SOUL.md, pamięć, artefakty).

Dane te przetrwają ponowne uruchomienia, a przechowywanie ich na dysku SSD zamiast na karcie SD zwiększa zarówno wydajność, jak i trwałość. Utwórz przenośną migawkę za pomocą:

openclaw backup create

Rozwiązywanie problemów

Brak pamięci — sprawdź za pomocą free -h, czy przestrzeń wymiany jest aktywna. 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 dysku SSD USB zamiast karty SD. Sprawdź ograniczanie częstotliwości procesora za pomocą vcgencmd get_throttled (wynikiem powinno być 0x0).

Usługa nie uruchamia się — sprawdź dzienniki za pomocą journalctl --user -u openclaw-gateway.service --no-pager -n 100 i uruchom openclaw doctor --non-interactive. Jeśli jest to Pi bez monitora, sprawdź również, czy pozostawanie procesu użytkownika po wylogowaniu jest włączone: sudo loginctl enable-linger "$(whoami)".

Problemy z plikami binarnymi ARM — jeśli Skill kończy działanie z błędem „exec format error”, sprawdź, czy plik binarny ma kompilację ARM64. Sprawdź architekturę za pomocą uname -m (wynikiem powinno być aarch64).

Zrywanie połączenia WiFi — wyłącz zarządzanie energią WiFi: sudo iwconfig wlan0 power off.

Następne kroki

• Kanały — połącz Telegram, WhatsApp, Discord i inne usługi
• Konfiguracja Gateway — wszystkie opcje konfiguracji
• Aktualizowanie — dbaj o aktualność OpenClaw

Powiązane materiały

• Omówienie instalacji
• Serwer Linux
• Platformy