Pular para o conteúdo principal
Inworld é um provedor de texto para fala (TTS) por streaming. No OpenClaw, ele sintetiza áudio de resposta de saída (MP3 por padrão, OGG_OPUS para notas de voz) e áudio PCM para canais de telefonia, como Voice Call. O OpenClaw envia requisições ao endpoint de TTS por streaming da Inworld, concatena os blocos de áudio em base64 retornados em um único buffer e entrega o resultado ao pipeline padrão de áudio de resposta.
PropriedadeValor
ID do provedorinworld
Pluginpacote externo oficial
ContratospeechProviders (somente TTS)
Variável de ambiente de autenticaçãoINWORLD_API_KEY (HTTP Basic, credencial do painel em Base64)
URL basehttps://api.inworld.ai
Voz padrãoSarah
Modelo padrãoinworld-tts-1.5-max
SaídaMP3 (padrão), OGG_OPUS (notas de voz), PCM 22050 Hz (telefonia)
Siteinworld.ai
Documentaçãodocs.inworld.ai/tts/tts

​
Instalar Plugin

Instale o Plugin oficial e reinicie o Gateway: 
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

​
Primeiros passos

1

Defina sua chave de API

Copie a credencial do seu 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 em Base64 novamente nem o converta em um token bearer.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

Selecione Inworld em messages.tts

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

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 nota de voz).

​
Opções de configuração

OpçãoCaminhoDescrição
apiKeymessages.tts.providers.inworld.apiKeyCredencial do painel em Base64. Usa INWORLD_API_KEY como fallback.
baseUrlmessages.tts.providers.inworld.baseUrlSubstitui a URL base da API da Inworld (padrão https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdIdentificador da voz (padrão Sarah).
modelIdmessages.tts.providers.inworld.modelIdID do modelo de TTS (padrão inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureTemperatura de amostragem 0..2 (opcional).

​
Observações

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 em Base64 você mesmo e não passe um token no estilo bearer. Consulte observações de autenticação de TTS para o mesmo aviso.
IDs de modelo compatíveis: inworld-tts-1.5-max (padrão), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
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.
Substitua o host da API com messages.tts.providers.inworld.baseUrl. Barras finais são removidas antes do envio das requisições.

​
Relacionados

Texto para fala

Visão geral de TTS, provedores e configuração de messages.tts.

Configuração

Referência completa de configuração, incluindo definições de messages.tts.

Provedores

Todos os provedores compatíveis do OpenClaw.

Solução de problemas

Problemas comuns e etapas de depuração.