Skill Vercel para OpenClaw

Visao Geral do Skill Vercel para OpenClaw

O skill Vercel conecta o OpenClaw a plataforma Vercel por meio da CLI oficial do Vercel. Uma vez instalado, seu agente OpenClaw pode implantar aplicacoes, gerenciar variaveis de ambiente, configurar dominios e inspecionar logs de build — tudo por meio de comandos em portugues simples.

O Vercel e a principal plataforma de nuvem para frontend, alimentando milhoes de sites construidos com Next.js, React, Svelte e outros frameworks modernos. Com o skill Vercel do OpenClaw, voce elimina a troca de contexto entre seu editor, terminal e o painel do Vercel. Basta descrever o que voce precisa e o OpenClaw cuida do resto.

Fluxo de trabalho tipico:

1. Peca ao OpenClaw para implantar seu projeto atual no Vercel.
2. O agente executa vercel deploy por baixo dos panos, cuidando da vinculacao do projeto e da configuracao de build.
3. Uma URL de preview e retornada instantaneamente — sem necessidade de abrir o painel.

Pre-requisitos para o Skill Vercel

Antes de instalar o skill Vercel, certifique-se de que voce tem:

• OpenClaw instalado e em execucao (v1.0+)
• Vercel CLI instalada — guia oficial de instalacao
• Uma conta Vercel (o plano gratuito funciona) com pelo menos um projeto
• Node.js 18+ (necessario para a Vercel CLI)
• clawhub CLI instalada para gerenciamento de skills

Verifique sua configuracao:

# Verificar a versao do OpenClaw
openclaw --version

# Verificar a versao da Vercel CLI
vercel --version

# Verificar a autenticacao do Vercel
vercel whoami

Como Instalar o Skill Vercel

Instale o skill Vercel com um unico comando:

npx clawhub@latest install vercel

Para verificar a instalacao:

clawhub list

Voce devera ver vercel na lista de skills instalados. Se voce ainda nao vinculou um projeto Vercel, o skill solicitara que voce faca isso no primeiro uso.

Configuracao do Skill Vercel

O skill Vercel requer autenticacao via um Vercel Access Token ou o fluxo de login da Vercel CLI. Recomendamos usar vercel login para a configuracao mais simples.

Autenticacao Baseada em Token

Se voce preferir um token, crie um em vercel.com/account/tokens:

| Configuracao | Recomendacao | |---------|---------------| | Escopo | Conta Completa ou equipe especifica | | Expiracao | 90 dias (alterne regularmente) | | Nome | Use um nome descritivo como openclaw-agent |

Configuracao de Ambiente

# Opcao 1: Usar login da Vercel CLI (recomendado)
vercel login

# Opcao 2: Definir um Vercel Access Token
export VERCEL_TOKEN=seu_token_vercel_aqui

# Opcional: Definir equipe/escopo padrao
export VERCEL_ORG_ID=team_id_da_sua_equipe
export VERCEL_PROJECT_ID=prj_id_do_seu_projeto

Importante: Nunca insira tokens diretamente em arquivos de configuracao. Use variaveis de ambiente ou um gerenciador de segredos como 1Password ou Bitwarden.

Vinculacao de Projeto

Antes de implantar, vincule seu diretorio local a um projeto Vercel:

vercel link

Isso cria um diretorio .vercel com a configuracao do projeto. O skill usa essa vinculacao para determinar qual projeto implantar.

Exemplos de Uso do Skill Vercel

1. Implantar em Preview

Voce: "Implante o projeto atual no Vercel como preview."

O agente executa vercel deploy e retorna a URL de preview. Voce pode compartilhar essa URL com colegas de equipe para revisao antes de promover para producao.

2. Promover para Producao

Voce: "Promova a implantacao de preview mais recente para producao."

O agente identifica a implantacao de preview mais recente e executa vercel promote, tornando-a a versao de producao ativa. O OpenClaw confirma a acao antes de prosseguir.

3. Gerenciar Variaveis de Ambiente

Voce: "Adicione uma nova variavel de ambiente DATABASE_URL para producao com o valor postgres://..."

O agente executa vercel env add DATABASE_URL production e armazena o valor de forma segura. Voce tambem pode pedir para listar, atualizar ou remover variaveis de ambiente nos ambientes de preview, desenvolvimento e producao.

4. Inspecionar Logs de Build

Voce: "Mostre os logs de build da ultima implantacao com falha."

O agente busca as implantacoes recentes com vercel ls, identifica a que falhou e recupera a saida do build com vercel inspect. Em seguida, resume o erro e sugere uma correcao.

5. Configurar Dominios Personalizados

Voce: "Adicione o dominio app.example.com ao meu projeto Vercel."

O agente executa vercel domains add app.example.com e fornece os registros DNS que voce precisa configurar no seu registrador. Ele tambem pode verificar o status da configuracao do dominio.

Seguranca e Boas Praticas

O skill Vercel pode realizar operacoes de escrita em suas implantacoes e configuracoes de projeto. Siga estas diretrizes para se manter seguro:

• Use o minimo de privilegios. Se voce trabalha em equipe, limite os tokens a projetos especificos em vez de acesso total a conta.
• Revise antes de implantar em producao. Sempre use implantacoes de preview primeiro. O OpenClaw solicita confirmacao antes de promover para producao.
• Proteja as variaveis de ambiente. Valores sensiveis como URLs de banco de dados e chaves de API devem ser definidos via vercel env — nunca commitados no codigo-fonte.
• Alterne os tokens regularmente. Defina uma expiracao de 90 dias no seu Vercel Access Token e alterne-o proativamente.
• Audite as implantacoes. Verifique a aba Atividade no painel do Vercel periodicamente para revisar implantacoes feitas via CLI.
• Use escopo de equipe. Em configuracoes com multiplas equipes, defina explicitamente VERCEL_ORG_ID para evitar implantar na equipe errada.

Solucao de Erros Comuns

"Error: No Project linked"

Voce ainda nao vinculou seu diretorio local a um projeto Vercel.

# Vincular a um projeto existente
vercel link

# Ou implantar e criar um novo projeto
vercel deploy

O skill guiara voce na selecao do projeto se existirem multiplos projetos na sua conta.

"Error: Invalid token"

Seu Vercel Access Token esta ausente, expirado ou foi revogado.

1. Verifique seu token em vercel.com/account/tokens.
2. Se expirado, gere um novo token e atualize sua variavel de ambiente.
3. Alternativamente, reautentique-se com vercel login.

# Reautenticar
vercel login

# Ou atualizar seu token
export VERCEL_TOKEN=seu_novo_token_aqui

"Build Failed: Command 'npm run build' exited with 1"

O comando de build falhou durante a implantacao. Isso geralmente e um problema de codigo, nao do skill.

1. Execute o build localmente primeiro: npm run build
2. Verifique se ha variaveis de ambiente ausentes — o skill pode lista-las com vercel env ls
3. Revise o log completo do build com vercel inspect <url-da-implantacao>
4. Certifique-se de que os scripts do package.json e as configuracoes do framework correspondem a configuracao de build do Vercel