Providers
Deepgram
Deepgram bir konuşmayı metne dönüştürme API'sidir. OpenClaw bunu tools.media.audio üzerinden gelen ses/sesli not
transkripsiyonu ve plugins.entries.voice-call.config.streaming üzerinden Sesli Arama akış STT'si
için kullanır.
Toplu transkripsiyon, ses dosyasının tamamını Deepgram'a yükler ve
transkripti yanıt işlem hattına ekler ({{Transcript}} + [Audio] bloğu).
Sesli Arama akışı, canlı G.711 u-law karelerini Deepgram'ın
WebSocket listen uç noktası üzerinden iletir ve Deepgram bunları
döndürdükçe kısmi/nihai transkriptleri yayımlar.
| Ayrıntı | Değer |
|---|---|
| Web sitesi | deepgram.com |
| Belgeler | developers.deepgram.com |
| Kimlik doğrulama | DEEPGRAM_API_KEY |
| Varsayılan model | nova-3 |
Başlarken
API anahtarınızı ayarlayın
DEEPGRAM_API_KEY=dg_...Ses sağlayıcısını etkinleştirin
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}Sesli not gönderin
Bağlı herhangi bir kanal üzerinden sesli mesaj gönderin. OpenClaw bunu Deepgram aracılığıyla metne dönüştürür ve transkripti yanıt işlem hattına ekler.
Yapılandırma seçenekleri
| Seçenek | Yol | Açıklama |
|---|---|---|
model |
tools.media.models[].model |
Deepgram model kimliği (varsayılan: nova-3) |
language |
tools.media.models[].language |
Dil ipucu (isteğe bağlı) |
providerOptions.deepgram, ek sorgu parametrelerini doğrudan
Deepgram /listen isteğiyle birleştirir; dolayısıyla Deepgram'ın desteklediği tüm parametre adları kullanılabilir
(örneğin detect_language, punctuate, smart_format):
Dil ipucuyla
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}Deepgram seçenekleriyle
{ tools: { media: { audio: { enabled: true, providerOptions: { deepgram: { detect_language: true, punctuate: true, smart_format: true, }, }, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}Sesli Arama akış STT'si
Paketle birlikte gelen deepgram Plugin'i, Sesli Arama Plugin'i için
gerçek zamanlı bir transkripsiyon sağlayıcısı da kaydeder.
| Ayar | Yapılandırma yolu | Varsayılan |
|---|---|---|
| API anahtarı | plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey |
DEEPGRAM_API_KEY değerine geri döner |
| Temel URL | ...deepgram.baseUrl |
DEEPGRAM_BASE_URL veya Deepgram'ın genel API'si |
| Model | ...deepgram.model |
nova-3 |
| Dil | ...deepgram.language |
(ayarlanmamış) |
| Kodlama | ...deepgram.encoding |
mulaw |
| Örnekleme hızı | ...deepgram.sampleRate |
8000 |
| Uç noktalama | ...deepgram.endpointingMs |
800 |
| Ara sonuçlar | ...deepgram.interimResults |
true |
{ plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "deepgram", providers: { deepgram: { apiKey: "${DEEPGRAM_API_KEY}", model: "nova-3", endpointingMs: 800, language: "en-US", }, }, }, }, }, }, },}Bir Deepgram özel uç noktası için
baseUrl değerini, temel yollar dâhil ancak /listen hariç olmak üzere uç nokta köküne ayarlayın.
Gerçek zamanlı uç noktalar http://, https://, ws:// ve wss:// kabul eder. HTTP
WS'ye, HTTPS WSS'ye eşlenir ve açık WebSocket şemaları değişmeden kalır.
Hatalı biçimlendirilmiş URL'ler ve diğer şemalar oturum kurulumu sırasında başarısız olur.
Notlar
Kimlik doğrulama
Kimlik doğrulama, standart sağlayıcı kimlik doğrulama sırasını izler. DEEPGRAM_API_KEY
en basit yoldur.
Proxy ve özel uç noktalar
Proxy kullanırken Deepgram tools.media.models[] girdisindeki uç noktaları veya üstbilgileri geçersiz kılın.
Çıktı davranışı
Çıktı, diğer sağlayıcılarla aynı ses kurallarını izler (boyut sınırları, zaman aşımları, transkript ekleme).
