Clientes/Hermes Agent
Usa la API de Wokey con Hermes Agent
Obtén una clave de API de Wokey, apunta Hermes Agent a la base URL de Wokey y confirma la conexión con una solicitud curl.
Actualizado
En esta páginaexpand_more
Obtén una clave de API y la base URLlink
Todos los clientes usan la misma clave de API de Wokey y la misma base URL.
Crea una clave de API
Inicia sesión y crea una clave de la plataforma en la página API. Las claves de una misma cuenta comparten su saldo.
Crear clave de APIkeyUsa la base URL de Wokey
Configura como base URL del cliente el dominio del gateway; la configuración de abajo indica si hay que añadir /v1.
Configura el clientelink
Hermes Agent solo necesita las primeras cinco líneas de configuración: modelo, provider personalizado, Base URL y clave de API. Para modelos GPT (como gpt-6-sol), agrega api_mode: codex_responses para obtener la mejor tasa de aciertos de caché; no lo pongas para otros modelos como Claude.
# ~/.hermes/config.yaml
model:
default: claude-opus-5-5
provider: custom
base_url: https://api.wokey.ai
api_key: YOUR_API_KEY
# Solo modelos GPT (como gpt-6-sol): quita el comentario para la mejor tasa de aciertos de caché:
# api_mode: codex_responsesFormatos de API y base URLlink
Cuando un mismo cliente cambia de formato de API, puede cambiar si la base URL termina en /v1.
| Formato | Base URL | Úsalo para |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi y otros modelos |
Dónde se configura: ~/.hermes/config.yaml
Ejecuta Hermes Agent como agente siempre activo con Opus 5.5: comparación con Claude Duetlink
El 2026-10-21 Anthropic abrió una vista previa de investigación de Claude Duet, un agente proactivo basado en Claude Opus 5.5 que envía un resumen cada mañana, vigila en segundo plano las apps que conectaste y te consulta antes de actuar. Duet solo funciona iniciando sesión con una cuenta de Claude; no tiene clave de API ni base URL personalizada, así que no puede usarse a través de Wokey. Hermes Agent es un agente siempre activo, de código abierto y autoalojado: conectado a Wokey usa el mismo modelo Opus 5.5, sin lista de espera y sin restricción de región.
| Claude Duet | Hermes Agent + Wokey | |
|---|---|---|
| Modelo | Claude Opus 5.5, no se puede cambiar | claude-opus-5-5 o cualquier otro modelo de Wokey |
| Quién puede usarlo | Suscriptores de Claude Pro y Max en EE. UU., mediante lista de espera; todavía no Team ni Enterprise | Lo instalas tú; solo necesitas una clave de API de Wokey, en cualquier región |
| Costo | Sin cargo adicional durante la vista previa, pero comparte los límites de uso de tu plan con el chat y Claude Code, incluidas las revisiones en segundo plano | Pago por token desde tu saldo de Wokey; tú eliges con qué frecuencia revisa |
| Dónde se ejecuta | Una máquina virtual con su propio navegador en la nube de Anthropic; sigue funcionando con tu celular y tu laptop apagados | Tu propia computadora o servidor; alójalo en una máquina siempre encendida para que funcione todo el día |
| Cómo hablas con él | La app de Duet (iOS y Android) y claude.ai | Apps de chat como Telegram y Slack |
| Memoria y herramientas | Hereda la memoria, las skills y los conectores de tu cuenta de Claude | La memoria, las skills y las herramientas están en tu equipo; tú las instalas y administras |
| Aprobación antes de actuar | Pregunta antes de enviar mensajes, pagar, firmar o eliminar; la compraventa de valores y las transferencias entre cuentas nunca están permitidas | Tú defines los permisos y las reglas de aprobación; da acceso solo a las cuentas que necesita |
- Con facturación por token, revisar con frecuencia cuesta más: cada revisión vuelve a enviar el prompt de sistema y la memoria. Usa un modelo más barato (como claude-sonnet-5-5 o deepseek-v4.1-flash) para las revisiones rutinarias y cambia a Opus 5.5 para decisiones y acciones.
- A través de Chat Completions, Opus 5.5 piensa antes de escribir, así que el primer token tarda; un agente que trabaja en segundo plano casi no lo nota.
- La configuración de arriba ya usa claude-opus-5-5 por defecto; no hace falta cambiar nada.
Datos de Duet verificados el 2026-10-22 · Fuentes sobre Duet: Introducing Claude Duet · Claude Duet FAQ
Verifica con curllink
Si el cliente muestra un error, primero descarta problemas con la clave y la base URL usando curl.
Hermes Agent usa el formato OpenAI Chat Completions de forma predeterminada. Si esta solicitud devuelve 200, la clave y la base URL son correctas. Reemplaza YOUR_API_KEY por tu clave antes de enviarla.
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'Errores y solución de problemaslink
Primero distingue los casos de autenticación, saldo, límite de tasa, disponibilidad del modelo y tiempo de espera del upstream.
invalid api key
La clave falta, está mal escrita, se eliminó, o los encabezados Authorization / x-api-key no coinciden.
insufficient balance
El saldo de la cuenta es demasiado bajo. Recarga antes de enviar más solicitudes.
model_denylisted / account_restricted
Las llamadas al modelo, o a todos los modelos de la cuenta, están pausadas tras infracciones repetidas. Consulta Tarifas por gestión de infracciones y restricciones.
request_blocked
Esta solicitud se bloqueó antes de llegar al upstream y no se cobra, por ejemplo el reenvío sin cambios de una solicitud que el modelo acaba de rechazar, o un usuario final pausado (X-End-User-Id). El mensaje de error indica qué está bloqueado; modifica la solicitud como indica o vuelve a intentarlo más tarde. Las demás solicitudes no se ven afectadas.
rate limited
El tráfico es demasiado frecuente. Vuelve a intentarlo más tarde o reduce la concurrencia. Si solo un modelo, o un usuario final (X-End-User-Id), sigue devolviendo 429, puede ser un límite temporal tras infracciones.
client disconnected
El cliente cerró la conexión antes de que terminara la respuesta (código downstream_aborted). Por defecto no se cobra. Cuando una cuenta acumula al menos 50 desconexiones del cliente en las últimas 24 horas y representan el 10% o más de sus solicitudes, las solicitudes desconectadas posteriores se cobran según el uso que informó el upstream: la entrada procesada, incluidas lecturas y escrituras de caché, y la salida solo si el upstream la contabilizó. Una desconexión antes de que el upstream informe cualquier uso sigue siendo gratis. La cuenta recibe un aviso cuando empieza el cobro, y el cobro se detiene automáticamente en menos de una hora cuando la tasa de desconexión vuelve a la normalidad. La causa habitual es un tiempo de espera del cliente o del proxy demasiado corto, o un programa que cancela solicitudes antes de que terminen.
upstream unavailable
El servicio del modelo upstream no está disponible temporalmente. Cambia de modelo o vuelve a intentarlo más tarde.
upstream timeout
Se agotó el tiempo de espera de la respuesta del upstream. Acorta el contexto, reduce max_tokens o vuelve a intentarlo.
upstream overloaded
El modelo upstream está sobrecargado temporalmente y Wokey ya reintentó por otras rutas (código upstream_overloaded). No tiene relación con tu saldo. Vuelve a intentarlo en breve o cambia de modelo.
Preguntas frecuenteslink
- ¿El base_url de Hermes Agent debe terminar en /v1?
- No. Configura base_url como https://api.wokey.ai y provider como custom.
- ¿Cuándo agrego api_mode: codex_responses?
- Solo con modelos GPT como gpt-6-sol, donde da la mejor tasa de aciertos de caché. Omítelo para Claude y otros modelos.
- ¿Dónde va la clave de API?
- En el campo api_key bajo model en ~/.hermes/config.yaml, solo la clave.