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

openclaw plugins install @openclaw/inworld-speech
openclaw 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.

INWORLD_API_KEY=<credencial-base64-do-painel>

Selecione a Inworld em messages.tts

{
  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.

Relacionados

Conversão de texto em fala

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

Configuração

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

Provedores

Todos os provedores compatíveis com o OpenClaw.

Solução de problemas

Problemas comuns e etapas de depuração.

Overview

Concepts and configuration

Providers

Instalar o plugin

Primeiros passos

Opções de configuração

Observações

Relacionados

Conversão de texto em fala

Configuração

Provedores

Solução de problemas

​Instalar o plugin

​Primeiros passos

​Opções de configuração

​Observações

​Relacionados

Conversão de texto em fala

Configuração

Provedores

Solução de problemas

Instalar o plugin

Primeiros passos

Opções de configuração

Observações

Relacionados