Implantação Vercel

melhor escolha pra front-end — deploy em segundos com edge computing

Implantar OpenClaw em Vercel, o palco do expert frontend

Se é dev front-end, Vercel não é novidade —— é a empresa por trás do Next.js, git push e deploya sozinho, experiência bem smooth.

mas ó: Vercel é bom pra deploy do OpenClaw pra Interface Web e API Gateway，não dá pra rodar Agent backend completo. Funções Serverless têm limite de tempo, tarefa AI de rodar longo tempo vai dar timeout. Cenário leve front + API proxy, Vercel é a coisa mais fácil.

O que Vercel consegue fazer e o que não consegue

⚠️ Serverless Functions do Vercel timeout padrão 10 segundos (versão Pro 60 segundos), não é adequado para rodar tarefas longas de inferência de AI. Se precisa rodar OpenClaw Agent completo, escolha plano VPS (AWS EC2, GCP etc).

Cenários adequados para Vercel:

Implantar OpenClaw
fazer gateway de API, encaminha requisição pro servidor backend
Guia de implantação

Vercel vs VPS tradicional

Vercel (Serverless)

git push deploy automático, sem se preocupar com servidor
rede global de borda, acesso rápido
crédito gratuito é o bastante pro projeto pessoal
não suporta tarefas de longa duração
Adequado para empresa e arquitetura complexa

VPS tradicional (EC2/GCP etc)

Controle total, roda o que quiser
Sem limite de tempo de execução
Porta que precisa estar aberta:
IP fixo, bom pra conexão backend de longa duração
Adequado para cenários

quatro passos deploy

Fork repositório

Abre o repositório GitHub do OpenClaw, clica Fork pra sua conta. Se tiver customização, traz pra local, arruma e faz push.

Depois que conecta SSH, é só ir seguindo os comandos:

vai em vercel.com Usa GitHub pra logar → Import Project → escolhe repo que fez fork → Vercel detecta tipo de projeto automaticamente.

Configuração flexível, monta conforme precisa

Nas Settings → Environment Variables do Vercel, adiciona as configurações necessárias, tipo API Key, connection string do banco, etc. Não coloca as chaves direto no código.

Implantar painel de controle web do OpenClaw

Clica Deploy, espera uns segundos. Vercel vai dar pra você um xxx.vercel.app do domínio, dá pra acessar direto. Toda vez que faz git push depois, redeploy automático.

configuração vercel.json

Cria na raiz do projeto vercel.json，configura rota e parâmetro de construção:

vercel.json

{
  "version": 2,
  "builds": [
    {
      "src": "package.json",
      "use": "@vercel/next"
    }
  ],
  "routes": [
    {
      "src": "/api/(.*)",
      "dest": "/api/$1"
    },
    {
      "src": "/(.*)",
      "dest": "/$1"
    }
  ],
  "env": {
    "NODE_ENV": "production"
  }
}

Implantação Vercel CLI

Se prefere usar linha de comando, também pode fazer deploy local com Vercel CLI:

Processo de implantação Vercel CLI

# Instalar Vercel CLI

Configuração de variável de ambiente

No Dashboard do Vercel, Settings → Environment Variables, adiciona:

Precisa configurar grupo de segurança, VPC, etc

# Obrigatório

⚠️ API Key e info sensível em variável de ambiente não coloca em Git repo, é só Vercel Dashboard que configura.

Cota gratuita Vercel

💡 Plano Hobby (gratuito) do Vercel é completamente suficiente para projeto pessoal: 100GB largura de banda / mês, 100.000 invocações Serverless / dia, HTTPS automático, domínio customizado. Desde que tráfego não seja especialmente grande, basicamente sem custos.

limite do plano gratuito:

Serverless timeout de função padrão 10 segundos (versão Pro 60 segundos)
não suporta colaboração em time (precisa Pro)
6000 minutos de tempo de build por mês
limite de tamanho do pacote de deploy único 250MB

Esse artigo vai desde o zero, guia bem passo a passo desde comprar servidor até terminar implantação. Mesmo sem nunca ter mexido com servidor em nuvem, copiando consegue.