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 Voice Call akışlı STT
için kullanır.
Toplu transkripsiyon, ses dosyasının tamamını Deepgram'a yükler ve
transkripti yanıt işlem hattına ({{Transcript}} + [Audio] bloğu) ekler.
Voice Call akışı, canlı G.711 u-law karelerini Deepgram'ın WebSocket listen
uç noktası üzerinden iletir ve Deepgram döndürdükçe kısmi/nihai transkriptleri
yayar.
| 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, mesajı 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.audio.models[].model |
Deepgram model kimliği (varsayılan: nova-3) |
language |
tools.media.audio.models[].language |
Dil ipucu (isteğe bağlı) |
providerOptions.deepgram, ek sorgu parametrelerini doğrudan Deepgram
/listen isteğine birleştirir; dolayısıyla Deepgram tarafından desteklenen
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" }], }, }, },}Voice Call akışlı STT
Paketle birlikte gelen deepgram Plugin'i, Voice Call 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 |
| Model | ...deepgram.model |
nova-3 |
| Dil | ...deepgram.language |
(ayarlanmamış) |
| Kodlama | ...deepgram.encoding |
mulaw |
| Örnekleme hızı | ...deepgram.sampleRate |
8000 |
| Uç nokta belirleme | ...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", }, }, }, }, }, }, },}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 uç noktaları veya üstbilgileri tools.media.audio.baseUrl
ve tools.media.audio.headers ile 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).