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_API_KEY=dg_...

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

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

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

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

{  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 المشوهة والمخططات الأخرى أثناء إعداد الجلسة.

ملاحظات

ذو صلة