Agentes Alojados | EmpirioLabs AI Docs

Los Agentes Alojados te ofrecen un entorno de ejecución de agente privado que se conecta a tus herramientas y se ejecuta sobre modelos de EmpirioLabs. Cada agente está aislado, mantiene su propio almacenamiento persistente y es accesible a través de la API de EmpirioLabs o desde tus canales conectados.

Por qué los agentes alojados

Vive en tus aplicaciones

Conecta Telegram, Discord, Slack, Matrix, Teams, WhatsApp y más.

Utiliza herramientas conectadas

Añade Gmail, Drive, GitHub, Notion, Slack, conectores MCP personalizados y más.

Corre código de forma segura

Ejecuta Python, paquetes, comandos y archivos generados en sandboxes aislados.

Navega visualmente

Abre páginas web, haz clic, escribe, desplázate y guarda capturas de pantalla.

Genera medios

Crea imágenes, vídeo, voz, música, recursos 3D, transcripciones y más.

Modelos, gestionados

Utiliza modelos de EmpirioLabs, Poe o tu propio proveedor compatible.

OpenClaw y Hermes

OpenClaw

Un asistente popular que hace de todo. Un defecto fuerte cuando quieres un agente general capaz desde el primer momento.

Hermes

Un agente que aprende y recuerda con el tiempo, así que se vuelve más útil para tu equipo cuanto más lo usas.

Planes

Básica

Un tiempo de inicio para un solo agente a 15 USD al mes.

Pro

Más recursos de ejecución y margen de margen a 30 USD al mes.

Inicio rápido

Despliega un agente

Elige un tiempo de ejecución (openclaw o hermes) y un plan, y luego despliega. La respuesta incluye un id de agente y un status.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic"
>   }'

Espera hasta que esté funcionando.

Consulta al agente hasta que su status esté running.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Conectarlo y utilizarlo

Envía un mensaje al agente a través de la API, o conecta un canal y habla con él desde ahí.

Desplegar y gestionar con la API

Todas las solicitudes usan tu clave API de EmpirioLabs como token portador. La URL base es https://api.empiriolabs.ai, y cada endpoint de agente está bajo /v1/hosted-agents.

Despliega un agente

agent_type es openclaw o hermes; plan_slug es hosted-agent-basic o hosted-agent-pro. Por defecto, el agente funciona con modelos de EmpirioLabs; Configura default_model para elegir uno específico, o default_provider para poe o custom para dirigirlo a tu propio proveedor.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic",
>     "default_model": "qwen3-7-plus"
>   }'

Haz una lista de tus agentes

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Consigue un agente

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Envía un mensaje

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/message \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "messages": [{ "role": "user", "content": "What is on my calendar today?" }]
>   }'

Arrancar, parar, reiniciar

La acción es el último segmento de camino: start, stop, restart o refresh.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/restart \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Renombrar un agente

$ curl -X PATCH https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "Renamed Assistant" }'

Eliminar un agente

$ curl -X DELETE https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Configura todos los ajustes de la API

Todo lo que puedes cambiar en el panel de control también es controlable desde la API, así que puedes gestionar los agentes completamente de forma programática.

Cambia el modelo o proveedor

Cambia el modelo del agente en su sitio (sin redeploy). provider es empirio, poe o custom.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/model \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "provider": "empirio", "model": "qwen3-7-plus" }'

Habilidades

Las habilidades son manuales reutilizables que sigue el agente. Busca en el registro oficial (OpenClaw usa ClawHub, Hermes usa skills.sh) y añade una habilidad por su referencia, o pega la tuya propia.

$ # List installed skills
$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
$ 
$ # Add an official skill (OpenClaw: clawhub:<slug>, Hermes: hermes:<id>)
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "slug": "hermes:openai/skills/pdf" }'
$ 
$ # Add your own pasted skill
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "custom": { "name": "House Style", "body": "Always answer in a concise, friendly tone." } }'
$ 
$ # Remove a skill
$ curl -X DELETE "https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills?slug=hermes:openai/skills/pdf" \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Conectores (MCP)

Conecta un servidor MCP remoto para proporcionar al agente herramientas y datos.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/mcp \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "my-tools", "url": "https://example.com/mcp" }'

Canales

Conecta un canal de mensajería basado en tokens (por ejemplo, telegram, discord o slack) para que la gente pueda hablar con el agente allí. Telegram, Discord, Slack y Matrix funcionan en agentes de OpenClaw y Hermes. Mattermost y Microsoft Teams son exclusivos para OpenClaw. WhatsApp se empareja desde el panel de control con un código QR en lugar de este endpoint token.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "secret": "YOUR_BOT_TOKEN" }'

El comportamiento del canal controla las señales de chat pequeñas en cada conector. Por defecto, los indicadores de escritura y las reacciones mínimas de procesamiento están activados, los recibos de lectura están desactivados y la vista previa de respuesta en vivo está desactivada. La versión preliminar de respuesta en vivo utiliza soporte nativo de edición o vista previa de borradores cuando está disponible; es independiente del streaming de API de modelos.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations/telegram/behavior \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "behavior": {
>       "reaction_level": "minimal",
>       "typing": true,
>       "read_receipts": false,
>       "streaming": false
>     }
>   }'

¿Quién puede enviar mensajes al bot?

mode es open (cualquiera) o restricted (solo los IDs de mensajería que permites). Con restricted y sin identificaciones, la primera persona en enviar un mensaje se convierte en el propietario. Incluye kind para establecer la regla para un canal conectado.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/access \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "mode": "restricted", "allow": { "telegram": ["123456789"] } }'

Precios

Los Agentes Alojados se facturan mensualmente por agente según el plan que elijas. El básico cuesta 15 USD al mes y el Pro 30 USD al mes. El plan cubre el tiempo de ejecución del agente. Los modelos que utiliza el agente se facturan por separado a tarifas estándar.

Límites

Cada cuenta puede ejecutar un número limitado de agentes desplegados a la vez. La configuración de tu panel muestra tu límite efectivo. Contacta us para aumentar tu límite.

Etiquetado blanco

Puedes integrar agentes alojados en tu propio producto y gestionarlos completamente bajo tu propia marca. La API no tiene marca: llamas a /v1/hosted-agents/* con tu clave API de EmpirioLabs y mostras el agente como quieras, para que tus usuarios finales interactúen con tu producto, no con el nuestro. No hay marca EmpirioLabs en las respuestas de la API ni en las respuestas del agente. Para límites más altos de agentes, capacidad dedicada o un acuerdo comercial personalizado, envíe un correo electrónico a support@empiriolabs.ai.

Próximos pasos

Referencia de API de agentes anfitriones

Esquemas completos de petición y respuesta para cada endpoint de agente alojado.

Modelos y precios

Consulta los modelos que tu agente puede utilizar.