For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
WebsiteModelsPricingGet Started
DocumentationAPI Reference
DocumentationAPI Reference
  • Overview
    • Welcome
    • Getting Started
    • Authentication
    • Concepts
  • Platform
    • Models and Pricing
    • Billing and Credits
    • Limits and API Keys
    • Account Usage API
    • Generation Templates
    • GPU Cloud
    • Agents
    • OpenAI and Anthropic Compatibility
    • Integrations
  • Providers and Models
    • All providers
  • Reference
    • API Reference Overview
    • AI Agent Access
    • Support
    • Changelog
Logo
WebsiteModelsPricingGet Started
On this page
  • Why Hosted Agents
  • OpenClaw and Hermes
  • Plans
  • Quickstart
  • Deploy and manage with the API
  • Deploy an agent
  • List your agents
  • Get an agent
  • Send a message
  • Run a lifecycle action
  • List integrations
  • Delete an agent
  • Pricing
  • Limits
  • Next steps
Platform

Hosted Agents

Deploy a private OpenClaw or Hermes agent runtime that uses EmpirioLabs models.
Was this page helpful?
Previous

OpenAI and Anthropic Compatibility

Use familiar request shapes while routing through EmpirioLabs AI
Next
Built with

Hosted Agents give you a private agent runtime that connects to your tools and runs on EmpirioLabs models. Each agent is isolated, keeps its own persistent storage, and is reachable through the EmpirioLabs API or from your connected channels.

Hosted Agents are in early access. Plans and runtimes may change. Contact us to request access.

Why Hosted Agents

OpenClaw or Hermes

Choose OpenClaw for a capable do-everything assistant, or Hermes for an agent that learns and remembers over time.

Private and isolated

Each agent runs in its own isolated runtime with its own persistent storage.

One API and key

Deploy and manage agents with the same EmpirioLabs API key you use for models.

Runs on your models

Agents call EmpirioLabs models with a key provisioned just for that agent.

OpenClaw and Hermes

OpenClaw

A popular do-everything assistant. A strong default when you want a capable general agent out of the box.

Hermes

An agent that learns and remembers over time, so it gets more useful to your team the more you use it.

Plans

Basic

A starter runtime for a single agent at 5 USD per month.

Pro

More runtime resources and headroom at 15 USD per month.

Quickstart

1

Request early access

Hosted Agents are gated while in early access. Contact us and we will enable it on your account.

2

Deploy an agent

Choose a runtime (openclaw or hermes) and a plan, then deploy.

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

Connect and use it

Send the agent a message through the API, or use it from a connected channel.

Deploy and manage with the API

All requests use your EmpirioLabs API key as a bearer token. The base URL is https://api.empiriolabs.ai.

Deploy an agent

The response includes an agent id and a status. Poll the agent until it reports that it is ready.

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

List your agents

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

Get an agent

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

Send a message

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

Run a lifecycle action

Use a lifecycle action to start, stop, or restart an agent.

$curl https://api.empiriolabs.ai/v1/hosted-agents/AGENT_ID/actions \
>  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{
>    "action": "restart"
>  }'

List integrations

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

Delete an agent

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

Pricing

Hosted Agents are billed monthly per agent based on the plan you choose. Basic is 5 USD per month and Pro is 15 USD per month. The plan covers the agent runtime. Models the agent uses are billed separately at standard model rates.

Limits

New accounts can run a limited number of deployed agents at once. The default is 3 deployed agents. Contact us to raise your limit.

Next steps

Hosted Agents API reference

Full request and response schemas for every hosted agent endpoint.

Models and pricing

Browse the models your agent can use.