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

# مكالمة صوتية

# `openclaw voicecall`

`voicecall` هو أمر يوفره Plugin. ولا يظهر إلا عند تثبيت Plugin المكالمات الصوتية وتمكينه.

عندما يكون Gateway قيد التشغيل، تُوجَّه أوامر التشغيل (`call`، `start`، `continue`، `speak`، `dtmf`، `end`، `status`) إلى وقت تشغيل المكالمات الصوتية الخاص بذلك Gateway. وإذا تعذّر الوصول إلى أي Gateway، فإنها تعود إلى وقت تشغيل CLI مستقل.

## الأوامر الفرعية

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw voicecall setup    [--json]
openclaw voicecall smoke    [-t <phone>] [--message <text>] [--mode <m>] [--yes] [--json]
openclaw voicecall call     -m <text> [-t <phone>] [--mode <m>]
openclaw voicecall start    --to <phone> [--message <text>] [--mode <m>]
openclaw voicecall continue --call-id <id> --message <text>
openclaw voicecall speak    --call-id <id> --message <text>
openclaw voicecall dtmf     --call-id <id> --digits <digits>
openclaw voicecall end      --call-id <id>
openclaw voicecall status   [--call-id <id>] [--json]
openclaw voicecall tail     [--file <path>] [--since <n>] [--poll <ms>]
openclaw voicecall latency  [--file <path>] [--last <n>]
openclaw voicecall expose   [--mode <m>] [--path <p>] [--port <port>] [--serve-path <p>]
```

| الأمر الفرعي | الوصف                                                              |
| ------------ | ------------------------------------------------------------------ |
| `setup`      | اعرض فحوص جاهزية المزوّد وWebhook.                                 |
| `smoke`      | شغّل فحوص الجاهزية؛ ولا تُجرِ مكالمة اختبار مباشرة إلا مع `--yes`. |
| `call`       | ابدأ مكالمة صوتية صادرة.                                           |
| `start`      | اسم بديل لـ `call` مع اشتراط `--to` وجعل `--message` اختياريًا.    |
| `continue`   | انطق رسالة وانتظر الاستجابة التالية.                               |
| `speak`      | انطق رسالة دون انتظار استجابة.                                     |
| `dtmf`       | أرسل أرقام DTMF إلى مكالمة نشطة.                                   |
| `end`        | أنهِ مكالمة نشطة.                                                  |
| `status`     | افحص المكالمات النشطة (أو مكالمة واحدة عبر `--call-id`).           |
| `tail`       | تتبّع `calls.jsonl` (مفيد أثناء اختبارات المزوّد).                 |
| `latency`    | لخّص مقاييس زمن انتقال الدور من `calls.jsonl`.                     |
| `expose`     | بدّل إعدادات Tailscale serve/funnel لنقطة نهاية Webhook.           |

## الإعداد والاختبار الأولي

### `setup`

يطبع فحوص جاهزية قابلة للقراءة البشرية افتراضيًا. مرّر `--json` للاستخدام في السكربتات.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw voicecall setup
openclaw voicecall setup --json
```

### `smoke`

يشغّل فحوص الجاهزية نفسها. ولن يجري مكالمة هاتفية حقيقية إلا إذا كان كل من `--to` و`--yes` موجودين.

| العلم              | الافتراضي                         | الوصف                                        |
| ------------------ | --------------------------------- | -------------------------------------------- |
| `-t, --to <phone>` | (لا شيء)                          | رقم الهاتف المطلوب الاتصال به لاختبار مباشر. |
| `--message <text>` | `OpenClaw voice call smoke test.` | الرسالة المراد نطقها أثناء مكالمة الاختبار.  |
| `--mode <mode>`    | `notify`                          | وضع المكالمة: `notify` أو `conversation`.    |
| `--yes`            | `false`                           | إجراء المكالمة الصادرة المباشرة فعليًا.      |
| `--json`           | `false`                           | اطبع JSON قابلًا للقراءة آليًا.              |

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123"        # تشغيل تجريبي
openclaw voicecall smoke --to "+15555550123" --yes  # مكالمة notify مباشرة
```

<Note>
  بالنسبة إلى المزوّدين الخارجيين (`twilio`، `telnyx`، `plivo`)، يتطلب `setup` و`smoke` عنوان Webhook URL عامًا من `publicUrl` أو نفقًا أو تعريضًا عبر Tailscale. يُرفض بديل local loopback أو serve خاص لأن شركات الاتصالات لا يمكنها الوصول إليه.
</Note>

## دورة حياة المكالمة

### `call`

ابدأ مكالمة صوتية صادرة.

| العلم                  | مطلوب | الافتراضي         | الوصف                                                                                   |
| ---------------------- | ----- | ----------------- | --------------------------------------------------------------------------------------- |
| `-m, --message <text>` | نعم   | (لا شيء)          | الرسالة المراد نطقها عند اتصال المكالمة.                                                |
| `-t, --to <phone>`     | لا    | config `toNumber` | رقم هاتف E.164 المطلوب الاتصال به.                                                      |
| `--mode <mode>`        | لا    | `conversation`    | وضع المكالمة: `notify` (إنهاء المكالمة بعد الرسالة) أو `conversation` (إبقاؤها مفتوحة). |

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw voicecall call --to "+15555550123" --message "Hello"
openclaw voicecall call -m "Heads up" --mode notify
```

