托管代理 | EmpirioLabs AI Docs

托管代理为你提供了一个私有代理运行时，连接你的工具，并运行在EmpirioLabs模型上。每个代理都是隔离的，保持自己的持久存储，并且可以通过EmpirioLabs API或你连接的频道访问。

为什么要用托管代理

住在你的应用程序里

连接Telegram、Discord、Slack、Matrix、Teams、WhatsApp等。

使用连接工具

添加Gmail、Drive、GitHub、Notion、Slack、自定义MCP连接器等。

安全运行代码

在隔离的沙箱中运行Python、包、命令和生成的文件。

浏览视觉

打开网页，点击、输入、滚动并保存截图。

生成媒体

创建图像、视频、语音、音乐、3D素材、转录等等。

模式,管理

使用EmpirioLabs的型号、Poe，或者你自己兼容的供应商。

OpenClaw和Hermes

OpenClaw

一个受欢迎的多面手助理。当你想要一个能干的通用经纪人时，这是强力默认选择。

赫尔墨斯

一个能随着时间学习和记忆的特工，所以你用得越多，对团队的帮助就越大。

计划

基础

单个代理的起始运行时间每月15美元。

优点

更多的运行时资源和每月30美元的余裕。

快速入门

部署代理

选择运行时（openclaw或hermes）和计划，然后部署。回应包括一名id和一名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"
>   }'

等到它运行的时候

对代理进行投票，直到status被running。

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

连接并使用

通过API向代理发送消息，或者连接一个通道并从那里与它对话。

用 API 部署和管理

所有请求都使用你的EmpirioLabs API密钥作为持有令牌。基础URL是https://api.empiriolabs.ai的，每个代理端点都属于/v1/hosted-agents。

部署代理

agent_type是openclaw或hermes;plan_slug是 hosted-agent-basic 或 hosted-agent-pro。默认情况下，代理运行在EmpirioLabs模型上;设置default_model选择特定方案，或者default_provider poe，或custom指向您自己的供应商。

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

列出你的代理人

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

找个经纪人

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

发送消息

$ 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或refresh。

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

从API里配置所有设置

仪表盘中所有能更改的内容也都可以通过API控制，所以你可以完全程序化地管理代理。

更换模型或供应商

切换代理的模式（不重新部署）。provider是empirio、poe或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" }'

技能

技能是特工可重复使用的操作手册。搜索官方注册表（OpenClaw用ClawHub，Hermes用 skills.sh），然后根据技能的引用添加技能，或者粘贴你自己的技能。

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

连接器（MCP）

连接一个远程MCP服务器，为代理提供工具和数据。

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

频道

连接基于令牌的消息通道（例如telegram、discord或slack），让人们可以在那里与代理对话。Telegram、Discord、Slack 和 Matrix 都支持 OpenClaw 和 Hermes 代理。Mattermost 和 Microsoft Teams 仅支持 OpenClaw。WhatsApp 通过仪表盘配对二维码，而不是这个令牌端点。

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

通道行为控制每个连接器上的小型聊天信号。默认情况下，打字指示和最小处理反应开启，已读回执关闭，实时回复预览关闭。实时回复预览在有平台原生编辑或草稿预览支持的情况下;它与模型API流是分开的。

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

谁可以给机器人发消息

mode是 open（任何人）或 restricted（仅限你允许的消息 ID）。有restricted且没有身份证的话，第一个发消息的人就是拥有者。包含一个连接通道的规则kind。

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

定价

托管客服按月按月计费，取决于您选择的套餐。基础版每月15美元，专业版每月30美元。该计划涵盖了代理运行时间。代理使用的型号按标准型号费率单独计费。

界限

每个账户一次只能运行有限数量的部署代理。你的仪表盘设置显示了你的有效限制。[联系 us](mailto:support@empiriolabs.ai）以提高你的上限。

白标

你可以把托管代理集成到自己的产品中，并完全以自己的品牌运营。API是无品牌化的：你用EmpirioLabs的API密钥调用/v1/hosted-agents/*，并随意显示代理，这样你的终端用户就能和你的产品互动，而不是我们的产品。API响应和代理回复中都没有EmpirioLabs的品牌标识。如需更高的代理额度、专用容量或定制商业安排，请发送邮件至 [support@empiriolabs.ai]（mailto:support@empiriolabs.ai）。

下一步

主机代理 API 参考

每个托管代理端点的完整请求和响应模式。

模式和定价

浏览你的经纪人可以使用的模型。