OpenClaw Config Edit: Guia Completo de Configuracao (2026)

Resumo

Referencia rapida para os comandos de configuracao OpenClaw mais comuns:

# Abrir o editor de configuracao
openclaw config edit

# Definir um valor especifico
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Ver configuracao atual
openclaw config show

# Validar e corrigir problemas de configuracao
openclaw doctor
openclaw doctor --fix

# Redefinir para padroes
openclaw config reset

O Que E o OpenClaw?

OpenClaw e um framework de assistente AI de codigo aberto que conecta grandes modelos de linguagem a canais de mensagens como WhatsApp, Discord, Telegram e Slack. Suporta multiplos provedores de modelo — OpenAI, Anthropic, Ollama (modelos locais), Google e mais — e pode ser estendido com habilidades e plugins personalizados.

O nucleo do OpenClaw e seu sistema de configuracao. Quase tudo — quais canais estao ativos, qual modelo usar, quais habilidades estao carregadas — e controlado atraves de arquivos de configuracao. Dominar openclaw config edit e a chave para fazer o OpenClaw funcionar do jeito que voce quer.

openclaw config edit: O Basico

Abrindo o Editor de Configuracao

O comando principal para configurar o OpenClaw e:

openclaw config edit

Isso abre seu arquivo de configuracao no editor de terminal padrao (geralmente nano, vim, ou o que $EDITOR estiver definido). O arquivo de configuracao normalmente esta em ~/.openclaw/config.yaml ou ~/.config/openclaw/config.yaml dependendo da instalacao.

Estrutura do Arquivo de Configuracao

O arquivo de configuracao do OpenClaw e formatado em YAML e organizado em secoes:

# Configuracao do modelo
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # string do identificador do modelo
  temperature: 0.7
  max_tokens: 4096

# Configuracao de canais
channels:
  whatsapp:
    enabled: false
    phone_number_id: ""
    access_token: ""
  discord:
    enabled: false
    bot_token: ""
  telegram:
    enabled: false
    bot_token: ""
  slack:
    enabled: false
    bot_token: ""
    app_token: ""

# Habilidades e plugins
skills:
  - web_search
  - calculator
  - weather

# Fala para texto
stt:
  provider: whisper
  model: whisper-1

# Prompt do sistema
system_prompt: "You are a helpful assistant."

Definindo Valores Individuais

Em vez de editar o arquivo completo, voce pode definir valores de configuracao individuais pela linha de comando:

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6
openclaw config set model.temperature 0.5

Isso e util para scripts ou mudancas rapidas sem abrir um editor.

Configurando Canais

WhatsApp

A integracao com WhatsApp requer uma conta Meta Business e acesso a API WhatsApp Business.

# Ativar canal WhatsApp
openclaw config set channels.whatsapp.enabled true
openclaw config set channels.whatsapp.phone_number_id "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.access_token "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verify_token "YOUR_VERIFY_TOKEN"

# Definir a URL do webhook
openclaw config set channels.whatsapp.webhook_url "https://your-domain.com/webhook/whatsapp"

Discord

A configuracao do Discord e mais simples — voce so precisa de um token de bot do Discord Developer Portal.

openclaw config set channels.discord.enabled true
openclaw config set channels.discord.bot_token "YOUR_DISCORD_BOT_TOKEN"

Telegram

Telegram requer um token de bot do @BotFather:

openclaw config set channels.telegram.enabled true
openclaw config set channels.telegram.bot_token "YOUR_TELEGRAM_BOT_TOKEN"

Telegram suporta modos polling e webhook. Polling e mais facil para desenvolvimento (nao precisa de URL publica):

openclaw config set channels.telegram.mode polling

Para producao, use modo webhook:

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://your-domain.com/webhook/telegram"

Slack

Integracao Slack usa Socket Mode (recomendado) ou Events API:

openclaw config set channels.slack.enabled true
openclaw config set channels.slack.bot_token "xoxb-YOUR-BOT-TOKEN"
openclaw config set channels.slack.app_token "xapp-YOUR-APP-TOKEN"

Socket Mode e recomendado porque nao requer uma URL publica.

Configurando Provedores de Modelo

OpenAI

openclaw config set model.provider openai
openclaw config set model.name gpt-4o

Defina sua chave de API como variavel de ambiente (nao coloque no arquivo de configuracao):

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

openclaw config set model.provider anthropic
openclaw config set model.name claude-sonnet-4-6

export ANTHROPIC_API_KEY="sk-ant-..."

Ollama (Modelos Locais)

E aqui que o OpenClaw brilha para usuarios preocupados com privacidade. Ollama permite executar modelos localmente sem chaves de API ou dados saindo da sua maquina.

# Instale o Ollama primeiro
# https://ollama.ai

# Baixe um modelo
ollama pull llama3.3

# Configure o OpenClaw para usar Ollama
openclaw config set model.provider ollama
openclaw config set model.name llama3.3
openclaw config set model.base_url "http://localhost:11434"

Google (Gemini)

openclaw config set model.provider google
openclaw config set model.name gemini-2.5-pro

export GOOGLE_API_KEY="..."

xAI (Grok)

