# openclaw voicecall

voicecall 是由 Plugin 提供的指令。只有在已安裝並啟用語音通話 Plugin 時才會出現。

當 Gateway 正在執行時，操作指令（call、start、 continue、speak、dtmf、end 和 status）會傳送到該 Gateway 的 語音通話執行階段。如果無法連線到 Gateway，它們會退回到獨立的 CLI 執行階段。

主要文件：

• 語音通話 Plugin：語音通話

# 常用指令

openclaw voicecall setup
openclaw voicecall smoke
openclaw voicecall status --json
openclaw voicecall status --call-id <id>
openclaw voicecall call --to "+15555550123" --message "Hello" --mode notify
openclaw voicecall continue --call-id <id> --message "Any questions?"
openclaw voicecall dtmf --call-id <id> --digits "ww123456#"
openclaw voicecall end --call-id <id>

setup 預設會列印人類可讀的就緒檢查。腳本請使用 --json：

openclaw voicecall setup --json

status 預設會以 JSON 列印作用中的通話。傳入 --call-id <id> 可檢查 單一通話。

對於外部提供者（twilio、telnyx、plivo），設定必須從 publicUrl、通道或 Tailscale 曝露解析出公開 Webhook URL。由於電信業者無法連線到回送/私人 服務備援，因此會被拒絕。

smoke 會執行相同的就緒檢查。除非同時提供 --to 和 --yes， 否則不會撥打真正的電話：

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

# 曝露 Webhook（Tailscale）

openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off

安全注意事項：只將 Webhook 端點曝露給你信任的網路。可行時，優先使用 Tailscale Serve，而非 Funnel。

# 相關

• CLI 參考
• 語音通話 Plugin