ホストエージェント | EmpirioLabs AI Docs

ホストエージェントは、ツールに接続し、EmpirioLabsモデル上で動作するプライベートエージェントランタイムを提供します。各エージェントは隔離されており、独自の永続的なストレージを持ち、EmpirioLabsのAPIや接続されたチャネルを通じてアクセス可能です。

なぜホスティングエージェントなのか

アプリでライブ

Telegram、Discord、Slack、Matrix、Teams、WhatsAppなどを接続できます。

接続されたツールを使用する

Gmail、Drive、GitHub、Notion、Slack、カスタムMCPコネクターなどを追加しましょう。

安全にコードを実行

Python、パッケージ、コマンド、生成ファイルを分離されたサンドボックスで実行してください。

視覚的にブラウズ

ウェブページを開き、クリックし、タイプし、スクロールし、スクリーンショットを保存してください。

メディア

画像、動画、音声、音楽、3Dアセット、文字起こしなどを制作できます。

モデル, 管理

EmpirioLabsのモデル、Poe、または自分専用の対応プロバイダーを使ってください。

OpenClawとHermes

オープンクロー

人気の何でもできるアシスタント。有能なジェネラルエージェントがすぐに欲しい場合、これは強力なデフォルトです。

エルメス

時間をかけて学び記憶していくエージェントなので、使えば使うほどチームにとって役立つものになります。

計画

基本情報

1人のエージェントのスターターランタイムで月額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はダッシュボードからQRコードでペアリングされており、このトークンエンドポイントではありません。

$ 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がいてIDがない場合は、最初にメッセージを送った人が所有者になります。接続された1つのチャンネルにルールを設定するための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にメールでお問い合わせください。

今後のステップ

ホストエージェント API リファレンス

すべてのホストエージェントエンドポイントに対する完全な要求および応答スキーマ。

モデルと価格設定

エージェントが使えるモデルを閲覧しましょう。