CLI commands

Голосовий дзвінок

`openclaw voicecall`

voicecall — це команда, надана Plugin. Вона з’являється лише тоді, коли Plugin голосових викликів установлено й увімкнено.

Коли Gateway запущено, операційні команди (call, start, continue, speak, dtmf, end, status) маршрутизуються до середовища виконання голосових викликів цього Gateway. Якщо Gateway недоступний, вони повертаються до автономного середовища виконання 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`	Показати перевірки готовності провайдера та 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 для endpoint webhook.

Налаштування та smoke

`setup`

За замовчуванням виводить перевірки готовності у форматі, зручному для читання. Передайте --json для скриптів.

bash

openclaw voicecall setupopenclaw voicecall setup --json

`smoke`

Запускає ті самі перевірки готовності. Реальний телефонний виклик не буде здійснено, якщо не вказано одночасно --to і --yes.

Прапорець	За замовчуванням	Опис
`-t, --to <phone>`	(немає)	Номер телефону для виклику під час live smoke.
`--message <text>`	`OpenClaw voice call smoke test.`	Повідомлення для озвучення під час smoke-виклику.
`--mode <mode>`	`notify`	Режим виклику: `notify` або `conversation`.
`--yes`	`false`	Справді здійснити live-вихідний виклик.
`--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>`	так	ID виклику.
`--message <text>`	так	Повідомлення для озвучення.

`speak`

Промовити повідомлення без очікування відповіді.

Прапорець	Обов’язково	Опис
`--call-id <id>`	так	ID виклику.
`--message <text>`	так	Повідомлення для озвучення.

`dtmf`

Надіслати цифри DTMF до активного виклику.

Прапорець	Обов’язково	Опис
`--call-id <id>`	так	ID виклику.
`--digits <digits>`	так	Цифри DTMF (наприклад, `ww123456#` для очікувань).

`end`

Завершити активний виклик.

Прапорець	Обов’язково	Опис
`--call-id <id>`	так	ID виклику.

`status`

Переглянути активні виклики.

Прапорець	За замовчуванням	Опис
`--call-id <id>`	(немає)	Обмежити вивід одним викликом.
`--json`	`false`	Вивести JSON, придатний для машинного читання.

bash

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

Журнали та метрики

`tail`

Стежити за JSONL-журналом голосових викликів. На старті виводить останні --since рядків, а потім транслює нові рядки під час їх запису.

Прапорець	За замовчуванням	Опис
`--file <path>`	resolved from plugin store	Шлях до `calls.jsonl`.
`--since <n>`	`25`	Рядки для виводу перед tailing.
`--poll <ms>`	`250` (мінімум 50)	Інтервал опитування в мілісекундах.

`latency`

Підсумувати метрики затримки ходу та очікування прослуховування з calls.jsonl. Вивід — JSON із підсумками recordsScanned, turnLatency і listenWait.

Прапорець	За замовчуванням	Опис
`--file <path>`	resolved from plugin store	Шлях до `calls.jsonl`.
`--last <n>`	`200` (мінімум 1)	Кількість нещодавніх записів для аналізу.

Експонування webhook

`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

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

Пов’язане

Was this useful?