Guia de Configuração do OpenClaw
Guia de Configuração do OpenClaw
Toda a configuração do OpenClaw fica em um único arquivo JSON. Este guia explica cada opção disponível.
📁 Localização do Arquivo
~/.clawdbot/clawdbot.json
Dica: Após editar, reinicie o gateway para aplicar as mudanças:
openclaw gateway restart
🏗️ Estrutura Completa
{
"gateway": {
"port": 18789,
"bind": "localhost"
},
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-sonnet-4"
},
"contextTokens": 100000,
"timeout": 120000
}
},
"channels": {
"telegram": {
"token": "BOT_TOKEN",
"allowFrom": ["user_id"]
},
"whatsapp": {
"allowFrom": ["+5511999999999"]
}
},
"heartbeat": {
"enabled": true,
"intervalMs": 1800000
}
}
⚙️ Seção: Gateway
Controla o servidor HTTP/WebSocket local.
| Opção | Tipo | Padrão | Descrição |
|---|---|---|---|
port | number | 18789 | Porta do servidor |
bind | string | “localhost” | Interface de rede |
{
"gateway": {
"port": 18789,
"bind": "localhost"
}
}
⚠️ Segurança: Mantenha bind como localhost a menos que precise expor externamente.
🤖 Seção: Agents
Configura o comportamento dos agentes de IA.
Model
{
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-sonnet-4",
"thinking": "anthropic/claude-opus-4"
}
}
}
}
| Opção | Descrição |
|---|---|
primary | Modelo principal para respostas |
thinking | Modelo para raciocínio complexo (opcional) |
Veja também: Comparativo de Modelos
Outras Opções do Agent
| Opção | Tipo | Padrão | Descrição |
|---|---|---|---|
contextTokens | number | 100000 | Limite de tokens no contexto |
timeout | number | 120000 | Timeout em ms para respostas |
📡 Seção: Channels
Configure canais de comunicação. Cada canal tem opções específicas.
Telegram
{
"channels": {
"telegram": {
"token": "123456:ABC-DEF...",
"allowFrom": ["123456789", "987654321"]
}
}
}
| Opção | Descrição |
|---|---|
token | Token do bot (obtido via @BotFather) |
allowFrom | Lista de IDs permitidos |
Veja: Configurar Telegram
{
"channels": {
"whatsapp": {
"allowFrom": ["+5511999999999"]
}
}
}
| Opção | Descrição |
|---|---|
allowFrom | Números permitidos (formato E.164) |
Veja: Configurar WhatsApp
Discord
{
"channels": {
"discord": {
"token": "TOKEN_DO_BOT",
"guildIds": ["123456789"]
}
}
}
| Opção | Descrição |
|---|---|
token | Token do bot Discord |
guildIds | IDs dos servidores permitidos |
Veja: Configurar Discord
💓 Seção: Heartbeat
Sistema de verificações periódicas automáticas.
{
"heartbeat": {
"enabled": true,
"intervalMs": 1800000
}
}
| Opção | Tipo | Padrão | Descrição |
|---|---|---|---|
enabled | boolean | false | Ativa o heartbeat |
intervalMs | number | 1800000 | Intervalo (30 min padrão) |
Veja também: Template de Heartbeat
🔐 Variáveis de Ambiente
Chaves de API e configs sensíveis ficam em variáveis de ambiente:
# Anthropic (Claude)
export ANTHROPIC_API_KEY="sk-ant-..."
# OpenAI (GPT)
export OPENAI_API_KEY="sk-..."
# Google (Gemini)
export GOOGLE_API_KEY="..."
# Porta personalizada
export CLAWDBOT_PORT=18789
Dica: Adicione ao seu ~/.bashrc ou ~/.zshrc para persistir.
📝 Templates Prontos
Não quer configurar do zero? Use nossos templates:
- Configuração Mínima — Para começar rápido
- Configuração Completa — Todas as opções
🔗 Próximos Passos
- CLI Reference — Comandos para gerenciar config
- REST API — Use a API programaticamente
- Modelos de IA — Escolha o modelo certo