Raspberry Pi

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

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

Мінімум: 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 хвилин

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

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

OPENCLAW_NO_RESPAWN=1 утримує звичайні перезапуски Gateway у межах процесу, що уникає додаткових передавань між процесами та спрощує відстеження PID на малих хостах.

Зменште використання пам’яті -- Для налаштувань без графічного інтерфейсу звільніть пам’ять 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. На 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.

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

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

Пов’язане

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