Raspberry Pi

Запустіть постійний, безперервно активний OpenClaw Gateway на Raspberry Pi. Оскільки Pi слугує лише шлюзом (моделі працюють у хмарі через 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 # Установіть часовий пояс (важливо для cron і нагадувань)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 # Зменште схильність до підкачки для пристроїв із малим обсягом ОЗПecho '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 значно підвищує продуктивність і витримує більше циклів запису; використовуйте його для OPENCLAW_STATE_DIR, якщо ОС залишається на SD-картці. Див. посібник із завантаження Pi через USB.

Увімкніть кеш компіляції модулів — це прискорює повторні виклики CLI на малопотужних хостах Pi. OPENCLAW_NO_RESPAWN=1 забезпечує виконання звичайних перезапусків Gateway у межах того самого процесу, уникаючи додаткової передачі між процесами та спрощуючи відстеження PID на малих хостах:

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

Використовуйте /var/tmp, а не /tmp — деякі дистрибутиви очищують /tmp під час завантаження, через що прогрітий кеш видаляється.

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

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

Додаткова конфігурація systemd для стабільних перезапусків — якщо цей Pi переважно використовується для запуску OpenClaw, додайте додаткову конфігурацію служби:

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. На Pi без монітора також один раз увімкніть збереження користувацьких служб після виходу із системи: sudo loginctl enable-linger "$(whoami)".

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

Оскільки Pi запускає лише шлюз, використовуйте моделі API, розміщені у хмарі, — не запускайте локальні LLM на Pi, адже навіть малі моделі надто повільні для практичного використання:

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

Примітки щодо бінарних файлів ARM

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

Збереження стану та резервні копії

Стан OpenClaw зберігається в таких каталогах:

• ~/.openclaw/ — openclaw.json, окремі для кожного агента auth-profiles.json, стан каналів і постачальників, сеанси.
• ~/.openclaw/workspace/ — робочий простір агента (SOUL.md, пам’ять, артефакти).

Ці дані зберігаються після перезавантажень, а використання SSD замість SD-картки підвищує як продуктивність, так і довговічність. Створіть переносний знімок за допомогою:

openclaw backup create

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

Недостатньо пам’яті — перевірте, чи активна підкачка, за допомогою free -h. Вимкніть невикористовувані служби (sudo systemctl disable cups bluetooth avahi-daemon). Використовуйте лише моделі на основі API.

Низька продуктивність — використовуйте USB SSD замість SD-картки. Перевірте обмеження частоти процесора за допомогою vcgencmd get_throttled (має повернути 0x0).

Служба не запускається — перегляньте журнали за допомогою journalctl --user -u openclaw-gateway.service --no-pager -n 100 і виконайте openclaw doctor --non-interactive. Якщо це Pi без монітора, також перевірте, чи ввімкнено збереження користувацьких служб після виходу із системи: sudo loginctl enable-linger "$(whoami)".

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

Обриви WiFi-з’єднання — вимкніть керування живленням WiFi: sudo iwconfig wlan0 power off.

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

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

Пов’язані матеріали

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