Saltar para o conteúdo principal

​
Assistente de Integração Inicial (CLI)

O assistente de integração inicial é a forma recomendada de configurar o OpenClaw no macOS, Linux ou Windows (via WSL2; fortemente recomendado). Ele configura um Gateway local ou uma conexão com um Gateway remoto, além de canais, skills e padrões de workspace em um único fluxo guiado. 
openclaw onboard
Primeiro chat mais rápido: abra a UI de Controle (não é necessário configurar canais). Execute openclaw dashboard e converse no navegador. Documentação: Dashboard.
Para reconfigurar mais tarde: 
openclaw configure
openclaw agents add <name>
--json não implica modo não interativo. Para scripts, use --non-interactive.
Recomendado: configure uma chave de API do Brave Search para que o agente possa usar web_search (web_fetch funciona sem chave). Caminho mais fácil: openclaw configure --section web que armazena tools.web.search.apiKey. Documentação: Web tools.

​
Início Rápido vs Avançado

O assistente começa com Início Rápido (padrões) vs Avançado (controle total).
  • gateway local (loopback)
  • Workspace padrão (ou workspace existente)
  • Porta do Gateway 18789
  • Autenticação do Gateway Token (gerado automaticamente, mesmo em loopback)
  • Exposição via Tailscale Desligada
  • DMs do Telegram + WhatsApp com lista de permissões por padrão (você será solicitado a informar seu número de telefone)

​
O que o assistente configura

O modo local (padrão) guia você pelas seguintes etapas:
  1. Modelo/Auth — Chave de API da Anthropic (recomendado), OAuth, OpenAI ou outros provedores. Escolha um modelo padrão.
  2. Workspace — Local para arquivos do agente (padrão ~/.openclaw/workspace). Cria arquivos iniciais.
  3. Gateway — Porta, endereço de bind, modo de autenticação, exposição via Tailscale.
  4. Canais — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles ou iMessage.
  5. Daemon — Instala um LaunchAgent (macOS) ou uma unidade de usuário systemd (Linux/WSL2).
  6. Verificação de integridade — Inicia o Gateway e verifica se está em execução.
  7. Skills — Instala skills recomendadas e dependências opcionais.
Executar o assistente novamente não apaga nada, a menos que você escolha explicitamente Reset (ou passe --reset). Se a configuração for inválida ou contiver chaves legadas, o assistente solicitará que você execute openclaw doctor primeiro.
O modo remoto apenas configura o cliente local para se conectar a um Gateway em outro lugar. Ele não instala nem altera nada no host remoto.

​
Adicionar outro agente

Use openclaw agents add <name> para criar um agente separado com seu próprio workspace, sessões e perfis de autenticação. Executar sem --workspace inicia o assistente. O que ele configura:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Notas:
  • Workspaces padrão seguem ~/.openclaw/workspace-<agentId>.
  • Adicione bindings para rotear mensagens de entrada (o assistente pode fazer isso).
  • Flags não interativas: --model, --agent-dir, --bind, --non-interactive.

​
Referência completa

Para detalhamentos passo a passo, scripts não interativos, configuração do Signal, API RPC e uma lista completa dos campos de configuração que o assistente grava, consulte a Referência do Assistente.

​
Documentos relacionados