Przejdź do głównej treści
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

Model PiRAMDziała?Uwagi
Pi 54/8 GBNajlepiejNajszybszy, zalecany.
Pi 44 GBDobrzeNajlepszy wybór dla większości użytkowników.
Pi 42 GBOKDodaj swap.
Pi 41 GBCiasnoMożliwe ze swapem, minimalna konfiguracja.
Pi 3B+1 GBWolnoDziała, ale ociężale.
Pi Zero 2 W512 MBNieNiezalecany.
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

1

Flash the OS

Użyj Raspberry Pi OS Lite (64-bit) — pulpit nie jest potrzebny dla serwera headless.
  1. Pobierz Raspberry Pi Imager.
  2. Wybierz system: Raspberry Pi OS Lite (64-bit).
  3. W oknie ustawień wstępnie skonfiguruj:
    • Nazwa hosta: gateway-host
    • Włącz SSH
    • Ustaw nazwę użytkownika i hasło
    • Skonfiguruj WiFi (jeśli nie używasz Ethernetu)
  4. Wgraj obraz na kartę SD lub dysk USB, włóż nośnik i uruchom Pi.
2

Connect via SSH

ssh user@gateway-host
3

Update the system

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

Install Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

Add swap (important for 2 GB or less)

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

Install OpenClaw

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

Run onboarding

openclaw onboard --install-daemon
Postępuj zgodnie z kreatorem. Klucze API są zalecane zamiast OAuth dla urządzeń headless. Telegram to najłatwiejszy kanał na start.
8

Verify

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
9

Access the Control UI

Na swoim komputerze pobierz URL panelu z Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
Następnie utwórz tunel SSH w innym terminalu:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Otwórz wydrukowany URL w lokalnej przeglądarce. Aby uzyskać zawsze dostępny dostęp zdalny, zobacz integrację Tailscale.

​
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 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
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.txt
sudo 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=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 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

​
Powiązane