Raspberry Pi

Execute um Gateway do OpenClaw persistente e sempre ativo em um Raspberry Pi. Como o Pi funciona apenas como gateway (os modelos são executados na nuvem via API), mesmo um Pi modesto lida bem com a carga de trabalho — o custo típico do hardware é de US$ 35–80, pago uma única vez, sem mensalidades.

Compatibilidade de hardware

Mínimo: 1 GB de RAM, 1 núcleo, 500 MB de espaço livre em disco e sistema operacional de 64 bits. Recomendado: 2 GB ou mais de RAM, cartão SD de 16 GB ou mais (ou SSD USB) e Ethernet.

Pré-requisitos

• Raspberry Pi 4 ou 5 com 2 GB ou mais de RAM (4 GB recomendados)
• Cartão microSD (16 GB ou mais) ou SSD USB (melhor desempenho)
• Fonte de alimentação oficial do Pi
• Conexão de rede (Ethernet ou WiFi)
• Raspberry Pi OS de 64 bits (obrigatório — não use a versão de 32 bits)
• Cerca de 30 minutos

Configuração

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Defina o fuso horário (importante para cron e lembretes)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 # Reduza a tendência de uso de swap em dispositivos com pouca RAMecho '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

Dicas de desempenho

Use um SSD USB — cartões SD são lentos e se desgastam. Um SSD USB melhora consideravelmente o desempenho e suporta mais ciclos de gravação; use-o para OPENCLAW_STATE_DIR caso mantenha o sistema operacional no SD. Consulte o guia de inicialização por USB do Pi.

Ative o cache de compilação de módulos — acelera execuções repetidas da CLI em hosts Pi com menor capacidade de processamento. OPENCLAW_NO_RESPAWN=1 mantém as reinicializações rotineiras do Gateway no mesmo processo, evitando transferências adicionais entre processos e simplificando o acompanhamento do PID em hosts pequenos:

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

Use /var/tmp, não /tmp — algumas distribuições limpam /tmp durante a inicialização, o que remove o cache já aquecido.

Reduza o uso de memória — para configurações sem monitor, libere memória da GPU e desative serviços não utilizados:

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

Configuração complementar do systemd para reinicializações estáveis — se este Pi for usado principalmente para executar o OpenClaw, adicione uma configuração complementar ao serviço:

systemctl --user edit openclaw-gateway.service

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

Depois, execute systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Em um Pi sem monitor, também ative uma vez a permanência do serviço para que o serviço do usuário continue em execução após o logout: sudo loginctl enable-linger "$(whoami)".

Configuração de modelo recomendada

Como o Pi executa apenas o gateway, use modelos de API hospedados na nuvem — não execute LLMs locais em um Pi, pois mesmo os modelos pequenos são lentos demais para serem úteis:

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

Observações sobre binários ARM

A maioria dos recursos do OpenClaw funciona em ARM64 sem alterações (Node.js, Telegram, WhatsApp/Baileys e Chromium). Os binários que ocasionalmente não têm compilações para ARM costumam ser ferramentas opcionais de CLI em Go/Rust fornecidas por skills. Verifique a arquitetura com uname -m (deve exibir aarch64) e consulte a página de lançamentos do binário ausente para procurar artefatos linux-arm64 / aarch64 antes de recorrer à compilação a partir do código-fonte.

Persistência e backups

O estado do OpenClaw fica em:

• ~/.openclaw/ — openclaw.json, auth-profiles.json de cada agente, estado de canais/provedores e sessões.
• ~/.openclaw/workspace/ — espaço de trabalho do agente (SOUL.md, memória e artefatos).

Esses dados sobrevivem às reinicializações e se beneficiam do uso de SSD em vez de cartão SD, tanto em desempenho quanto em longevidade. Crie um snapshot portátil com:

openclaw backup create

Solução de problemas

Memória insuficiente — verifique se a swap está ativa com free -h. Desative serviços não utilizados (sudo systemctl disable cups bluetooth avahi-daemon). Use apenas modelos baseados em API.

Desempenho lento — use um SSD USB em vez de um cartão SD. Verifique se há limitação da CPU com vcgencmd get_throttled (deve retornar 0x0).

O serviço não inicia — consulte os logs com journalctl --user -u openclaw-gateway.service --no-pager -n 100 e execute openclaw doctor --non-interactive. Se este for um Pi sem monitor, verifique também se a permanência está ativada: sudo loginctl enable-linger "$(whoami)".

Problemas com binários ARM — se uma skill falhar com "exec format error", verifique se o binário possui uma compilação para ARM64. Confirme a arquitetura com uname -m (deve exibir aarch64).

Quedas do WiFi — desative o gerenciamento de energia do WiFi: sudo iwconfig wlan0 power off.

Próximas etapas

• Canais — conecte Telegram, WhatsApp, Discord e outros
• Configuração do Gateway — todas as opções de configuração
• Atualização — mantenha o OpenClaw atualizado

Conteúdo relacionado

• Visão geral da instalação
• Servidor Linux
• Plataformas