Hosted Agents

Deploy a private OpenClaw or Hermes agent runtime that uses EmpirioLabs models.

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.

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

Deploy an agent

Choose a runtime (openclaw or hermes) and a plan, then deploy. The response includes an agent id and a 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"
>   }'

Wait until it is running

Poll the agent until its status is running.

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

Connect and use it

Send the agent a message through the API, or connect a channel and talk to it from there.

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, and every agent endpoint lives under /v1/hosted-agents.

Deploy an agent

agent_type is openclaw or hermes; plan_slug is hosted-agent-basic or hosted-agent-pro. By default the agent runs on EmpirioLabs models; set default_model to choose a specific one, or default_provider to poe or custom to point it at your own provider.

$ 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-max"
>   }'

List your agents

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

Get an agent

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

Send a message

$ 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?" }]
>   }'

Start, stop, restart

The action is the last path segment: start, stop, restart, or refresh.

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

Rename an agent

$ 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" }'

Delete an agent

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

Configure every setting from the API

Everything you can change in the dashboard is also controllable from the API, so you can manage agents entirely programmatically.

Change the model or provider

Switch the agent’s model in place (no redeploy). provider is empirio, poe, or 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-max" }'

Skills

Skills are reusable playbooks the agent follows. Search the official registry (OpenClaw uses ClawHub, Hermes uses skills.sh) and add a skill by its reference, or paste your own.

$ # 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"

Connectors (MCP)

Attach a remote MCP server to give the agent tools and data.

$ 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" }'

Channels

Connect a messaging channel (for example telegram, discord, or slack) so people can talk to the agent there.

$ 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" }'

Who can message the bot

mode is open (anyone) or restricted (only the messaging IDs you allow). With restricted and no IDs, the first person to message becomes the owner.

$ 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 '{ "mode": "restricted", "allow": {} }'

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

Each account 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.

$	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"
>	}'

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

$	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" }'

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

$	# 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"