Providers
Deepgram
Deepgram هي واجهة API لتحويل الكلام إلى نص. يستخدمها OpenClaw لنسخ الصوت الوارد/الملاحظات الصوتية
عبر tools.media.audio، ولتحويل الكلام إلى نص أثناء بث المكالمات الصوتية
عبر plugins.entries.voice-call.config.streaming.
يرفع النسخ الدفعي ملف الصوت كاملًا إلى Deepgram ويدرج
النص المنسوخ في مسار معالجة الرد ({{Transcript}} + كتلة [Audio]).
يمرر بث المكالمات الصوتية إطارات 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):
مع تلميح اللغة
{ tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, },}مع خيارات Deepgram
{ tools: { media: { audio: { enabled: true, providerOptions: { deepgram: { detect_language: true, punctuate: true, smart_format: true, }, }, models: [{ provider: "deepgram", model: "nova-3" }], }, }, },}تحويل الكلام إلى نص أثناء بث المكالمات الصوتية
يسجّل Plugin deepgram المضمّن أيضًا موفّرًا للنسخ في الوقت الفعلي
لـ Plugin المكالمات الصوتية.
| الإعداد | مسار الإعداد | الافتراضي |
|---|---|---|
| مفتاح API | plugins.entries.voice-call.config.streaming.providers.deepgram.apiKey |
يرجع إلى DEEPGRAM_API_KEY |
| النموذج | ...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_API_KEY
المسار الأبسط.
الوكيل ونقاط النهاية المخصصة
تجاوز نقاط النهاية أو الترويسات باستخدام tools.media.audio.baseUrl و
tools.media.audio.headers عند استخدام وكيل.
سلوك المخرجات
تتبع المخرجات قواعد الصوت نفسها المتبعة لدى الموفّرين الآخرين (حدود الحجم، والمهلات، وإدراج النص المنسوخ).