> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.claw-ops.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.claw-ops.com/_mcp/server.

# Quickstart

> 번호를 발급하고 첫 번째 AI 음성 에이전트를 실행합니다.

# Quickstart

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

#### 번호와 API 키 준비

[ClawOps 대시보드](https://platform.claw-ops.com)에서 070 번호를 발급한 뒤 **설정 → API 키**에서 API Key와 Account ID를 확인합니다.

#### SDK 설치

```bash
pip install "clawops[agent,openai]"
```

#### 환경변수 설정

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

#### 에이전트 실행

```python
import asyncio
from clawops.agent import ClawOpsAgent, OpenAIRealtime

agent = ClawOpsAgent(
    from_="07012341234",
    session=OpenAIRealtime(
        system_prompt="친절한 고객 상담원입니다. 한국어로 응대합니다.",
        voice="marin",
        language="ko",
    ),
)

asyncio.run(agent.serve())
```

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

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

## 다음 단계

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