Raspberry Pi

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

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

Мінімум: 1 ГБ ОЗП, 1 ядро, 500 МБ вільного диска, 64-бітна ОС. Рекомендовано: 2+ ГБ ОЗП, SD-карта 16+ ГБ (або USB SSD), Ethernet.

Передумови

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

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

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

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

Використовуйте 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 secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

Зменште використання пам’яті -- для headless-налаштувань звільніть пам’ять GPU й вимкніть невикористовувані служби:

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

systemd drop-in для стабільних перезапусків -- якщо цей Pi здебільшого запускає OpenClaw, додайте service drop-in:

systemctl --user edit openclaw-gateway.service

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

Потім systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. На headless 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, поагентні 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. Якщо це headless Pi, також перевірте, що lingering увімкнено: sudo loginctl enable-linger "$(whoami)".

Проблеми з бінарними файлами ARM -- Якщо skill завершується з помилкою "exec format error", перевірте, чи має бінарний файл ARM64-збірку. Перевірте архітектуру за допомогою uname -m (має показати aarch64).

Розривається WiFi -- Вимкніть керування живленням WiFi: sudo iwconfig wlan0 power off.

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

• Канали -- підключіть Telegram, WhatsApp, Discord та інші
• Конфігурація Gateway -- усі параметри конфігурації
• Оновлення -- підтримуйте OpenClaw в актуальному стані

Пов’язане

• Огляд встановлення
• Linux-сервер
• Платформи