> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Deepgram

Deepgram هي واجهة API لتحويل الكلام إلى نص. وفي OpenClaw تُستخدم لنسخ
الصوت/الملاحظات الصوتية الواردة عبر `tools.media.audio`، وللنسخ المتدفق في Voice Call
عبر `plugins.entries.voice-call.config.streaming`.

في النسخ الدفعي، يرفع OpenClaw ملف الصوت كاملًا إلى Deepgram
ويحقن النص المنسوخ في مسار الرد (`{{Transcript}}` +
كتلة `[Audio]`). أما في النسخ المتدفق لـ Voice Call، فيمرّر OpenClaw
إطارات G.711 u-law الحية عبر نقطة نهاية WebSocket ‏`listen` الخاصة بـ Deepgram
ويصدر نصوصًا جزئية أو نهائية عندما تعيدها Deepgram.

| التفصيل           | القيمة                                                     |
| ----------------- | ---------------------------------------------------------- |
| الموقع            | [deepgram.com](https://deepgram.com)                       |
| المستندات         | [developers.deepgram.com](https://developers.deepgram.com) |
| المصادقة          | `DEEPGRAM_API_KEY`                                         |
| النموذج الافتراضي | `nova-3`                                                   |

## البدء

<Steps>
  <Step title="عيّن مفتاح API الخاص بك">
    أضف مفتاح Deepgram API إلى البيئة:

    ```
    DEEPGRAM_API_KEY=dg_...
    ```
  </Step>

  <Step title="فعّل موفّر الصوت">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      tools: {
        media: {
          audio: {
            enabled: true,
            models: [{ provider: "deepgram", model: "nova-3" }],
          },
        },
      },
    }
    ```
  </Step>

  <Step title="أرسل ملاحظة صوتية">
    أرسل رسالة صوتية عبر أي قناة متصلة. سيقوم OpenClaw بنسخها
    عبر Deepgram وحقن النص في مسار الرد.
  </Step>
</Steps>

## خيارات التهيئة

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

<Tabs>
  <Tab title="مع تلميح اللغة">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      tools: {
        media: {
          audio: {
            enabled: true,
            models: [{ provider: "deepgram", model: "nova-3", language: "en" }],
          },
        },
      },
    }
    ```
  </Tab>

  <Tab title="مع خيارات Deepgram">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      tools: {
        media: {
          audio: {
            enabled: true,
            providerOptions: {
              deepgram: {
                detect_language: true,
                punctuate: true,
                smart_format: true,
              },
            },
            models: [{ provider: "deepgram", model: "nova-3" }],
          },
        },
      },
    }
    ```
  </Tab>
</Tabs>

## النسخ المتدفق في Voice Call

تسجّل Plugin المجمّعة `deepgram` أيضًا موفّر نسخ فوري
لـ Plugin الخاصة بـ Voice Call.

| الإعداد          | مسار التهيئة                                                            | الافتراضي                   |
| ---------------- | ----------------------------------------------------------------------- | --------------------------- |
| مفتاح 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`                      |
| Endpointing      | `...deepgram.endpointingMs`                                             | `800`                       |
| النتائج المرحلية | `...deepgram.interimResults`                                            | `true`                      |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "deepgram",
            providers: {
              deepgram: {
                apiKey: "${DEEPGRAM_API_KEY}",
                model: "nova-3",
                endpointingMs: 800,
                language: "en-US",
              },
            },
          },
        },
      },
    },
  },
}
```

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

## ملاحظات

<AccordionGroup>
  <Accordion title="المصادقة">
    تتبع المصادقة ترتيب auth القياسي الخاص بالموفّر. ويُعد `DEEPGRAM_API_KEY`
    أبسط مسار.
  </Accordion>

  <Accordion title="Proxy ونقاط النهاية المخصصة">
    تجاوز نقاط النهاية أو الرؤوس باستخدام `tools.media.audio.baseUrl` و
    `tools.media.audio.headers` عند استخدام proxy.
  </Accordion>

  <Accordion title="سلوك الإخراج">
    يتبع الإخراج قواعد الصوت نفسها كما في الموفّرين الآخرين (حدود الحجم، والمهلات،
    وحقن النص المنسوخ).
  </Accordion>
</AccordionGroup>

## ذو صلة

<CardGroup cols={2}>
  <Card title="أدوات الوسائط" href="/ar/tools/media-overview" icon="photo-film">
    نظرة عامة على خط معالجة الصوت والصور والفيديو.
  </Card>

  <Card title="التهيئة" href="/ar/gateway/configuration" icon="gear">
    مرجع التهيئة الكامل بما في ذلك إعدادات أداة الوسائط.
  </Card>

  <Card title="استكشاف الأخطاء وإصلاحها" href="/ar/help/troubleshooting" icon="wrench">
    المشكلات الشائعة وخطوات تصحيح الأخطاء.
  </Card>

  <Card title="الأسئلة الشائعة" href="/ar/help/faq" icon="circle-question">
    الأسئلة المتكررة حول إعداد OpenClaw.
  </Card>
</CardGroup>