OpenClaw
GitHubComenzar
Configuración Profunda

Guía de Configuración OpenClaw - Modelos IA y Canales de Chat

¿Ya instalaste OpenClaw? Aprende a configurar modelos de IA, ajustes de puerta de enlace, canales de chat y más

¿Qué quieres configurar?

Selecciona lo que quieres configurar y salta a la sección correspondiente

OpenClaw Visión General de Configuración

OpenClaw almacena toda la configuración en el directorio ~/.openclaw. Comprender esta estructura te ayuda a gestionar y respaldar tus ajustes.

Estructura de Archivos

~/.openclaw/openclaw.jsonArchivo de configuración principal
~/.openclaw/workspace/Habilidades, prompts, memorias
~/.openclaw/credentials/Credenciales OAuth y API
~/.openclaw/agents/Configuraciones multi-agente
~/.openclaw/credentials/oauth.jsonTokens OAuth (Claude, etc.)

OpenClaw Configuración de Modelos de IA

Requerido

OpenClaw soporta múltiples proveedores de IA. Elige tu proveedor preferido y sigue los pasos de configuración.

Configuración actual:Anthropic - API Key

Ideal para: Acceso API estándar con facturación por uso. Crea tu clave API en la Consola de Anthropic.

1

Obtener Clave API

Crea una clave API desde la Consola de Anthropic

Abrir Consola de Anthropic
2

Configuración CLI

Ejecuta el asistente de configuración o usa el modo no interactivo

Interactivo (Recomendado)

$ openclaw onboard
# choose: Anthropic API key

No interactivo

$ openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Estructura del Archivo de Configuración

Después de la configuración, los ajustes relevantes en openclaw.json:

~/.openclaw/openclaw.json
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}

Caché de Prompts (Solo API)

OpenClaw no sobrescribe el TTL de caché predeterminado de Anthropic a menos que lo configures. La autenticación por suscripción no respeta la configuración de TTL.

~/.openclaw/openclaw.json
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" }, // or "1h"
        },
      },
    },
  },
}

Verificar Configuración

$ openclaw models status

Ejecuta este comando para confirmar que la autenticación funciona

Anthropic Claude es recomendado para la mejor experiencia. Modelos soportados: anthropic/claude-opus-4-5, anthropic/claude-sonnet-4-20250514, anthropic/claude-haiku, etc.
Nota: La autenticación es independiente por agente. Los nuevos agentes requieren configuración de credenciales separada.

OpenClaw Configuración de Puerta de Enlace

Requerido

La puerta de enlace es el servicio central de OpenClaw que maneja todo el enrutamiento de mensajes entre IA y plataformas de chat.

Configuración Predeterminada

Puerto
18789
Dirección de Enlace
127.0.0.1
Autenticación
token / password

Comandos Comunes

Instalar servicio daemon (detecta auto macOS/Linux)

$ openclaw gateway install

Verificar estado de puerta de enlace

$ openclaw gateway status

Ver logs en tiempo real

$ openclaw logs --follow

Acceso Remoto

Acceso seguro a la puerta de enlace en servidor remoto vía túnel SSH:

$ ssh -N -L 18789:127.0.0.1:18789 user@host
Ver documentación completa de la puerta de enlace

OpenClaw Configuración de Canales de Chat

Al menos uno

Conecta OpenClaw a tus plataformas de chat preferidas. Cada canal tiene su propio proceso de configuración.

Configuración actual:WhatsApp
1

Gestión de Cuenta WhatsApp

Iniciar o cerrar sesión en la cuenta WhatsApp

Iniciar sesión (generar código QR)

$ openclaw channels login whatsapp

Cerrar sesión (usar para reconectar)

$ openclaw channels logout whatsapp
2

Escanear Código QR

Abre WhatsApp en tu teléfono, ve a Configuración -> Dispositivos Vinculados -> Escanea el código QR

Código QR

Escanea con la app móvil de WhatsApp

3

Aprobar Emparejamiento

Tu primer mensaje recibirá un código de emparejamiento. Apruébalo para comenzar a chatear.

$ openclaw pairing list whatsapp
$ openclaw pairing approve whatsapp [CODE]
Usa un número de teléfono dedicado. Los números VoIP no son recomendados ya que pueden ser bloqueados fácilmente.
Las credenciales se almacenan en el directorio ~/.openclaw/credentials/whatsapp/.
Ver documentación completa de WhatsApp

OpenClaw Gestión de Habilidades

Opcional

Las habilidades extienden las capacidades de OpenClaw. Instala y gestiona habilidades para mejorar tu asistente de IA.

Listar habilidades disponibles

$ openclaw skills list

Instalar una habilidad

$ openclaw skills install <skill-name>

Habilitar una habilidad

$ openclaw skills enable <skill-name>

Habilidades Populares

Búsqueda Web

Buscar en la web y resumir resultados

web-search
Intérprete de Código

Ejecutar código en un entorno aislado

code-interpreter
Gestor de Archivos

Leer, escribir y gestionar archivos

file-manager
Calendario

Gestionar eventos de calendario y recordatorios

calendar
Ver documentación completa de habilidades

OpenClaw Configuración Avanzada

Opcional

Funciones para usuarios avanzados para configuraciones complejas y automatización.

Configuración Multi-Agente

Crea agentes separados para diferentes contextos (trabajo, personal, etc.). Cada agente tiene su propio espacio de trabajo, sesiones y credenciales.

$ openclaw agents add work
$ openclaw agents list
$ openclaw agents switch work

Modo No Interactivo

Automatiza la configuración de OpenClaw en scripts o pipelines CI/CD.

$ openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

Tareas Programadas

Configura mensajes y tareas automatizadas usando programación estilo cron.

cron.json
# ~/.openclaw/cron.json
{
  "jobs": [
    {
      "schedule": "0 9 * * *",
      "action": "send",
      "channel": "telegram",
      "message": "Good morning! Here's your daily briefing..."
    }
  ]
}
Ver documentación completa de configuración avanzada

¡Configuración Completa!

Tu OpenClaw está completamente configurado. Comienza a chatear con tu asistente de IA.

Próximos Pasos