Azure Speech - OpenClaw

Azure Speech to dostawca zamiany tekstu na mowę Azure AI Speech. W OpenClaw syntetyzuje dźwięk odpowiedzi wychodzących domyślnie jako MP3, natywne Ogg/Opus dla notatek głosowych oraz dźwięk mulaw 8 kHz dla kanałów telefonicznych, takich jak połączenie głosowe. OpenClaw używa bezpośrednio Azure Speech REST API z SSML i wysyła format wyjściowy należący do dostawcy przez X-Microsoft-OutputFormat.

Szczegół	Wartość
Witryna	Azure AI Speech
Dokumentacja	Speech REST text-to-speech
Uwierzytelnianie	`AZURE_SPEECH_KEY` plus `AZURE_SPEECH_REGION`
Domyślny głos	`en-US-JennyNeural`
Domyślne wyjście pliku	`audio-24khz-48kbitrate-mono-mp3`
Domyślny plik notatki głosowej	`ogg-24khz-16bit-mono-opus`

Pierwsze kroki

Create an Azure Speech resource

W portalu Azure utwórz zasób Speech. Skopiuj KEY 1 z Resource Management > Keys and Endpoint oraz skopiuj lokalizację zasobu, taką jak eastus.

AZURE_SPEECH_KEY=<speech-resource-key>
AZURE_SPEECH_REGION=eastus

Select Azure Speech in messages.tts

{
  messages: {
    tts: {
      auto: "always",
      provider: "azure-speech",
      providers: {
        "azure-speech": {
          speakerVoice: "en-US-JennyNeural",
          lang: "en-US",
        },
      },
    },
  },
}

Send a message

Wyślij odpowiedź przez dowolny połączony kanał. OpenClaw syntetyzuje dźwięk za pomocą Azure Speech i dostarcza MP3 dla standardowego dźwięku albo Ogg/Opus, gdy kanał oczekuje notatki głosowej.

Opcje konfiguracji

Opcja	Ścieżka	Opis
`apiKey`	`messages.tts.providers.azure-speech.apiKey`	Klucz zasobu Azure Speech. Wraca do `AZURE_SPEECH_KEY`, `AZURE_SPEECH_API_KEY` lub `SPEECH_KEY`.
`region`	`messages.tts.providers.azure-speech.region`	Region zasobu Azure Speech. Wraca do `AZURE_SPEECH_REGION` lub `SPEECH_REGION`.
`endpoint`	`messages.tts.providers.azure-speech.endpoint`	Opcjonalne zastąpienie punktu końcowego/bazowego URL Azure Speech.
`baseUrl`	`messages.tts.providers.azure-speech.baseUrl`	Opcjonalne zastąpienie bazowego URL Azure Speech.
`speakerVoice`	`messages.tts.providers.azure-speech.speakerVoice`	`ShortName` głosu Azure (domyślnie `en-US-JennyNeural`). Starszy alias: `voice`.
`lang`	`messages.tts.providers.azure-speech.lang`	Kod języka SSML (domyślnie `en-US`).
`outputFormat`	`messages.tts.providers.azure-speech.outputFormat`	Format wyjściowy pliku audio (domyślnie `audio-24khz-48kbitrate-mono-mp3`).
`voiceNoteOutputFormat`	`messages.tts.providers.azure-speech.voiceNoteOutputFormat`	Format wyjściowy notatki głosowej (domyślnie `ogg-24khz-16bit-mono-opus`).

Uwagi

Authentication

Azure Speech używa klucza zasobu Speech, a nie klucza Azure OpenAI. Klucz jest wysyłany jako Ocp-Apim-Subscription-Key; OpenClaw wyprowadza https://<region>.tts.speech.microsoft.com z region, chyba że podasz endpoint lub baseUrl.

Voice names

Użyj wartości ShortName głosu Azure Speech, na przykład en-US-JennyNeural. Dołączony dostawca może wyświetlać głosy przez ten sam zasób Speech i odfiltrowuje głosy oznaczone jako przestarzałe lub wycofane.

Audio outputs

Azure akceptuje formaty wyjściowe, takie jak audio-24khz-48kbitrate-mono-mp3, ogg-24khz-16bit-mono-opus i riff-24khz-16bit-mono-pcm. OpenClaw żąda Ogg/Opus dla celów voice-note, aby kanały mogły wysyłać natywne dymki głosowe bez dodatkowej konwersji MP3.

Alias

azure jest akceptowany jako alias dostawcy dla istniejących PR-ów i konfiguracji użytkownika, ale nowa konfiguracja powinna używać azure-speech, aby uniknąć pomylenia z dostawcami modeli Azure OpenAI.

Powiązane

Text-to-speech

Omówienie TTS, dostawcy i konfiguracja messages.tts.

Configuration

Pełna dokumentacja konfiguracji, w tym ustawienia messages.tts.

Providers

Wszyscy dołączeni dostawcy OpenClaw.

Troubleshooting

Typowe problemy i kroki debugowania.

​Pierwsze kroki

​Opcje konfiguracji

​Uwagi

​Powiązane