OpenClaw
Primeiros passos8 min de leitura

Início Rápido OpenClaw: Do Zero ao Funcionamento em 30 Minutos

Da preparação da sua chave de modelo até receber sua primeira resposta, cobrindo instalação, configuração, verificações de saúde e falhas de inicialização comuns.

O

OpenClaw Guides

Tutorial Authors

1. Pré-requisitos

Antes de instalar o OpenClaw, certifique-se de que seu sistema atende aos seguintes requisitos:

  • Node.js 22 ou superior (LTS recomendado)
  • Gerenciador de pacotes npm ou pnpm
  • Uma conexão de Internet estável

Para verificar sua versão do Node.js:

bash
node --version
# Deve exibir v22.x.x ou superior

2. Instalação em Uma Linha

Abra seu terminal e execute:

bash
curl -fsSL https://openclaw.ai/install.sh | bash

O script de instalação detectará automaticamente seu ambiente de sistema e completará todas as configurações.

Alternativa: Usando npm

Se você preferir usar npm diretamente:

bash
# Instalar OpenClaw globalmente
npm install -g openclaw@latest

# Iniciar o assistente de integração
openclaw onboard

3. Configuração Inicial

Após a instalação, execute o assistente de configuração:

bash
openclaw onboard

O assistente irá guiá-lo através de:

  1. Configuração da Chave API - Digite sua chave API da Anthropic
  2. Seleção do Modelo Padrão - Escolha entre Claude 3.5 Haiku, Claude 3.5 Sonnet ou Claude Sonnet 4
  3. Conexão da Plataforma de Chat - Conecte WhatsApp, Telegram ou Discord

4. Iniciar o Serviço Gateway

Inicie o gateway do OpenClaw:

bash
openclaw gateway start

Você deve ver uma saída como:

🦞 OpenClaw Gateway v1.0.0
✓ Model provider connected
✓ Gateway listening on http://127.0.0.1:18789
✓ Ready to receive messages

5. Verificar Sua Instalação

Verifique o status do serviço:

bash
openclaw status

Se tudo estiver funcionando corretamente, você deve ver:

Gateway: Running ✓
Model: Connected ✓
Channels: 0 active

Solução de Problemas

Porta Já em Uso

Se você vir o erro EADDRINUSE:

bash
# Encontrar o que está usando a porta 3000
lsof -i :18789

# Encerrar o processo ou usar uma porta diferente
openclaw gateway start --port 18790

Problemas com Chave API

Se você receber 401 Unauthorized:

bash
# Reconfigurar sua chave API
openclaw config set api-key

Próximos Passos