Saltar al contenido principal
Inworld es un proveedor de texto a voz (TTS) por streaming. En OpenClaw sintetiza audio de respuestas salientes (MP3 de forma predeterminada, OGG_OPUS para notas de voz) y audio PCM sin procesar para canales de telefonía como Llamada de voz. OpenClaw publica en el endpoint de TTS por streaming de Inworld, concatena los fragmentos de audio base64 devueltos en un único búfer y entrega el resultado al flujo estándar de audio de respuesta.
PropiedadValor
Id. de proveedorinworld
Pluginpaquete externo oficial (@openclaw/inworld-speech)
ContratospeechProviders (solo TTS)
Variable de entorno de autenticaciónINWORLD_API_KEY (HTTP Basic, credencial del panel en Base64)
URL basehttps://api.inworld.ai
Voz predeterminadaSarah
Modelo predeterminadoinworld-tts-1.5-max
SalidaMP3 (predeterminado), OGG_OPUS (notas de voz), PCM 22050 Hz (telefonía)
Sitio webinworld.ai
Documentacióndocs.inworld.ai/tts/tts

​
Instalar Plugin

openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

​
Primeros pasos

1

Configura tu clave de API

Copia la credencial desde tu panel de Inworld (Workspace > API Keys) y configúrala como una variable de entorno. El valor se envía literalmente como la credencial de HTTP Basic, así que no vuelvas a codificarlo en Base64 ni lo conviertas en un token de portador.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

Selecciona Inworld en messages.tts

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

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 (u OGG_OPUS cuando el canal espera una nota de voz).

​
Opciones de configuración

OpciónRutaDescripción
apiKeymessages.tts.providers.inworld.apiKeyCredencial del panel en Base64. Recurre a INWORLD_API_KEY.
baseUrlmessages.tts.providers.inworld.baseUrlAnula la URL base de la API de Inworld (predeterminada https://api.inworld.ai).
voiceIdmessages.tts.providers.inworld.voiceIdIdentificador de voz (predeterminado Sarah). Alias heredado: speakerVoiceId.
modelIdmessages.tts.providers.inworld.modelIdId. del modelo TTS (predeterminado inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureTemperatura de muestreo, de 0 (exclusivo) a 2 (opcional).

​
Notas

Inworld usa autenticación HTTP Basic con una única cadena de credencial 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, así que no la codifiques tú mismo en Base64 y no pases un token con estilo de portador. Consulta las notas de autenticación de TTS para ver el mismo aviso.
Ids. de modelos admitidos: inworld-tts-1.5-max (predeterminado), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
Las respuestas usan 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 usa PCM sin procesar a 22050 Hz para alimentar el puente de telefonía.
Anula el host de la API con messages.tts.providers.inworld.baseUrl. Las barras finales se eliminan antes de enviar las solicitudes.

​
Relacionado

Texto a voz

Vista general de TTS, proveedores y configuración de messages.tts.

Configuración

Referencia de configuración completa, incluidos los ajustes de messages.tts.

Proveedores

Todos los proveedores de OpenClaw admitidos.

Solución de problemas

Problemas comunes y pasos de depuración.