跳转至

openclaw voicecall

voicecall 是插件提供的命令。仅当 voice-call 插件已安装并启用时,它才会出现。如果系统无法识别 openclaw voicecall,请在 Gateway 主机上安装并启用该插件:

openclaw plugins install @openclaw/voice-call
openclaw plugins enable voice-call

这些命令会自动应用于正在运行的 Gateway;如果它处于离线状态,请先启动它。有关提供商凭据和 Webhook 配置,请参阅 Voice call 插件;有关运行时验证,请参阅 应用更改并检查。

当 Gateway 正在运行时,操作命令(call、start、continue、speak、dtmf、end、status)会路由到该 Gateway 的 voice-call 运行时。如果无法连接到任何 Gateway,这些命令将回退到独立的 CLI 运行时。status 使用持久化的通话存储,而不会启动该运行时。

回退仅限于传输层不可用的情况。如果 Gateway 返回请求错误或身份验证错误,或者超时前未应答,命令将以非零状态退出,并提示运行 openclaw gateway status;此时不会启动第二个 Webhook 服务器。如果独立回退无法绑定配置的 serve.port,错误信息会指出可能正在运行的 Gateway,而不是直接输出原始 EADDRINUSE 错误。

子命令

openclaw voicecall setup    [--json]
openclaw voicecall smoke    [-t <phone>] [--message <text>] [--mode <m>] [--yes] [--json]
openclaw voicecall call     -m <text> [-t <phone>] [--mode <m>] [--brief <text-or-json> | --brief-file <path>]
openclaw voicecall start    --to <phone> [--message <text>] [--mode <m>] [--brief <text-or-json> | --brief-file <path>]
openclaw voicecall continue --call-id <id> --message <text>
openclaw voicecall speak    --call-id <id> --message <text>
openclaw voicecall steer    --call-id <id> --message <text> [--mode say|guidance]
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 跟踪持久化通话记录或显式指定的自定义 JSONL 日志。
latency 汇总通话历史或自定义 JSONL 日志中的轮次延迟。
expose 切换 Webhook 端点的 Tailscale serve/funnel。

设置与冒烟测试

setup

默认输出人类可读的就绪检查结果。如需脚本化输出,请传入 --json。

openclaw voicecall setup
openclaw voicecall setup --json

smoke

运行相同的就绪检查。仅当同时提供 --to 和 --yes 时才拨打真实电话。

选项 默认值 描述
-t, --to <phone> (无) 拨打实时测试呼叫的电话号码。
--message <text> OpenClaw voice call smoke test. 烟雾测试通话期间要播报的消息。
--mode <mode> notify 通话模式:notify 或 conversation。
--yes false 实际拨打实时外呼电话。
--json false 输出机器可读的 JSON。
openclaw voicecall smoke
openclaw voicecall smoke --to "+15555550123"        # dry run
openclaw voicecall smoke --to "+15555550123" --yes  # live notify call

Note

对于外部提供商(plivo、telnyx、twilio),setup 和 smoke 需要来自 publicUrl 的公共 Webhook URL、隧道或 Tailscale 暴露。回环地址或私有 serve 回退会被拒绝,因为运营商无法访问它们。

通话生命周期

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 notify

使用 --brief 以纯文本或 JSON 对象形式提供任务。--brief-file 从文件读取 JSON 对象;这两个选项互斥。开场消息仍会首先逐字播报。有关架构、权限和时长上限,请参阅 每次通话的 brief。

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> 是 要播报的消息。

steer

向一个活动的实时通话发送新的所有者指令:

openclaw voicecall steer --call-id "<call-id>" --message "Ask for Tuesday morning"
openclaw voicecall steer --call-id "<call-id>" --mode say --message "Tuesday morning works for us."

guidance 是默认值。say 请求立即使用确切措辞。该指令也会包含在后续的 agent 咨询中。消息限制为 500 个字符。CLI 使用正在运行的 Gateway 的操作员授权;Gateway 不可用会报错,因为独立进程无法引导其实时桥接。

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

从 SQLite 中跟踪已持久化的语音通话记录:最初打印最近 --since 条记录,然后仅打印新快照(--since 0 仅从新快照开始)。对于已存在的自定义 --file,如果其 basename 不是 calls.jsonl,启动时打印最近 --since 行非空完整行,然后流式输出新的完整行。部分行会等待换行符;文件被替换或观察到截断时会开始新的流。缓慢的输出管道会暂停读取,而不是将日志其余部分累积在内存中。

标志 默认值 描述
--file <path> 从插件存储解析 calls.jsonl 的路径。
--since <n> 25 开始跟踪前打印的行数。
--poll <ms> 250(最小值 50) 轮询间隔(毫秒)。

latency

从 SQLite 或使用 --file 选择的现有自定义日志中汇总回合延迟和监听等待指标。输出为 JSON,包含 recordsScanned、turnLatency 和 listenWait 摘要。

自定义日志会增量扫描,对请求的历史没有字节上限。latency 选择最近 N 条非空记录,跳过格式错误的 JSON,并接受最后一条没有换行符的 JSON 记录。它一次解析一条选中的记录;内存仍会随着最大的选中 JSON 记录和请求的指标样本数量而增长。

标志 默认值 描述
--file <path> 从插件存储解析 calls.jsonl 的路径。
--last <n> 200(最小值 1) 要分析的最近记录数。

公开 Webhook

expose

启用、禁用或更改语音 Webhook 的 Tailscale serve/funnel 配置。当启用实时或流式音频时,该命令还会公开或清除该模式的 WebSocket 流路径。外部 HTTPS 端口来自 tailscale.port(默认 443);Funnel 支持 443、8443 或 10000。

标志 默认值 描述
--mode <mode> funnel off、serve(tailnet)或 funnel(公共)。
--path <path> 配置 tailscale.path 或 --serve-path 要公开的 Tailscale 路径。
--port <port> 配置 serve.port 或 3334 本地 Webhook 端口。
--serve-path <path> 配置 serve.path 或 /voice/webhook 本地 Webhook 路径。
openclaw voicecall expose --mode serve
openclaw voicecall expose --mode funnel
openclaw voicecall expose --mode off

Warning

仅将 Webhook 端点公开给你信任的网络。尽可能优先使用 Tailscale Serve 而不是 Funnel。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw