Guia de Configuracao

Todas as configuracoes do OpenClaw ficam centralizadas em um unico arquivo. Vamos aprender a personaliza-lo.

📄 Localizacao do arquivo de configuracao

O arquivo principal de configuracao do OpenClaw fica em:

~/.openclaw/openclaw.json

O ~ representa seu diretorio home. No macOS, por exemplo, o caminho completo geralmente e /Users/seu-usuario/.openclaw/openclaw.json.

💡 Dica: .openclaw e uma pasta oculta (pastas que comecam com ponto sao invisiveis por padrao). No macOS Finder, pressione Command + Shift + . pra ver arquivos ocultos. No Linux, use o comando ls -a.

⚙️ Configuracoes principais

Veja as opcoes de configuracao mais usadas:

Selecao do modelo de IA

Defina o modelo de IA padrao:

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  }
}

Voce pode trocar o provider pra "openai", "deepseek" ou "google", e colocar o nome do modelo e a chave de API correspondentes.

Gerenciamento de sessao

Controle o comportamento das conversas com a IA:

{
  "session": {
    "max_history": 50,
    "timeout_minutes": 30,
    "system_prompt": "Voce e um assistente de IA util..."
  }
}

max_history — Numero maximo de mensagens mantidas no historico de cada conversa
timeout_minutes — Depois de quantos minutos sem interacao uma nova conversa e iniciada automaticamente
system_prompt — A "definicao de personagem" da IA, voce pode personalizar a personalidade da IA

Configuracao de canais

Defina as informacoes de conexao de cada plataforma de chat:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF..."
    },
    "discord": {
      "enabled": true,
      "bot_token": "MTIz..."
    }
  }
}

🔄 Hot Reload (Recarga automatica)

O OpenClaw suporta hot reload, ou seja, depois de editar o arquivo de configuracao, nao precisa reiniciar o OpenClaw - ele detecta automaticamente as mudancas e aplica as novas configuracoes.

Resumindo: basta editar e salvar o arquivo de configuracao e o OpenClaw ja usa as novas configuracoes. Super pratico!

ℹ️ Atencao: Algumas configuracoes essenciais (como numero da porta) ainda podem exigir reinicio manual. Mas a maioria das configuracoes (como troca de modelo, configuracao de canais) funciona com hot reload.