Перейти до основного вмісту
Запустіть постійний, завжди увімкнений OpenClaw Gateway на Raspberry Pi. Оскільки Pi є лише Gateway (моделі працюють у хмарі через API), навіть скромний Pi добре справляється з навантаженням — типова вартість обладнання становить $35–80 одноразово, без щомісячних платежів.

​
Сумісність обладнання

Модель PiRAMПрацює?Примітки
Pi 54/8 GBНайкращеНайшвидший, рекомендовано.
Pi 44 GBДобреОптимальний варіант для більшості користувачів.
Pi 42 GBНормальноДодайте swap.
Pi 41 GBОбмеженоМожливо зі swap, мінімальна конфігурація.
Pi 3B+1 GBПовільноПрацює, але мляво.
Pi Zero 2 W512 MBНіНе рекомендовано.
Мінімум: 1 GB RAM, 1 ядро, 500 MB вільного диска, 64-бітна ОС. Рекомендовано: 2 GB+ RAM, SD-карта 16 GB+ (або USB SSD), Ethernet.

​
Передумови

  • Raspberry Pi 4 або 5 з 2 GB+ RAM (рекомендовано 4 GB)
  • Картка MicroSD (16 GB+) або USB SSD (краща продуктивність)
  • Офіційний блок живлення Pi
  • Мережеве підключення (Ethernet або WiFi)
  • 64-бітна Raspberry Pi OS (обов’язково — не використовуйте 32-бітну)
  • Близько 30 хвилин

​
Налаштування

1

Flash the OS

Використовуйте Raspberry Pi OS Lite (64-bit) — робочий стіл не потрібен для сервера без графічного інтерфейсу.
  1. Завантажте Raspberry Pi Imager.
  2. Виберіть ОС: Raspberry Pi OS Lite (64-bit).
  3. У діалоговому вікні налаштувань попередньо задайте:
    • Hostname: gateway-host
    • Enable SSH
    • Set username and password
    • Configure WiFi (якщо не використовуєте Ethernet)
  4. Запишіть образ на SD-карту або USB-накопичувач, вставте його й завантажте 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
Дотримуйтесь майстра. API-ключі рекомендовані замість OAuth для пристроїв без графічного інтерфейсу. Telegram — найпростіший канал для початку.
8

Verify

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

Access the Control UI

На своєму комп’ютері отримайте URL панелі керування з Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
Потім створіть SSH-тунель в іншому терміналі:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Відкрийте надрукований URL у локальному браузері. Для постійного віддаленого доступу див. інтеграцію Tailscale.

​
Поради щодо продуктивності

Використовуйте USB SSD — SD-карти повільні та зношуються. USB SSD різко покращує продуктивність. Див. посібник із USB-завантаження Pi. Увімкніть кеш компіляції модулів — пришвидшує повторні виклики CLI на менш потужних хостах 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 утримує звичайні перезапуски Gateway у межах процесу, що уникає додаткових передавань між процесами та спрощує відстеження PID на малих хостах. Зменште використання пам’яті — Для налаштувань без графічного інтерфейсу звільніть пам’ять GPU і вимкніть невикористовувані служби: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
systemd drop-in для стабільних перезапусків — Якщо цей Pi здебільшого запускає OpenClaw, додайте service drop-in: 
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
Потім systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. На Pi без графічного інтерфейсу також один раз увімкніть lingering, щоб служба користувача переживала вихід із системи: sudo loginctl enable-linger "$(whoami)".

​
Рекомендоване налаштування моделей

Оскільки Pi запускає лише Gateway, використовуйте API-моделі, розміщені в хмарі: 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}
Не запускайте локальні LLM на Pi — навіть малі моделі надто повільні, щоб бути корисними. Нехай Claude або GPT виконують роботу моделі.

​
Примітки щодо ARM-бінарників

Більшість функцій OpenClaw працює на ARM64 без змін (Node.js, Telegram, WhatsApp/Baileys, Chromium). Бінарники, для яких іноді бракує ARM-збірок, зазвичай є необов’язковими CLI-інструментами Go/Rust, що постачаються Skills. Перевірте сторінку релізів відсутнього бінарника на наявність артефактів linux-arm64 / aarch64, перш ніж переходити до збирання з вихідного коду.

​
Постійність і резервні копії

Стан OpenClaw зберігається в:
  • ~/.openclaw/ — openclaw.json, per-agent auth-profiles.json, стан каналів/провайдерів, сеанси.
  • ~/.openclaw/workspace/ — робочий простір агента (SOUL.md, пам’ять, артефакти).
Вони переживають перезавантаження. Створіть переносний знімок за допомогою: 
openclaw backup create
Якщо тримати їх на SSD, і продуктивність, і довговічність покращаться порівняно з SD-картою.

​
Усунення несправностей

Бракує пам’яті — Перевірте, що swap активний, за допомогою free -h. Вимкніть невикористовувані служби (sudo systemctl disable cups bluetooth avahi-daemon). Використовуйте лише API-моделі. Повільна продуктивність — Використовуйте USB SSD замість SD-карти. Перевірте тротлінг CPU за допомогою vcgencmd get_throttled (має повернути 0x0). Служба не запускається — Перевірте журнали за допомогою journalctl --user -u openclaw-gateway.service --no-pager -n 100 і запустіть openclaw doctor --non-interactive. Якщо це Pi без графічного інтерфейсу, також перевірте, що lingering увімкнено: sudo loginctl enable-linger "$(whoami)". Проблеми з ARM-бінарниками — Якщо skill завершується з помилкою “exec format error”, перевірте, чи має бінарник ARM64-збірку. Перевірте архітектуру за допомогою uname -m (має показати aarch64). WiFi від’єднується — Вимкніть керування живленням WiFi: sudo iwconfig wlan0 power off.

​
Наступні кроки

​
Пов’язане