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
Deepgram seçenekleriyle

{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "deepgram", model: "nova-3", language: "en" }],
      },
    },
  },
}

{
  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.

Sesli Arama, telefon sesini 8 kHz G.711 u-law olarak alır. Deepgram akış sağlayıcısının varsayılanları encoding: "mulaw" ve sampleRate: 8000 olduğundan Twilio medya kareleri doğrudan iletilebilir.

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).

İlgili

Medya araçları

Ses, görüntü ve video işleme hattına genel bakış.

Yapılandırma

Medya aracı ayarları dâhil tam yapılandırma başvurusu.

Sorun giderme

Yaygın sorunlar ve hata ayıklama adımları.

SSS

OpenClaw kurulumu hakkında sıkça sorulan sorular.

Overview

Concepts and configuration

Providers

Başlarken

Yapılandırma seçenekleri

Sesli Arama akış STT’si

Notlar

İlgili

Medya araçları

Yapılandırma

Sorun giderme

SSS

​Başlarken

​Yapılandırma seçenekleri

​Sesli Arama akış STT’si

​Notlar

​İlgili

Medya araçları

Yapılandırma

Sorun giderme

SSS

Başlarken

Yapılandırma seçenekleri

Sesli Arama akış STT’si

Notlar

İlgili