A Vertra Cloud não hospeda modelo. Você traz a chave de um provedor e paga o uso do modelo a esse provedor. Este template é um empacotamento da Vertra Cloud e não é afiliado ao projeto OpenClaw (licença MIT).
Requisitos e plano
1. Obtenha a chave do provedor e escolha o modelo
O OpenClaw funciona com OpenAI, Anthropic, Google Gemini, OpenRouter ou um endpoint compatível com a OpenAI, e dezenas de outros pelo painel (Settings > Models). Crie uma chave na conta do seu provedor e copie-a: a maioria dos provedores a mostra só uma vez. No assistente você informa a chave e, opcionalmente, o modelo. Vazio significa o padrão do provedor. Com um endpoint compatível, a URL base (terminada em/v1) e o modelo são obrigatórios. No OpenRouter qualquer id de modelo funciona, inclusive os :free. O OpenClaw inicia mesmo com uma chave inválida; a chave só é usada quando o assistente responde, então teste-a no primeiro chat.
2. Crie o assistente
1
Abra o template
No dashboard, abra Templates, escolha OpenClaw e clique em Use template.
2
Provedor, chave e modelo
Escolha o provedor, cole a chave e, se quiser, digite o modelo.
3
Navegador: sim ou não
Can the assistant use a browser? Yes (padrão) adiciona o Chromium ao app e exige no mínimo 3 GB de memória. No entrega um assistente só de texto, com 2 GB. Vale a partir da primeira inicialização.
4
Canais (opcional)
Telegram, Discord e Slack pedem cada um o token e quem pode falar com o bot. Sem uma lista de permitidos, o canal não é ativado. Veja o passo 4.
5
Crie
Dê um nome ao app e clique em Create. As saídas mostram o endereço do app e o token do gateway, mostrado uma única vez. Copie o token.
3. Primeiro acesso: o token do gateway
1
Abra o endereço
Abra o endereço do app. O painel (Control UI) pede o token.
2
Cole o token
Em Settings > Gateway, cole o gateway token das saídas. O token também fica na variável criptografada
OPENCLAW_GATEWAY_TOKEN.3
Aguarde o pareamento
Aguarde até 15 segundos: o primeiro navegador que você usar é aprovado automaticamente. Depois disso, converse com o assistente no painel.
Aprove um segundo navegador ou dispositivo
Somente o primeiro dispositivo é aprovado sozinho. Quando você abre o painel em outro navegador ou computador e cola o token, o dispositivo fica aguardando aprovação. A partir de um dispositivo já conectado, abra Settings > Devices e aprove o novo.O pareamento automático reduz “token mais aprovação” para “token” apenas para esse primeiro dispositivo. Se você prefere aprovar todos os dispositivos, defina
OPENCLAW_BOOTSTRAP_PAIRING como off nas variáveis do app antes do primeiro acesso.4. Conecte um canal
Você pode configurar os canais no assistente ou depois, no painel.- Telegram
- Discord
- Slack
- WhatsApp
- No Telegram, fale com o @BotFather, envie
/newbote copie o bot token. - Descubra seu id numérico com o @userinfobot.
- Informe o token e o seu id.
5. Use o navegador
Peça algo que precise da web, como “abra example.com e me diga o título”. Em Chat > + > Browser você vê a janela que o agente está usando.- O navegador do agente bloqueia redes privadas e locais, de propósito.
- Ele roda sem o sandbox próprio do Chromium: o container é o isolamento.
- Ele precisa de memória. Com várias abas o Chromium passa de 2 GB, então um plano com folga importa.
O terminal do painel
O painel tem um terminal que abre um shell no próprio container do app, sem privilégio extra. Use-o para olhar o ambiente, mas lembre que o sistema de arquivos do container fora de/app é somente leitura.
Cron, skills e voz
Use Settings > Cron para tarefas agendadas. As skills prontas aparecem em Skills. A voz precisa do microfone do seu navegador e de um provedor de fala.Mude o provedor ou o modelo depois
Use Settings > Models no painel. As variáveisOPENCLAW_PROVIDER e OPENCLAW_MODEL_ID também seguem o assistente a cada inicialização. O arquivo /app/.openclaw/openclaw.json é gerado uma única vez; depois disso ele é seu e o painel o reescreve. O token do gateway, a origem pública e o modelo seguem as variáveis do app.
O custo da IA é seu
O plano cobra a memória. Seu provedor cobra as chamadas ao modelo. Tarefas do navegador e jobs agendados podem consumir muitos tokens, então defina um limite de gastos na conta do seu provedor.Atualize e faça rollback
As novas versões chegam como novas versões do template. Um snapshot é feito antes da atualização, e o rollback traz os dados junto, porque o OpenClaw migra o esquema local quando inicia uma nova versão. Veja Atualizar e fazer rollback. O deploy sem downtime está desligado: duas cópias no mesmo disco não podem coexistir.Problemas comuns
O painel não conecta
O painel não conecta
Confira o token em Settings > Gateway e se o endereço que você abriu é o próprio endereço do app (
PUBLIC_ORIGIN).Discord ou Slack demoram a subir
Discord ou Slack demoram a subir
Normal no primeiro boot (plugins do npm). Se falhar, confira o token e o acesso ao npm no log do app.
OPENCLAW_MODEL_ID is required
OPENCLAW_MODEL_ID is required
Com um endpoint compatível o modelo é obrigatório. Defina
OPENCLAW_MODEL_ID e reinicie.Relacionados
OpenClaw no catálogo
O que o template cria e suas variáveis.
Atualizar e fazer rollback
O snapshot de segurança e o rollback com dados.
Página pública
O template na galeria pública.
Usar um template
A galeria, o assistente e as saídas.