OpenClaw Manual OpenClaw
Configuração Avançada

Guia de Configuração OpenClaw - Modelos de IA e Canais de Chat

Já instalou o OpenClaw? Aprenda a configurar modelos de IA, configurações de gateway, canais de chat e mais

O que você quer configurar?

Selecione o que deseja configurar e vá para a seção correspondente

OpenClaw Visão Geral da Configuração

O OpenClaw armazena toda a configuração no diretório ~/.openclaw. Entender esta estrutura ajuda você a gerenciar e fazer backup de suas configurações.

Estrutura de Arquivos

~/.openclaw/openclaw.json Arquivo de configuração principal
~/.openclaw/workspace/ Habilidades, prompts, memórias
~/.openclaw/credentials/ Credenciais OAuth e API
~/.openclaw/agents/ Configurações multi-agente
~/.openclaw/credentials/oauth.json Tokens OAuth (Claude, etc.)

OpenClaw Configuração de Modelos de IA

Obrigatório

O OpenClaw suporta múltiplos provedores de IA. Escolha seu provedor preferido e siga os passos de configuração.

Configuração atual : Anthropic - API Key

Ideal para: Acesso API padrão com faturamento baseado em uso. Crie sua chave API no Console da Anthropic.

1

Obter Chave API

Crie uma chave API no Console da Anthropic

Abrir Console da Anthropic
2

Configuração CLI

Execute o assistente de configuração ou use o modo não interativo

Interativo (Recomendado)

$ openclaw onboard
# choose: Anthropic API key

Não interativo

$ openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Estrutura do Arquivo de Configuração

Após a configuração, as configurações relevantes em openclaw.json:

~/.openclaw/openclaw.json 
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}

Cache de Prompts (Apenas API)

O OpenClaw não substitui o TTL de cache padrão da Anthropic a menos que você o defina. A autenticação por assinatura não respeita as configurações de TTL.

~/.openclaw/openclaw.json 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" }, // or "1h"
        },
      },
    },
  },
}

Verificar Configuração

$ openclaw models status

Execute este comando para confirmar que a autenticação está funcionando

Anthropic Claude é recomendado para a melhor experiência. Modelos suportados: anthropic/claude-opus-4-5, anthropic/claude-sonnet-4-20250514, anthropic/claude-haiku, etc.
Nota: A autenticação é independente por agente. Novos agentes requerem configuração de credenciais separada.

OpenClaw Configuração do Gateway

Obrigatório

O gateway é o serviço central do OpenClaw que gerencia todo o roteamento de mensagens entre IA e plataformas de chat.

Configurações Padrão

Porta
18789
Endereço de Binding
127.0.0.1
Autenticação
token / password

Comandos Comuns

Instalar serviço daemon (detecta auto macOS/Linux)

$ openclaw gateway install

Verificar status do gateway

$ openclaw gateway status

Ver logs em tempo real

$ openclaw logs --follow

Acesso Remoto

Acesso seguro ao gateway no servidor remoto via túnel SSH:

$ ssh -N -L 18789:127.0.0.1:18789 user@host
Ver documentação completa do gateway

OpenClaw Configuração de Canais de Chat

Pelo menos um

Conecte o OpenClaw às suas plataformas de chat preferidas. Cada canal tem seu próprio processo de configuração.

Configuração atual : WhatsApp
1

Gerenciamento de Conta WhatsApp

Fazer login ou logout da conta WhatsApp

Login (gerar código QR)

$ openclaw channels login whatsapp

Logout (usar para reconectar)

$ openclaw channels logout whatsapp
2

Escanear Código QR

Abra o WhatsApp no seu telefone, vá em Configurações → Dispositivos Vinculados → Escaneie o código QR

Código QR

Escaneie com o app WhatsApp no celular

3

Aprovar Pareamento

Sua primeira mensagem receberá um código de pareamento. Aprove-o para começar a conversar.

$ openclaw pairing list whatsapp
$ openclaw pairing approve whatsapp [CODE]
Use um número de telefone dedicado. Números VoIP não são recomendados pois podem ser bloqueados facilmente.
As credenciais são armazenadas no diretório ~/.openclaw/credentials/whatsapp/.
Ver documentação completa do WhatsApp

OpenClaw Gerenciamento de Habilidades

Opcional

Habilidades estendem as capacidades do OpenClaw. Instale e gerencie habilidades para aprimorar seu assistente de IA.

Listar habilidades disponíveis

$ openclaw skills list

Instalar uma habilidade

$ openclaw skills install

Habilitar uma habilidade

$ openclaw skills enable

Habilidades Populares

Busca na Web

Pesquisar na web e resumir resultados

web-search
Interpretador de Código

Executar código em um ambiente isolado

code-interpreter
Gerenciador de Arquivos

Ler, escrever e gerenciar arquivos

file-manager
Calendário

Gerenciar eventos de calendário e lembretes

calendar
Ver documentação completa de habilidades

OpenClaw Configuração Avançada

Opcional

Recursos para usuários avançados para configurações complexas e automação.

Configuração Multi-Agente

Crie agentes separados para diferentes contextos (trabalho, pessoal, etc.). Cada agente tem seu próprio workspace, sessões e credenciais.

$ openclaw agents add work
$ openclaw agents list
$ openclaw agents switch work

Modo Não Interativo

Automatize a configuração do OpenClaw em scripts ou pipelines CI/CD.

$ openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Tarefas Agendadas

Configure mensagens e tarefas automatizadas usando agendamento estilo cron.

cron.json 
# ~/.openclaw/cron.json
{
  "jobs": [
    {
      "schedule": "0 9 * * *",
      "action": "send",
      "channel": "telegram",
      "message": "Good morning! Here's your daily briefing..."
    }
  ]
}
Ver documentação completa de configuração avançada

Configuração Completa!

Seu OpenClaw está totalmente configurado. Comece a conversar com seu assistente de IA.

Próximos Passos