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 pasa el resultado al flujo 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 Base64 del panel)
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 a 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

Configura tu clave de API

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

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

Selecciona Inworld en messages.tts

json5

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

Envía un mensaje

Envía una respuesta a través de cualquier canal conectado. OpenClaw sintetiza el audio con Inworld y lo entrega como MP3 (o como OGG_OPUS cuando el canal espera una nota de voz).

Opciones de configuración

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

Notas

Autenticación

Inworld utiliza autenticación HTTP Basic con una única cadena de credenciales codificada en Base64. Cópiala literalmente desde el panel de Inworld. El proveedor la envía como Authorization: Basic <apiKey> sin ninguna codificación adicional, por lo que no debes codificarla tú mismo en Base64 ni proporcionar un token de tipo portador. Consulta 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 OGG_OPUS a Inworld para que el audio se reproduzca como una burbuja de voz nativa. La síntesis para telefonía utiliza PCM sin procesar a 22050 Hz para alimentar el puente de telefonía.

Endpoints personalizados

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