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 для endpoint webhook. |
Налаштування та smoke
setup
За замовчуванням виводить перевірки готовності у форматі, зручному для читання. Передайте --json для скриптів.
openclaw voicecall setup
openclaw 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, придатний для машинного читання. |
openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123" # dry run
openclaw voicecall smoke --to "+15555550123" --yes # live notify call
Для зовнішніх провайдерів (twilio, telnyx, plivo) setup і smoke потребують публічної URL-адреси webhook з publicUrl, тунелю або експонування через Tailscale. Резервний варіант loopback або private 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> | так | 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, придатний для машинного читання. |
openclaw voicecall status
openclaw voicecall status --json
openclaw 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. |
openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off
Експонуйте endpoint webhook лише в мережі, яким довіряєте. За можливості віддавайте перевагу Tailscale Serve над Funnel.
Пов’язане
