EasyRunner

EasyRunner pode hospedar o Gateway do OpenClaw como um pequeno app conteinerizado atrás de seu proxy Caddy. Este guia pressupõe um host EasyRunner que executa apps Compose compatíveis com Podman e expõe HTTPS por meio do Caddy.

Antes de começar

• Um servidor EasyRunner com um domínio roteado para ele.
• Uma imagem de contêiner do OpenClaw criada ou publicada.
• Um volume de configuração persistente para /home/node/.openclaw.
• Um volume de workspace persistente para /workspace.
• Um token ou senha forte do Gateway.

Mantenha a autenticação de dispositivo habilitada quando possível. Se sua implantação de proxy reverso não conseguir transportar corretamente a identidade do dispositivo, corrija primeiro as configurações de proxy confiável; use contornos perigosos de autenticação somente para uma rede totalmente privada e controlada pelo operador.

App Compose

Crie um app EasyRunner com um arquivo Compose estruturado assim:

services:  openclaw:    image: ghcr.io/openclaw/openclaw:latest    restart: unless-stopped    environment:      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}      OPENCLAW_HOME: /home/node      OPENCLAW_STATE_DIR: /home/node/.openclaw      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json      OPENCLAW_WORKSPACE_DIR: /workspace    volumes:      - openclaw-config:/home/node/.openclaw      - openclaw-workspace:/workspace    labels:      caddy: openclaw.example.com      caddy.reverse_proxy: "{{upstreams 1455}}"    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"] volumes:  openclaw-config:  openclaw-workspace:

Substitua openclaw.example.com pelo nome de host do seu Gateway. Armazene OPENCLAW_GATEWAY_TOKEN no gerenciador de segredos/ambiente do EasyRunner em vez de confirmá-lo na definição do app.

Configurar o OpenClaw

Dentro do volume de configuração persistente, mantenha o Gateway acessível somente por meio do proxy e exija autenticação:

{  gateway: {    bind: "lan",    port: 1455,    auth: {      token: "${OPENCLAW_GATEWAY_TOKEN}",    },  },}

Se o Caddy encerrar TLS para o Gateway, configure as configurações de proxy confiável para o caminho exato do proxy em vez de desabilitar verificações de autenticação globalmente. Consulte Autenticação de proxy confiável.

Verificar

A partir da sua estação de trabalho:

openclaw gateway probe --url https://openclaw.example.com --token <token>openclaw gateway status --url https://openclaw.example.com --token <token>

A partir do host EasyRunner, verifique nos logs do app se há um Gateway em escuta e se não há falhas de autenticação de SecretRef, Plugin ou canal na inicialização.

Atualizações e backups

• Baixe ou crie a nova imagem do OpenClaw e, em seguida, reimplante o app EasyRunner.
• Faça backup do volume openclaw-config antes das atualizações.
• Faça backup de openclaw-workspace se agentes gravarem dados de projeto duráveis ali.
• Execute openclaw doctor após atualizações importantes para identificar migrações de configuração e avisos de serviço.

Solução de problemas

• gateway probe não consegue se conectar: confirme que o nome de host do Caddy aponta para o app e que o contêiner escuta em 0.0.0.0:1455.
• A autenticação falha: altere o token nos segredos do EasyRunner e no comando do cliente local juntos.
• Os arquivos pertencem ao root após a restauração: repare os volumes montados para que o usuário do contêiner possa gravar em /home/node/.openclaw e /workspace.
• Plugins de navegador ou canal falham: verifique se os binários externos necessários, a saída de rede e as credenciais montadas estão disponíveis dentro do contêiner.