---
title: "Guia de Configuração do OpenClaw — Config Reference"
url: "https://openclaw.ia.br/api/config/"
markdown_url: "https://openclaw.ia.br/api/config.MD"
description: "Referência completa do arquivo config.yaml. Configure modelos, canais, heartbeat e todas as opções do seu assistente IA."
date: ""
author: ""
---

# Guia de Configuração do OpenClaw — Config Reference

Referência completa do arquivo config.yaml. Configure modelos, canais, heartbeat e todas as opções do seu assistente IA.


# Guia de Configuração do OpenClaw

Toda a configuração do OpenClaw fica em um único arquivo YAML. Este guia explica cada opção disponível.

##  Localização do Arquivo

```
~/.openclaw/config.yaml
```

**Dica:** Após editar, reinicie o gateway para aplicar as mudanças:

```bash
openclaw gateway restart
```

##  Estrutura Completa

```json
{
  "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 |

```json
{
  "gateway": {
    "port": 18789,
    "bind": "localhost"
  }
}
```

**Atenção: Segurança:** Mantenha `bind` como `localhost` a menos que precise expor externamente.

##  Seção: Agents

Configura o comportamento dos agentes de IA.

### Model

```json
{
  "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](/modelos/comparativo/)

### 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

```json
{
  "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](/canais/telegram/)

### WhatsApp

```json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+5511999999999"]
    }
  }
}
```

| Opção | Descrição |
|-------|-----------|
| `allowFrom` | Números permitidos (formato E.164) |

**Veja:** [Configurar WhatsApp](/canais/whatsapp/)

### Discord

```json
{
  "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](/canais/discord/)

##  Seção: Heartbeat

Sistema de verificações periódicas automáticas.

```json
{
  "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](/templates/heartbeat-simples/)

##  Variáveis de Ambiente

Chaves de API e configs sensíveis ficam em variáveis de ambiente:

```bash
# 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](/templates/config-minimo/) — Para começar rápido
- [Configuração Completa](/templates/config-completa/) — Todas as opções

##  Próximos Passos

- [CLI Reference](/api/cli/) — Comandos para gerenciar config
- [REST API](/api/rest/) — Use a API programaticamente
- [Modelos de IA](/modelos/) — Escolha o modelo certo