Giọng nói Azure

Azure Speech là nhà cung cấp chuyển văn bản thành giọng nói Azure AI Speech được tích hợp sẵn. OpenClaw gọi trực tiếp API REST của Azure Speech bằng SSML, tổng hợp MP3 cho các phản hồi tiêu chuẩn, Ogg/Opus gốc cho tin nhắn thoại và mulaw 8 kHz cho các kênh điện thoại như Cuộc gọi thoại. Yêu cầu gửi định dạng đầu ra do nhà cung cấp sở hữu qua tiêu đề X-Microsoft-OutputFormat.

Chi tiết	Giá trị
ID nhà cung cấp	azure-speech (bí danh: azure)
Trang web	Azure AI Speech
Tài liệu	Chuyển văn bản thành giọng nói qua Speech REST
Xác thực	AZURE_SPEECH_KEY cùng với AZURE_SPEECH_REGION
Giọng nói mặc định	en-US-JennyNeural
Tệp đầu ra mặc định	audio-24khz-48kbitrate-mono-mp3
Tệp tin nhắn thoại mặc định	ogg-24khz-16bit-mono-opus

​

Bắt đầu

1. Tạo tài nguyên Azure Speech

   Trong cổng thông tin Azure, hãy tạo một tài nguyên Speech. Sao chép KEY 1 từ Resource Management > Keys and Endpoint và sao chép vị trí tài nguyên, chẳng hạn như eastus.

   AZURE_SPEECH_KEY=<speech-resource-key>
   AZURE_SPEECH_REGION=eastus
   
2. Chọn Azure Speech trong messages.tts

   {
     messages: {
       tts: {
         auto: "always",
         provider: "azure-speech",
         providers: {
           "azure-speech": {
             voice: "en-US-JennyNeural",
             lang: "en-US",
           },
         },
       },
     },
   }
   
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 Azure Speech và phân phối MP3 cho âm thanh tiêu chuẩn 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ất cả tùy chọn nằm trong messages.tts.providers["azure-speech"].

Tùy chọn	Mô tả
apiKey	Khóa tài nguyên Azure Speech. Dự phòng bằng AZURE_SPEECH_KEY, AZURE_SPEECH_API_KEY hoặc SPEECH_KEY.
region	Khu vực tài nguyên Azure Speech. Dự phòng bằng AZURE_SPEECH_REGION hoặc SPEECH_REGION.
endpoint	Ghi đè điểm cuối Azure Speech tùy chọn. Dự phòng bằng AZURE_SPEECH_ENDPOINT đáng tin cậy.
baseUrl	Ghi đè URL cơ sở Azure Speech tùy chọn.
voice	ShortName của giọng nói Azure (mặc định en-US-JennyNeural). Bí danh cũ: voiceId.
lang	Mã ngôn ngữ SSML (mặc định en-US).
outputFormat	Định dạng đầu ra tệp âm thanh (mặc định audio-24khz-48kbitrate-mono-mp3).
voiceNoteOutputFormat	Định dạng đầu ra tin nhắn thoại (mặc định ogg-24khz-16bit-mono-opus).
timeoutMs	Ghi đè thời gian chờ yêu cầu, tính bằng mili giây. Dự phòng bằng messages.tts.timeoutMs toàn cục.

Nhà cung cấp được coi là đã cấu hình sau khi đặt apiKey cùng với một trong region, endpoint hoặc baseUrl. Các biến môi trường chỉ được kiểm tra để dự phòng cho những khóa cấu hình chưa được đặt. Các tệp .env trong không gian làm việc không thể đặt AZURE_SPEECH_ENDPOINT; hãy sử dụng môi trường tiến trình, dotenv của môi trường chạy toàn cục hoặc cấu hình tường minh để định tuyến điểm cuối.

​

Ghi chú

Xác thực

Azure Speech sử dụng khóa tài nguyên Speech, không phải khóa Azure OpenAI. Khóa được gửi dưới dạng Ocp-Apim-Subscription-Key; OpenClaw suy ra https://<region>.tts.speech.microsoft.com từ region trừ khi bạn cung cấp endpoint hoặc baseUrl.

Tên giọng nói

Sử dụng giá trị ShortName của giọng nói Azure Speech, ví dụ en-US-JennyNeural. Nhà cung cấp tích hợp sẵn có thể liệt kê các giọng nói thông qua cùng tài nguyên Speech và lọc bỏ những giọng nói được đánh dấu là không còn được khuyến nghị, đã ngừng cung cấp hoặc bị vô hiệu hóa.

Đầu ra âm thanh

Azure chấp nhận các định dạng đầu ra như audio-24khz-48kbitrate-mono-mp3, ogg-24khz-16bit-mono-opus và riff-24khz-16bit-mono-pcm. OpenClaw yêu cầu Ogg/Opus cho các đích voice-note để các kênh có thể gửi bong bóng thoại gốc mà không cần chuyển đổi thêm từ MP3, đồng thời bắt buộc raw-8khz-8bit-mono-mulaw cho các đích điện thoại.

Bí danh

azure được chấp nhận làm bí danh nhà cung cấp cho cấu hình hiện có, nhưng cấu hình mới nên sử dụng azure-speech để tránh nhầm lẫn với các nhà cung cấp mô hình Azure OpenAI.

​

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 chiếu cấu hình đầy đủ, bao gồm các thiết lập messages.tts.

Nhà cung cấp

Tất cả nhà cung cấp OpenClaw được tích hợp sẵn.

Khắc phục sự cố

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