Inworld

Inworld là nhà cung cấp chuyển văn bản thành giọng nói (TTS) dạng phát trực tuyến. Trong OpenClaw, Inworld tổng hợp âm thanh cho câu trả lời gửi đi (MP3 theo mặc định, OGG_OPUS cho tin nhắn thoại) và âm thanh PCM thô cho các kênh điện thoại như Voice Call.

OpenClaw gửi yêu cầu đến điểm cuối 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ả cho quy trình xử lý âm thanh trả lời tiêu chuẩn.

Thuộc tính	Giá trị
Mã nhà cung cấp	inworld
Plugin	gói bên ngoài chính thức (@openclaw/inworld-speech)
Hợp đồng	speechProviders (chỉ TTS)
Biến môi trường xác thực	INWORLD_API_KEY (HTTP Basic, thông tin xác thực Base64 từ bảng điều khiển)
URL cơ sở	https://api.inworld.ai
Giọng nói mặc định	Sarah
Mô hình mặc định	inworld-tts-1.5-max
Đầu ra	MP3 (mặc định), OGG_OPUS (tin nhắn thoại), PCM 22050 Hz (điện thoại)
Trang web	inworld.ai
Tài liệu	docs.inworld.ai/tts/tts

​

Cài đặt Plugin

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

​

Bắt đầu

1. Thiết lập khóa API

   Sao chép thông tin xác thực từ bảng điều khiển Inworld (Workspace > API Keys) và đặt làm biến môi trường. Giá trị được gửi nguyên trạng dưới dạng thông tin xác thực HTTP Basic, vì vậy không mã hóa lại bằng Base64 hoặc chuyển đổi thành mã thông báo bearer.

   INWORLD_API_KEY=<base64-credential-from-dashboard>
   
2. Chọn Inworld trong messages.tts

   {
     messages: {
       tts: {
         auto: "always",
         provider: "inworld",
         providers: {
           inworld: {
             voiceId: "Sarah",
             modelId: "inworld-tts-1.5-max",
           },
         },
       },
     },
   }
   
3. Gửi tin nhắn

   Gửi câu trả lời qua bất kỳ kênh nào đã kết nối. OpenClaw tổng hợp âm thanh bằng Inworld và gửi dưới dạng MP3 (hoặc OGG_OPUS khi kênh yêu cầu tin nhắn thoại).

​

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

Tùy chọn	Đường dẫn	Mô tả
apiKey	messages.tts.providers.inworld.apiKey	Thông tin xác thực Base64 từ bảng điều khiển. Dự phòng bằng INWORLD_API_KEY.
baseUrl	messages.tts.providers.inworld.baseUrl	Ghi đè URL cơ sở của API Inworld (mặc định https://api.inworld.ai).
voiceId	messages.tts.providers.inworld.voiceId	Mã định danh giọng nói (mặc định Sarah). Bí danh cũ: speakerVoiceId.
modelId	messages.tts.providers.inworld.modelId	Mã mô hình TTS (mặc định inworld-tts-1.5-max).
temperature	messages.tts.providers.inworld.temperature	Nhiệt độ lấy mẫu, từ 0 (không bao gồm) đến 2 (tùy chọn).

​

Ghi chú

Xác thực

Inworld sử dụng xác thực HTTP Basic với một chuỗi thông tin xác thực duy nhất được mã hóa Base64. Sao chép nguyên trạng chuỗi này từ bảng điều khiển Inworld. Nhà cung cấp gửi chuỗi dưới dạng Authorization: Basic <apiKey> mà không mã hóa thêm, vì vậy không tự mã hóa lại bằng Base64 và không truyền mã thông báo kiểu bearer. Xem ghi chú xác thực TTS để biết cảnh báo tương tự.

Mô hình

Các mã 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.

Đầu ra âm thanh

Câu trả lời sử dụng MP3 theo mặc định. Khi đích của kênh là voice-note, OpenClaw yêu cầu Inworld cung cấp OGG_OPUS để âm thanh phát dưới dạng bong bóng thoại gốc. Việc tổng hợp cho điện thoại sử dụng PCM thô ở tần số 22050 Hz để cấp dữ liệu cho cầu nối điện thoại.

Điểm cuối tùy chỉnh

Ghi đè máy chủ 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.

​

Nội dung liên quan

Chuyển văn bản thành giọng nói

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

Cấu hình

Tài liệu tham khảo cấu hình đầy đủ, bao gồm các thiết lập messages.tts.

Nhà cung cấp

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

Khắc phục sự cố

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