Configura modelos en OpenClaw: Guía rápida de uso

¿Alguna vez has sentido que pierdes más tiempo configurando modelos que escribiendo código real? Saltar entre diferentes proveedores y recordar IDs de modelos larguísimos puede ser un incordio cuando solo quieres avanzar en tu proyecto.

Configurar OpenClaw correctamente te permite enfocarte en lo que importa, automatizando la selección de modelos para que siempre tengas la herramienta adecuada a mano sin complicaciones.

Selección de Modelos y Aliases

Cómo elegir y configurar modelos en OpenClaw.

---

¿Qué es el “modelo por defecto”?

El modelo por defecto de OpenClaw es el que definas como:

agents.defaults.model.primary

Los modelos se referencian como provider/model (ejemplo: anthropic/claude-opus-4-5).

---

¿Qué modelo recomiendas?

• Default recomendado: anthropic/claude-opus-4-5
• Buena alternativa: anthropic/claude-sonnet-4-5
• Confiable (menos personalidad): openai/gpt-5.2
• Económico: zai/glm-4.7

Regla de oro: usa el mejor modelo que puedas permitirte para tareas críticas, y un modelo más barato para chats rutinarios o resúmenes.

⚠️ Advertencia importante: los modelos más débiles o con demasiada cuantización son más vulnerables a prompt injection y comportamientos no seguros.

---

¿Puedo usar modelos locales (llama.cpp, vLLM, Ollama)?

Sí. Si tu servidor local expone una API compatible con OpenAI, puedes apuntar un proveedor personalizado hacia él. Ollama tiene soporte directo y es el camino más sencillo.

Nota de seguridad: los modelos pequeños o muy cuantizados son más vulnerables a prompt injection. Te recomendamos usar modelos grandes para cualquier bot que utilice herramientas.

---

¿Cómo cambio de modelo sin borrar mi configuración?

Opciones seguras:

• /model en el chat (rápido, por sesión)
• openclaw models set ... (actualiza solo la configuración del modelo)
• openclaw configure --section models (interactivo)
• edita agents.defaults.model en ~/.openclaw/openclaw.json

Evita usar config.apply con un objeto parcial a menos que quieras reemplazar toda la configuración.

---

¿Cómo cambio de modelo sobre la marcha (sin reiniciar)?

Usa el comando /model como un mensaje independiente:

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

Puedes listar los modelos disponibles con /model o /model list.

Selecciona por número:

/model 3

También puedes forzar un perfil de autenticación específico:

/model opus@anth

/model opus@anthropic:default /model opus@anthropic:work

/model gpt-5.2 # for daily tasks /model gpt-5.2-codex # for coding

```json
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-5" },
      models: {
        "anthropic/claude-opus-4-5": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" }
      }
    }
  }
}

{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} }
    }
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." }
}

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4.7" },
      models: { "zai/glm-4.7": {} }
    }
  },
  env: { ZAI_API_KEY: "..." }
}