OpenClaw Manual OpenClaw
6 Passos para Implantar

OpenClaw Começando

Siga estes passos para instalar e configurar o OpenClaw do zero

Caminho Mais Rápido

Só quer experimentar? Um comando inicia o Dashboard para chat instantâneo:

$ openclaw dashboard
http://127.0.0.1:18789/

Requisitos do OpenClaw

Antes de começar, certifique-se de que seu sistema atende a estes requisitos

Node.js ≥ 22

Necessário para executar o OpenClaw

Sistema Operacional

macOS, Linux ou Windows (WSL2 recomendado)

Brave Search API (Opcional)

Habilita funcionalidade de busca na web

Windows
Usuários do Windows são fortemente recomendados a usar WSL2 para melhor compatibilidade e desempenho.
1

Instalar OpenClaw

Escolha seu método de instalação preferido. A instalação de uma linha é recomendada

$ curl -fsSL https://openclaw.ai/install.sh | bash
O comando de uma linha detecta e instala automaticamente o Node.js e todas as dependências. Nenhuma configuração manual necessária.
2

Assistente de Configuração do OpenClaw

O assistente irá guiá-lo através de toda a configuração necessária incluindo gateway, autenticação e conexões de plataformas de chat

$ openclaw onboard --install-daemon

O assistente irá configurar

  • Tipo de Gateway - Escolher gateway local ou remoto
  • Autenticação do Modelo de IA - OpenAI (OAuth/Chave API) ou Anthropic (Chave API recomendada, claude setup-token também suportado)
  • Plataformas de Chat - Código QR do WhatsApp, Token do Bot Telegram/Discord, etc.
  • Serviço Daemon - Instalação de serviço em segundo plano (macOS: launchd, Linux/WSL2: systemd)
Localizações dos Arquivos de Configuração (Importante)
  • Diretório de configuração principal ~/.openclaw/
  • Credenciais OAuth ~/.openclaw/credentials/oauth.json
  • Perfis de autenticação (OAuth + Chave API) ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Se você tem o Claude Code instalado, pode reutilizar credenciais existentes via claude setup-token sem reconfiguração.
Dica para servidor headless: Complete o OAuth em uma máquina com navegador primeiro, depois copie o arquivo oauth.json para o diretório correspondente do servidor.
3

Iniciar Gateway do OpenClaw

O gateway é o serviço central do OpenClaw que processa todas as mensagens

Verificar status do serviço

$ openclaw gateway status

Iniciar gateway manualmente (para especificar porta)

$ openclaw gateway --port 18789

Acessar Dashboard Web

http://127.0.0.1:18789/
Verificação Rápida (confirmar que o serviço está funcionando) 
$ openclaw status
$ openclaw health
$ openclaw security audit --deep
4

Conectar Plataformas de Chat

Parear e conectar sua primeira interface de chat

WhatsApp ( Login por Código QR ) 

$ openclaw channels login

Execute o comando para exibir um código QR. Abra WhatsApp → Configurações → Dispositivos Vinculados → Escaneie o código QR para conectar.

Um número de telefone dedicado é recomendado. Números VoIP não são recomendados (facilmente bloqueados). As credenciais são armazenadas no diretório ~/.openclaw/credentials/whatsapp/.

Telegram / Discord / Outros

O assistente pode ajudar a configurar tokens. Se preferir configuração manual, veja estes documentos:

Dica do Telegram: Seu primeiro DM retornará um código de pareamento. Você precisa aprová-lo (veja o próximo passo), caso contrário o bot não responderá.
5

Configuração de Segurança do OpenClaw

Garanta que apenas usuários autorizados possam usar seu assistente de IA

Comportamento padrão: DMs desconhecidos recebem um código curto, e mensagens não serão processadas até serem aprovadas. Se seu primeiro DM não obtiver resposta, aprove o pareamento:

Listar solicitações de pareamento pendentes

$ openclaw pairing list whatsapp

Aprovar pareamento (substitua [code] pelo código real)

$ openclaw pairing approve whatsapp
Esta é uma medida de segurança importante para prevenir acesso não autorizado. Você também pode configurar uma lista de permissões no arquivo de configuração para permitir automaticamente números específicos.
6

Verificar OpenClaw

Em um novo terminal, envie uma mensagem de teste

Enviar mensagem de teste (substitua pelo seu número de destino)

$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
Se openclaw health mostrar "auth not configured", volte ao assistente e configure a autenticação OAuth/chave API—sem ela, o agente não responderá.

Dicas de Debug

  • openclaw status --all Melhor relatório de debug para copiar e colar, somente leitura
  • openclaw health ou openclaw status --deep Solicita snapshot de saúde do gateway em execução

Configuração do OpenClaw Completa

Parabéns! Você instalou e configurou o OpenClaw com sucesso. Comece a conversar com seu assistente de IA agora.