Guía de configuración

Todos los ajustes de OpenClaw están centralizados en un archivo de configuración. Veamos cómo personalizarlo.

📄 Ubicación del archivo de configuración

El archivo de configuración principal de OpenClaw se encuentra en:

~/.openclaw/openclaw.json

Aquí, ~ representa tu directorio de usuario. Por ejemplo, en macOS la ruta completa suele ser /Users/tu_nombre_de_usuario/.openclaw/openclaw.json.

💡 Consejo: .openclaw es una carpeta oculta (las carpetas cuyo nombre empieza con un punto están ocultas por defecto). En el Finder de macOS, pulsa Command + Shift + . para mostrar archivos ocultos. En Linux, usa el comando ls -a para verlos.

⚙️ Opciones de configuración clave

A continuación te explicamos las opciones más utilizadas del archivo de configuración:

Selección del modelo de IA

Configura el modelo de IA predeterminado:

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  }
}

Puedes cambiar provider a "openai", "deepseek" o "google", y configurar el nombre del modelo y la clave API correspondientes.

Gestión de sesiones

Controla el comportamiento de las conversaciones con la IA:

{
  "session": {
    "max_history": 50,
    "timeout_minutes": 30,
    "system_prompt": "Eres un asistente de IA útil..."
  }
}

max_history — Número máximo de mensajes del historial que se conservan en cada conversación
timeout_minutes — Minutos de inactividad tras los cuales se inicia automáticamente una nueva conversación
system_prompt — La "definición de rol" de la IA. Puedes personalizar la personalidad de la IA

Configuración de canales

Configura la información de conexión de cada plataforma de chat:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF..."
    },
    "discord": {
      "enabled": true,
      "bot_token": "MTIz..."
    }
  }
}

🔄 Recarga en caliente

OpenClaw soporta recarga en caliente (Hot Reload). Esto significa que después de modificar el archivo de configuración, no necesitas reiniciar OpenClaw: detectará automáticamente los cambios y aplicará los nuevos ajustes.

En pocas palabras: solo tienes que editar y guardar el archivo de configuración, y OpenClaw empezará a funcionar automáticamente con los nuevos ajustes. ¡Muy cómodo!

ℹ️ Nota: Algunos ajustes fundamentales (como el número de puerto) pueden requerir un reinicio manual. Sin embargo, la mayoría de los ajustes (como cambiar de modelo o configurar canales) admiten recarga en caliente.