> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> OpenClaw에 vox.ai MCP를 연결해 통화 중 음성 에이전트의 질문에 답하게 할 수 있어요.

OpenClaw에 vox.ai 원격 MCP 서버를 서버용 API 키로 연결해요. 연결하면 [AI 에이전트에게 전화기 주기](https://docs.tryvox.co/docs/ai/phone/overview.md)의 음성 에이전트 준비와 전화 걸기를 OpenClaw에 맡길 수 있어요.

## 준비물

* **OpenClaw**: 게이트웨이가 설치돼 있어야 해요. 설치와 MCP 설정 구조는 [OpenClaw MCP 문서](https://docs.openclaw.ai/tools/mcp)를 참고하세요.
* **서버용 API 키**: `sk_`로 시작하는 서버용 키가 필요해요. 만드는 방법은 [API 키](https://docs.tryvox.co/docs/workspace/api-keys.md)를 참고하세요.
* **발신번호**: 전화를 걸 워크스페이스에 발신번호가 등록돼 있어야 해요. 번호 준비는 [전화번호](https://docs.tryvox.co/docs/operate/deploy/phone-numbers.md)에서 확인하세요.

실제 발신에는 통화 요금이 들며, 요금과 동시 통화·운영 한도는 [요금](https://docs.tryvox.co/docs/start/pricing.md)에서 확인할 수 있어요.

## API 키로 연결하기

**1. 환경 변수로 API 키 설정하기**

설정 파일에 키가 직접 남지 않도록 OpenClaw 게이트웨이를 실행하는 환경에 서버용 API 키를 환경 변수로 등록하세요.

```bash theme={null}
export VOX_API_KEY="sk_..."
```

**2. MCP 서버 추가하기**

`~/.openclaw/openclaw.json`의 `mcp.servers`에 `vox-ai` 서버를 추가하거나 명령으로 등록하세요.

> [tab] 설정 파일
>
> ```json5 theme={null}
> {
>   mcp: {
>     servers: {
>       "vox-ai": {
>         url: "https://mcp.tryvox.co/mcp",
>         transport: "streamable-http",
>         enabled: true,
>         headers: { Authorization: "Bearer ${VOX_API_KEY}" },
>       },
>     },
>   },
> }
> ```

> [tab] 명령
>
> ```bash theme={null}
> openclaw mcp set vox-ai '{"url":"https://mcp.tryvox.co/mcp","transport":"streamable-http","enabled":true,"headers":{"Authorization":"Bearer ${VOX_API_KEY}"}}'
> ```

**3. 연결 상태 점검하기**

게이트웨이가 이미 떠 있으면 `openclaw mcp reload`로 설정을 다시 불러오세요. 이어서 아래 명령으로 연결을 점검하면 정상일 때 `vox-ai: ok`가 출력돼요.

```bash theme={null}
openclaw mcp doctor vox-ai --probe
```

## 연결 확인

에이전트 목록을 요청하세요. API 키로 연결하면 키를 만든 워크스페이스 하나에서만 동작하며 다른 워크스페이스로 바꿀 수 없어요.

```text theme={null}
vox.ai에 연결된 에이전트 목록을 보여줘.
```

터미널에서 `openclaw mcp probe vox-ai`를 실행해 불러온 도구 수를 확인할 수도 있어요. 목록이 보이면 [AI 에이전트에게 전화기 주기](https://docs.tryvox.co/docs/ai/phone/overview.md)의 음성 에이전트 준비하기 단계로 돌아가세요.

## 문제가 생겼을 때

> [accordion] doctor를 실행하면 literal sensitive value 경고가 나와요
>
> 헤더 값이 `Bearer ${VOX_API_KEY}`처럼 환경 변수 자리 표시자로 적혀 있다면 경고를 무시하세요. 자리 표시자를 넣었을 때도 경고가 나올 수 있으며, 결과에 `vox-ai: ok`가 보이면 정상으로 연결된 상태예요.

> [accordion] mcp show를 실행하면 API 키가 그대로 보여요
>
> 화면을 공유하거나 기록이 남는 환경에서는 `openclaw mcp show vox-ai`를 실행하지 마세요. 이 명령은 환경 변수를 펼친 실제 API 키를 화면에 그대로 출력해요.

> [accordion] 설정을 고쳤는데 반영되지 않아요
>
> 터미널에서 `openclaw mcp reload`를 실행해 설정을 다시 불러오세요. 게이트웨이가 이미 떠 있는 상태에서 설정을 바꾸면 다시 불러와야 반영돼요.

## 관련 문서

* [AI 에이전트에게 전화기 주기](https://docs.tryvox.co/docs/ai/phone/overview.md): 중계 서버를 띄우고 통화 중 질문에 답하게 하기
* [MCP 도구](https://docs.tryvox.co/docs/ai/mcp-reference.md): 전체 도구 목록과 입력·실행 규칙 보기
* [MCP](https://docs.tryvox.co/docs/ai/mcp.md): 로그인으로 연결하고 워크스페이스 전환하기


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.