Chuyển đến nội dung chính
Inworld là nhà cung cấp chuyển văn bản thành giọng nói (TTS) phát trực tuyến. Trong OpenClaw, nó tổng hợp âm thanh phản hồi gửi đi (mặc định là MP3, OGG_OPUS cho ghi chú thoại) và âm thanh PCM cho các kênh điện thoại như Cuộc gọi thoại. OpenClaw gửi yêu cầu đến endpoint TTS phát trực tuyến của Inworld, nối các đoạn âm thanh base64 được trả về thành một bộ đệm duy nhất, rồi chuyển kết quả vào pipeline âm thanh phản hồi tiêu chuẩn.
Thuộc tínhGiá trị
ID nhà cung cấpinworld
Plugingói bên ngoài chính thức
Hợp đồngspeechProviders (chỉ TTS)
Biến env xác thựcINWORLD_API_KEY (HTTP Basic, thông tin xác thực dashboard Base64)
URL cơ sởhttps://api.inworld.ai
Giọng mặc địnhSarah
Mô hình mặc địnhinworld-tts-1.5-max
Đầu raMP3 (mặc định), OGG_OPUS (ghi chú thoại), PCM 22050 Hz (điện thoại)
Websiteinworld.ai
Tài liệudocs.inworld.ai/tts/tts

​
Cài đặt plugin

Cài đặt plugin chính thức, rồi khởi động lại Gateway: 
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

​
Bắt đầu

1

Set your API key

Sao chép thông tin xác thực từ dashboard Inworld của bạn (Workspace > API Keys) và đặt nó làm biến env. Giá trị được gửi nguyên văn dưới dạng thông tin xác thực HTTP Basic, vì vậy đừng mã hóa Base64 lại hoặc chuyển nó thành bearer token.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

Select Inworld in messages.tts

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

Send a message

Gửi một phản hồi qua bất kỳ kênh nào đã kết nối. OpenClaw tổng hợp âm thanh bằng Inworld và phân phối dưới dạng MP3 (hoặc OGG_OPUS khi kênh mong đợi một ghi chú thoại).

​
Tùy chọn cấu hình

Tùy chọnĐường dẫnMô tả
apiKeymessages.tts.providers.inworld.apiKeyThông tin xác thực dashboard Base64. Dự phòng sang INWORLD_API_KEY.
baseUrlmessages.tts.providers.inworld.baseUrlGhi đè URL cơ sở API Inworld (mặc định https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdMã định danh giọng nói (mặc định Sarah).
modelIdmessages.tts.providers.inworld.modelIdID mô hình TTS (mặc định inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureNhiệt độ lấy mẫu 0..2 (tùy chọn).

​
Ghi chú

Inworld dùng xác thực HTTP Basic với một chuỗi thông tin xác thực được mã hóa Base64 duy nhất. Sao chép nguyên văn từ dashboard Inworld. Nhà cung cấp gửi nó dưới dạng Authorization: Basic <apiKey> mà không mã hóa thêm, vì vậy đừng tự mã hóa Base64 và đừng truyền token kiểu bearer. Xem ghi chú xác thực TTS để biết lưu ý tương tự.
Các ID mô hình được hỗ trợ: inworld-tts-1.5-max (mặc định), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
Phản hồi mặc định dùng MP3. Khi mục tiêu kênh là voice-note, OpenClaw yêu cầu Inworld dùng OGG_OPUS để âm thanh phát như một bong bóng thoại gốc. Tổng hợp cho điện thoại dùng PCM thô ở 22050 Hz để cấp cho cầu nối điện thoại.
Ghi đè host API bằng messages.tts.providers.inworld.baseUrl. Dấu gạch chéo ở cuối sẽ bị loại bỏ trước khi gửi yêu cầu.

​
Liên quan

Text-to-speech

Tổng quan về TTS, nhà cung cấp và cấu hình messages.tts.

Configuration

Tham chiếu cấu hình đầy đủ, bao gồm các thiết lập messages.tts.

Providers

Tất cả nhà cung cấp OpenClaw được hỗ trợ.

Troubleshooting

Các sự cố thường gặp và bước gỡ lỗi.