OpenClaw

OpenClaw에 vox.ai 원격 MCP 서버를 서버용 API 키로 연결해요. 연결하면 AI 에이전트에게 전화기 주기의 음성 에이전트 준비와 전화 걸기를 OpenClaw에 맡길 수 있어요.

준비물

OpenClaw: 게이트웨이가 설치돼 있어야 해요. 설치와 MCP 설정 구조는 OpenClaw MCP 문서를 참고하세요.
서버용 API 키: sk_로 시작하는 서버용 키가 필요해요. 만드는 방법은 API 키를 참고하세요.
발신번호: 전화를 걸 워크스페이스에 발신번호가 등록돼 있어야 해요. 번호 준비는 전화번호에서 확인하세요.

실제 발신에는 통화 요금이 들며, 요금과 동시 통화·운영 한도는 요금에서 확인할 수 있어요.

API 키로 연결하기

환경 변수로 API 키 설정하기

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

export VOX_API_KEY="sk_..."

MCP 서버 추가하기

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

설정 파일
명령

{
  mcp: {
    servers: {
      "vox-ai": {
        url: "https://mcp.tryvox.co/mcp",
        transport: "streamable-http",
        enabled: true,
        headers: { Authorization: "Bearer ${VOX_API_KEY}" },
      },
    },
  },
}

openclaw mcp set vox-ai '{"url":"https://mcp.tryvox.co/mcp","transport":"streamable-http","enabled":true,"headers":{"Authorization":"Bearer ${VOX_API_KEY}"}}'

연결 상태 점검하기

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

openclaw mcp doctor vox-ai --probe

연결 확인

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

vox.ai에 연결된 에이전트 목록을 보여줘.

터미널에서 openclaw mcp probe vox-ai를 실행해 불러온 도구 수를 확인할 수도 있어요. 목록이 보이면 AI 에이전트에게 전화기 주기의 음성 에이전트 준비하기 단계로 돌아가세요.

문제가 생겼을 때

doctor를 실행하면 literal sensitive value 경고가 나와요

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

mcp show를 실행하면 API 키가 그대로 보여요

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

설정을 고쳤는데 반영되지 않아요

터미널에서 openclaw mcp reload를 실행해 설정을 다시 불러오세요. 게이트웨이가 이미 떠 있는 상태에서 설정을 바꾸면 다시 불러와야 반영돼요.

연동

AI 에이전트에게 전화기 주기

참조

준비물

API 키로 연결하기

연결 확인

문제가 생겼을 때

관련 문서

​준비물

​API 키로 연결하기

​연결 확인

​문제가 생겼을 때

​관련 문서

준비물

API 키로 연결하기

연결 확인

문제가 생겼을 때

관련 문서