Providers

Inworld

Inworld é um provedor de conversão de texto em fala (TTS) por streaming. No OpenClaw, ele sintetiza o áudio de respostas de saída (MP3 por padrão, OGG_OPUS para mensagens de voz) e áudio PCM bruto para canais de telefonia, como Voice Call.

O OpenClaw envia solicitações ao endpoint de TTS por streaming da Inworld, concatena os blocos de áudio em base64 retornados em um único buffer e encaminha o resultado ao pipeline padrão de áudio de resposta.

Propriedade	Valor
ID do provedor	`inworld`
Plugin	pacote externo oficial (`@openclaw/inworld-speech`)
Contrato	`speechProviders` (somente TTS)
Var. de amb. de autenticação	`INWORLD_API_KEY` (HTTP Basic, credencial Base64 do painel)
URL base	`https://api.inworld.ai`
Voz padrão	`Sarah`
Modelo padrão	`inworld-tts-1.5-max`
Saída	MP3 (padrão), OGG_OPUS (mensagens de voz), PCM 22050 Hz (telefonia)
Site	inworld.ai
Documentação	docs.inworld.ai/tts/tts

Instalar o plugin

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Primeiros passos

Defina sua chave de API

Copie a credencial do painel da Inworld (Workspace > API Keys) e defina-a como uma variável de ambiente. O valor é enviado literalmente como a credencial HTTP Basic; portanto, não o codifique novamente em Base64 nem o converta em um token bearer.

bash

INWORLD_API_KEY=<credencial-base64-do-painel>

Selecione a Inworld em messages.tts

json5

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

Envie uma mensagem

Envie uma resposta por qualquer canal conectado. O OpenClaw sintetiza o áudio com a Inworld e o entrega como MP3 (ou OGG_OPUS quando o canal espera uma mensagem de voz).

Opções de configuração

Opção	Caminho	Descrição
`apiKey`	`messages.tts.providers.inworld.apiKey`	Credencial Base64 do painel. Usa `INWORLD_API_KEY` como alternativa.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Substitui a URL base da API da Inworld (padrão: `https://api.inworld.ai`).
`voiceId`	`messages.tts.providers.inworld.voiceId`	Identificador da voz (padrão: `Sarah`). Alias legado: `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	ID do modelo de TTS (padrão: `inworld-tts-1.5-max`).
`temperature`	`messages.tts.providers.inworld.temperature`	Temperatura de amostragem, de `0` (exclusivo) a `2` (opcional).

Observações

Autenticação

A Inworld usa autenticação HTTP Basic com uma única string de credencial codificada em Base64. Copie-a literalmente do painel da Inworld. O provedor a envia como Authorization: Basic <apiKey> sem nenhuma codificação adicional; portanto, não a codifique você mesmo em Base64 nem forneça um token no formato bearer. Consulte as observações sobre autenticação de TTS para ver o mesmo aviso.

Modelos

IDs de modelos compatíveis: inworld-tts-1.5-max (padrão), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Saídas de áudio

As respostas usam MP3 por padrão. Quando o destino do canal é voice-note, o OpenClaw solicita OGG_OPUS à Inworld para que o áudio seja reproduzido como um balão de voz nativo. A síntese para telefonia usa PCM bruto a 22050 Hz para alimentar a ponte de telefonia.

Endpoints personalizados

Substitua o host da API com messages.tts.providers.inworld.baseUrl. As barras finais são removidas antes do envio das solicitações.