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 на небольших хостах.

Снизьте использование памяти -- Для headless-настроек освободите память GPU и отключите неиспользуемые службы:

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

systemd drop-in для стабильных перезапусков -- Если этот Pi в основном запускает OpenClaw, добавьте 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-сервер
• Платформы