Providers

Inworld

Inworld es un proveedor de texto a voz (TTS) en streaming. En OpenClaw, sintetiza el audio de las respuestas salientes (MP3 de forma predeterminada, OGG_OPUS para notas de voz) y audio PCM sin procesar para canales de telefonía como Voice Call.

OpenClaw envía solicitudes al endpoint de TTS en streaming de Inworld, concatena los fragmentos de audio en base64 devueltos en un único búfer y entrega el resultado al pipeline estándar de audio de respuesta.

Propiedad	Valor
Id. del proveedor	`inworld`
Plugin	paquete externo oficial (`@openclaw/inworld-speech`)
Contrato	`speechProviders` (solo TTS)
Variable de entorno de autenticación	`INWORLD_API_KEY` (HTTP Basic, credencial del panel en Base64)
URL base	`https://api.inworld.ai`
Voz predeterminada	`Sarah`
Modelo predeterminado	`inworld-tts-1.5-max`
Salida	MP3 (predeterminada), OGG_OPUS (notas de voz), PCM de 22050 Hz (telefonía)
Sitio web	inworld.ai
Documentación	docs.inworld.ai/tts/tts

Instalar el plugin

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Primeros pasos

Establecer la clave de API

Copie la credencial del panel de Inworld (Workspace > API Keys) y establézcala como variable de entorno. El valor se envía literalmente como credencial de HTTP Basic, por lo que no debe volver a codificarlo en Base64 ni convertirlo en un token de portador.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

Seleccionar Inworld en tts

json5

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

Enviar un mensaje

Envíe una respuesta mediante cualquier canal conectado. OpenClaw sintetiza el audio con Inworld y lo entrega como MP3 (u OGG_OPUS cuando el canal espera una nota de voz).

Opciones de configuración

Opción	Ruta	Descripción
`apiKey`	`tts.providers.inworld.apiKey`	Credencial del panel en Base64. Utiliza `INWORLD_API_KEY` como alternativa.
`baseUrl`	`tts.providers.inworld.baseUrl`	Sustituye la URL base de la API de Inworld (valor predeterminado: `https://api.inworld.ai`).
`voiceId`	`tts.providers.inworld.voiceId`	Identificador de voz (valor predeterminado: `Sarah`). Alias heredado: `speakerVoiceId`.
`modelId`	`tts.providers.inworld.modelId`	Id. del modelo de TTS (valor predeterminado: `inworld-tts-1.5-max`).
`temperature`	`tts.providers.inworld.temperature`	Temperatura de muestreo, de `0` (exclusivo) a `2` (opcional).

Notas

Autenticación

Inworld utiliza la autenticación HTTP Basic con una única cadena de credencial codificada en Base64. Cópiela literalmente del panel de Inworld. El proveedor la envía como Authorization: Basic <apiKey> sin ninguna codificación adicional, por lo que no debe codificarla en Base64 ni proporcionar un token de tipo portador. Consulte las notas de autenticación de TTS para ver la misma advertencia.

Modelos

Id. de modelos compatibles: inworld-tts-1.5-max (predeterminado), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Salidas de audio

Las respuestas utilizan MP3 de forma predeterminada. Cuando el destino del canal es voice-note, OpenClaw solicita a Inworld OGG_OPUS para que el audio se reproduzca como una burbuja de voz nativa. La síntesis de telefonía utiliza PCM sin procesar a 22050 Hz para alimentar el puente de telefonía.

Endpoints personalizados

Sustituya el host de la API con tts.providers.inworld.baseUrl. Las barras diagonales finales se eliminan antes de enviar las solicitudes.