OpenClaw
Configuración6 min de lectura

Plantilla de Configuración OpenClaw: Un Template 'Seguro y Usable'

Ejemplos de configuración mínima para Model/Gateway/Channel/Skills con valores predeterminados seguros y fragmentos listos para copiar y pegar.

O

OpenClaw Guides

Tutorial Authors

Configuración Mínima

Aquí hay una plantilla de configuración mínima verificada con valores predeterminados seguros:

json
// ~/.openclaw/openclaw.json
{
  "model": {
    "provider": "anthropic",
    "default": "claude-3-5-sonnet",
    "apiKey": "${ANTHROPIC_API_KEY}"
  },
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1"
  },
  "channels": [
    { "type": "whatsapp", "enabled": false },
    { "type": "telegram", "enabled": false },
    { "type": "discord", "enabled": false }
  ],
  "security": {
    "rateLimiting": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    }
  }
}

Explicación de las Secciones de Configuración

Configuración del Modelo

json
{
  "model": {
    "provider": "anthropic",
    "default": "claude-3-5-sonnet",
    "apiKey": "${ANTHROPIC_API_KEY}"
  }
}

Modelos disponibles:

  • claude-3-5-haiku - Rápido, rentable ($0.25/1M entrada, $1.25/1M salida)
  • claude-3-5-sonnet - Rendimiento equilibrado ($3/1M entrada, $15/1M salida)
  • claude-sonnet-4 - Última generación, mejor calidad ($3/1M entrada, $15/1M salida)

Configuración del Gateway

json
{
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1",
    "timeout": 30000
  }
}

Nota de Seguridad: Nunca establezcas host en 0.0.0.0 a menos que tengas reglas de firewall apropiadas configuradas.

Configuración de Canales

Cada canal puede configurarse de forma independiente:

json
{
  "channels": [
    {
      "type": "whatsapp",
      "enabled": true,
      "sessionPath": "~/.openclaw/whatsapp-session"
    },
    {
      "type": "telegram",
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    },
    {
      "type": "discord",
      "enabled": true,
      "botToken": "${DISCORD_BOT_TOKEN}",
      "intents": ["GUILDS", "GUILD_MESSAGES", "MESSAGE_CONTENT"]
    }
  ]
}

Configuración de Seguridad

json
{
  "security": {
    "rateLimiting": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    },
    "quotas": {
      "daily": {
        "enabled": true,
        "maxTokens": 100000
      }
    }
  }
}

Variables de Entorno

Crea un archivo .env en tu directorio de OpenClaw:

bash
# ~/.openclaw/.env
ANTHROPIC_API_KEY=sk-ant-xxxxx
TELEGRAM_BOT_TOKEN=123456:ABC-xxxxx
DISCORD_BOT_TOKEN=xxxxx.xxxxx.xxxxx

Validación

Valida tu configuración:

bash
openclaw config validate

Esto verificará:

  • Campos requeridos
  • Claves API válidas
  • Formato correcto

Próximos Pasos