Guía completa para configurar el gateway del asistente de IA Clawdbot. Aprende sobre opciones de configuración, variables de entorno y ajustes avanzados.

Descripción General de la Configuración de Clawdbot Gateway

El gateway de Clawdbot se configura a través de ~/.clawdbot/clawdbot.json. Esta guía cubre todas las opciones de configuración para personalizar tu gateway.

Archivo de Configuración

Ubicación

~/.clawdbot/clawdbot.json

Estructura Básica

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

Configuración del Gateway

Configuración Principal

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

Opciones

Opción	Predeterminado	Descripción
`port`	3010	Puerto del servidor WebSocket
`host`	localhost	Dirección de enlace
`logLevel`	info	Nivel de detalle del registro
`maxConnections`	100	Conexiones concurrentes máximas

Configuración de Proveedores

{
  "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"]
    }
  }
}

Configuración 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"
    }
  }
}

Configuración de Sesiones

Política de Sesiones

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

Opciones de Sesión

Opción	Predeterminado	Descripción
`dmScope`	main	Alcance de sesión de mensajes directos
`resetTime`	04:00	Hora de reinicio diario
`idleMinutes`	null	Tiempo de espera inactivo
`maxHistory`	100	Máximo de mensajes en el historial

Configuración de Herramientas

Política de Herramientas

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

Herramientas Específicas por Proveedor

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

Variables de Entorno

Uso de Variables de Entorno

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

Variables Comunes

Variable	Descripción
`CLAWDBOT_CONFIG`	Ruta del archivo de configuración
`CLAWDBOT_LOG_LEVEL`	Anulación del nivel de registro
`CLAWDBOT_PORT`	Anulación del puerto

Configuración CLI

Anular Configuración

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

Comandos de Configuración

# Ver configuración actual
clawdbot config get

# Establecer valor de configuración
clawdbot config set gateway.port 3011

# Restablecer a valores predeterminados
clawdbot config reset

Configuración Avanzada

Rendimiento

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

Límites

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

Próximos Pasos

Seguridad de Clawdbot - Configuración de seguridad
Solución de Problemas de Clawdbot - Depurar problemas
Clawdbot Gateway - Descripción general del gateway

Configuración de Clawdbot Gateway