Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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, nhà cung cấp này 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ư Voice Call. 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.
Chi tiếtGiá trị
Trang webinworld.ai
Tài liệudocs.inworld.ai/tts/tts
Xác thựcINWORLD_API_KEY (HTTP Basic, thông tin xác thực Base64 từ dashboard)
Giọng mặc địnhSarah
Mô hình mặc địnhinworld-tts-1.5-max

​
Bắt đầu

1

Thiết lập API key của bạn

Sao chép thông tin xác thực từ dashboard Inworld của bạn (Workspace > API Keys) và đặt làm biến môi trường. Giá trị này được gửi nguyên văn dưới dạng thông tin xác thực HTTP Basic, vì vậy không mã hóa Base64 lại hoặc chuyển đổi thành bearer token.
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 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 yêu cầu 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 Base64 từ dashboard. Dùng dự phòng INWORLD_API_KEY.
baseUrlmessages.tts.providers.inworld.baseUrlGhi đè URL cơ sở của API Inworld (mặc định https://api.inworld.ai).
voiceIdmessages.tts.providers.inworld.voiceIdMã đị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 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 Base64 và không truyền token kiểu bearer. Xem ghi chú xác thực TTS để biết cùng lưu ý này.
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ư 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ẽ được loại bỏ trước khi gửi yêu cầu.

​
Liên quan

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

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

Cấu hình

Tài liệu tham chiếu cấu hình đầy đủ, bao gồm cài đặt messages.tts.

Nhà cung cấp

Tất cả nhà cung cấp OpenClaw được đóng gói sẵn.

Khắc phục sự cố

Các vấn đề thường gặp và các bước gỡ lỗi.