Pular para o conteúdo principal
Implante o OpenClaw no Render usando Infrastructure as Code. O Blueprint render.yaml incluído define toda a sua stack de forma declarativa — serviço, disco, variáveis de ambiente — para que você possa implantar com um único clique e versionar sua infraestrutura junto com seu código.

​
Pré-requisitos

​
Implantar com um Render Blueprint

Deploy to Render Ao clicar nesse link, você irá:
  1. Criar um novo serviço no Render a partir do Blueprint render.yaml na raiz deste repositório.
  2. Compilar a imagem Docker e implantar
Depois da implantação, a URL do seu serviço seguirá o padrão https://<service-name>.onrender.com.

​
Entendendo o Blueprint

Render Blueprints são arquivos YAML que definem sua infraestrutura. O render.yaml neste repositório configura tudo o que é necessário para executar o OpenClaw: 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # gera automaticamente um token seguro
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Principais recursos do Blueprint usados:
RecursoFinalidade
runtime: dockerCompila a partir do Dockerfile do repositório
healthCheckPathO Render monitora /health e reinicia instâncias não saudáveis
generateValue: trueGera automaticamente um valor criptograficamente seguro
diskArmazenamento persistente que sobrevive a novas implantações

​
Escolhendo um plano

PlanoSuspensãoDiscoMelhor para
FreeApós 15 min ociosoNão disponívelTestes, demos
StarterNunca1GB+Uso pessoal, pequenas equipes
Standard+Nunca1GB+Produção, múltiplos canais
O Blueprint usa starter por padrão. Para usar a camada gratuita, altere plan: free no render.yaml do seu fork (mas observe: sem disco persistente, o estado do OpenClaw é redefinido a cada implantação).

​
Após a implantação

​
Acessar a Control UI

O dashboard web está disponível em https://<your-service>.onrender.com/. Conecte-se usando o segredo compartilhado configurado. Este template de implantação gera automaticamente OPENCLAW_GATEWAY_TOKEN (encontre-o em Dashboard → seu serviço → Environment); se você o substituir por autenticação por senha, use essa senha em vez disso.

​
Recursos do Render Dashboard

​
Logs

Veja logs em tempo real em Dashboard → seu serviço → Logs. Filtre por:
  • Logs de build (criação da imagem Docker)
  • Logs de implantação (inicialização do serviço)
  • Logs de runtime (saída da aplicação)

​
Acesso ao shell

Para depuração, abra uma sessão de shell em Dashboard → seu serviço → Shell. O disco persistente é montado em /data.

​
Variáveis de ambiente

Modifique variáveis em Dashboard → seu serviço → Environment. Alterações acionam uma nova implantação automática.

​
Implantação automática

Se você usar o repositório original do OpenClaw, o Render não fará implantação automática do seu OpenClaw. Para atualizá-lo, execute uma sincronização manual do Blueprint pelo dashboard.

​
Domínio personalizado

  1. Vá para Dashboard → seu serviço → Settings → Custom Domains
  2. Adicione seu domínio
  3. Configure o DNS conforme instruído (CNAME para *.onrender.com)
  4. O Render provisiona automaticamente um certificado TLS

​
Escalonamento

O Render oferece suporte a escalonamento horizontal e vertical:
  • Vertical: mude o plano para obter mais CPU/RAM
  • Horizontal: aumente a contagem de instâncias (plano Standard e acima)
Para o OpenClaw, o escalonamento vertical geralmente é suficiente. O escalonamento horizontal exige sessões persistentes ou gerenciamento de estado externo.

​
Backups e migração

Exporte seu estado, configuração, perfis de autenticação e workspace a qualquer momento usando o acesso ao shell no Render Dashboard: 
openclaw backup create
Isso cria um arquivo de backup portátil com o estado do OpenClaw mais qualquer workspace configurado. Consulte Backup para detalhes.

​
Solução de problemas

​
O serviço não inicia

Verifique os logs de implantação no Render Dashboard. Problemas comuns:
  • OPENCLAW_GATEWAY_TOKEN ausente — verifique se ele está definido em Dashboard → Environment
  • Incompatibilidade de porta — verifique se OPENCLAW_GATEWAY_PORT=8080 está definido para que o gateway seja vinculado à porta esperada pelo Render

​
Inicializações frias lentas (camada gratuita)

Serviços da camada gratuita entram em suspensão após 15 minutos de inatividade. A primeira solicitação após a suspensão leva alguns segundos enquanto o contêiner é iniciado. Atualize para o plano Starter para manter o serviço sempre ativo.

​
Perda de dados após nova implantação

Isso acontece na camada gratuita (sem disco persistente). Atualize para um plano pago ou exporte regularmente um backup completo via openclaw backup create no shell do Render.

​
Falhas em health check

O Render espera uma resposta 200 de /health em até 30 segundos. Se as compilações derem certo, mas as implantações falharem, o serviço pode estar demorando demais para iniciar. Verifique:
  • Logs de build em busca de erros
  • Se o contêiner roda localmente com docker build && docker run

​
Próximos passos