OpenClaw

할 수 있는 것

타입캐스트와 OpenClaw를 사용하면 다음을 할 수 있습니다:

• 에이전트 워크플로우에서 음성 생성 - 모든 텍스트 출력을 자연스러운 오디오로 변환
• 500개 이상의 보이스 선택 - 성별, 나이, 스타일별로 보이스 선택
• 감정 제어 - 스마트 이모션 또는 이모션 프리셋(happy, sad, angry, whisper 등) 적용
• 37개 언어 지원 - 영어, 한국어, 일본어, 중국어 등으로 음성 생성
• 오디오 파이프라인 자동화 - 다른 도구와 결합하여 엔드투엔드 콘텐츠 제작

사전 요구 사항

시작하기 전에 다음을 준비하세요:

1. OpenClaw 설치 - npm install -g openclaw@latest
2. 타입캐스트 API 키 - 여기서 받기
3. 타입캐스트 CLI (cast) - 가장 빠른 연동 방법

빠른 시작: cast CLI

공식 타입캐스트 CLI는 음성 생성을 단일 셸 명령으로 처리합니다. 에이전트가 셸 명령을 실행할 수 있다면 커스텀 프로바이더 없이 타입캐스트 오디오를 생성할 수 있습니다.

단계 1: CLI 설치

brew install neosapience/tap/cast

단계 2: 인증

cast login

또는 키를 직접 전달:

cast login <your-api-key>

단계 3: 확인

cast "안녕하세요!" --out ./test.mp3 --format mp3

파일이 정상적으로 생성되면 OpenClaw와 함께 사용할 준비가 된 것입니다.

연동 방법

방법 1: cast를 통한 Local exec (권장)

OpenClaw는 local exec과 remote code_execution을 구분합니다. 설치된 바이너리에 접근해야 할 때는 local exec을 사용하세요.

OpenClaw 에이전트에게 다음과 같이 요청하세요:

local exec으로 다음 명령을 실행해줘:
cast "금요일 오후 7시로 예약이 확정되었습니다." --language kor --format mp3 --out ./confirmation.mp3
생성된 파일 경로를 반환해줘.

반복적으로 사용하려면 OpenClaw 설정에 프로젝트 인스트럭션을 추가하세요:

사용자가 음성 오디오를 요청하면 로컬 `cast` CLI를 사용하세요.
기본 명령:

cast "$TEXT" --voice-id "$TYPECAST_VOICE_ID" --language "${TYPECAST_LANGUAGE:-kor}" --format "${TYPECAST_FORMAT:-mp3}" --out "$OUTPUT"

API 키를 출력하지 마세요. 헤드리스 세션에서는 `--out`을 사용하세요.

권장 환경 변수:

export TYPECAST_VOICE_ID="tc_60e5426de8b95f1d3000d7b5"
export TYPECAST_LANGUAGE="kor"
export TYPECAST_FORMAT="mp3"

방법 2: MCP 서버 (도구 네이티브)

더 깊은 연동을 위해 타입캐스트 API MCP 서버를 연결하여 OpenClaw가 TTS 도구를 직접 호출하도록 하세요.

openclaw mcp set typecast '{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/neosapience/typecast-api-mcp-server.git",
    "typecast-api-mcp-server"
  ],
  "env": {
    "TYPECAST_API_KEY": "${TYPECAST_API_KEY}",
    "TYPECAST_OUTPUT_DIR": "./typecast_output"
  }
}'

openclaw mcp show typecast

등록 후 타입캐스트 도구가 typecast__synthesize_speech, typecast__list_voices 등으로 나타납니다. 에이전트에게 요청:

typecast MCP 도구를 사용해서 "안녕하세요"를 mp3 파일로 합성해줘.

보이스 및 감정 제어

보이스 찾기

cast CLI로 사용 가능한 보이스를 조회하세요:

cast voices --model ssfm-v30

또는 에이전트에게 MCP list_voices 도구를 사용하여 성별, 나이, 사용 사례별로 검색하도록 요청하세요.

감정 옵션

cast CLI로 감정 적용:

# 스마트 이모션 (ssfm-v30 전용)
cast "정말 믿을 수 없어요!" --model ssfm-v30 --emotion smart --out ./excited.mp3

# 이모션 프리셋
cast "정말 유감입니다." --model ssfm-v30 --emotion sad --out ./sorry.mp3

예시 워크플로우

문제 해결

리소스