Documentation Index
Fetch the complete documentation index at: https://docs.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 مستقل.
الأوامر الفرعية
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 للاستخدام في السكربتات.
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 قابلًا للقراءة آليًا. |
openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123" # تشغيل تجريبي
openclaw voicecall smoke --to "+15555550123" --yes # مكالمة notify مباشرة
بالنسبة إلى المزوّدين الخارجيين (twilio، telnyx، plivo)، يتطلب setup وsmoke عنوان Webhook URL عامًا من publicUrl أو نفقًا أو تعريضًا عبر Tailscale. يُرفض بديل local loopback أو serve خاص لأن شركات الاتصالات لا يمكنها الوصول إليه.
دورة حياة المكالمة
call
ابدأ مكالمة صوتية صادرة.
| العلم | مطلوب | الافتراضي | الوصف |
|---|
-m, --message <text> | نعم | (لا شيء) | الرسالة المراد نطقها عند اتصال المكالمة. |
-t, --to <phone> | لا | config toNumber | رقم هاتف E.164 المطلوب الاتصال به. |
--mode <mode> | لا | conversation | وضع المكالمة: notify (إنهاء المكالمة بعد الرسالة) أو conversation (إبقاؤها مفتوحة). |
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 قابلًا للقراءة آليًا. |
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 المحلي. |
openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off
لا تعرّض نقطة نهاية Webhook إلا للشبكات التي تثق بها. فضّل Tailscale Serve على Funnel عندما يكون ذلك ممكنًا.
ذات صلة