openclaw config set model.provider openai   # xAI usa API compativel com OpenAI
openclaw config set model.name grok-4.1
openclaw config set model.base_url "https://api.x.ai/v1"

export OPENAI_API_KEY="xai-..."   # Use chave xAI com provedor OpenAI

Erros Comuns de Configuracao e Solucoes

Erro: "Unknown config key"

Error: Unknown config key 'chanels.whatsapp.enabled'

Isso geralmente significa um erro de digitacao na chave de configuracao. Verifique a ortografia. Erros comuns:

• chanels → channels


• providr → provider


• telgram → telegram

Erro: "Channel auto-enabled without credentials"

Algumas versoes do OpenClaw ativam canais automaticamente quando voce define credenciais, mesmo que nao os tenha ativado explicitamente. Isso pode causar falhas na inicializacao se as credenciais estiverem incompletas.

# Desative explicitamente canais que nao esta usando
openclaw config set channels.whatsapp.enabled false
openclaw config set channels.discord.enabled false
openclaw config set channels.slack.enabled false

Erro: "Model provider not configured"

Error: Model provider 'anthropic' requires ANTHROPIC_API_KEY

Voce precisa definir a variavel de ambiente correspondente. O OpenClaw intencionalmente nao armazena chaves de API no arquivo de configuracao por razoes de seguranca.

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Usando openclaw doctor

O comando openclaw doctor valida toda sua configuracao e relata problemas:

openclaw doctor

Exemplo de saida:

Checking configuration...
  ✓ Config file found
  ✓ Model provider configured
  ✗ WhatsApp: enabled but missing access_token
  ✗ Discord: bot token invalid format
  ✓ Telegram: configured correctly
  ✓ Ollama: connection successful

2 issues found. Run 'openclaw doctor --fix' to attempt auto-fix.

A flag --fix tenta resolver problemas automaticamente:

openclaw doctor --fix

Isso desativara canais com credenciais faltando, corrigira problemas de formatacao conhecidos e sugerira correcoes manuais para problemas que nao pode resolver automaticamente.

Configuracao Avancada

Habilidades Personalizadas

OpenClaw suporta habilidades personalizadas (plugins) que estendem as capacidades do assistente:

skills:
  - web_search
  - calculator
  - weather
  - custom_skill:
      path: ./my-skills/custom_tool.py
      config:
        api_key_env: CUSTOM_API_KEY

Ou via linha de comando:

openclaw skills add web_search
openclaw skills add ./my-skills/custom_tool.py
openclaw skills list
openclaw skills remove calculator

Configuracao de Fala para Texto (STT)

Para suporte a mensagens de voz no WhatsApp e Telegram:

stt:
  provider: whisper          # whisper, deepgram, google
  model: whisper-1
  language: auto             # deteccao automatica ou especifique "en", "pt", etc.

openclaw config set stt.provider whisper
openclaw config set stt.model whisper-1

Integracao Smart Home Tuya

OpenClaw pode controlar dispositivos smart home compativeis com Tuya:

tuya:
  enabled: true
  access_id: "YOUR_TUYA_ACCESS_ID"
  access_key: "YOUR_TUYA_ACCESS_KEY"
  endpoint: "https://openapi.tuyaus.com"

Isso permite controlar luzes, interruptores, termostatos e outros dispositivos Tuya atraves de comandos em linguagem natural em qualquer canal conectado.

Multiplas Configuracoes de Modelo

Voce pode definir presets de modelo e alternar entre eles:

models:
  default:
    provider: openai
    name: gpt-4o
  fast:
    provider: ollama
    name: llama3.3
  reasoning:
    provider: anthropic
    name: claude-opus-4-6

openclaw config set model.active default
# ou alterne em tempo de execucao
openclaw --model fast

Perguntas Frequentes

Onde o arquivo de configuracao do OpenClaw e armazenado?

A localizacao padrao e ~/.openclaw/config.yaml. Em algumas instalacoes pode estar em ~/.config/openclaw/config.yaml. Execute openclaw config show --path para ver a localizacao exata.

Posso usar o OpenClaw sem nenhuma API de nuvem?

Sim. Configure o Ollama como seu provedor de modelo e use o Telegram em modo polling. Isso oferece um assistente AI totalmente local e privado sem dados saindo da sua maquina.

Como atualizo o OpenClaw?

pip install --upgrade openclaw
# ou
npm update -g openclaw

Apos atualizar, execute openclaw doctor para verificar mudancas no formato de configuracao.

Posso executar multiplos canais simultaneamente?

Sim. Ative quantos canais quiser — o OpenClaw os gerencia simultaneamente. Cada canal compartilha a mesma configuracao de modelo e habilidades.

Como redefinir minha configuracao para padroes?

openclaw config reset

Isso sobrescreve seu arquivo de configuracao com o modelo padrao. Faca backup da configuracao existente primeiro, se necessario.

Quer Algo Mais Simples?

OpenClaw e poderoso, mas requer conforto com terminal e configuracao manual. Se voce quer construir e enviar produtos alimentados por AI sem gerenciar arquivos de configuracao, provedores de modelo e integracoes de canais:

• OpenClaw GitHub Repository
• OpenClaw Documentation
• Ollama Installation Guide
• WhatsApp Business API Docs