Configurar modelos

Resumen

Configurar un modelo es opcional: tu plan incluye créditos mensuales para modelos, por lo que una vez que creas un Agent y conectes un canal puedes empezar a hablar inmediatamente y solo configurar un modelo después de que se agoten esos créditos. La sección de Modelos de la consola ofrece tres opciones: Plan de Codificación de Modelos (mensual o anual, ideal para uso intensivo), API de Modelo (pago a medida, ideal para uso ligero o pruebas) y Modelo personalizado (conectar un endpoint compatible con OpenAI). Las tres requieren tu propia clave API del proveedor correspondiente. Los pasos son: elegir una fuente, elegir un modelo específico, pegar la clave API y establecerla como predeterminada. Puedes cambiar los modelos más tarde sin perder memoria. Las claves API son credenciales sensibles — nunca las publiques en grupos de chat ni en páginas públicas, nunca las comprometas en un repositorio Git y revoca o rota inmediatamente la clave en la consola del proveedor si se filtra.

---

Esta página explica cómo configurar un modelo de lenguaje grande para Hermes Agent, incluyendo las diferencias entre los tres métodos de configuración, cómo obtener una Clave API, los pasos de configuración en la consola, los modelos compatibles y orientación para la selección de modelos.

---

¿Qué cubre esta página

• Diferencias entre los tres métodos de configuración (Plan de Codificación / API / Modelo Personalizado)

• Cómo obtener una Clave API

• Pasos de configuración en la consola

• Cambio de modelos

• Modelos compatibles

• Orientación para la selección de modelos

---

Tres métodos de configuración

El menú desplegable de nivel superior en la tarjeta "Modelo" de la consola ofrece tres opciones:

---

Proceso general para obtener una Clave API

Las interfaces de los proveedores difieren, pero el proceso es generalmente el mismo:

1. Visita el sitio web del proveedor: Después de seleccionar un modelo en la tarjeta de modelo de la consola, aparece el enlace "Obtener CLAVE API" debajo. Haz clic para abrir el sitio web del proveedor

2. Regístrate o inicia sesión: La mayoría de las plataformas chinas soportan el inicio de sesión con WeChat o número de teléfono

3. Completa la verificación de identidad: Los proveedores de modelos chinos generalmente requieren verificación de identidad antes de permitir llamadas API

4. Abre la página de gestión de claves API: Generalmente bajo "Consola → Gestión de API / Gestión de Claves / Credenciales"

5. Crea una nueva Clave: Nombra la Clave (por ejemplo, LightVela) y cópiala inmediatamente después de crearla. La mayoría de las plataformas muestran la Clave completa solo una vez

6. Vuelve a LightVela y pega la Clave

---

Configurar en la consola

Ingresa a la consola y abre el botón "Modelo".

Pasos de configuración

1. Elige fuente (menú desplegable de nivel superior): API de Modelo / Plan de Codificación de Modelo / Modelo Personalizado

2. Elige modelo específico (menú desplegable de nivel inferior): Los modelos disponibles se muestran según la fuente seleccionada anteriormente

3. Introduce la Clave API: Pega la Clave que obtuviste. El icono de ojo a la derecha alterna la visibilidad

4. Haz clic en "Agregar como predeterminado"

5. Aparece el registro correspondiente en la lista de "Modelo actual", indicando que la configuración fue exitosa

Campos adicionales para modelos personalizados

Al seleccionar "Modelo Personalizado", generalmente necesitas rellenar los siguientes campos además de la Clave API:

• URL base: La dirección de la API del servicio del modelo, por ejemplo https://api.openai.com/v1

• Nombre del modelo: El identificador del modelo, por ejemplo gpt-4o o claude-3-5-sonnet-20241022

Los campos reales dependen de la interfaz de la consola.

---

Cambiar modelos

Cómo cambiar

Ejecuta nuevamente los pasos de configuración. La nueva acción "Agregar como predeterminado" sobrescribe la configuración anterior.

Impacto en la memoria

Cambiar modelos no afecta la memoria de la conversación. La memoria pertenece a Hermes Agent en sí mismo; el modelo solo se encarga de generar respuestas.

---

Modelos compatibles

Plan de Codificación de Modelo (mensual)

API de Modelo (pago a medida)

Modelos personalizados

Cualquier endpoint compatible con el protocolo OpenAI Chat Completions puede conectarse, incluyendo:

• Modelos auto-hospedados: vLLM, Ollama, LM Studio y otros servicios que exponen endpoints compatibles con OpenAI

• Plataformas de agregación: OpenRouter, etc.

---

Orientación para la selección

Direcciones de selección según diferentes prioridades:

Recomendación: usa los créditos de prueba del plan de Lanzamiento para varias conversaciones primero. Después de confirmar que Hermes Agent funciona normalmente, decide qué modelo usar.

---

Preguntas frecuentes

Error de conversación "HTTP 401:InvalidAuthentication" o errores 401 similares

Si aparece HTTP 401:InvalidAuthentication u otro error 401 xxx durante una conversación con OpenClaw, generalmente se debe a una de las siguientes:

1. La Clave API del modelo está configurada incorrectamente;

2. La Clave API del Plan de Codificación se confunde con una Clave API de modelo regular;

3. Se selecciona incorrectamente la versión nacional o internacional de un proveedor de modelos.

Cuando esto ocurre, revisa nuevamente la configuración del modelo.

---

Próximos pasos

• Configurar Canal - WeChat

• Configurar Canal - Telegram

• Configurar Canal - WhatsApp

• Configurar Canal - Discord

• Configurar Canal - Slack

• Configurar Canal - QQ

• Configurar Canal - WeCom

• Configurar Canal - Lark

• Configurar Skills