CLI commands
語音通話
openclaw voicecall
voicecall 是由外掛提供的命令。只有在安裝並啟用 voice-call
外掛後才會顯示。
閘道執行時，操作命令（call、start、
continue、speak、dtmf、end、status）會路由至該閘道的
voice-call 執行階段。如果無法連線至任何閘道，則會改用獨立的
命令列介面執行階段。
子命令
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 |
顯示供應商與網路鉤子的就緒狀態檢查。 |
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。 |
設定與冒煙測試
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> |
是 | 通話 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 statusopenclaw voicecall status --jsonopenclaw voicecall status --call-id <id>記錄與指標
tail
追蹤 voice-call JSONL 記錄。啟動時輸出最後 --since 行，接著在寫入新行時
串流輸出。
| 旗標 | 預設值 | 說明 |
|---|---|---|
--file <path> |
從外掛儲存區解析 | calls.jsonl 的路徑。 |
--since <n> |
25 |
開始追蹤前要輸出的行數。 |
--poll <ms> |
250（最小值 50） |
輪詢間隔（毫秒）。 |
latency
摘要整理 calls.jsonl 中的輪次延遲與聆聽等待指標。輸出為
JSON，包含 recordsScanned、turnLatency 和 listenWait 摘要。
| 旗標 | 預設值 | 說明 |
|---|---|---|
--file <path> |
從外掛儲存區解析 | calls.jsonl 的路徑。 |
--last <n> |
200（最小值 1） |
要分析的近期記錄數量。 |
公開網路鉤子
expose
啟用、停用或變更語音網路鉤子的 Tailscale serve/funnel 設定。
| 旗標 | 預設值 | 說明 |
|---|---|---|
--mode <mode> |
funnel |
off、serve（tailnet）或 funnel（公開）。 |
--path <path> |
設定 tailscale.path 或 --serve-path |
要公開的 Tailscale 路徑。 |
--port <port> |
設定 serve.port 或 3334 |
本機網路鉤子連接埠。 |
--serve-path <path> |
設定 serve.path 或 /voice/webhook |
本機網路鉤子路徑。 |
openclaw voicecall expose --mode serveopenclaw voicecall expose --mode funnelopenclaw voicecall expose --mode off相關內容
Was this useful?
