Guia completo para configurar o gateway do assistente de IA Clawdbot. Aprenda sobre opções de configuração, variáveis de ambiente e configurações avançadas.

Visão Geral da Configuração do Clawdbot Gateway

O gateway do Clawdbot é configurado através de ~/.clawdbot/clawdbot.json. Este guia cobre todas as opções de configuração para personalizar seu gateway.

Arquivo de Configuração

Localização

~/.clawdbot/clawdbot.json

Estrutura Básica

{
  "gateway": {
    "port": 3010,
    "host": "localhost"
  },
  "providers": {},
  "agents": {},
  "tools": {},
  "sessions": {}
}

Configurações do Gateway

Configurações Principais

{
  "gateway": {
    "port": 3010,
    "host": "localhost",
    "logLevel": "info",
    "maxConnections": 100
  }
}

Opções

Opção	Padrão	Descrição
`port`	3010	Porta do servidor WebSocket
`host`	localhost	Endereço de ligação
`logLevel`	info	Nível de detalhamento do log
`maxConnections`	100	Máximo de conexões simultâneas

Configuração de Provedores

{
  "providers": {
    "whatsapp": {
      "enabled": true,
      "authStrategy": "qr",
      "dmPolicy": "main"
    }
  }
}

{
  "providers": {
    "telegram": {
      "enabled": true,
      "token": "${TELEGRAM_BOT_TOKEN}"
    }
  }
}

Discord

{
  "providers": {
    "discord": {
      "enabled": true,
      "token": "${DISCORD_BOT_TOKEN}",
      "intents": ["GUILDS", "GUILD_MESSAGES", "DIRECT_MESSAGES"]
    }
  }
}

Configuração de Agentes

Agente Único

{
  "agents": {
    "main": {
      "workspace": "~/.clawdbot/workspace",
      "model": "claude-3-sonnet"
    }
  }
}

Multi-Agente

{
  "agents": {
    "main": {
      "workspace": "~/.clawdbot/agents/main/workspace"
    },
    "work": {
      "workspace": "~/.clawdbot/agents/work/workspace"
    }
  }
}

Configuração de Sessões

Política de Sessões

{
  "sessions": {
    "dmScope": "main",
    "resetTime": "04:00",
    "idleMinutes": 60,
    "maxHistory": 100
  }
}

Opções de Sessão

Opção	Padrão	Descrição
`dmScope`	main	Escopo de sessão de mensagens diretas
`resetTime`	04:00	Horário de redefinição diária
`idleMinutes`	null	Tempo limite de inatividade
`maxHistory`	100	Máximo de mensagens no histórico

Configuração de Ferramentas

Política de Ferramentas

{
  "tools": {
    "profile": "full",
    "allow": ["*"],
    "deny": ["browser"]
  }
}

Ferramentas Específicas por Provedor

{
  "tools": {
    "byProvider": {
      "whatsapp": {
        "deny": ["exec"]
      }
    }
  }
}

Variáveis de Ambiente

Usando Variáveis de Ambiente

{
  "providers": {
    "telegram": {
      "token": "${TELEGRAM_BOT_TOKEN}"
    }
  }
}

Variáveis Comuns

Variável	Descrição
`CLAWDBOT_CONFIG`	Caminho do arquivo de configuração
`CLAWDBOT_LOG_LEVEL`	Substituição do nível de log
`CLAWDBOT_PORT`	Substituição da porta

Configuração CLI

Substituir Configuração

clawdbot gateway start --port 3011 --log-level debug

Comandos de Configuração

# Ver configuração atual
clawdbot config get

# Definir valor de configuração
clawdbot config set gateway.port 3011

# Redefinir para padrões
clawdbot config reset

Configurações Avançadas

Desempenho

{
  "gateway": {
    "messageBuffer": 1000,
    "processTimeout": 30000,
    "streamChunkSize": 50
  }
}

Limites

{
  "limits": {
    "maxMessageLength": 10000,
    "maxConcurrentRequests": 10,
    "rateLimitPerMinute": 60
  }
}

Próximos Passos

Segurança do Clawdbot - Configuração de segurança
Solução de Problemas do Clawdbot - Depurar problemas
Clawdbot Gateway - Visão geral do gateway

Configuração do Clawdbot Gateway