Python SDK

View as Markdown

Python SDK

공식 ClawOps Python SDK는 동기·비동기 클라이언트와 AI 음성 에이전트 프레임워크를 제공합니다.

PyPI Python

현재 공개 버전은 0.38.0이며 Python 3.9 이상을 지원합니다.

설치

$pip install clawops

빠른 시작

1from clawops import ClawOps
2
3client = ClawOps(
4 api_key="YOUR_API_KEY",
5 account_id="YOUR_ACCOUNT_ID",
6)
7
8# 보유 전화번호 조회
9numbers = client.numbers.list()
10
11# 아웃바운드 통화 발신
12call = client.calls.create(
13 to="01012345678",
14 from_="07012341234",
15 url="https://example.com/voice",
16)
17
18print(call.call_id)

생성자 옵션을 생략하면 CLAWOPS_API_KEYCLAWOPS_ACCOUNT_ID 환경변수를 자동으로 사용합니다.

AI 음성 에이전트

OpenAI Realtime 기반 Voice Agent를 사용하려면 optional dependency를 함께 설치합니다.

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

주요 리소스

  • client.calls — 통화 발신, 조회, 종료, 녹음·전사·요약
  • client.numbers — 전화번호 발급, 조회, 라우팅, 해제
  • client.messages — SMS·LMS·MMS 발송 및 조회
  • client.recordings — 통화 녹음 다운로드 및 삭제
  • client.sip_endpoints, client.sip_credentials — SIP와 WebRTC 연동
  • client.webhook_logs — Webhook 전달 이력 조회
  • AsyncClawOps — 모든 주요 리소스의 비동기 클라이언트

링크