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

# Inworld

Inworld는 스트리밍 텍스트 음성 변환(TTS) 제공자입니다. OpenClaw에서는
발신 답장 오디오(기본값은 MP3, 음성 메모는 OGG\_OPUS)와 Voice Call 같은
전화 통신 채널용 PCM 오디오를 합성합니다.

OpenClaw는 Inworld의 스트리밍 TTS 엔드포인트에 게시하고, 반환된
base64 오디오 청크를 단일 버퍼로 연결한 다음, 그 결과를 표준 답장 오디오
파이프라인에 전달합니다.

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

## Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작합니다.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart
```

## 시작하기

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

    ```
    INWORLD_API_KEY=<base64-credential-from-dashboard>
    ```
  </Step>

  <Step title="messages.tts에서 Inworld 선택">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      messages: {
        tts: {
          auto: "always",
          provider: "inworld",
          providers: {
            inworld: {
              speakerVoiceId: "Sarah",
              modelId: "inworld-tts-1.5-max",
            },
          },
        },
      },
    }
    ```
  </Step>

  <Step title="메시지 보내기">
    연결된 채널을 통해 답장을 보냅니다. OpenClaw는 Inworld로 오디오를
    합성하고 MP3로 전달합니다(또는 채널이 음성 메모를 기대하는 경우
    OGG\_OPUS로 전달).
  </Step>
</Steps>

## 구성 옵션

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

## 참고

<AccordionGroup>
  <Accordion title="인증">
    Inworld는 단일 Base64 인코딩 자격 증명 문자열로 HTTP Basic 인증을
    사용합니다. Inworld 대시보드에서 그대로 복사하세요. 제공자는 추가
    인코딩 없이 이를 `Authorization: Basic <apiKey>`로 보내므로 직접
    Base64로 인코딩하지 말고 bearer 스타일 토큰을 전달하지 마세요.
    동일한 주의 사항은 [TTS 인증 참고](/ko/tools/tts#inworld-primary)를
    참조하세요.
  </Accordion>

  <Accordion title="모델">
    지원되는 모델 ID: `inworld-tts-1.5-max`(기본값),
    `inworld-tts-1.5-mini`, `inworld-tts-1-max`, `inworld-tts-1`.
  </Accordion>

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

  <Accordion title="사용자 지정 엔드포인트">
    `messages.tts.providers.inworld.baseUrl`로 API 호스트를 재정의합니다.
    요청을 보내기 전에 끝의 슬래시는 제거됩니다.
  </Accordion>
</AccordionGroup>

## 관련 항목

<CardGroup cols={2}>
  <Card title="텍스트 음성 변환" href="/ko/tools/tts" icon="waveform-lines">
    TTS 개요, 제공자, `messages.tts` 구성입니다.
  </Card>

  <Card title="구성" href="/ko/gateway/configuration" icon="gear">
    `messages.tts` 설정을 포함한 전체 구성 참조입니다.
  </Card>

  <Card title="제공자" href="/ko/providers" icon="grid">
    지원되는 모든 OpenClaw 제공자입니다.
  </Card>

  <Card title="문제 해결" href="/ko/help/troubleshooting" icon="wrench">
    일반적인 문제와 디버깅 단계입니다.
  </Card>
</CardGroup>