Deploy no Render | Docs

Faca o deploy do OpenClaw no Render usando Infrastructure as Code. O render.yaml Blueprint incluso define toda a sua stack de forma declarativa — servico, disco, variaveis de ambiente — permitindo deploy com um unico clique e versionamento da infraestrutura junto com o codigo.

Pre-requisitos

Uma conta no Render (tier gratuito disponivel)
Uma chave de API do seu provedor de modelos preferido

Deploy com um Render Blueprint

Deploy to Render

Ao clicar nesse link, o Render vai:

Criar um novo servico a partir do Blueprint render.yaml na raiz do repositorio.
Solicitar que voce defina o SETUP_PASSWORD
Construir a imagem Docker e fazer o deploy

Apos o deploy, a URL do seu servico segue o padrao https://<nome-do-servico>.onrender.com.

Entendendo o Blueprint

Render Blueprints sao arquivos YAML que definem sua infraestrutura. O render.yaml deste repositorio configura tudo o que e necessario para rodar o OpenClaw:

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # prompts during deploy
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Principais recursos do Blueprint utilizados:

Recurso	Finalidade
`runtime: docker`	Constroi a partir do Dockerfile do repositorio
`healthCheckPath`	O Render monitora `/health` e reinicia instancias com problema
`sync: false`	Solicita o valor durante o deploy (para segredos)
`generateValue: true`	Gera automaticamente um valor criptograficamente seguro
`disk`	Armazenamento persistente que sobrevive a redeploys

Escolhendo um plano

Plano	Suspensao	Disco	Ideal para
Free	Apos 15 min ocioso	Nao disponivel	Testes, demos
Starter	Nunca	1GB+	Uso pessoal, equipes pequenas
Standard+	Nunca	1GB+	Producao, multiplos canais

O Blueprint usa starter por padrao. Para usar o tier gratuito, altere plan: free no render.yaml do seu fork (mas atencao: sem disco persistente, a config reseta a cada deploy).

Apos o deploy

Finalize o assistente de configuracao

Acesse https://<seu-servico>.onrender.com/setup
Insira seu SETUP_PASSWORD
Selecione um provedor de modelo e cole sua chave de API
Opcionalmente, configure canais de mensagens (Telegram, Discord, Slack)
Clique em Run setup

Acesse a Interface de Controle

O painel web fica disponivel em https://<seu-servico>.onrender.com/openclaw.

Recursos do Render Dashboard

Logs

Veja logs em tempo real em Dashboard → seu servico → Logs. Filtre por:

Logs de build (criacao da imagem Docker)
Logs de deploy (inicializacao do servico)
Logs de runtime (saida da aplicacao)

Acesso ao shell

Para depuracao, abra uma sessao de shell em Dashboard → seu servico → Shell. O disco persistente esta montado em /data.

Variaveis de ambiente

Modifique variaveis em Dashboard → seu servico → Environment. Alteracoes disparam um redeploy automatico.

Auto-deploy

Se voce usa o repositorio original do OpenClaw, o Render nao fara auto-deploy. Para atualizar, execute uma sincronizacao manual do Blueprint pelo dashboard.

Dominio personalizado

Acesse Dashboard → seu servico → Settings → Custom Domains
Adicione seu dominio
Configure o DNS conforme indicado (CNAME apontando para *.onrender.com)
O Render provisiona um certificado TLS automaticamente

Escalabilidade

O Render suporta escalabilidade horizontal e vertical:

Vertical: Troque de plano para obter mais CPU/RAM
Horizontal: Aumente o numero de instancias (plano Standard ou superior)

Para o OpenClaw, a escalabilidade vertical costuma ser suficiente. A horizontal exige sticky sessions ou gerenciamento de estado externo.

Backups e migracao

Exporte sua configuracao e workspace a qualquer momento:

https://<seu-servico>.onrender.com/setup/export

Isso baixa um backup portavel que voce pode restaurar em qualquer host com OpenClaw.

Solucao de problemas

Servico nao inicia

Verifique os logs de deploy no Render Dashboard. Problemas comuns:

SETUP_PASSWORD ausente — o Blueprint solicita esse valor, mas confirme que ele esta definido
Porta incorreta — garanta que PORT=8080 corresponde a porta exposta no Dockerfile

Cold starts lentos (tier gratuito)

Servicos no tier gratuito sao suspensos apos 15 minutos de inatividade. A primeira requisicao apos a suspensao leva alguns segundos enquanto o container inicia. Para manter o servico sempre ativo, migre para o plano Starter.

Perda de dados apos redeploy

Isso acontece no tier gratuito (sem disco persistente). Migre para um plano pago ou exporte sua config regularmente via /setup/export.

Falhas no health check

O Render espera uma resposta 200 de /health em ate 30 segundos. Se o build funciona mas o deploy falha, o servico pode estar demorando demais para iniciar. Verifique:

Logs de build em busca de erros
Se o container roda localmente com docker build && docker run