CLI commands
تماس صوتی
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 |
قابلیت serve/funnel در Tailscale را برای نقطه پایانی Webhook تغییر میدهد. |
راهاندازی و آزمون دود
setup
بهطور پیشفرض بررسیهای آمادگی را بهشکل خوانا برای انسان چاپ میکند. برای اسکریپتها --json را ارسال کنید.
openclaw voicecall setupopenclaw voicecall setup --jsonsmoke
همان بررسیهای آمادگی را اجرا میکند. فقط هنگامی یک تماس تلفنی واقعی برقرار میکند که هر دو گزینه
--to و --yes موجود باشند.
| پرچم | پیشفرض | توضیحات |
|---|---|---|
-t, --to <phone> |
(هیچکدام) | شماره تلفن برای تماس در آزمون دود واقعی. |
--message <text> |
OpenClaw voice call smoke test. |
پیامی که در تماس آزمون دود بیان میشود. |
--mode <mode> |
notify |
حالت تماس: notify یا conversation. |
--yes |
false |
تماس خروجی واقعی را برقرار میکند. |
--json |
false |
JSON قابلخواندن توسط ماشین را چاپ میکند. |
openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123" # اجرای آزمایشیopenclaw voicecall smoke --to "+15555550123" --yes # تماس اعلان واقعیچرخه عمر تماس
call
یک تماس صوتی خروجی را آغاز میکند.
| پرچم | الزامی | پیشفرض | توضیحات |
|---|---|---|---|
-m, --message <text> |
بله | (هیچکدام) | پیامی که هنگام اتصال تماس بیان میشود. |
-t, --to <phone> |
خیر | پیکربندی toNumber |
شماره تلفن E.164 برای تماس. |
--mode <mode> |
خیر | conversation |
حالت تماس: notify (پس از پیام قطع شود) یا conversation (باز بماند). |
openclaw voicecall call --to "+15555550123" --message "Hello"openclaw voicecall call -m "Heads up" --mode notifystart
نام مستعار 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 statusopenclaw voicecall status --jsonopenclaw 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) |
تعداد رکوردهای اخیر برای تحلیل. |
در معرض دسترس قرار دادن Webhookها
expose
پیکربندی serve/funnel در Tailscale را برای Webhook صوتی فعال، غیرفعال یا تغییر میدهد.
| پرچم | پیشفرض | توضیحات |
|---|---|---|
--mode <mode> |
funnel |
off، serve (tailnet) یا funnel (عمومی). |
--path <path> |
پیکربندی tailscale.path یا --serve-path |
مسیر Tailscale که در معرض دسترس قرار میگیرد. |
--port <port> |
پیکربندی serve.port یا 3334 |
درگاه محلی Webhook. |
--serve-path <path> |
پیکربندی serve.path یا /voice/webhook |
مسیر محلی Webhook. |
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off