openclaw voicecall¶
voicecall 是插件提供的命令。仅当 voice-call 插件已安装并启用时,它才会出现。如果系统无法识别 openclaw voicecall,请在 Gateway 主机上安装并启用该插件:
这些命令会自动应用于正在运行的 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。
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。 |
日志和指标¶
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