Edição de Configuração do OpenClaw: Guia Completo de Instalação (2026)

Q: Onde o arquivo de configuração do OpenClaw é armazenado?

O local padrão é ~/.openclaw/config.yaml. Em algumas instalações, pode estar em ~/.config/openclaw/config.yaml. Execute openclaw config show --path para ver o local exato.

Q: Como eu atualizo o OpenClaw?

```bash pip install --upgrade openclaw

Q: Como eu reseto minha configuração para os padrões?

```bash openclaw config reset ```

TL;DR

Referência rápida para os comandos de configuração mais comuns do OpenClaw:

bash

# Abre o editor de configuração
openclaw config edit

# Define um valor específico
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Visualiza a configuração atual
openclaw config show

# Valida e corrige problemas de configuração
openclaw doctor
openclaw doctor --fix

# Reseta para os padrões
openclaw config reset

O Que É o OpenClaw?

O OpenClaw é um framework de assistente de IA de código aberto que conecta modelos de linguagem de grande escala (LLMs) a canais de mensagens como WhatsApp, Discord, Telegram e Slack. Ele suporta múltiplos provedores de modelos — OpenAI, Anthropic, Ollama (modelos locais), Google e mais — e pode ser estendido com habilidades customizadas e plugins.

O núcleo do OpenClaw é seu sistema de configuração. Quase tudo — quais canais estão ativos, qual modelo usar, quais habilidades estão carregadas — é controlado através de arquivos de configuração. Dominar o openclaw config edit é a chave para colocar o OpenClaw funcionando do jeito que você deseja.

openclaw config edit: O Básico

Abrindo o Editor de Configuração

O comando principal para configurar o OpenClaw é:

bash

openclaw config edit

Isso abre seu arquivo de configuração no editor padrão do seu terminal (geralmente nano, vim ou o que estiver definido em $EDITOR). O arquivo de configuração geralmente está localizado em ~/.openclaw/config.yaml ou ~/.config/openclaw/config.yaml, dependendo da sua instalação.

Estrutura do Arquivo de Configuração

O arquivo de configuração do OpenClaw é formatado em YAML e organizado em seções:

yaml

# Configuração do modelo
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # string identificadora do modelo
  temperature: 0.7
  max_tokens: 4096

# Configuração 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

# Speech-to-text (Voz 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, você pode definir valores de configuração individuais via linha de comando:

bash

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

Isso é útil para automação com scripts ou mudanças rápidas sem abrir um editor.

Configurando Canais

A integração com WhatsApp requer uma conta Meta Business e acesso à API do WhatsApp Business.

bash

# Habilita o canal do 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"

Problema comum: O WhatsApp requer uma URL de webhook. Você precisa expor o OpenClaw para a internet usando um proxy reverso (nginx, Caddy) ou um serviço de túnel (ngrok, Cloudflare Tunnel).

bash

# Define a URL do webhook
openclaw config set channels.whatsapp.webhook_url "https://seu-dominio.com/webhook/whatsapp"

Discord

A configuração do Discord é mais simples — você só precisa de um token de bot do Portal do Desenvolvedor do Discord.

bash

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

Dica: Certifique-se de que seu bot do Discord tenha a intent privilegiada "Message Content" habilitada no Portal do Desenvolvedor, caso contrário, ele não conseguirá ler as mensagens.

O Telegram requer um token de bot do @BotFather:

bash

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

O Telegram suporta tanto o modo polling quanto o modo webhook. Polling é mais fácil para desenvolvimento (não requer URL pública):

bash

openclaw config set channels.telegram.mode polling

Para produção, use o modo webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://seu-dominio.com/webhook/telegram"

Slack

A integração com Slack utiliza o Modo Socket (recomendado) ou a API de Eventos:

bash

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"

O Modo Socket é recomendado porque não requer uma URL pública.

Configurando Provedores de Modelo

OpenAI

bash

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

Defina sua chave de API como uma variável de ambiente (não a coloque no arquivo de configuração):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

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

bash

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

Ollama (Modelos Locais)

É aqui que o OpenClaw se destaca para usuários preocupados com a privacidade. O Ollama permite rodar modelos localmente sem chaves de API ou dados saindo da sua máquina.

bash

# Primeiro, instale o Ollama
# https://ollama.ai

# Baixe um modelo
ollama pull llama3.3

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

Problema comum: Se o OpenClaw não conseguir conectar ao Ollama, verifique se o Ollama está rodando (ollama serve) e se a URL base está correta. A porta padrão do Ollama é 11434.

Google (Gemini)

bash

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

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

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

bash

export OPENAI_API_KEY="xai-..."   # Use a chave da xAI com o provedor openai

Erros de Configuração Comuns e Correções

Erro: "Unknown config key"

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

Isso geralmente significa um erro de digitação na chave de configuração. Verifique a ortografia. Erros comuns:

chanels → channels

providr → provider

telgram → telegram

Execute openclaw config show para ver todas as chaves válidas.

Erro: "Channel auto-enabled without credentials"

Algumas versões do OpenClaw ativam canais automaticamente quando você define credenciais, mesmo que não os tenha ativado explicitamente. Isso pode causar falhas na inicialização se as credenciais estiverem incompletas.

Correção:

bash

# Desative explicitamente os canais que você não está 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

Você precisa definir a variável de ambiente correspondente. O OpenClaw intencionalmente não armazena chaves de API no arquivo de configuração por razões de segurança.

Correção: Adicione a chave de API ao seu perfil do shell (~/.bashrc, ~/.zshrc) ou use um arquivo .env:

bash

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

Usando openclaw doctor

O comando openclaw doctor valida toda a sua configuração e relata problemas:

bash

openclaw doctor

Exemplo de saída:

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 os problemas automaticamente:

bash

openclaw doctor --fix

Isso desativará canais com credenciais ausentes, corrigirá problemas conhecidos de formatação e sugerirá correções manuais para problemas que não podem ser resolvidos automaticamente.

Configuração Avançada

Habilidades Customizadas (Skills)

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

yaml

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:

bash

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

Configuração de Speech-to-Text (STT)

Para suporte a mensagens de voz no WhatsApp e Telegram:

yaml

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

bash

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

Integração com Casa Inteligente Tuya

O OpenClaw pode controlar dispositivos de casa inteligente compatíveis com Tuya:

yaml

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

Isso permite que você controle luzes, interruptores, termostatos e outros dispositivos Tuya através de comandos em linguagem natural em qualquer canal conectado.

Múltiplas Configurações de Modelo

Você pode definir predefinições (presets) de modelos e alternar entre eles:

yaml

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

bash

openclaw config set model.active default
# ou alterne em tempo de execução
openclaw --model fast

Perguntas Frequentes

Onde o arquivo de configuração do OpenClaw é armazenado?

O local padrão é ~/.openclaw/config.yaml. Em algumas instalações, pode estar em ~/.config/openclaw/config.yaml. Execute openclaw config show --path para ver o local exato.

Posso usar o OpenClaw sem nenhuma API na nuvem?

Sim. Configure o Ollama como seu provedor de modelo e use o Telegram no modo polling. Isso lhe dá um assistente de IA totalmente local e privado, sem dados saindo da sua máquina.

Como eu atualizo o OpenClaw?

bash

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

Após atualizar, execute openclaw doctor para verificar se houve mudanças no formato da configuração.

Posso rodar múltiplos canais simultaneamente?

Sim. Ative quantos canais desejar — o OpenClaw os gerencia de forma concorrente. Cada canal compartilha a mesma configuração de modelo e habilidades.

Como eu reseto minha configuração para os padrões?

bash

openclaw config reset

Isso sobrescreve seu arquivo de configuração com o modelo padrão. Faça um backup da sua configuração existente primeiro, se necessário.

Quer Algo Mais Simples?

O OpenClaw é poderoso, mas exige conforto com o terminal e configuração manual. Se você quer construir e lançar produtos baseados em IA sem gerenciar arquivos de configuração, provedores de modelos e integrações de canais sozinho:

Y Build gerencia todo o stack — implantação, vídeos de produto, SEO com IA e analytics. Sem arquivos de configuração. Sem terminal. Apenas construa e lance. Comece grátis →

Fontes:

TL;DR

Referência rápida para os comandos de configuração mais comuns do OpenClaw:

bash

# Abre o editor de configuração
openclaw config edit

# Define um valor específico
openclaw config set channels.whatsapp.enabled true
openclaw config set model.provider openai
openclaw config set model.name gpt-4o

# Visualiza a configuração atual
openclaw config show

# Valida e corrige problemas de configuração
openclaw doctor
openclaw doctor --fix

# Reseta para os padrões
openclaw config reset

O Que É o OpenClaw?

openclaw config edit: O Básico

Abrindo o Editor de Configuração

O comando principal para configurar o OpenClaw é:

bash

openclaw config edit

Estrutura do Arquivo de Configuração

O arquivo de configuração do OpenClaw é formatado em YAML e organizado em seções:

yaml

# Configuração do modelo
model:
  provider: openai        # openai, anthropic, ollama, google
  name: gpt-4o            # string identificadora do modelo
  temperature: 0.7
  max_tokens: 4096

# Configuração 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

# Speech-to-text (Voz 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, você pode definir valores de configuração individuais via linha de comando:

bash

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

Isso é útil para automação com scripts ou mudanças rápidas sem abrir um editor.

Configurando Canais

A integração com WhatsApp requer uma conta Meta Business e acesso à API do WhatsApp Business.

bash

# Habilita o canal do 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"

Problema comum: O WhatsApp requer uma URL de webhook. Você precisa expor o OpenClaw para a internet usando um proxy reverso (nginx, Caddy) ou um serviço de túnel (ngrok, Cloudflare Tunnel).

bash

# Define a URL do webhook
openclaw config set channels.whatsapp.webhook_url "https://seu-dominio.com/webhook/whatsapp"

Discord

A configuração do Discord é mais simples — você só precisa de um token de bot do Portal do Desenvolvedor do Discord.

bash

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

Dica: Certifique-se de que seu bot do Discord tenha a intent privilegiada "Message Content" habilitada no Portal do Desenvolvedor, caso contrário, ele não conseguirá ler as mensagens.

O Telegram requer um token de bot do @BotFather:

bash

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

O Telegram suporta tanto o modo polling quanto o modo webhook. Polling é mais fácil para desenvolvimento (não requer URL pública):

bash

openclaw config set channels.telegram.mode polling

Para produção, use o modo webhook:

bash

openclaw config set channels.telegram.mode webhook
openclaw config set channels.telegram.webhook_url "https://seu-dominio.com/webhook/telegram"

Slack

A integração com Slack utiliza o Modo Socket (recomendado) ou a API de Eventos:

bash

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"

O Modo Socket é recomendado porque não requer uma URL pública.

Configurando Provedores de Modelo

OpenAI

bash

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

Defina sua chave de API como uma variável de ambiente (não a coloque no arquivo de configuração):

bash

export OPENAI_API_KEY="sk-..."

Anthropic (Claude)

bash

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

bash

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

Ollama (Modelos Locais)

É aqui que o OpenClaw se destaca para usuários preocupados com a privacidade. O Ollama permite rodar modelos localmente sem chaves de API ou dados saindo da sua máquina.

bash

# Primeiro, instale o Ollama
# https://ollama.ai

# Baixe um modelo
ollama pull llama3.3

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

Problema comum: Se o OpenClaw não conseguir conectar ao Ollama, verifique se o Ollama está rodando (ollama serve) e se a URL base está correta. A porta padrão do Ollama é 11434.

Google (Gemini)

bash

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

bash

export GOOGLE_API_KEY="..."

xAI (Grok)

bash

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

bash

export OPENAI_API_KEY="xai-..."   # Use a chave da xAI com o provedor openai

Erros de Configuração Comuns e Correções

Erro: "Unknown config key"

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

Isso geralmente significa um erro de digitação na chave de configuração. Verifique a ortografia. Erros comuns:

chanels → channels

providr → provider

telgram → telegram

Execute openclaw config show para ver todas as chaves válidas.

Erro: "Channel auto-enabled without credentials"

Correção:

bash

# Desative explicitamente os canais que você não está 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

Você precisa definir a variável de ambiente correspondente. O OpenClaw intencionalmente não armazena chaves de API no arquivo de configuração por razões de segurança.

Correção: Adicione a chave de API ao seu perfil do shell (~/.bashrc, ~/.zshrc) ou use um arquivo .env:

bash

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

Usando openclaw doctor

O comando openclaw doctor valida toda a sua configuração e relata problemas:

bash

openclaw doctor

Exemplo de saída:

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 os problemas automaticamente:

bash

openclaw doctor --fix

Isso desativará canais com credenciais ausentes, corrigirá problemas conhecidos de formatação e sugerirá correções manuais para problemas que não podem ser resolvidos automaticamente.

Configuração Avançada

Habilidades Customizadas (Skills)

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

yaml

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:

bash

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

Configuração de Speech-to-Text (STT)

Para suporte a mensagens de voz no WhatsApp e Telegram:

yaml

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

bash

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

Integração com Casa Inteligente Tuya

O OpenClaw pode controlar dispositivos de casa inteligente compatíveis com Tuya:

yaml

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

Isso permite que você controle luzes, interruptores, termostatos e outros dispositivos Tuya através de comandos em linguagem natural em qualquer canal conectado.

Múltiplas Configurações de Modelo

Você pode definir predefinições (presets) de modelos e alternar entre eles:

yaml

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

bash

openclaw config set model.active default
# ou alterne em tempo de execução
openclaw --model fast

Perguntas Frequentes

Onde o arquivo de configuração do OpenClaw é armazenado?

O local padrão é ~/.openclaw/config.yaml. Em algumas instalações, pode estar em ~/.config/openclaw/config.yaml. Execute openclaw config show --path para ver o local exato.

Posso usar o OpenClaw sem nenhuma API na nuvem?

Sim. Configure o Ollama como seu provedor de modelo e use o Telegram no modo polling. Isso lhe dá um assistente de IA totalmente local e privado, sem dados saindo da sua máquina.

Como eu atualizo o OpenClaw?

bash

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

Após atualizar, execute openclaw doctor para verificar se houve mudanças no formato da configuração.

Posso rodar múltiplos canais simultaneamente?

Sim. Ative quantos canais desejar — o OpenClaw os gerencia de forma concorrente. Cada canal compartilha a mesma configuração de modelo e habilidades.

Como eu reseto minha configuração para os padrões?

bash

openclaw config reset

Isso sobrescreve seu arquivo de configuração com o modelo padrão. Faça um backup da sua configuração existente primeiro, se necessário.

Quer Algo Mais Simples?

Y Build gerencia todo o stack — implantação, vídeos de produto, SEO com IA e analytics. Sem arquivos de configuração. Sem terminal. Apenas construa e lance. Comece grátis →

Fontes: