From 6832010aa3e96040e446f0eea1512076b0ce6c1c Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Fri, 1 May 2026 04:48:21 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/cli/voicecall.md | 33 +-- docs/zh-CN/plugins/google-meet.md | 361 +++++++++++++++--------------- 2 files changed, 200 insertions(+), 194 deletions(-) diff --git a/docs/zh-CN/cli/voicecall.md b/docs/zh-CN/cli/voicecall.md index 69651a264..5f66c2ccb 100644 --- a/docs/zh-CN/cli/voicecall.md +++ b/docs/zh-CN/cli/voicecall.md @@ -1,31 +1,32 @@ --- read_when: - - 你使用语音通话插件，并且想了解 CLI 入口点 - - 你想查看 `voicecall setup|smoke|call|continue|dtmf|status|tail|expose` 的快速示例 + - 你使用 voice-call 插件，并想要 CLI 入口点 + - 你想要 `voicecall setup|smoke|call|continue|dtmf|status|tail|expose` 的快速示例 summary: '`openclaw voicecall` 的 CLI 参考（语音通话插件命令界面）' title: 语音通话 x-i18n: - generated_at: "2026-04-25T04:55:01Z" - model: gpt-5.4 + generated_at: "2026-05-01T04:46:12Z" + model: gpt-5.5 provider: openai - source_hash: 7c8b83ef75f792920024a67b0dee1b07aff9f55486de1149266c6d94854ca0fe + source_hash: 4090858a58b7defaff955a370c8cb0ff025ef68061e68a6c69a637de24707c0b source_path: cli/voicecall.md - workflow: 15 + workflow: 16 --- # `openclaw voicecall` -`voicecall` 是一个由插件提供的命令。只有在安装并启用语音通话插件后，它才会显示。 +`voicecall` 是一个由插件提供的命令。只有安装并启用语音通话插件后，它才会出现。 主要文档： -- 语音通话插件：[Voice Call](/zh-CN/plugins/voice-call) +- 语音通话插件：[语音通话](/zh-CN/plugins/voice-call) ## 常用命令 ```bash openclaw voicecall setup openclaw voicecall smoke +openclaw voicecall status --json openclaw voicecall status --call-id openclaw voicecall call --to "+15555550123" --message "Hello" --mode notify openclaw voicecall continue --call-id --message "Any questions?" @@ -33,22 +34,24 @@ openclaw voicecall dtmf --call-id --digits "ww123456#" openclaw voicecall end --call-id ``` -`setup` 默认会输出人类可读的就绪检查结果。对于脚本，请使用 `--json`： +`setup` 默认会打印便于阅读的就绪检查。脚本请使用 `--json`： ```bash openclaw voicecall setup --json ``` -对于外部提供商（`twilio`、`telnyx`、`plivo`），设置必须从 `publicUrl`、隧道或 Tailscale 暴露中解析一个公开的 webhook URL。由于运营商无法访问，local loopback/私有服务的回退方案会被拒绝。 +`status` 默认以 JSON 打印活跃通话。传入 `--call-id ` 可检查一个通话。 + +对于外部提供商（`twilio`、`telnyx`、`plivo`），设置必须从 `publicUrl`、隧道或 Tailscale 暴露地址解析出一个公网 webhook URL。回环/私有服务回退会被拒绝，因为运营商无法访问它。 `smoke` 会运行相同的就绪检查。除非同时提供 `--to` 和 `--yes`，否则它不会拨打真实电话： ```bash -openclaw voicecall smoke --to "+15555550123" # 试运行 -openclaw voicecall smoke --to "+15555550123" --yes # 实际通知呼叫 +openclaw voicecall smoke --to "+15555550123" # dry run +openclaw voicecall smoke --to "+15555550123" --yes # live notify call ``` -## 暴露 webhook（Tailscale） +## 暴露 webhooks（Tailscale） ```bash openclaw voicecall expose --mode serve @@ -56,9 +59,9 @@ openclaw voicecall expose --mode funnel openclaw voicecall expose --mode off ``` -安全说明：只将 webhook 端点暴露给你信任的网络。条件允许时，优先使用 Tailscale Serve 而不是 Funnel。 +安全注意事项：只将 webhook 端点暴露给你信任的网络。尽可能优先使用 Tailscale Serve，而不是 Funnel。 -## 相关内容 +## 相关 - [CLI 参考](/zh-CN/cli) - [语音通话插件](/zh-CN/plugins/voice-call) diff --git a/docs/zh-CN/plugins/google-meet.md b/docs/zh-CN/plugins/google-meet.md index 9a33f07c5..7b9ec42f7 100644 --- a/docs/zh-CN/plugins/google-meet.md +++ b/docs/zh-CN/plugins/google-meet.md @@ -1,36 +1,36 @@ --- read_when: - - 你想让一个 OpenClaw 智能体加入 Google Meet 通话 - - 你希望一个 OpenClaw 智能体创建一个新的 Google Meet 通话 - - 你正在将 Chrome、Chrome node 或 Twilio 配置为 Google Meet 传输方式 + - 你想让 OpenClaw 智能体加入 Google Meet 通话 + - 你想让 OpenClaw 智能体创建一个新的 Google Meet 通话 + - 你正在将 Chrome、Chrome 节点或 Twilio 配置为 Google Meet 传输协议 summary: Google Meet 插件：通过 Chrome 或 Twilio 加入显式 Meet URL，并使用实时语音默认设置 title: Google Meet 插件 x-i18n: - generated_at: "2026-04-30T01:50:00Z" + generated_at: "2026-05-01T04:46:16Z" model: gpt-5.5 provider: openai - source_hash: 7b989c872fee0dca31680f67559cd26b715303f7c6f4eeda51fc63889bb0383c + source_hash: 7eb6e48964d9592562fad1cebeadd765f2a2bcea9bfe887153e65438bfeaa617 source_path: plugins/google-meet.md workflow: 16 --- -Google Meet 参与者支持面向 OpenClaw，插件的设计明确： +Google Meet 对 OpenClaw 的参会者支持按设计是显式的： -- 它只会加入明确的 `https://meet.google.com/...` URL。 +- 它只会加入显式的 `https://meet.google.com/...` URL。 - 它可以通过 Google Meet API 创建新的 Meet 空间，然后加入返回的 URL。 - `realtime` 语音是默认模式。 - 当需要更深入的推理或工具时，实时语音可以回调到完整的 OpenClaw 智能体。 -- 智能体通过 `mode` 选择加入行为：使用 `realtime` 进行实时听取/回应，或使用 `transcribe` 加入/控制浏览器而不启用实时语音桥接。 -- 凭证从个人 Google OAuth 或已经登录的 Chrome 配置文件开始。 -- 不会自动播报同意声明。 -- 默认 Chrome 音频后端是 `BlackHole 2ch`。 +- 智能体通过 `mode` 选择加入行为：使用 `realtime` 进行实时收听/回话，或使用 `transcribe` 加入/控制浏览器而不启用实时语音桥接。 +- 凭证从个人 Google OAuth 或已登录的 Chrome 配置文件开始。 +- 没有自动同意公告。 +- 默认的 Chrome 音频后端是 `BlackHole 2ch`。 - Chrome 可以在本地运行，也可以在已配对的节点主机上运行。 -- Twilio 接受一个拨入号码，以及可选的 PIN 或 DTMF 序列。 +- Twilio 接受拨入号码，以及可选的 PIN 或 DTMF 序列。 - CLI 命令是 `googlemeet`；`meet` 保留给更广泛的智能体电话会议工作流。 ## 快速开始 -安装本地音频依赖并配置后端实时语音提供商。OpenAI 是默认值；Google Gemini Live 也可配合 `realtime.provider: "google"` 使用： +安装本地音频依赖项并配置后端实时语音提供商。OpenAI 是默认值；Google Gemini Live 也可以与 `realtime.provider: "google"` 一起使用： ```bash brew install blackhole-2ch sox @@ -39,13 +39,13 @@ export OPENAI_API_KEY=sk-... export GEMINI_API_KEY=... ``` -`blackhole-2ch` 会安装 `BlackHole 2ch` 虚拟音频设备。Homebrew 的安装器需要重启后，macOS 才会暴露该设备： +`blackhole-2ch` 会安装 `BlackHole 2ch` 虚拟音频设备。Homebrew 的安装器要求重启后 macOS 才会暴露该设备： ```bash sudo reboot ``` -重启后，验证两项组件： +重启后，验证这两项： ```bash system_profiler SPAudioDataType | grep -i BlackHole @@ -73,13 +73,13 @@ command -v sox openclaw googlemeet setup ``` -设置输出旨在让智能体可读，并且感知模式。它会报告 Chrome 配置文件、节点固定，以及针对实时 Chrome 加入的 BlackHole/SoX 音频桥接和延迟实时开场白检查。对于仅观察加入，请使用 `--mode transcribe` 检查同一传输；该模式会跳过实时音频前置条件，因为它不会通过桥接监听或说话： +设置输出旨在便于智能体读取并感知模式。它会报告 Chrome 配置文件、节点固定，以及对于实时 Chrome 加入，还会报告 BlackHole/SoX 音频桥接和延迟实时介绍检查。对于仅观察加入，请用 `--mode transcribe` 检查相同传输；该模式会跳过实时音频前置条件，因为它不会通过桥接收听或发声： ```bash openclaw googlemeet setup --transport chrome-node --mode transcribe ``` -配置 Twilio 委派后，设置还会报告 `voice-call` 插件和 Twilio 凭证是否就绪。在要求智能体加入之前，请将任何 `ok: false` 检查视为对应传输和模式的阻断项。脚本或机器可读输出请使用 `openclaw googlemeet setup --json`。在智能体尝试之前，使用 `--transport chrome`、`--transport chrome-node` 或 `--transport twilio` 对特定传输进行预检。 +配置 Twilio 委派后，设置还会报告 `voice-call` 插件和 Twilio 凭证是否就绪。在让智能体加入之前，将任何 `ok: false` 检查视为对应传输和模式的阻断项。脚本或机器可读输出请使用 `openclaw googlemeet setup --json`。在智能体尝试之前，使用 `--transport chrome`、`--transport chrome-node` 或 `--transport twilio` 预检特定传输。 加入会议： @@ -87,7 +87,7 @@ openclaw googlemeet setup --transport chrome-node --mode transcribe openclaw googlemeet join https://meet.google.com/abc-defg-hij ``` -或让智能体通过 `google_meet` 工具加入： +或者让智能体通过 `google_meet` 工具加入： ```json { @@ -112,13 +112,13 @@ openclaw googlemeet create --no-join `googlemeet create` 有两条路径： -- API 创建：在已配置 Google Meet OAuth 凭证时使用。这是最具确定性的路径，并且不依赖浏览器 UI 状态。 -- 浏览器回退：在缺少 OAuth 凭证时使用。OpenClaw 使用固定的 Chrome 节点，打开 `https://meet.google.com/new`，等待 Google 重定向到真实的会议代码 URL，然后返回该 URL。此路径要求节点上的 OpenClaw Chrome 配置文件已经登录 Google。浏览器自动化会处理 Meet 自己的首次运行麦克风提示；该提示不会被视为 Google 登录失败。 - 加入和创建流程也会在打开新标签页之前尝试复用现有 Meet 标签页。匹配会忽略无害的 URL 查询字符串，例如 `authuser`，因此智能体重试时应聚焦已经打开的会议，而不是创建第二个 Chrome 标签页。 +- API 创建：在已配置 Google Meet OAuth 凭证时使用。这是最确定的路径，不依赖浏览器 UI 状态。 +- 浏览器回退：在没有 OAuth 凭证时使用。OpenClaw 使用固定的 Chrome 节点，打开 `https://meet.google.com/new`，等待 Google 重定向到真实的会议代码 URL，然后返回该 URL。此路径要求节点上的 OpenClaw Chrome 配置文件已经登录 Google。浏览器自动化会处理 Meet 自己的首次运行麦克风提示；该提示不会被视为 Google 登录失败。 + 加入和创建流程还会先尝试复用现有 Meet 标签页，再打开新标签页。匹配会忽略无害的 URL 查询字符串，例如 `authuser`，因此智能体重试应聚焦已打开的会议，而不是创建第二个 Chrome 标签页。 -命令/工具输出包含 `source` 字段（`api` 或 `browser`），以便智能体解释使用了哪条路径。`create` 默认加入新会议，并返回 `joined: true` 以及加入会话。若只生成 URL，请在 CLI 上使用 `create --no-join`，或向工具传入 `"join": false`。 +命令/工具输出包含 `source` 字段（`api` 或 `browser`），因此智能体可以说明使用了哪条路径。`create` 默认加入新会议，并返回 `joined: true` 以及加入会话。若只生成 URL，请在 CLI 上使用 `create --no-join`，或向工具传入 `"join": false`。 -或告诉智能体：“创建一个 Google Meet，用实时语音加入，并把链接发给我。”智能体应使用 `action: "create"` 调用 `google_meet`，然后分享返回的 `meetingUri`。 +或者告诉智能体：“创建一个 Google Meet，用实时语音加入，并把链接发给我。” 智能体应使用 `action: "create"` 调用 `google_meet`，然后分享返回的 `meetingUri`。 ```json { @@ -128,54 +128,54 @@ openclaw googlemeet create --no-join } ``` -对于仅观察/浏览器控制的加入，请设置 `"mode": "transcribe"`。这不会启动双工实时模型桥接，不需要 BlackHole 或 SoX，也不会在会议中回应。此模式下的 Chrome 加入还会避免 OpenClaw 的麦克风/摄像头权限授予，并避开 Meet **Use microphone** 路径。如果 Meet 显示音频选择中间页，自动化会尝试无麦克风路径；否则会报告需要手动操作，而不是打开本地麦克风。 +对于仅观察/浏览器控制加入，请设置 `"mode": "transcribe"`。这不会启动双工实时模型桥接，不需要 BlackHole 或 SoX，也不会向会议回话。此模式下的 Chrome 加入还会避免 OpenClaw 的麦克风/摄像头权限授予，并避开 Meet **使用麦克风** 路径。如果 Meet 显示音频选择插屏，自动化会尝试无麦克风路径，否则报告需要手动操作，而不是打开本地麦克风。 -在实时会话期间，`google_meet` Status 包含浏览器和音频桥接健康状况，例如 `inCall`、`manualActionRequired`、`providerConnected`、`realtimeReady`、`audioInputActive`、`audioOutputActive`、最后输入/输出时间戳、字节计数器和桥接关闭状态。如果出现安全的 Meet 页面提示，浏览器自动化会在可行时处理。登录、主持人准入以及浏览器/操作系统权限提示会作为手动操作报告，并带有原因和消息，供智能体转述。托管 Chrome 会话只有在浏览器健康状态报告 `inCall: true` 后才会发出开场白或测试短语；否则 Status 会报告 `speechReady: false`，并阻止语音尝试，而不是假装智能体已经在会议中说话。 +实时会话期间，`google_meet` Status 包含浏览器和音频桥接健康状况，例如 `inCall`、`manualActionRequired`、`providerConnected`、`realtimeReady`、`audioInputActive`、`audioOutputActive`、上次输入/输出时间戳、字节计数器以及桥接关闭状态。如果出现安全的 Meet 页面提示，浏览器自动化会在可行时处理它。登录、主持人准入以及浏览器/操作系统权限提示会作为手动操作报告，并带有原因和消息，供智能体转述。托管 Chrome 会话仅在浏览器健康状况报告 `inCall: true` 后才会发出介绍或测试短语；否则 Status 会报告 `speechReady: false`，并阻止语音尝试，而不是假装智能体已在会议中发言。 -本地 Chrome 通过已登录的 OpenClaw 浏览器配置文件加入。实时模式需要 `BlackHole 2ch` 作为 OpenClaw 使用的麦克风/扬声器路径。为了获得清晰的双工音频，请使用独立的虚拟设备或 Loopback 风格的图；单个 BlackHole 设备足以进行首次冒烟测试，但可能产生回声。 +本地 Chrome 通过已登录的 OpenClaw 浏览器配置文件加入。实时模式需要 `BlackHole 2ch` 来提供 OpenClaw 使用的麦克风/扬声器路径。为获得干净的双工音频，请使用独立虚拟设备或 Loopback 风格的图；单个 BlackHole 设备足以完成首次冒烟测试，但可能产生回声。 ### 本地 Gateway 网关 + Parallels Chrome -如果只是让 VM 拥有 Chrome，你**不**需要在 macOS VM 内运行完整的 OpenClaw Gateway 网关或配置模型 API key。在本地运行 Gateway 网关和智能体，然后在 VM 中运行节点主机。在 VM 上启用一次内置插件，让节点发布 Chrome 命令： +仅为了让虚拟机拥有 Chrome，你**不**需要在 macOS 虚拟机内运行完整的 OpenClaw Gateway 网关或配置模型 API key。在本地运行 Gateway 网关和智能体，然后在虚拟机中运行节点主机。在虚拟机上启用一次内置插件，让节点广播 Chrome 命令： -各组件运行位置： +各处运行的内容： - Gateway 网关主机：OpenClaw Gateway 网关、智能体工作区、模型/API keys、实时提供商，以及 Google Meet 插件配置。 -- Parallels macOS VM：OpenClaw CLI/节点主机、Google Chrome、SoX、BlackHole 2ch，以及已登录 Google 的 Chrome 配置文件。 -- VM 中不需要：Gateway 网关服务、智能体配置、OpenAI/GPT key，或模型提供商设置。 +- Parallels macOS 虚拟机：OpenClaw CLI/节点主机、Google Chrome、SoX、BlackHole 2ch，以及已登录 Google 的 Chrome 配置文件。 +- 虚拟机中不需要：Gateway 网关服务、智能体配置、OpenAI/GPT key 或模型提供商设置。 -安装 VM 依赖： +安装虚拟机依赖项： ```bash brew install blackhole-2ch sox ``` -安装 BlackHole 后重启 VM，让 macOS 暴露 `BlackHole 2ch`： +安装 BlackHole 后重启虚拟机，让 macOS 暴露 `BlackHole 2ch`： ```bash sudo reboot ``` -重启后，验证 VM 能看到音频设备和 SoX 命令： +重启后，验证虚拟机可以看到音频设备和 SoX 命令： ```bash system_profiler SPAudioDataType | grep -i BlackHole command -v sox ``` -在 VM 中安装或更新 OpenClaw，然后在那里启用内置插件： +在虚拟机中安装或更新 OpenClaw，然后在那里启用内置插件： ```bash openclaw plugins enable google-meet ``` -在 VM 中启动节点主机： +在虚拟机中启动节点主机： ```bash openclaw node run --host --port 18789 --display-name parallels-macos ``` -如果 `` 是 LAN IP 且你未使用 TLS，则节点会拒绝明文 WebSocket，除非你为该受信任的私有网络选择加入： +如果 `` 是 LAN IP 且你没有使用 TLS，节点会拒绝明文 WebSocket，除非你为该受信任的私有网络选择加入： ```bash OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \ @@ -190,7 +190,7 @@ OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \ openclaw node restart ``` -`OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1` 是进程环境，而不是 `openclaw.json` 设置。当安装命令中存在该环境变量时，`openclaw node install` 会将其存入 LaunchAgent 环境。 +`OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1` 是进程环境，不是 `openclaw.json` 设置。当安装命令中存在它时，`openclaw node install` 会把它存储在 LaunchAgent 环境中。 从 Gateway 网关主机批准节点： @@ -199,13 +199,13 @@ openclaw devices list openclaw devices approve ``` -确认 Gateway 网关能看到该节点，并且它发布了 `googlemeet.chrome` 以及浏览器能力/`browser.proxy`： +确认 Gateway 网关能看到该节点，并且该节点广播了 `googlemeet.chrome` 和浏览器能力/`browser.proxy`： ```bash openclaw nodes status ``` -在 Gateway 网关主机上通过该节点路由 Meet： +在 Gateway 网关主机上将 Meet 路由到该节点： ```json5 { @@ -243,55 +243,55 @@ openclaw googlemeet join https://meet.google.com/abc-defg-hij 或要求智能体使用带有 `transport: "chrome-node"` 的 `google_meet` 工具。 -若要进行一条命令的冒烟测试，创建或复用会话、说出已知短语，并打印会话健康状态： +对于一条命令的冒烟测试，它会创建或复用会话、说出已知短语，并打印会话健康状况： ```bash openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij ``` -在实时加入期间，OpenClaw 浏览器自动化会填写访客姓名，点击加入/请求加入，并在 Meet 首次运行的 “Use microphone” 选择出现时接受它。在仅观察加入或仅浏览器会议创建期间，如果有不使用麦克风的选项，它会在同一提示中选择继续而不使用麦克风。如果浏览器配置文件未登录、Meet 正在等待主持人准入、Chrome 需要麦克风/摄像头权限以进行实时加入，或 Meet 卡在自动化无法解决的提示上，加入/test-speech 结果会报告 `manualActionRequired: true`，并附带 `manualActionReason` 和 `manualActionMessage`。智能体应停止重试加入，报告该确切消息以及当前 `browserUrl`/`browserTitle`，并且只在手动浏览器操作完成后重试。 +实时加入期间，OpenClaw 浏览器自动化会填写访客名称、点击加入/请求加入，并在 Meet 首次运行的“使用麦克风”选项出现时接受它。在仅观察加入或仅浏览器创建会议期间，如果可用，它会在不使用麦克风的情况下继续通过相同提示。如果浏览器配置文件未登录、Meet 正在等待主持人准入、Chrome 在实时加入时需要麦克风/摄像头权限，或 Meet 卡在自动化无法解决的提示上，加入/test-speech 结果会报告 `manualActionRequired: true`，并带有 `manualActionReason` 和 `manualActionMessage`。智能体应停止重试加入，报告该确切消息以及当前 `browserUrl`/`browserTitle`，并且只在手动浏览器操作完成后重试。 -如果省略 `chromeNode.node`，OpenClaw 只有在正好有一个已连接节点同时发布 `googlemeet.chrome` 和浏览器控制时才会自动选择。如果连接了多个具备能力的节点，请将 `chromeNode.node` 设置为节点 ID、显示名称或远程 IP。 +如果省略 `chromeNode.node`，OpenClaw 只会在恰好有一个已连接节点同时广播 `googlemeet.chrome` 和浏览器控制时自动选择。如果连接了多个具备能力的节点，请将 `chromeNode.node` 设置为节点 id、显示名称或远程 IP。 -常见失败检查： +常见故障检查： -- `Configured Google Meet node ... is not usable: offline`：固定的节点已被 Gateway 网关识别，但不可用。智能体应将该节点视为诊断状态，而不是可用的 Chrome 主机，并报告设置阻塞问题，而不是回退到另一个传输协议，除非用户要求这样做。 +- `Configured Google Meet node ... is not usable: offline`：固定的节点已被 Gateway 网关识别，但当前不可用。智能体应将该节点视为诊断状态，而不是可用的 Chrome 主机，并报告设置阻塞项，而不是回退到另一种传输协议，除非用户明确要求这样做。 - `No connected Google Meet-capable node`：在 VM 中启动 `openclaw node run`，批准配对，并确保已在 VM 中运行 `openclaw plugins enable google-meet` 和 `openclaw plugins enable browser`。还要确认 Gateway 网关主机允许这两个节点命令：`gateway.nodes.allowCommands: ["googlemeet.chrome", "browser.proxy"]`。 -- `BlackHole 2ch audio device not found`：在被检查的主机上安装 `blackhole-2ch`，并在使用本地 Chrome 音频前重启。 +- `BlackHole 2ch audio device not found`：在被检查的主机上安装 `blackhole-2ch`，并在使用本地 Chrome 音频之前重启。 - `BlackHole 2ch audio device not found on the node`：在 VM 中安装 `blackhole-2ch`，并重启 VM。 -- Chrome 已打开但无法加入：登录 VM 内部的浏览器配置文件，或保留 `chrome.guestName` 以使用访客加入。访客自动加入通过节点浏览器代理使用 OpenClaw 浏览器自动化；确保节点浏览器配置指向你想使用的配置文件，例如 `browser.defaultProfile: "user"` 或一个已命名的现有会话配置文件。 -- Meet 标签页重复：保持启用 `chrome.reuseExistingTab: true`。OpenClaw 会先激活同一 Meet URL 的现有标签页，再打开新标签页；浏览器会议创建也会先复用进行中的 `https://meet.google.com/new` 或 Google 账号提示标签页，再打开另一个标签页。 -- 无音频：在 Meet 中，将麦克风/扬声器路由到 OpenClaw 使用的虚拟音频设备路径；使用独立的虚拟设备或 Loopback 风格的路由，以获得干净的双工音频。 +- Chrome 打开但无法加入：登录 VM 内的浏览器配置文件，或保留 `chrome.guestName` 以便访客加入。访客自动加入会通过节点浏览器代理使用 OpenClaw 浏览器自动化；请确保节点浏览器配置指向你想使用的配置文件，例如 `browser.defaultProfile: "user"` 或一个已命名的现有会话配置文件。 +- Meet 标签页重复：保持启用 `chrome.reuseExistingTab: true`。OpenClaw 会在打开新标签页之前激活同一 Meet URL 的现有标签页，并且浏览器会议创建会在打开另一个标签页之前复用进行中的 `https://meet.google.com/new` 或 Google 账号提示标签页。 +- 没有音频：在 Meet 中，将麦克风/扬声器路由到 OpenClaw 使用的虚拟音频设备路径；使用独立的虚拟设备或 Loopback 风格的路由，以获得清晰的双向音频。 ## 安装说明 Chrome 实时默认设置使用两个外部工具： -- `sox`：命令行音频工具。该插件为默认的 24 kHz PCM16 音频桥接使用显式 CoreAudio 设备命令。 -- `blackhole-2ch`：macOS 虚拟音频驱动。它会创建 Chrome/Meet 可通过其路由的 `BlackHole 2ch` 音频设备。 +- `sox`：命令行音频工具。该插件为默认 24 kHz PCM16 音频桥接使用显式 CoreAudio 设备命令。 +- `blackhole-2ch`：macOS 虚拟音频驱动。它会创建 Chrome/Meet 可路由的 `BlackHole 2ch` 音频设备。 -OpenClaw 不捆绑或再分发任一软件包。文档要求用户通过 Homebrew 将它们安装为主机依赖。SoX 的许可证为 `LGPL-2.0-only AND GPL-2.0-only`；BlackHole 为 GPL-3.0。如果你构建的安装程序或设备将 BlackHole 与 OpenClaw 捆绑，请审查 BlackHole 的上游许可条款，或从 Existential Audio 获取单独的许可证。 +OpenClaw 不捆绑或再分发这两个软件包。文档要求用户通过 Homebrew 将它们作为主机依赖项安装。SoX 的许可证是 `LGPL-2.0-only AND GPL-2.0-only`；BlackHole 是 GPL-3.0。如果你构建的安装程序或设备将 BlackHole 与 OpenClaw 捆绑，请查看 BlackHole 的上游许可条款，或从 Existential Audio 获取单独许可。 ## 传输协议 ### Chrome -Chrome 传输协议通过 OpenClaw 浏览器控制打开 Meet URL，并以已登录的 OpenClaw 浏览器配置文件加入。在 macOS 上，该插件会在启动前检查 `BlackHole 2ch`。如果已配置，它还会在打开 Chrome 前运行音频桥接健康命令和启动命令。当 Chrome/音频位于 Gateway 网关主机上时使用 `chrome`；当 Chrome/音频位于已配对节点（例如 Parallels macOS VM）上时使用 `chrome-node`。对于本地 Chrome，使用 `browser.defaultProfile` 选择配置文件；`chrome.browserProfile` 会传递给 `chrome-node` 主机。 +Chrome 传输协议通过 OpenClaw 浏览器控制打开 Meet URL，并以已登录的 OpenClaw 浏览器配置文件加入。在 macOS 上，该插件会在启动前检查 `BlackHole 2ch`。如果已配置，它还会在打开 Chrome 之前运行音频桥接健康检查命令和启动命令。当 Chrome/音频位于 Gateway 网关主机上时使用 `chrome`；当 Chrome/音频位于已配对节点（例如 Parallels macOS VM）上时使用 `chrome-node`。对于本地 Chrome，请使用 `browser.defaultProfile` 选择配置文件；`chrome.browserProfile` 会传递给 `chrome-node` 主机。 ```bash openclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome openclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome-node ``` -将 Chrome 麦克风和扬声器音频路由到本地 OpenClaw 音频桥接。如果未安装 `BlackHole 2ch`，加入会因设置错误失败，而不是在没有音频路径的情况下静默加入。 +将 Chrome 麦克风和扬声器音频路由到本地 OpenClaw 音频桥接。如果未安装 `BlackHole 2ch`，加入会因设置错误而失败，而不是在没有音频路径的情况下静默加入。 ### Twilio -Twilio 传输协议是委托给 Voice Call 插件的严格拨号计划。它不会解析 Meet 页面以查找电话号码。 +Twilio 传输协议是委托给 Voice Call 插件的严格拨号方案。它不会解析 Meet 页面来查找电话号码。 -当 Chrome 参会不可用，或你想要电话拨入回退时使用此方式。Google Meet 必须为会议公开电话拨入号码和 PIN；OpenClaw 不会从 Meet 页面发现这些信息。 +当 Chrome 参与不可用，或你需要电话拨入回退方案时使用它。Google Meet 必须为会议提供电话拨入号码和 PIN；OpenClaw 不会从 Meet 页面发现这些信息。 -在 Gateway 网关主机上启用 Voice Call 插件，而不是在 Chrome 节点上启用： +在 Gateway 网关主机上启用 Voice Call 插件，而不是在 Chrome 节点上： ```json5 { @@ -316,7 +316,7 @@ Twilio 传输协议是委托给 Voice Call 插件的严格拨号计划。它不 } ``` -通过环境或配置提供 Twilio 凭据。环境会避免密钥进入 `openclaw.json`： +通过环境或配置提供 Twilio 凭据。环境变量可避免将密钥放入 `openclaw.json`： ```bash export TWILIO_ACCOUNT_SID=AC... @@ -324,7 +324,7 @@ export TWILIO_AUTH_TOKEN=... export TWILIO_FROM_NUMBER=+15550001234 ``` -启用 `voice-call` 后重启或重新加载 Gateway 网关；插件配置变更在 Gateway 网关进程重新加载前不会出现在已运行的进程中。 +启用 `voice-call` 后重启或重新加载 Gateway 网关；插件配置更改在 Gateway 网关进程重新加载前不会出现在已运行的进程中。 然后验证： @@ -334,7 +334,7 @@ openclaw plugins list | grep -E 'google-meet|voice-call' openclaw googlemeet setup ``` -当 Twilio 委托已接好后，`googlemeet setup` 会包含成功的 `twilio-voice-call-plugin` 和 `twilio-voice-call-credentials` 检查。 +当 Twilio 委托接好后，`googlemeet setup` 会包含成功的 `twilio-voice-call-plugin` 和 `twilio-voice-call-credentials` 检查。 ```bash openclaw googlemeet join https://meet.google.com/abc-defg-hij \ @@ -343,7 +343,7 @@ openclaw googlemeet join https://meet.google.com/abc-defg-hij \ --pin 123456 ``` -当会议需要自定义序列时，使用 `--dtmf-sequence`： +当会议需要自定义序列时使用 `--dtmf-sequence`： ```bash openclaw googlemeet join https://meet.google.com/abc-defg-hij \ @@ -354,11 +354,11 @@ openclaw googlemeet join https://meet.google.com/abc-defg-hij \ ## OAuth 和预检 -OAuth 对创建 Meet 链接是可选的，因为 `googlemeet create` 可以回退到浏览器自动化。当你想使用官方 API 创建、空间解析或 Meet Media API 预检检查时，请配置 OAuth。 +创建 Meet 链接时 OAuth 是可选的，因为 `googlemeet create` 可以回退到浏览器自动化。当你需要官方 API 创建、空间解析或 Meet Media API 预检检查时配置 OAuth。 -Google Meet API 访问使用用户 OAuth：创建 Google Cloud OAuth 客户端，请求所需作用域，授权一个 Google 账号，然后将生成的 refresh token 存储在 Google Meet 插件配置中，或提供 `OPENCLAW_GOOGLE_MEET_*` 环境变量。 +Google Meet API 访问使用用户 OAuth：创建 Google Cloud OAuth 客户端，请求所需 scope，授权 Google 账号，然后将生成的 refresh token 存储在 Google Meet 插件配置中，或提供 `OPENCLAW_GOOGLE_MEET_*` 环境变量。 -OAuth 不会替代 Chrome 加入路径。当你使用浏览器参会时，Chrome 和 Chrome-node 传输协议仍通过已登录的 Chrome 配置文件、BlackHole/SoX 以及已连接节点加入。OAuth 仅用于官方 Google Meet API 路径：创建会议空间、解析空间，以及运行 Meet Media API 预检检查。 +OAuth 不会替代 Chrome 加入路径。当你使用浏览器参与时，Chrome 和 Chrome-node 传输协议仍会通过已登录的 Chrome 配置文件、BlackHole/SoX 以及已连接节点加入。OAuth 仅用于官方 Google Meet API 路径：创建会议空间、解析空间，以及运行 Meet Media API 预检检查。 ### 创建 Google 凭据 @@ -367,25 +367,25 @@ OAuth 不会替代 Chrome 加入路径。当你使用浏览器参会时，Chrome 1. 创建或选择一个 Google Cloud 项目。 2. 为该项目启用 **Google Meet REST API**。 3. 配置 OAuth 同意屏幕。 - - 对于 Google Workspace 组织，**Internal** 最简单。 - - **External** 适用于个人/测试设置；当应用处于 Testing 状态时，将每个要授权该应用的 Google 账号添加为测试用户。 -4. 添加 OpenClaw 请求的作用域： + - **内部** 对 Google Workspace 组织最简单。 + - **外部** 适用于个人/测试设置；当应用处于 Testing 状态时，将每个会授权该应用的 Google 账号添加为测试用户。 +4. 添加 OpenClaw 请求的 scope： - `https://www.googleapis.com/auth/meetings.space.created` - `https://www.googleapis.com/auth/meetings.space.readonly` - `https://www.googleapis.com/auth/meetings.conference.media.readonly` 5. 创建 OAuth 客户端 ID。 - 应用类型：**Web application**。 - - 已获授权的重定向 URI： + - 已授权重定向 URI： ```text http://localhost:8085/oauth2callback ``` -6. 复制客户端 ID 和客户端密钥。 +6. 复制 client ID 和 client secret。 Google Meet `spaces.create` 需要 `meetings.space.created`。`meetings.space.readonly` 允许 OpenClaw 将 Meet URL/代码解析为空间。`meetings.conference.media.readonly` 用于 Meet Media API 预检和媒体工作；Google 可能要求实际使用 Media API 时加入 Developer Preview。如果你只需要基于浏览器的 Chrome 加入，请完全跳过 OAuth。 -### 生成 refresh token +### 签发 refresh token 配置 `oauth.clientId` 和可选的 `oauth.clientSecret`，或将它们作为环境变量传入，然后运行： @@ -393,7 +393,7 @@ Google Meet `spaces.create` 需要 `meetings.space.created`。`meetings.space.re openclaw googlemeet auth login --json ``` -该命令会打印一个包含 refresh token 的 `oauth` 配置块。它使用 PKCE、`http://localhost:8085/oauth2callback` 上的 localhost 回调，以及带 `--manual` 的手动复制/粘贴流程。 +该命令会输出包含 refresh token 的 `oauth` 配置块。它使用 PKCE、`http://localhost:8085/oauth2callback` 上的 localhost 回调，以及带 `--manual` 的手动复制/粘贴流程。 示例： @@ -447,50 +447,50 @@ JSON 输出包含： } ``` -当你不希望 refresh token 出现在配置中时，优先使用环境变量。如果配置和环境值都存在，插件会先解析配置，然后再使用环境回退。 +如果你不想将 refresh token 放入配置，优先使用环境变量。如果配置和环境值同时存在，插件会先解析配置，然后再使用环境回退值。 -OAuth 同意包含 Meet 空间创建、Meet 空间读取访问权限和 Meet 会议媒体读取访问权限。如果你在会议创建支持出现前已完成身份验证，请重新运行 `openclaw googlemeet auth login --json`，使 refresh token 具有 `meetings.space.created` 作用域。 +OAuth 同意范围包括 Meet 空间创建、Meet 空间读取访问和 Meet 会议媒体读取访问。如果你在会议创建支持存在之前完成过身份验证，请重新运行 `openclaw googlemeet auth login --json`，让 refresh token 拥有 `meetings.space.created` scope。 ### 使用 Doctor 验证 OAuth -当你需要快速、无密钥的健康检查时，运行 OAuth Doctor： +当你需要快速、无密钥输出的健康检查时，运行 OAuth Doctor： ```bash openclaw googlemeet doctor --oauth --json ``` -这不会加载 Chrome 运行时，也不需要已连接的 Chrome 节点。它会检查 OAuth 配置是否存在，以及 refresh token 能否生成 access token。JSON 报告仅包含 `ok`、`configured`、`tokenSource`、`expiresAt` 和检查消息等状态字段；它不会打印 access token、refresh token 或客户端密钥。 +这不会加载 Chrome 运行时，也不需要已连接的 Chrome 节点。它会检查 OAuth 配置是否存在，以及 refresh token 是否能签发 access token。JSON 报告只包含 `ok`、`configured`、`tokenSource`、`expiresAt` 和检查消息等状态字段；不会输出 access token、refresh token 或 client secret。 常见结果： | 检查 | 含义 | | -------------------- | --------------------------------------------------------------------------------------- | -| `oauth-config` | 存在 `oauth.clientId` 加 `oauth.refreshToken`，或存在已缓存的 access token。 | -| `oauth-token` | 已缓存的 access token 仍然有效，或 refresh token 已生成新的 access token。 | -| `meet-spaces-get` | 可选的 `--meeting` 检查已解析现有 Meet 空间。 | -| `meet-spaces-create` | 可选的 `--create-space` 检查已创建新的 Meet 空间。 | +| `oauth-config` | 存在 `oauth.clientId` 加 `oauth.refreshToken`，或存在缓存的 access token。 | +| `oauth-token` | 缓存的 access token 仍然有效，或 refresh token 已签发新的 access token。 | +| `meet-spaces-get` | 可选的 `--meeting` 检查解析了现有 Meet 空间。 | +| `meet-spaces-create` | 可选的 `--create-space` 检查创建了新的 Meet 空间。 | -若还要证明 Google Meet API 已启用并且具备 `spaces.create` 作用域，请运行会产生副作用的创建检查： +若还要证明 Google Meet API 已启用以及拥有 `spaces.create` scope，请运行会产生副作用的创建检查： ```bash openclaw googlemeet doctor --oauth --create-space --json openclaw googlemeet create --no-join --json ``` -`--create-space` 会创建一个一次性 Meet URL。当你需要确认 Google Cloud 项目已启用 Meet API，并且已授权账号具有 `meetings.space.created` 作用域时使用它。 +`--create-space` 会创建一个一次性 Meet URL。当你需要确认 Google Cloud 项目已启用 Meet API，且已授权账号拥有 `meetings.space.created` scope 时使用它。 -若要证明现有会议空间的读取访问权限： +若要证明对现有会议空间的读取访问： ```bash openclaw googlemeet doctor --oauth --meeting https://meet.google.com/abc-defg-hij --json openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij ``` -`doctor --oauth --meeting` 和 `resolve-space` 证明对已授权 Google 账号可访问的现有空间具有读取访问权限。这些检查返回 `403` 通常表示 Google Meet REST API 已禁用、已同意授权的 refresh token 缺少所需作用域，或 Google 账号无法访问该 Meet 空间。refresh-token 错误表示需要重新运行 `openclaw googlemeet auth login --json` 并存储新的 `oauth` 块。 +`doctor --oauth --meeting` 和 `resolve-space` 证明对已授权 Google 账号可访问的现有空间具有读取权限。这些检查返回 `403` 通常表示 Google Meet REST API 已禁用、已同意的 refresh token 缺少所需 scope，或该 Google 账号无法访问该 Meet 空间。refresh-token 错误表示需要重新运行 `openclaw googlemeet auth login --json`，并存储新的 `oauth` 块。 -浏览器回退不需要 OAuth 凭据。在该模式下，Google 身份验证来自所选节点上已登录的 Chrome 配置文件，而不是来自 OpenClaw 配置。 +浏览器回退不需要 OAuth 凭据。在该模式下，Google 身份验证来自所选节点上的已登录 Chrome 配置文件，而不是 OpenClaw 配置。 -这些环境变量可作为回退使用： +以下环境变量可作为回退值： - `OPENCLAW_GOOGLE_MEET_CLIENT_ID` 或 `GOOGLE_MEET_CLIENT_ID` - `OPENCLAW_GOOGLE_MEET_CLIENT_SECRET` 或 `GOOGLE_MEET_CLIENT_SECRET` @@ -507,13 +507,13 @@ openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij ``` -在处理媒体之前运行预检： +在处理媒体前运行预检： ```bash openclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij ``` -在 Meet 创建会议记录后，列出会议工件和出席情况： +在 Meet 创建会议记录后列出会议工件和出席情况： ```bash openclaw googlemeet artifacts --meeting https://meet.google.com/abc-defg-hij @@ -521,9 +521,9 @@ openclaw googlemeet attendance --meeting https://meet.google.com/abc-defg-hij openclaw googlemeet export --meeting https://meet.google.com/abc-defg-hij --output ./meet-export ``` -带有 `--meeting` 时，`artifacts` 和 `attendance` 默认使用最新的会议记录。当你想要该会议的每条已保留记录时，传入 `--all-conference-records`。 +使用 `--meeting` 时，`artifacts` 和 `attendance` 默认使用最新会议记录。当你需要该会议保留的所有记录时，传入 `--all-conference-records`。 -Calendar 查找可以先从 Google Calendar 解析会议 URL，再读取 Meet 工件： +日历查找可以先从 Google Calendar 解析会议 URL，再读取 Meet 工件： ```bash openclaw googlemeet latest --today @@ -532,9 +532,9 @@ openclaw googlemeet artifacts --event "Weekly sync" openclaw googlemeet attendance --today --format csv --output attendance.csv ``` -`--today` 会在今天的 `primary` Calendar 中搜索带有 Google Meet 链接的 Calendar 事件。使用 `--event ` 搜索匹配的事件文本，并使用 `--calendar ` 指定非主 Calendar。Calendar 查找需要一次新的 OAuth 登录，并包含 Calendar events readonly 作用域。`calendar-events` 会预览匹配的 Meet 事件，并标记 `latest`、`artifacts`、`attendance` 或 `export` 将选择的事件。 +`--today` 会在今天的 `primary` 日历中搜索带有 Google Meet 链接的 Calendar 事件。使用 `--event ` 搜索匹配的事件文本，使用 `--calendar ` 指定非主日历。日历查找需要包含 Calendar events readonly scope 的新 OAuth 登录。`calendar-events` 会预览匹配的 Meet 事件，并标记 `latest`、`artifacts`、`attendance` 或 `export` 将选择的事件。 -如果你已经知道会议记录 ID，可以直接指定它： +如果你已经知道会议记录 ID，可以直接指定： ```bash openclaw googlemeet latest --meeting https://meet.google.com/abc-defg-hij @@ -557,11 +557,11 @@ openclaw googlemeet export --conference-record conferenceRecords/abc123 \ --include-doc-bodies --dry-run ``` -当 Google 为该会议公开相关数据时，`artifacts` 会返回会议记录元数据，以及参与者、录制、转录、结构化转录条目和智能笔记资源元数据。对于大型会议，使用 `--no-transcript-entries` 跳过条目查找。`attendance` 会将参与者展开为参与者会话行，包含首次/最后出现时间、总会话时长、迟到/提前离开标记，并按已登录用户或显示名称合并重复的参与者资源。传入 `--no-merge-duplicates` 可保留原始参与者资源分离，传入 `--late-after-minutes` 可调整迟到检测，传入 `--early-before-minutes` 可调整提前离开检测。 +当 Google 为该会议公开这些数据时，`artifacts` 会返回会议记录元数据，以及参与者、录制、转录、结构化转录条目和智能笔记资源元数据。对大型会议使用 `--no-transcript-entries` 可跳过条目查找。`attendance` 会把参与者展开为参与者会话行，包含首次/最后看到时间、总会话时长、迟到/提前离开标记，并按已登录用户或显示名称合并重复的参与者资源。传入 `--no-merge-duplicates` 可保留原始参与者资源为独立项，传入 `--late-after-minutes` 调整迟到检测，传入 `--early-before-minutes` 调整提前离开检测。 -`export` 会写入一个文件夹，其中包含 `summary.md`、`attendance.csv`、`transcript.md`、`artifacts.json`、`attendance.json` 和 `manifest.json`。`manifest.json` 会记录所选输入、导出选项、会议记录、输出文件、计数、令牌来源、使用过的 Calendar 事件，以及任何部分检索警告。传入 `--zip` 还会在文件夹旁写入一个可移植归档。传入 `--include-doc-bodies` 可通过 Google Drive `files.export` 导出链接的转录和智能笔记 Google Docs 文本；这需要一次新的 OAuth 登录，并包含 Drive Meet readonly 作用域。不使用 `--include-doc-bodies` 时，导出只包含 Meet 元数据和结构化转录条目。如果 Google 返回部分工件失败，例如智能笔记列表、转录条目或 Drive 文档正文错误，摘要和清单会保留警告，而不会让整个导出失败。使用 `--dry-run` 可获取相同的工件/出席数据并打印清单 JSON，而不创建文件夹或 ZIP。这在写入大型导出之前，或当智能体只需要计数、选定记录和警告时很有用。 +`export` 会写入一个文件夹，包含 `summary.md`、`attendance.csv`、`transcript.md`、`artifacts.json`、`attendance.json` 和 `manifest.json`。`manifest.json` 会记录所选输入、导出选项、会议记录、输出文件、计数、令牌来源、使用过的 Calendar 事件，以及任何部分检索警告。传入 `--zip` 还会在文件夹旁写入一个便携归档。传入 `--include-doc-bodies` 可通过 Google Drive `files.export` 导出链接的转录和智能笔记 Google Docs 文本；这需要包含 Drive Meet readonly scope 的新 OAuth 登录。未使用 `--include-doc-bodies` 时，导出仅包含 Meet 元数据和结构化转录条目。如果 Google 返回部分工件失败，例如智能笔记列表、转录条目或 Drive 文档正文错误，摘要和清单会保留警告，而不是让整个导出失败。使用 `--dry-run` 可获取相同的工件/出席数据并打印清单 JSON，而不创建文件夹或 ZIP。这适合在写入大型导出前使用，或在智能体只需要计数、所选记录和警告时使用。 -智能体也可以通过 `google_meet` 工具创建同样的包： +智能体也可以通过 `google_meet` 工具创建相同的打包内容： ```json { @@ -573,7 +573,7 @@ openclaw googlemeet export --conference-record conferenceRecords/abc123 \ } ``` -设置 `"dryRun": true` 只返回导出清单并跳过文件写入。 +设置 `"dryRun": true` 可仅返回导出清单并跳过文件写入。 针对真实保留会议运行受保护的实时冒烟测试： @@ -586,12 +586,12 @@ pnpm test:live -- extensions/google-meet/google-meet.live.test.ts 实时冒烟测试环境： - `OPENCLAW_LIVE_TEST=1` 启用受保护的实时测试。 -- `OPENCLAW_GOOGLE_MEET_LIVE_MEETING` 指向已保留的 Meet URL、代码或 `spaces/{id}`。 +- `OPENCLAW_GOOGLE_MEET_LIVE_MEETING` 指向保留的 Meet URL、代码或 `spaces/{id}`。 - `OPENCLAW_GOOGLE_MEET_CLIENT_ID` 或 `GOOGLE_MEET_CLIENT_ID` 提供 OAuth 客户端 ID。 - `OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN` 或 `GOOGLE_MEET_REFRESH_TOKEN` 提供刷新令牌。 -- 可选：`OPENCLAW_GOOGLE_MEET_CLIENT_SECRET`、`OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN` 和 `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT` 使用不带 `OPENCLAW_` 前缀的相同回退名称。 +- 可选：`OPENCLAW_GOOGLE_MEET_CLIENT_SECRET`、`OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN` 和 `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT` 使用不带 `OPENCLAW_` 前缀的相同后备名称。 -基础工件/出席实时冒烟测试需要 `https://www.googleapis.com/auth/meetings.space.readonly` 和 `https://www.googleapis.com/auth/meetings.conference.media.readonly`。Calendar 查找需要 `https://www.googleapis.com/auth/calendar.events.readonly`。Drive 文档正文导出需要 `https://www.googleapis.com/auth/drive.meet.readonly`。 +基础工件/出席实时冒烟测试需要 `https://www.googleapis.com/auth/meetings.space.readonly` 和 `https://www.googleapis.com/auth/meetings.conference.media.readonly`。日历查找需要 `https://www.googleapis.com/auth/calendar.events.readonly`。Drive 文档正文导出需要 `https://www.googleapis.com/auth/drive.meet.readonly`。 创建新的 Meet 空间： @@ -599,9 +599,9 @@ pnpm test:live -- extensions/google-meet/google-meet.live.test.ts openclaw googlemeet create ``` -该命令会打印新的 `meeting uri`、来源和加入会话。使用 OAuth 凭据时，它会使用官方 Google Meet API。没有 OAuth 凭据时，它会使用固定 Chrome 节点的已登录浏览器配置文件作为回退。智能体可以使用 `google_meet` 工具并设置 `action: "create"`，一步创建并加入。若只创建 URL，传入 `"join": false`。 +该命令会打印新的 `meeting uri`、来源和加入会话。使用 OAuth 凭证时，它使用官方 Google Meet API。没有 OAuth 凭证时，它使用固定 Chrome 节点的已登录浏览器配置文件作为后备。智能体可以使用带有 `action: "create"` 的 `google_meet` 工具在一步中创建并加入。若只创建 URL，传入 `"join": false`。 -浏览器回退的 JSON 输出示例： +浏览器后备的 JSON 输出示例： ```json { @@ -621,7 +621,7 @@ openclaw googlemeet create } ``` -如果浏览器回退在创建 URL 之前遇到 Google 登录或 Meet 权限阻塞，Gateway 网关方法会返回失败响应，`google_meet` 工具会返回结构化详情，而不是纯字符串： +如果浏览器后备在创建 URL 前遇到 Google 登录或 Meet 权限阻塞，Gateway 网关方法会返回失败响应，`google_meet` 工具会返回结构化详情，而不是纯字符串： ```json { @@ -639,7 +639,7 @@ openclaw googlemeet create } ``` -当智能体看到 `manualActionRequired: true` 时，应报告 `manualActionMessage` 以及浏览器节点/标签页上下文，并停止打开新的 Meet 标签页，直到操作者完成浏览器步骤。 +当智能体看到 `manualActionRequired: true` 时，应报告 `manualActionMessage` 以及浏览器节点/标签页上下文，并停止打开新的 Meet 标签页，直到操作员完成浏览器步骤。 API 创建的 JSON 输出示例： @@ -662,13 +662,13 @@ API 创建的 JSON 输出示例： } ``` -创建 Meet 默认会加入。Chrome 或 Chrome 节点传输仍需要已登录的 Google Chrome 配置文件，才能通过浏览器加入。如果配置文件已登出，OpenClaw 会报告 `manualActionRequired: true` 或浏览器回退错误，并要求操作者完成 Google 登录后重试。 +创建 Meet 默认会加入。Chrome 或 Chrome 节点传输仍需要已登录的 Google Chrome 配置文件，才能通过浏览器加入。如果配置文件已退出登录，OpenClaw 会报告 `manualActionRequired: true` 或浏览器后备错误，并要求操作员先完成 Google 登录后再重试。 -仅在确认你的 Cloud 项目、OAuth 主体和会议参与者已加入适用于 Meet 媒体 API 的 Google Workspace Developer Preview Program 后，才设置 `preview.enrollmentAcknowledged: true`。 +仅在确认你的 Cloud 项目、OAuth 主体和会议参与者已加入用于 Meet media APIs 的 Google Workspace Developer Preview Program 后，才设置 `preview.enrollmentAcknowledged: true`。 ## 配置 -常见的 Chrome 实时路径只需要启用插件、BlackHole、SoX，以及一个后端实时语音提供商密钥。OpenAI 是默认值；设置 `realtime.provider: "google"` 可使用 Google Gemini Live： +通用 Chrome 实时路径只需要启用该插件、BlackHole、SoX，以及后端实时语音提供商密钥。OpenAI 是默认值；设置 `realtime.provider: "google"` 可使用 Google Gemini Live： ```bash brew install blackhole-2ch sox @@ -698,20 +698,20 @@ export GEMINI_API_KEY=... - `defaultMode: "realtime"` - `chromeNode.node`：用于 `chrome-node` 的可选节点 ID/名称/IP - `chrome.audioBackend: "blackhole-2ch"` -- `chrome.guestName: "OpenClaw Agent"`：已登出 Meet 访客屏幕上使用的名称 -- `chrome.autoJoin: true`：在 `chrome-node` 上通过 OpenClaw 浏览器自动化尽力填写访客名称并点击 Join Now +- `chrome.guestName: "OpenClaw Agent"`：在已退出登录的 Meet 访客屏幕上使用的名称 +- `chrome.autoJoin: true`：通过 `chrome-node` 上的 OpenClaw 浏览器自动化，尽力填写访客名称并点击立即加入 - `chrome.reuseExistingTab: true`：激活现有 Meet 标签页，而不是打开重复标签页 -- `chrome.waitForInCallMs: 20000`：在触发实时介绍前，等待 Meet 标签页报告已在通话中 +- `chrome.waitForInCallMs: 20000`：等待 Meet 标签页报告已在通话中，然后触发实时介绍 - `chrome.audioFormat: "pcm16-24khz"`：命令对音频格式。仅对仍输出电话音频的旧版/自定义命令对使用 `"g711-ulaw-8khz"`。 -- `chrome.audioInputCommand`：SoX 命令，从 CoreAudio `BlackHole 2ch` 读取并以 `chrome.audioFormat` 写入音频 -- `chrome.audioOutputCommand`：SoX 命令，以 `chrome.audioFormat` 读取音频并写入 CoreAudio `BlackHole 2ch` +- `chrome.audioInputCommand`：从 CoreAudio `BlackHole 2ch` 读取并以 `chrome.audioFormat` 写入音频的 SoX 命令 +- `chrome.audioOutputCommand`：读取 `chrome.audioFormat` 格式音频并写入 CoreAudio `BlackHole 2ch` 的 SoX 命令 - `realtime.provider: "openai"` - `realtime.toolPolicy: "safe-read-only"` -- `realtime.instructions`：简短的口语回复，并使用 `openclaw_agent_consult` 处理更深入的答案 -- `realtime.introMessage`：实时桥接连接时的简短口语就绪检查；将其设置为 `""` 可静默加入 -- `realtime.agentId`：用于 `openclaw_agent_consult` 的可选 OpenClaw 智能体 ID；默认为 `main` +- `realtime.instructions`：简短口头回复，并用 `openclaw_agent_consult` 处理更深入的答案 +- `realtime.introMessage`：实时桥接连接时的简短口头就绪检查；将其设为 `""` 可静默加入 +- `realtime.agentId`：用于 `openclaw_agent_consult` 的可选 OpenClaw 智能体 ID；默认值为 `main` -可选覆盖： +可选覆盖项： ```json5 { @@ -758,7 +758,7 @@ export GEMINI_API_KEY=... } ``` -`voiceCall.enabled` 默认为 `true`；使用 Twilio 传输时，它会将实际 PSTN 呼叫和 DTMF 委托给 Voice Call 插件。如果未启用 `voice-call`，Google Meet 仍可验证并记录拨号计划，但无法发起 Twilio 呼叫。 +`voiceCall.enabled` 默认值为 `true`；使用 Twilio 传输时，它会把实际 PSTN 呼叫和 DTMF 委托给 Voice Call 插件。如果未启用 `voice-call`，Google Meet 仍可验证和记录拨号计划，但无法发起 Twilio 呼叫。 ## 工具 @@ -773,18 +773,21 @@ export GEMINI_API_KEY=... } ``` -当 Chrome 在 Gateway 网关主机上运行时，使用 `transport: "chrome"`。当 Chrome 在配对节点（例如 Parallels VM）上运行时，使用 `transport: "chrome-node"`。在两种情况下，realtime 模型和 `openclaw_agent_consult` 都在 Gateway 网关主机上运行，因此模型凭证会保留在那里。 +当 Chrome 在 Gateway 网关主机上运行时，使用 `transport: "chrome"`。当 Chrome 在配对节点（例如 Parallels VM）上运行时，使用 +`transport: "chrome-node"`。在这两种情况下，实时模型和 `openclaw_agent_consult` 都在 +Gateway 网关主机上运行，因此模型凭证会留在那里。 -使用 `action: "status"` 列出活跃会话或检查会话 ID。使用带有 `sessionId` 和 `message` 的 `action: "speak"` 让 realtime 智能体立即说话。使用 `action: "test_speech"` 创建或复用会话、触发一个已知短语，并在 Chrome 主机能够报告时返回 `inCall` 健康状态。`test_speech` 始终强制使用 `mode: "realtime"`，如果要求它在 `mode: "transcribe"` 中运行则会失败，因为仅观察会话有意不能发出语音。它的 `speechOutputVerified` 结果基于本次测试调用期间 realtime 音频输出字节数增加，因此带有旧音频的复用会话不算作一次新的成功语音检查。使用 `action: "leave"` 将会话标记为已结束。 +使用 `action: "status"` 列出活跃会话或检查某个会话 ID。使用 +`action: "speak"` 并带上 `sessionId` 和 `message`，可让实时智能体立即发言。使用 `action: "test_speech"` 可创建或复用会话、触发一个已知短语，并在 Chrome 主机可以报告时返回 `inCall` 健康状态。`test_speech` 始终强制使用 `mode: "realtime"`，如果被要求以 `mode: "transcribe"` 运行则会失败，因为仅观察会话有意不能发出语音。它的 `speechOutputVerified` 结果基于本次测试调用期间实时音频输出字节数是否增加，因此复用的会话中较早的音频不会算作一次新的成功语音检查。使用 `action: "leave"` 将会话标记为已结束。 -`status` 在可用时包含 Chrome 健康状态： +`status` 会在可用时包含 Chrome 健康状态： -- `inCall`：Chrome 似乎已在 Meet 通话中 +- `inCall`：Chrome 似乎在 Meet 通话中 - `micMuted`：尽力判断的 Meet 麦克风状态 -- `manualActionRequired` / `manualActionReason` / `manualActionMessage`：浏览器配置文件需要手动登录、Meet 主持人准入、权限授予或浏览器控制修复，语音才能工作 -- `speechReady` / `speechBlockedReason` / `speechBlockedMessage`：托管 Chrome 语音当前是否允许使用。`speechReady: false` 表示 OpenClaw 没有将介绍语/测试短语发送到音频桥。 -- `providerConnected` / `realtimeReady`：realtime 语音桥状态 -- `lastInputAt` / `lastOutputAt`：上次从桥接收或发送到桥的音频时间 +- `manualActionRequired` / `manualActionReason` / `manualActionMessage`：浏览器配置文件需要手动登录、Meet 主持人准入、权限或浏览器控制修复，语音才能工作 +- `speechReady` / `speechBlockedReason` / `speechBlockedMessage`：当前是否允许托管 Chrome 语音。`speechReady: false` 表示 OpenClaw 没有把介绍/测试短语发送进音频桥。 +- `providerConnected` / `realtimeReady`：实时语音桥状态 +- `lastInputAt` / `lastOutputAt`：桥接器上次接收或发送音频的时间 ```json { @@ -794,29 +797,29 @@ export GEMINI_API_KEY=... } ``` -## Realtime 智能体咨询 +## 实时智能体咨询 -Chrome realtime 模式针对实时语音循环做了优化。realtime 语音提供商会听取会议音频，并通过已配置的音频桥说话。当 realtime 模型需要更深入的推理、当前信息或普通 OpenClaw 工具时，它可以调用 `openclaw_agent_consult`。 +Chrome 实时模式针对实时语音循环优化。实时语音提供商会听取会议音频，并通过配置的音频桥发声。当实时模型需要更深入的推理、当前信息或普通 OpenClaw 工具时，它可以调用 `openclaw_agent_consult`。 -咨询工具会在后台运行常规 OpenClaw 智能体，带上最近的会议转录上下文，并向 realtime 语音会话返回简洁的口语答案。语音模型随后可以把该答案说回会议中。它使用与 Voice Call 相同的共享 realtime 咨询工具。 +咨询工具会在后台运行常规 OpenClaw 智能体，带上最近的会议转录上下文，并向实时语音会话返回一个简洁的口语答案。然后语音模型可以把该答案说回会议中。它使用与 Voice Call 相同的共享实时咨询工具。 -默认情况下，咨询针对 `main` 智能体运行。当某个 Meet 通道应咨询专用 OpenClaw 智能体工作区、模型默认值、工具策略、记忆和会话历史时，设置 `realtime.agentId`。 +默认情况下，咨询会针对 `main` 智能体运行。当某个 Meet 通道应咨询专用 OpenClaw 智能体工作区、模型默认值、工具策略、记忆和会话历史时，请设置 `realtime.agentId`。 `realtime.toolPolicy` 控制咨询运行： -- `safe-read-only`：公开咨询工具，并将常规智能体限制为 `read`、`web_search`、`web_fetch`、`x_search`、`memory_search` 和 `memory_get`。 -- `owner`：公开咨询工具，并允许常规智能体使用正常的智能体工具策略。 -- `none`：不向 realtime 语音模型公开咨询工具。 +- `safe-read-only`：暴露咨询工具，并将常规智能体限制为 `read`、`web_search`、`web_fetch`、`x_search`、`memory_search` 和 `memory_get`。 +- `owner`：暴露咨询工具，并允许常规智能体使用普通智能体工具策略。 +- `none`：不向实时语音模型暴露咨询工具。 -咨询会话键按每个 Meet 会话限定范围，因此在同一场会议中，后续咨询调用可以复用之前的咨询上下文。 +咨询会话键按 Meet 会话限定作用域，因此同一场会议中的后续咨询调用可以复用先前的咨询上下文。 -在 Chrome 完全加入通话后，如需强制执行一次口头就绪检查： +要在 Chrome 完全加入通话后强制进行一次口播就绪检查： ```bash openclaw googlemeet speak meet_... "Say exactly: I'm here and listening." ``` -完整的加入并说话冒烟测试： +完整的加入并发声冒烟测试： ```bash openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \ @@ -826,7 +829,7 @@ openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \ ## 实时测试清单 -在把会议交给无人值守智能体之前，使用此流程： +在把会议交给无人值守的智能体之前，使用以下序列： ```bash openclaw googlemeet setup @@ -836,15 +839,15 @@ openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \ --message "Say exactly: Google Meet speech test complete." ``` -预期 Chrome-node 状态： +预期的 Chrome-node 状态： - `googlemeet setup` 全部为绿色。 -- 当 Chrome-node 是默认传输方式或固定了某个节点时，`googlemeet setup` 包含 `chrome-node-connected`。 +- 当 Chrome-node 是默认传输协议或某个节点被固定时，`googlemeet setup` 包含 `chrome-node-connected`。 - `nodes status` 显示所选节点已连接。 -- 所选节点同时公布 `googlemeet.chrome` 和 `browser.proxy`。 -- Meet 标签页加入通话，并且 `test-speech` 返回带有 `inCall: true` 的 Chrome 健康状态。 +- 所选节点同时通告 `googlemeet.chrome` 和 `browser.proxy`。 +- Meet 标签页加入通话，并且 `test-speech` 返回包含 `inCall: true` 的 Chrome 健康状态。 -对于远程 Chrome 主机（例如 Parallels macOS VM），在更新 Gateway 网关或 VM 后，这是最短的安全检查： +对于远程 Chrome 主机（例如 Parallels macOS VM），这是更新 Gateway 网关或 VM 后最短的安全检查： ```bash openclaw googlemeet setup @@ -855,9 +858,9 @@ openclaw nodes invoke \ --params '{"action":"setup"}' ``` -这证明 Gateway 网关插件已加载、VM 节点已使用当前令牌连接，并且 Meet 音频桥在智能体打开真实会议标签页之前可用。 +这可以证明 Gateway 网关插件已加载，VM 节点已使用当前令牌连接，并且在智能体打开真实会议标签页之前，Meet 音频桥可用。 -对于 Twilio 冒烟测试，请使用公开电话拨入详情的会议： +对于 Twilio 冒烟测试，请使用一个公开电话拨入详情的会议： ```bash openclaw googlemeet setup @@ -867,11 +870,11 @@ openclaw googlemeet join https://meet.google.com/abc-defg-hij \ --pin 123456 ``` -预期 Twilio 状态： +预期的 Twilio 状态： - `googlemeet setup` 包含绿色的 `twilio-voice-call-plugin` 和 `twilio-voice-call-credentials` 检查。 -- Gateway 网关重新加载后，`voicecall` 可在 CLI 中使用。 -- 返回的会话具有 `transport: "twilio"` 和 `twilio.voiceCallId`。 +- Gateway 网关重新加载后，CLI 中可使用 `voicecall`。 +- 返回的会话包含 `transport: "twilio"` 和 `twilio.voiceCallId`。 - `googlemeet leave ` 会挂断委托的语音通话。 ## 故障排除 @@ -885,7 +888,7 @@ openclaw plugins list | grep google-meet openclaw googlemeet setup ``` -如果你刚刚编辑了 `plugins.entries.google-meet`，请重启或重新加载 Gateway 网关。正在运行的智能体只能看到由当前 Gateway 网关进程注册的插件工具。 +如果你刚刚编辑了 `plugins.entries.google-meet`，请重启或重新加载 Gateway 网关。正在运行的智能体只能看到当前 Gateway 网关进程注册的插件工具。 ### 没有已连接且支持 Google Meet 的节点 @@ -898,7 +901,7 @@ OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \ openclaw node run --host --port 18789 --display-name parallels-macos ``` -在 Gateway 网关主机上，批准节点并验证命令： +在 Gateway 网关主机上，批准该节点并验证命令： ```bash openclaw devices list @@ -906,7 +909,8 @@ openclaw devices approve openclaw nodes status ``` -节点必须已连接，并列出 `googlemeet.chrome` 以及 `browser.proxy`。Gateway 网关配置必须允许这些节点命令： +节点必须已连接，并列出 `googlemeet.chrome` 加上 `browser.proxy`。 +Gateway 网关配置必须允许这些节点命令： ```json5 { @@ -936,68 +940,67 @@ openclaw googlemeet setup openclaw nodes status --connected ``` -### 浏览器打开，但智能体无法加入 +### 浏览器打开但智能体无法加入 运行 `googlemeet test-speech` 并检查返回的 Chrome 健康状态。如果它报告 `manualActionRequired: true`，请向操作员显示 `manualActionMessage`，并在浏览器操作完成前停止重试。 -常见手动操作： +常见的手动操作： - 登录 Chrome 配置文件。 -- 从 Meet 主持人账号准入访客。 -- 当 Chrome 的原生权限提示出现时，授予 Chrome 麦克风/摄像头权限。 +- 由 Meet 主持人账号准入访客。 +- 在 Chrome 原生权限提示出现时，授予 Chrome 麦克风/摄像头权限。 - 关闭或修复卡住的 Meet 权限对话框。 -不要仅仅因为 Meet 显示 “Do you want people to hear you in the meeting?” 就报告“未登录”。这是 Meet 的音频选择插页；OpenClaw 会在可用时通过浏览器自动化点击 **Use microphone**，并继续等待真实会议状态。对于仅创建的浏览器回退，OpenClaw 可能会点击 **Continue without microphone**，因为创建 URL 不需要 realtime 音频路径。 +不要仅仅因为 Meet 显示“你想让会议中的人听到你的声音吗？”就报告“未登录”。这是 Meet 的音频选择插屏；OpenClaw 会在可用时通过浏览器自动化点击 **使用麦克风**，并继续等待真实会议状态。对于仅创建浏览器回退，OpenClaw 可能会点击 **在不使用麦克风的情况下继续**，因为创建 URL 不需要实时音频路径。 ### 会议创建失败 -配置了 OAuth 凭证时，`googlemeet create` 首先使用 Google Meet API `spaces.create` 端点。如果没有 OAuth 凭证，它会回退到固定的 Chrome 节点浏览器。确认： +当 OAuth 凭证已配置时，`googlemeet create` 会首先使用 Google Meet API `spaces.create` 端点。没有 OAuth 凭证时，它会回退到固定的 Chrome 节点浏览器。确认： - 对于 API 创建：已配置 `oauth.clientId` 和 `oauth.refreshToken`，或存在匹配的 `OPENCLAW_GOOGLE_MEET_*` 环境变量。 -- 对于 API 创建：刷新令牌是在添加创建支持之后签发的。较旧令牌可能缺少 `meetings.space.created` 作用域；请重新运行 `openclaw googlemeet auth login --json` 并更新插件配置。 -- 对于浏览器回退：`defaultTransport: "chrome-node"` 且 `chromeNode.node` 指向一个已连接并带有 `browser.proxy` 和 `googlemeet.chrome` 的节点。 +- 对于 API 创建：刷新令牌是在添加创建支持后生成的。较旧的令牌可能缺少 `meetings.space.created` 作用域；请重新运行 `openclaw googlemeet auth login --json` 并更新插件配置。 +- 对于浏览器回退：`defaultTransport: "chrome-node"` 且 `chromeNode.node` 指向一个已连接、带有 `browser.proxy` 和 `googlemeet.chrome` 的节点。 - 对于浏览器回退：该节点上的 OpenClaw Chrome 配置文件已登录 Google，并且可以打开 `https://meet.google.com/new`。 -- 对于浏览器回退：重试会先复用现有 `https://meet.google.com/new` 或 Google 账号提示标签页，然后才打开新标签页。如果智能体超时，请重试该工具调用，而不是手动打开另一个 Meet 标签页。 -- 对于浏览器回退：如果工具返回 `manualActionRequired: true`，请使用返回的 `browser.nodeId`、`browser.targetId`、`browserUrl` 和 `manualActionMessage` 指导操作员。在该操作完成前，不要循环重试。 -- 对于浏览器回退：如果 Meet 显示 “Do you want people to hear you in the meeting?”，请保持标签页打开。OpenClaw 应通过浏览器自动化点击 **Use microphone**，或在仅创建回退时点击 **Continue without microphone**，然后继续等待生成的 Meet URL。如果无法做到，错误应提到 `meet-audio-choice-required`，而不是 `google-login-required`。 +- 对于浏览器回退：重试会在打开新标签页之前复用现有的 `https://meet.google.com/new` 或 Google 账号提示标签页。如果智能体超时，请重试工具调用，而不是手动再打开一个 Meet 标签页。 +- 对于浏览器回退：如果工具返回 `manualActionRequired: true`，请使用返回的 `browser.nodeId`、`browser.targetId`、`browserUrl` 和 `manualActionMessage` 指导操作员。在该操作完成前不要循环重试。 +- 对于浏览器回退：如果 Meet 显示“你想让会议中的人听到你的声音吗？”，请保持标签页打开。OpenClaw 应通过浏览器自动化点击 **使用麦克风**，或对于仅创建回退点击 **在不使用麦克风的情况下继续**，并继续等待生成的 Meet URL。如果无法完成，错误应提到 `meet-audio-choice-required`，而不是 `google-login-required`。 ### 智能体加入但不说话 -检查 realtime 路径： +检查实时路径： ```bash openclaw googlemeet setup openclaw googlemeet doctor ``` -使用 `mode: "realtime"` 进行监听/回话。`mode: "transcribe"` 有意不启动双工 realtime 语音桥。`googlemeet test-speech` 始终检查 realtime 路径，并报告是否观察到本次调用的桥输出字节。如果 `speechOutputVerified` 为 false 且 `speechOutputTimedOut` 为 true，realtime 提供商可能已接受话语，但 OpenClaw 没有看到新的输出字节到达 Chrome 音频桥。 +使用 `mode: "realtime"` 进行监听/回话。`mode: "transcribe"` 有意不启动双工实时语音桥。`googlemeet test-speech` 始终检查实时路径，并报告是否在该调用中观察到桥接器输出字节。如果 `speechOutputVerified` 为 false 且 `speechOutputTimedOut` 为 true，实时提供商可能已经接受了话语，但 OpenClaw 没有看到新的输出字节到达 Chrome 音频桥。 还要验证： -- Gateway 网关主机上有可用的 realtime 提供商密钥，例如 `OPENAI_API_KEY` 或 `GEMINI_API_KEY`。 -- `BlackHole 2ch` 在 Chrome 主机上可见。 -- `sox` 存在于 Chrome 主机上。 +- Gateway 网关主机上有可用的实时提供商密钥，例如 `OPENAI_API_KEY` 或 `GEMINI_API_KEY`。 +- Chrome 主机上可以看到 `BlackHole 2ch`。 +- Chrome 主机上存在 `sox`。 - Meet 麦克风和扬声器通过 OpenClaw 使用的虚拟音频路径路由。 -`googlemeet doctor [session-id]` 会打印会话、节点、通话中状态、手动操作原因、realtime 提供商连接、`realtimeReady`、音频输入/输出活动、最后音频时间戳、字节计数器和浏览器 URL。当你需要原始 JSON 时，使用 `googlemeet status [session-id]`。当你需要在不暴露令牌的情况下验证 Google Meet OAuth 刷新时，使用 `googlemeet doctor --oauth`；当你还需要 Google Meet API 证明时，添加 `--meeting` 或 `--create-space`。 +`googlemeet doctor [session-id]` 会打印会话、节点、通话内状态、手动操作原因、实时提供商连接、`realtimeReady`、音频输入/输出活动、最近音频时间戳、字节计数器和浏览器 URL。当你需要原始 JSON 时，使用 `googlemeet status [session-id] --json`。当你需要在不暴露令牌的情况下验证 Google Meet OAuth 刷新时，使用 `googlemeet doctor --oauth`；当你还需要 Google Meet API 证明时，添加 `--meeting` 或 `--create-space`。 -如果智能体已超时且你能看到一个已经打开的 Meet 标签页，请检查该标签页，而不要再打开另一个： +如果智能体超时，而你能看到 Meet 标签页已经打开，请在不打开另一个标签页的情况下检查该标签页： ```bash openclaw googlemeet recover-tab openclaw googlemeet recover-tab https://meet.google.com/abc-defg-hij ``` -等效工具操作是 `recover_current_tab`。它会聚焦并检查所选传输方式的现有 Meet 标签页。使用 `chrome` 时，它通过 Gateway 网关进行本地浏览器控制；使用 `chrome-node` 时，它使用已配置的 Chrome 节点。它不会打开新标签页或创建新会话；它会报告当前阻塞原因，例如登录、准入、权限或音频选择状态。CLI 命令会与已配置的 Gateway 网关通信，因此 Gateway 网关必须正在运行；`chrome-node` 还要求 Chrome 节点已连接。 +等效的工具操作是 `recover_current_tab`。它会聚焦并检查所选传输协议的现有 Meet 标签页。使用 `chrome` 时，它通过 Gateway 网关使用本地浏览器控制；使用 `chrome-node` 时，它使用配置的 Chrome 节点。它不会打开新标签页或创建新会话；它会报告当前阻塞项，例如登录、准入、权限或音频选择状态。CLI 命令会与配置的 Gateway 网关通信，因此 Gateway 网关必须正在运行；`chrome-node` 还要求 Chrome 节点已连接。 ### Twilio 设置检查失败 -`twilio-voice-call-plugin` 会在不允许或未启用 `voice-call` 时失败。 +`twilio-voice-call-plugin` 在 `voice-call` 未被允许或未启用时会失败。 将它添加到 `plugins.allow`，启用 `plugins.entries.voice-call`，然后重新加载 Gateway 网关。 -`twilio-voice-call-credentials` 会在 Twilio 后端缺少账户 -SID、认证令牌或主叫号码时失败。在 Gateway 网关主机上设置这些变量： +`twilio-voice-call-credentials` 在 Twilio 后端缺少账户 SID、认证令牌或主叫号码时会失败。在 Gateway 网关主机上设置这些变量： ```bash export TWILIO_ACCOUNT_SID=AC... @@ -1013,19 +1016,19 @@ openclaw voicecall setup openclaw voicecall smoke ``` -`voicecall smoke` 默认只检查就绪状态。要对特定号码执行试运行： +`voicecall smoke` 默认只检查就绪状态。要对特定号码执行 dry run： ```bash openclaw voicecall smoke --to "+15555550123" ``` -只有在你明确想要发起真实的外呼通知电话时，才添加 `--yes`： +只有在你有意拨打实时外呼通知电话时，才添加 `--yes`： ```bash openclaw voicecall smoke --to "+15555550123" --yes ``` -### Twilio 通话已开始但从未进入会议 +### Twilio 通话开始但从未进入会议 确认 Meet 事件公开了电话拨入详情。传入准确的拨入号码和 PIN，或自定义 DTMF 序列： @@ -1036,24 +1039,24 @@ openclaw googlemeet join https://meet.google.com/abc-defg-hij \ --dtmf-sequence ww123456# ``` -如果提供商在输入 PIN 前需要暂停，请在 `--dtmf-sequence` 中使用前导 `w` 或逗号。 +如果提供商需要在输入 PIN 之前暂停，请在 `--dtmf-sequence` 中使用前导 `w` 或逗号。 ## 备注 -Google Meet 的官方媒体 API 面向接收，因此在 Meet 通话中发言仍然需要参与者路径。此插件会让这条边界保持明确： +Google Meet 的官方媒体 API 偏向接收，因此向 Meet 通话中讲话仍然需要一个参会者路径。这个插件让该边界保持可见： Chrome 处理浏览器参会和本地音频路由；Twilio 处理电话拨入参会。 -Chrome 实时模式需要 `BlackHole 2ch`，并配合以下二者之一： +Chrome 实时模式需要 `BlackHole 2ch`，并且还需要以下其中一种： -- `chrome.audioInputCommand` 加 `chrome.audioOutputCommand`：OpenClaw 拥有实时模型桥接，并在这些命令和所选实时语音提供商之间按 `chrome.audioFormat` 传输音频。默认 Chrome 路径是 24 kHz PCM16；8 kHz G.711 mu-law 仍可用于旧版命令对。 +- `chrome.audioInputCommand` 加 `chrome.audioOutputCommand`：OpenClaw 拥有实时模型桥，并在这些命令和所选实时语音提供商之间通过 `chrome.audioFormat` 管道传输音频。默认 Chrome 路径是 24 kHz PCM16；8 kHz G.711 mu-law 仍可用于旧版命令对。 - `chrome.audioBridgeCommand`：外部桥接命令拥有整个本地音频路径，并且必须在启动或验证其守护进程后退出。 -为获得干净的双工音频，请将 Meet 输出和 Meet 麦克风路由到不同的虚拟设备，或路由到 Loopback 风格的虚拟设备图。单个共享的 BlackHole 设备可能会把其他参与者的声音回传到通话中。 +为了获得干净的双工音频，请通过不同的虚拟设备或 Loopback 风格的虚拟设备图来路由 Meet 输出和 Meet 麦克风。单个共享的 BlackHole 设备可能会将其他参会者的声音回放到通话中。 -`googlemeet speak` 会为 Chrome 会话触发当前活动的实时音频桥接。`googlemeet leave` 会停止该桥接。对于通过 Voice Call 插件委托的 Twilio 会话，`leave` 也会挂断底层语音通话。 +`googlemeet speak` 会触发 Chrome 会话的活动实时音频桥。`googlemeet leave` 会停止该桥。对于通过 Voice Call 插件委托的 Twilio 会话，`leave` 还会挂断底层语音通话。 -## 相关 +## 相关内容 -- [Voice Call 插件](/zh-CN/plugins/voice-call) +- [语音通话插件](/zh-CN/plugins/voice-call) - [通话模式](/zh-CN/nodes/talk) - [构建插件](/zh-CN/plugins/building-plugins)