Providers

인월드

Inworld는 스트리밍 텍스트 음성 변환(TTS) 제공업체입니다. OpenClaw에서는 발신 응답 오디오(기본적으로 MP3, 음성 메모에는 OGG_OPUS)와 Voice Call 같은 전화 통신 채널용 원시 PCM 오디오를 합성합니다.

OpenClaw는 Inworld의 스트리밍 TTS 엔드포인트에 요청을 보내고, 반환된 base64 오디오 청크를 단일 버퍼로 이어 붙인 다음 그 결과를 표준 응답 오디오 파이프라인에 전달합니다.

속성	값
제공업체 ID	`inworld`
Plugin	공식 외부 패키지(`@openclaw/inworld-speech`)
계약	`speechProviders`(TTS 전용)
인증 환경 변수	`INWORLD_API_KEY`(HTTP Basic, Base64 대시보드 자격 증명)
기본 URL	`https://api.inworld.ai`
기본 음성	`Sarah`
기본 모델	`inworld-tts-1.5-max`
출력	MP3(기본값), OGG_OPUS(음성 메모), PCM 22050Hz(전화 통신)
웹사이트	inworld.ai
문서	docs.inworld.ai/tts/tts

Plugin 설치

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

시작하기

API 키 설정

Inworld 대시보드(Workspace > API Keys)에서 자격 증명을 복사하여 환경 변수로 설정합니다. 이 값은 HTTP Basic 자격 증명으로 그대로 전송되므로 다시 Base64로 인코딩하거나 베어러 토큰으로 변환하지 마세요.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

messages.tts에서 Inworld 선택

json5

{  messages: {    tts: {      auto: "always",      provider: "inworld",      providers: {        inworld: {          voiceId: "Sarah",          modelId: "inworld-tts-1.5-max",        },      },    },  },}

메시지 보내기

연결된 채널을 통해 응답을 보냅니다. OpenClaw는 Inworld로 오디오를 합성하고 MP3로 전달합니다(채널에서 음성 메모를 요구하는 경우 OGG_OPUS).

구성 옵션

옵션	경로	설명
`apiKey`	`messages.tts.providers.inworld.apiKey`	Base64 대시보드 자격 증명입니다. `INWORLD_API_KEY`를 대체 값으로 사용합니다.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Inworld API 기본 URL을 재정의합니다(기본값 `https://api.inworld.ai`).
`voiceId`	`messages.tts.providers.inworld.voiceId`	음성 식별자입니다(기본값 `Sarah`). 레거시 별칭: `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	TTS 모델 ID입니다(기본값 `inworld-tts-1.5-max`).
`temperature`	`messages.tts.providers.inworld.temperature`	샘플링 온도입니다. `0` 초과 `2` 이하이며 선택 사항입니다.

참고 사항

인증

Inworld는 Base64로 인코딩된 단일 자격 증명 문자열을 사용하여 HTTP Basic 인증을 수행합니다. Inworld 대시보드에서 그대로 복사하세요. 제공업체는 추가 인코딩 없이 이를 Authorization: Basic <apiKey>로 전송하므로 직접 Base64로 인코딩하거나 베어러 형식 토큰을 전달하지 마세요. 같은 주의 사항은 TTS 인증 참고 사항을 참조하세요.

모델

지원되는 모델 ID: inworld-tts-1.5-max(기본값), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

오디오 출력

응답은 기본적으로 MP3를 사용합니다. 채널 대상이 voice-note이면 오디오가 네이티브 음성 말풍선으로 재생되도록 OpenClaw가 Inworld에 OGG_OPUS를 요청합니다. 전화 통신 합성은 전화 통신 브리지에 공급하기 위해 22050Hz의 원시 PCM을 사용합니다.

사용자 지정 엔드포인트

messages.tts.providers.inworld.baseUrl을 사용하여 API 호스트를 재정의합니다. 요청을 보내기 전에 끝의 슬래시가 제거됩니다.

인월드