// dokumentacja openclaw

Instalacja OpenClaw na Raspberry Pi — poradnik krok po kroku

OpenClaw na Raspberry Pi

Raspberry Pi to doskonała platforma do uruchomienia prywatnego Gateway OpenClaw. Sam Gateway działa lokalnie na Pi, natomiast modele AI komunikują się przez API w chmurze — dzięki temu nawet skromne konfiguracje Pi radzą sobie z obsługą agentów.

Wymagania sprzętowe

  • Raspberry Pi 4 lub 5 z minimum 2 GB RAM (zalecane 4 GB).
  • System operacyjny 64-bitowy — wersje 32-bitowe nie są obsługiwane.
  • Karta microSD lub dysk SSD USB — SSD zapewnia znacznie lepszą wydajność.
  • Zasilacz odpowiedni dla modelu Pi.
  • Połączenie z internetem (Ethernet lub Wi-Fi).

Krok 1 — Przygotowanie systemu

Wgraj 64-bitowy Raspberry Pi OS Lite za pomocą oficjalnego narzędzia Raspberry Pi Imager. Wersja Lite (bez pulpitu graficznego) jest zalecana dla Gateway, który będzie działał jako serwer.

W ustawieniach Imagera skonfiguruj:

  • Nazwę hosta (np. openclaw-pi).
  • Dostęp SSH z kluczem publicznym.
  • Dane sieci Wi-Fi (jeśli nie używasz Ethernetu).

Krok 2 — Połączenie przez SSH

ssh pi@openclaw-pi.local

Krok 3 — Aktualizacja systemu i zależności

sudo apt update && sudo apt upgrade -y
sudo apt install -y git build-essential

Krok 4 — Instalacja Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v  # Powinno wyswietlic v24.x.x

Krok 5 — Konfiguracja pamięci swap

Szczególnie ważne dla modeli Pi z 2 GB RAM. Dodatkowy swap zapobiega zamrożeniu systemu podczas intensywnych operacji:

sudo dphys-swapfile swapoff
sudo sed -i 's/CONF_SWAPSIZE=.*/CONF_SWAPSIZE=2048/' /etc/dphys-swapfile
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

Krok 6 — Instalacja OpenClaw

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

Krok 7 — Konfiguracja i uruchomienie

openclaw onboard --install-daemon

Kreator przeprowadzi Cię przez konfigurację klucza API, kanałów komunikacji i automatycznego uruchamiania jako usługa systemd.

Krok 8 — Dostęp do panelu

Z innego komputera w sieci użyj tunelu SSH:

ssh -L 18789:127.0.0.1:18789 pi@openclaw-pi.local

Następnie otwórz w przeglądarce http://localhost:18789.

Optymalizacja wydajności

  • Włącz cache kompilacji modułów — przyspiesza operacje CLI na słabszym sprzęcie.
  • Zmniejsz pamięć GPU — dla pracy bez ekranu ustaw gpu_mem=16 w /boot/config.txt.
  • Wyłącz Bluetooth — jeśli nie używasz, dodaj dtoverlay=disable-bt do /boot/config.txt.
  • Używaj SSD zamiast karty SD — znacznie poprawia czas odpowiedzi i żywotność nośnika.

Rozwiązywanie problemów

  • Brak pamięci — zwiększ swap lub rozważ upgrade do modelu z 4 GB RAM.
  • Usługa nie startuje — sprawdź logi: journalctl --user -u openclaw-gateway.
  • Problemy z Wi-Fi — zweryfikuj konfigurację sieci: nmcli device status.
  • Wolne działanie CLI — włącz cache kompilacji modułów w konfiguracji OpenClaw.
Wróc do dokumentacji