Deepgram

Deepgram هي واجهة API لتحويل الكلام إلى نص. يستخدمها OpenClaw لنسخ الصوت الوارد/الملاحظات الصوتية عبر tools.media.audio، ولتحويل الكلام إلى نص المتدفق في Voice Call عبر plugins.entries.voice-call.config.streaming. يرفع النسخ الدفعي ملف الصوت الكامل إلى Deepgram ويُدرج النص المنسوخ في مسار الرد (كتلة {{Transcript}} + [Audio]). يمرر البث في Voice Call إطارات G.711 u-law المباشرة عبر نقطة نهاية WebSocket listen الخاصة بـ Deepgram، ويُصدر النصوص المنسوخة الجزئية/النهائية عند إرجاعها من Deepgram.

التفصيل	القيمة
الموقع الإلكتروني	deepgram.com
الوثائق	developers.deepgram.com
المصادقة	`DEEPGRAM_API_KEY`
النموذج الافتراضي	`nova-3`

بدء الاستخدام

عيّن مفتاح API

DEEPGRAM_API_KEY=dg_...

فعّل موفر الصوت

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

أرسل ملاحظة صوتية

أرسل رسالة صوتية عبر أي قناة متصلة. ينسخها OpenClaw عبر Deepgram ويُدرج النص المنسوخ في مسار الرد.

خيارات الإعداد

الخيار	المسار	الوصف
`model`	`tools.media.audio.models[].model`	معرّف نموذج Deepgram (الافتراضي: `nova-3`)
`language`	`tools.media.audio.models[].language`	تلميح اللغة (اختياري)

يدمج providerOptions.deepgram معاملات الاستعلام الإضافية مباشرةً في طلب Deepgram ‏/listen، لذا يعمل أي اسم معامل تدعمه Deepgram (على سبيل المثال detect_language وpunctuate وsmart_format):

مع تلميح اللغة
مع خيارات Deepgram

{
  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" }],
      },
    },
  },
}

تحويل الكلام إلى نص المتدفق في Voice Call

يسجّل Plugin المضمّن deepgram أيضًا موفر نسخ في الوقت الفعلي لـ Plugin ‏Voice Call.

الإعداد	مسار الإعداد	الافتراضي
مفتاح API	`plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey`	يعود إلى `DEEPGRAM_API_KEY` عند عدم توفره
عنوان URL الأساسي	`...deepgram.baseUrl`	`DEEPGRAM_BASE_URL` أو واجهة API العامة لـ Deepgram
النموذج	`...deepgram.model`	`nova-3`
اللغة	`...deepgram.language`	(غير معيّنة)
الترميز	`...deepgram.encoding`	`mulaw`
معدل أخذ العينات	`...deepgram.sampleRate`	`8000`
تحديد نقطة النهاية	`...deepgram.endpointingMs`	`800`
النتائج المؤقتة	`...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",
              },
            },
          },
        },
      },
    },
  },
}

لاستخدام نقطة نهاية مخصصة لـ Deepgram، عيّن baseUrl إلى جذر نقطة النهاية، بما في ذلك أي مسار أساسي ولكن دون /listen. تقبل نقاط النهاية في الوقت الفعلي http:// وhttps:// وws:// وwss://. يُحوَّل HTTP إلى WS، ويُحوَّل HTTPS إلى WSS، بينما تظل مخططات WebSocket الصريحة دون تغيير. تفشل عناوين URL المشوهة والمخططات الأخرى أثناء إعداد الجلسة.

يستقبل Voice Call صوت الاتصالات الهاتفية بتنسيق G.711 u-law ومعدل 8 kHz. يستخدم موفر البث في Deepgram القيمتين encoding: "mulaw" وsampleRate: 8000 افتراضيًا، لذا يمكن تمرير إطارات وسائط Twilio مباشرةً.

ملاحظات

المصادقة

تتبع المصادقة ترتيب مصادقة الموفر القياسي. يُعد DEEPGRAM_API_KEY المسار الأبسط.

الوكيل ونقاط النهاية المخصصة

تجاوز نقاط النهاية أو الترويسات باستخدام tools.media.audio.baseUrl و tools.media.audio.headers عند استخدام وكيل.

سلوك المخرجات

تتبع المخرجات قواعد الصوت نفسها المتّبعة لدى الموفرين الآخرين (حدود الحجم، والمهلات، وإدراج النص المنسوخ).

ذو صلة

أدوات الوسائط

نظرة عامة على مسار معالجة الصوت والصور والفيديو.

الإعداد

مرجع الإعداد الكامل، بما في ذلك إعدادات أدوات الوسائط.

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة وخطوات تصحيح الأخطاء.

الأسئلة الشائعة

الأسئلة المتكررة حول إعداد OpenClaw.

Overview

Concepts and configuration

Providers

بدء الاستخدام

خيارات الإعداد

تحويل الكلام إلى نص المتدفق في Voice Call

ملاحظات

ذو صلة

أدوات الوسائط

الإعداد

استكشاف الأخطاء وإصلاحها

الأسئلة الشائعة

​بدء الاستخدام

​خيارات الإعداد

​تحويل الكلام إلى نص المتدفق في Voice Call

​ملاحظات

​ذو صلة

أدوات الوسائط

الإعداد

استكشاف الأخطاء وإصلاحها

الأسئلة الشائعة

بدء الاستخدام

خيارات الإعداد

تحويل الكلام إلى نص المتدفق في Voice Call

ملاحظات

ذو صلة