CLI commands

تماس صوتی

`openclaw voicecall`

voicecall یک فرمان ارائه‌شده توسط Plugin است. این فرمان فقط زمانی ظاهر می‌شود که Plugin تماس صوتی نصب و فعال شده باشد.

وقتی Gateway در حال اجراست، فرمان‌های عملیاتی (call، start، continue، speak، dtmf، end، status) به runtime تماس صوتی همان Gateway مسیریابی می‌شوند. اگر هیچ Gateway قابل دسترسی نباشد، به runtime مستقل CLI بازمی‌گردند.

زیرفرمان‌ها

bash

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`	بررسی‌های آمادگی provider و Webhook را نشان می‌دهد.
`smoke`	بررسی‌های آمادگی را اجرا می‌کند؛ فقط با `--yes` یک تماس آزمایشی زنده برقرار می‌کند.
`call`	یک تماس صوتی خروجی را آغاز می‌کند.
`start`	نام مستعار `call` است که در آن `--to` الزامی و `--message` اختیاری است.
`continue`	یک پیام را پخش می‌کند و منتظر پاسخ بعدی می‌ماند.
`speak`	یک پیام را بدون انتظار برای پاسخ پخش می‌کند.
`dtmf`	ارقام DTMF را به یک تماس فعال ارسال می‌کند.
`end`	یک تماس فعال را قطع می‌کند.
`status`	تماس‌های فعال را بررسی می‌کند (یا یکی را با `--call-id`).
`tail`	`calls.jsonl` را دنبال می‌کند (در آزمون‌های provider مفید است).
`latency`	معیارهای تأخیر نوبت را از `calls.jsonl` خلاصه می‌کند.
`expose`	serve/funnel در Tailscale را برای endpoint وب‌هوک روشن یا خاموش می‌کند.

راه‌اندازی و smoke

`setup`

به‌طور پیش‌فرض بررسی‌های آمادگی خوانا برای انسان را چاپ می‌کند. برای اسکریپت‌ها --json را ارسال کنید.

bash

openclaw voicecall setupopenclaw voicecall setup --json

`smoke`

همان بررسی‌های آمادگی را اجرا می‌کند. مگر اینکه هر دو --to و --yes وجود داشته باشند، تماس تلفنی واقعی برقرار نمی‌کند.

پرچم	پیش‌فرض	توضیح
`-t, --to <phone>`	(هیچ)	شماره تلفنی که برای smoke زنده با آن تماس گرفته می‌شود.
`--message <text>`	`OpenClaw voice call smoke test.`	پیامی که در تماس smoke پخش می‌شود.
`--mode <mode>`	`notify`	حالت تماس: `notify` یا `conversation`.
`--yes`	`false`	واقعاً تماس خروجی زنده را برقرار می‌کند.
`--json`	`false`	JSON قابل خواندن توسط ماشین را چاپ می‌کند.

bash

openclaw voicecall smokeopenclaw voicecall smoke --to "+15555550123"        # dry runopenclaw voicecall smoke --to "+15555550123" --yes  # live notify call

چرخه عمر تماس

`call`

یک تماس صوتی خروجی را آغاز می‌کند.

پرچم	الزامی	پیش‌فرض	توضیح
`-m, --message <text>`	بله	(هیچ)	پیامی که هنگام وصل شدن تماس پخش می‌شود.
`-t, --to <phone>`	خیر	config `toNumber`	شماره تلفن E.164 برای تماس.
`--mode <mode>`	خیر	`conversation`	حالت تماس: `notify` (قطع پس از پیام) یا `conversation` (باز بماند).

bash

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

openclaw voicecall statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>

گزارش‌ها و معیارها

`tail`

گزارش JSONL تماس صوتی را دنبال می‌کند. هنگام شروع، آخرین --since خط را چاپ می‌کند و سپس خط‌های جدید را هنگام نوشته شدن stream می‌کند.

پرچم	پیش‌فرض	توضیح
`--file <path>`	از store مربوط به Plugin حل می‌شود	مسیر `calls.jsonl`.
`--since <n>`	`25`	خط‌هایی که قبل از دنبال کردن چاپ می‌شوند.
`--poll <ms>`	`250` (حداقل 50)	بازه polling بر حسب میلی‌ثانیه.

`latency`

معیارهای تأخیر نوبت و انتظار شنیدن را از calls.jsonl خلاصه می‌کند. خروجی JSON با خلاصه‌های recordsScanned، turnLatency، و listenWait است.

پرچم	پیش‌فرض	توضیح
`--file <path>`	از store مربوط به Plugin حل می‌شود	مسیر `calls.jsonl`.
`--last <n>`	`200` (حداقل 1)	تعداد رکوردهای اخیر برای تحلیل.

نمایان‌سازی وب‌هوک‌ها

`expose`

پیکربندی serve/funnel در Tailscale را برای وب‌هوک صوتی فعال، غیرفعال، یا تغییر می‌دهد.

پرچم	پیش‌فرض	توضیح
`--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

openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off

مرتبط

Was this useful?