Raspberry Pi

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

Совместимость оборудования

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

Предварительные требования

• Raspberry Pi 4 или 5 с 2 GB+ ОЗУ (рекомендуется 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 # Задайте часовой пояс (важно для 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 — если навык завершается с ошибкой "exec format error", проверьте наличие сборки двоичного файла для ARM64. Проверьте архитектуру с помощью uname -m (должно отображаться aarch64).

Обрывы WiFi — отключите управление энергопотреблением WiFi: sudo iwconfig wlan0 power off.

Дальнейшие действия

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

Связанные материалы

• Обзор установки
• Сервер Linux
• Платформы