openclaw voicecall

语音通话插件命令,仅在 voice-call 插件安装并启用后可用。

Gateway 运行时,操作命令路由到 Gateway 的 voice-call runtime;无 Gateway 时回退到独立 CLI runtime。

子命令总览

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 就绪检查。

openclaw voicecall setup
openclaw voicecall setup --json

smoke

运行就绪检查;仅在同时传入 --to 和 --yes 时才发起真实通话。

openclaw voicecall smoke                              # 仅检查
openclaw voicecall smoke --to "+15555550123"          # dry run
openclaw voicecall smoke --to "+15555550123" --yes    # 真实通话

外部 provider(twilio/telnyx/plivo)需要公网 webhook URL。

通话生命周期

call / start

发起出站语音通话。start 是 call 的别名,--to 必填。

openclaw voicecall call --to "+15555550123" --message "Hello"
openclaw voicecall call -m "Heads up" --mode notify

通话模式:

  • notify — 播报消息后挂断
  • conversation — 保持通话(默认)

continue / speak

  • continue — 播报消息并等待响应
  • speak — 播报消息,不等待响应
openclaw voicecall continue --call-id <id> --message "Next step?"
openclaw voicecall speak    --call-id <id> --message "Done."

dtmf / end

openclaw voicecall dtmf --call-id <id> --digits "ww123456#"
openclaw voicecall end  --call-id <id>

日志与指标

# 实时追踪通话日志
openclaw voicecall tail --since 25 --poll 250
 
# 分析延迟指标
openclaw voicecall latency --last 200

Webhook 暴露

openclaw voicecall expose --mode serve    # Tailscale 内网
openclaw voicecall expose --mode funnel   # 公网
openclaw voicecall expose --mode off      # 关闭

相关链接

  • docs/plugins/voice-call — voice-call 插件配置
  • cli-webhooks — Webhook 配置