### `start`

اسم بديل لـ `call` بشكل أعلام افتراضي مختلف.

| العلم              | مطلوب | الافتراضي      | الوصف                                     |
| ------------------ | ----- | -------------- | ----------------------------------------- |
| `--to <phone>`     | نعم   | (لا شيء)       | رقم الهاتف المطلوب الاتصال به.            |
| `--message <text>` | لا    | (لا شيء)       | الرسالة المراد نطقها عند اتصال المكالمة.  |
| `--mode <mode>`    | لا    | `conversation` | وضع المكالمة: `notify` أو `conversation`. |

### `continue`

انطق رسالة وانتظر استجابة.

| العلم              | مطلوب | الوصف                 |
| ------------------ | ----- | --------------------- |
| `--call-id <id>`   | نعم   | معرّف المكالمة.       |
| `--message <text>` | نعم   | الرسالة المراد نطقها. |

### `speak`

انطق رسالة دون انتظار استجابة.

| العلم              | مطلوب | الوصف                 |
| ------------------ | ----- | --------------------- |
| `--call-id <id>`   | نعم   | معرّف المكالمة.       |
| `--message <text>` | نعم   | الرسالة المراد نطقها. |

### `dtmf`

أرسل أرقام DTMF إلى مكالمة نشطة.

| العلم               | مطلوب | الوصف                                    |
| ------------------- | ----- | ---------------------------------------- |
| `--call-id <id>`    | نعم   | معرّف المكالمة.                          |
| `--digits <digits>` | نعم   | أرقام DTMF (مثل `ww123456#` للانتظارات). |

### `end`

أنهِ مكالمة نشطة.

| العلم            | مطلوب | الوصف           |
| ---------------- | ----- | --------------- |
| `--call-id <id>` | نعم   | معرّف المكالمة. |

### `status`

افحص المكالمات النشطة.

| العلم            | الافتراضي | الوصف                           |
| ---------------- | --------- | ------------------------------- |
| `--call-id <id>` | (لا شيء)  | احصر المخرجات في مكالمة واحدة.  |
| `--json`         | `false`   | اطبع JSON قابلًا للقراءة آليًا. |

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw voicecall status
openclaw voicecall status --json
openclaw voicecall status --call-id <id>
```

## السجلات والمقاييس

### `tail`

تتبّع سجل JSONL للمكالمات الصوتية. يطبع آخر أسطر `--since` عند البدء، ثم يبث الأسطر الجديدة أثناء كتابتها.

| العلم           | الافتراضي              | الوصف                               |
| --------------- | ---------------------- | ----------------------------------- |
| `--file <path>` | يُحل من مخزن Plugin    | المسار إلى `calls.jsonl`.           |
| `--since <n>`   | `25`                   | الأسطر المطلوب طباعتها قبل التتبّع. |
| `--poll <ms>`   | `250` (الحد الأدنى 50) | فاصل الاستقصاء بالمللي ثانية.       |

### `latency`

لخّص مقاييس زمن انتقال الدور وانتظار الاستماع من `calls.jsonl`. تكون المخرجات JSON يتضمن ملخصات `recordsScanned` و`turnLatency` و`listenWait`.

| العلم           | الافتراضي             | الوصف                                |
| --------------- | --------------------- | ------------------------------------ |
| `--file <path>` | يُحل من مخزن Plugin   | المسار إلى `calls.jsonl`.            |
| `--last <n>`    | `200` (الحد الأدنى 1) | عدد السجلات الحديثة المطلوب تحليلها. |

## تعريض Webhooks

### `expose`

مكّن أو عطّل أو غيّر إعدادات Tailscale serve/funnel لWebhook الصوتي.

| العلم                 | الافتراضي                                 | الوصف                                         |
| --------------------- | ----------------------------------------- | --------------------------------------------- |
| `--mode <mode>`       | `funnel`                                  | `off` أو `serve` (tailnet) أو `funnel` (عام). |
| `--path <path>`       | config `tailscale.path` أو `--serve-path` | مسار Tailscale المراد تعريضه.                 |
| `--port <port>`       | config `serve.port` أو `3334`             | منفذ Webhook المحلي.                          |
| `--serve-path <path>` | config `serve.path` أو `/voice/webhook`   | مسار Webhook المحلي.                          |

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off
```

<Warning>
  لا تعرّض نقطة نهاية Webhook إلا للشبكات التي تثق بها. فضّل Tailscale Serve على Funnel عندما يكون ذلك ممكنًا.
</Warning>

## ذات صلة

* [مرجع CLI](/ar/cli)
* [Plugin المكالمات الصوتية](/ar/plugins/voice-call)