Quickstart

이 가이드에서는 ClawOps 번호를 발급하고, OpenAI Realtime 기반 에이전트로 전화를 받는 데까지 진행합니다.

번호와 API 키 준비

ClawOps 대시보드에서 070 번호를 발급한 뒤 설정 → API 키에서 API Key와 Account ID를 확인합니다.

SDK 설치

$ pip install "clawops[agent,openai]"

환경변수 설정

$ export CLAWOPS_API_KEY="your-api-key"
$ export CLAWOPS_ACCOUNT_ID="your-account-id"
$ export OPENAI_API_KEY="your-openai-key"

에이전트 실행

1 import asyncio
2 from clawops.agent import ClawOpsAgent, OpenAIRealtime
3 
4 agent = ClawOpsAgent(
5     from_="07012341234",
6     session=OpenAIRealtime(
7         system_prompt="친절한 고객 상담원입니다. 한국어로 응대합니다.",
8         voice="marin",
9         language="ko",
10     ),
11 )
12 
13 asyncio.run(agent.serve())

실행 후 발급받은 번호로 전화를 걸면 에이전트가 전화를 받습니다.

에이전트가 ClawOps 서버에 직접 연결하므로 인바운드 수신을 위해 ngrok 같은 터널을 열 필요가 없습니다.

다음 단계

Voice Agent에서 도구 호출, 이벤트 처리와 아웃바운드 발신을 알아보세요.
VoiceML에서 서버가 통화 흐름을 직접 제어하는 방식을 알아보세요.
API Reference에서 REST API 인증과 전체 엔드포인트를 확인하세요.