강령

호스팅 에이전트

EmpirioLabs 모델을 사용하는 개인 OpenClaw 또는 Hermes 에이전트 런타임을 배포하세요.

호스팅 에이전트는 도구와 연결되고 EmpirioLabs 모델에서 실행되는 프라이빗 에이전트 런타임을 제공합니다. 각 에이전트는 격리되어 있고, 자체 영구 저장소를 유지하며, EmpirioLabs API나 연결된 채널을 통해 접근할 수 있습니다.

호스팅 에이전트가 왜 필요한가

앱에서 라이브

텔레그램, 디스코드, 슬랙, 매트릭스, 팀즈, 왓츠앱 등 다양한 채널을 연결하세요.

연결 도구 사용

Gmail, Drive, GitHub, Notion, Slack, 커스텀 MCP 커넥터 등 다양한 기능을 추가하세요.

코드를 안전하게 실행

파이썬, 패키지, 명령어, 생성된 파일들을 분리된 샌드박스에서 실행하세요.

시각적으로 찾아보기

웹페이지를 열고, 클릭하고, 타이핑하고, 스크롤하고, 스크린샷을 저장하세요.

생성 미디어

이미지, 비디오, 음성, 음악, 3D 자산, 전사 등 다양한 기능을 만들 수 있습니다.

모델, 관리

EmpirioLabs 모델, Poe, 또는 호환되는 공급업체를 사용하세요.

오픈클로와 헤르메스

오픈클로

인기 있는 모든 일을 하는 조수. 유능한 일반 에이전트를 원할 때 강력한 기본값입니다.

헤르메스

시간이 지나면서 배우고 기억하는 요원이라서, 많이 사용할수록 팀에 더 유용해집니다.

계획

기본 정보

단일 에이전트의 시작 런타임을 월 15달러에 제공합니다.

장점

더 많은 런타임 자원과 월 30달러의 여유가 있습니다.

퀵스타트

1

에이전트를 배치하세요

런타임(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"
>  }'
2

실행까지 대기

에이전트의 status이 running될 때까지 설문조사를 하세요.

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

연결 및 사용

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 있고 신분증이 없으면, 가장 먼저 메시지를 보내는 사람이 소유자가 됩니다. 하나의 연결된 채널에 대한 규칙을 설정하는 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 이메일을 보내십시오.

다음 단계

Hosted Agents API 참조

모든 호스팅 에이전트 엔드포인트에 대한 전체 요청 및 응답 스키마.

모델 및 가격

에이전트가 사용할 수 있는 모델을 살펴보세요.