# Render

Implante o OpenClaw no Render usando Infraestrutura como Código. 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

• Uma conta no Render (com camada gratuita disponível)
• Uma chave de API do seu provedor de modelo preferido

# Implantar com um Blueprint do Render

Implantar no Render

Clicar neste link irá:

1. Criar um novo serviço no Render a partir do Blueprint render.yaml na raiz deste repositório.
2. Construir 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

Blueprints do Render 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:

Recurso	Finalidade
runtime: docker	Constrói a partir do Dockerfile do repositório
healthCheckPath	O Render monitora /health e reinicia instâncias não saudáveis
generateValue: true	Gera automaticamente um valor criptograficamente seguro
disk	Armazenamento persistente que sobrevive a reimplantações

# Escolhendo um plano

Plano	Hibernação	Disco	Melhor para
Free	Após 15 min ocioso	Não disponível	Testes, demonstrações
Starter	Nunca	1GB+	Uso pessoal, equipes pequenas
Standard+	Nunca	1GB+	Produção, vários canais

O Blueprint usa starter por padrão. Para usar a camada gratuita, altere plan: free em render.yaml no seu fork (mas observe: sem disco persistente, o estado do OpenClaw é redefinido a cada implantação).

# Após a implantação

# Acesse a Control UI

O painel web está disponível em https://<your-service>.onrender.com/.

Conecte-se usando o segredo compartilhado configurado. Este modelo de implantação gera automaticamente OPENCLAW_GATEWAY_TOKEN (encontre-o em Dashboard → your service → Environment); se você substituí-lo por autenticação por senha, use essa senha em vez disso.

# Recursos do Dashboard do Render

# Logs

Veja logs em tempo real em Dashboard → your service → 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 → your service → Shell. O disco persistente é montado em /data.

# Variáveis de ambiente

Modifique variáveis em Dashboard → your service → Environment. As mudanças acionam uma reimplantaçã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 → your service → 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: altere o plano para obter mais CPU/RAM
• Horizontal: aumente a contagem de instâncias (plano Standard e superiores)

Para o OpenClaw, o escalonamento vertical geralmente é suficiente. O escalonamento horizontal exige sessões fixas 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 Dashboard do Render:

openclaw backup create

Isso cria um arquivo de backup portátil com o estado do OpenClaw mais qualquer workspace configurado. Veja Backup para detalhes.

# Solução de problemas

# O serviço não inicia

Verifique os logs de implantação no Dashboard do Render. Problemas comuns:

• OPENCLAW_GATEWAY_TOKEN ausente — verifique se está definido em Dashboard → Environment
• Incompatibilidade de porta — verifique se OPENCLAW_GATEWAY_PORT=8080 está definido para que o Gateway se vincule à porta esperada pelo Render

# Inicialização lenta a frio (camada gratuita)

Serviços da camada gratuita hibernam após 15 minutos de inatividade. A primeira solicitação após a hibernação leva alguns segundos enquanto o contêiner inicia. Faça upgrade para o plano Starter para manter sempre ativo.

# Perda de dados após reimplantação

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

# Falhas na verificação de integridade

O Render espera uma resposta 200 de /health em até 30 segundos. Se os builds forem bem-sucedidos, 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 é executado localmente com docker build && docker run

# Próximos passos

• Configure canais de mensagens: Channels
• Configure o Gateway: Configuração do Gateway
• Mantenha o OpenClaw atualizado: Atualizando