Google 遇到故障排除

飞行前实时测试清单以及针对连接、语音、创建和 Twilio 故障的修复。 Google Meet 插件 指南的一部分。

实时测试清单

在将会议交给无人值守代理之前：

openclaw googlemeet setupopenclaw nodes statusopenclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \  --transport chrome-node \  --message "Say exactly: Google Meet speech test complete."

预期 Chrome-node 状态：

• googlemeet setup 全部为绿色，并且当 Chrome-node 是默认传输方式或已固定某个节点时，会包含 chrome-node-connected。
• nodes status 显示所选节点已连接，并同时广播 googlemeet.chrome 和 browser.proxy。
• Meet 标签页加入会议，并且 test-speech 返回带有 inCall: true 的 Chrome 健康状态。

对于远程 Chrome 主机（例如 Parallels macOS VM），更新网关或 VM 后最短的安全检查：

openclaw googlemeet setupopenclaw nodes status --connectedopenclaw nodes invoke \  --node parallels-macos \  --command googlemeet.chrome \  --params '{"action":"setup"}'

这证明网关插件已加载，VM 节点已与当前令牌连接，并且在客服人员打开真正的会议选项卡之前，会议音频桥可用。

对于 Twilio 试运行，请使用一个提供电话拨入详情的会议：

openclaw googlemeet setupopenclaw googlemeet join https://meet.google.com/abc-defg-hij \  --transport twilio \  --dial-in-number +15551234567 \  --pin 123456

预期 Twilio 状态：

• googlemeet setup 包含绿色的 twilio-voice-call-plugin、twilio-voice-call-credentials 和 twilio-voice-call-webhook 检查项。
• 安装并启用语音通话插件后，voicecall 在 CLI 中可用。
• 返回的会话具有 transport: "twilio" 和 twilio.voiceCallId。
• openclaw logs --follow 显示先提供 DTMF TwiML，再提供 realtime TwiML，随后是带有已排队初始问候语的实时桥接。
• googlemeet leave <sessionId> 挂断委托的语音通话。

故障排查

Agent 无法看到 Google Meet 工具

确认插件已启用且其运行时应用成功；请参阅 应用更改并检查 。然后检查设置：

openclaw plugins list | grep google-meetopenclaw googlemeet setup

在 Linux 上，本地 Chrome 回传音频需要 Chrome 桌面用户会话中的 PipeWire-Pulse，以及 pactl、pacat 和 parec。在不受支持的操作系统上，请使用 mode: "transcribe"、Twilio 拨入，或受支持的 macOS/Linux chrome-node 主机。

没有已连接的支持 Google Meet 的节点

在节点主机上：

openclaw plugins install @openclaw/google-meetopenclaw plugins enable browserOPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node run --host <gateway-lan-ip> --port 18789 --display-name parallels-macos

在 Gateway 主机上：

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

节点必须已连接，并列出 googlemeet.chrome 和 browser.proxy；Gateway 配置也必须允许这两项：

{  gateway: {    nodes: {      commands: { allow: ["browser.proxy", "googlemeet.chrome"] },    },  },}

如果 googlemeet setup 失败并提示 chrome-node-connected，或者 Gateway 日志报告 gateway token mismatch，请使用当前 Gateway token 重新安装或重启节点：

OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node install \  --host <gateway-lan-ip> \  --port 18789 \  --display-name parallels-macos \  --force

然后重新加载节点服务并再次运行：

openclaw googlemeet setupopenclaw nodes status --connected

浏览器打开了，但 agent 无法加入

运行 googlemeet test-listen 进行仅观察式加入，或运行 googlemeet test-speech 进行实时加入，然后检查返回的 Chrome 健康状态。如果任一命令的结果包含 manualAction，请向操作员显示 manualAction.message，并在浏览器操作完成前停止重试。

常见手动操作：登录 Chrome 个人资料；从 Meet 主持人帐户接纳来宾；出现本机提示时授予 Chrome microphone/camera 权限；关闭或修复卡住的 Meet 权限对话框。

不要因为 Meet 提示“您希望会议中的其他人听到您的声音吗？”就报告“未登录”；那是 Meet 的音频选择中间页。OpenClaw 会在可用时通过浏览器自动化点击 使用麦克风，并继续等待真正的会议状态；对于仅创建的浏览器回退路径，它可能会改为点击 不使用麦克风继续，因为生成 URL 不需要实时音频路径。

会议创建失败

配置 OAuth 时，googlemeet create 使用 Meet API spaces.create，否则使用固定的 Chrome 节点浏览器。确认：

• API 创建：存在 oauth.clientId 和 oauth.refreshToken（或对应的 OPENCLAW_GOOGLE_MEET_* 环境变量），并且刷新令牌是在添加创建支持后生成的；较旧的令牌可能缺少 meetings.space.created 权限，因此请重新运行 openclaw googlemeet auth login --json。
• 浏览器回退：defaultTransport: "chrome-node" 且 chromeNode.node 指向一个已连接的节点，该节点具有 browser.proxy 和 googlemeet.chrome；该节点上的 OpenClaw Chrome 配置文件已登录，并且可以打开 https://meet.google.com/new。
• 浏览器回退重试：在打开新标签页之前，先复用现有的 .../new 标签页或 Google 账户提示标签页；应重试工具调用，而不是手动打开另一个标签页。
• 人工操作：如果工具返回 manualAction，请使用 browser.nodeId、browser.targetId、browserUrl 和 manualAction.message 引导操作员；不要循环重试。
• 音频选择中间页：如果 Meet 显示“您希望会议中的其他人听到您的声音吗？”，请保持标签页打开。OpenClaw 应点击 使用麦克风，或（仅创建场景）点击 不使用麦克风继续，并继续等待生成的 URL；如果无法完成，错误应提及 meet-audio-choice-required，而不是 google-login-required。

Agent 加入了，但没有说话

openclaw googlemeet setupopenclaw googlemeet doctor

对 STT -> OpenClaw 代理 -> TTS 路径使用 mode: "agent"，或对实时语音使用 mode: "bidi"，包括 GPT-Live。 mode: "transcribe" 故意启动无对讲桥。对于仅观察调试，请在参与者发言后运行 openclaw googlemeet status --json <session-id> 并检查 captioning、transcriptLines、lastCaptionText。如果 inCall 为 true，但 transcriptLines 仍为 0，则 Meet 字幕可能被禁用、自安装观察员以来无人发言、Meet UI 已更改，或者会议 language/account. 的实时字幕不可用

googlemeet test-speech 检查所选的对讲路径，并需要虚拟麦克风捕获路径上的新助理输出波形。如果 speechOutputVerified 为 false 并且 speechOutputTimedOut 为 true，则检查提供程序输出和本机 injection/loopback 字段；仅接受的输出字节并不能证明语音已到达 Meet 的麦克风。

还要验证网关主机上的提供商身份验证、Chrome 主机上的本机音频后端以及 doctor 中的两个音频路由。通过生成的输入命令，浏览器会话使用虚拟麦克风进行助理注入，并报告 Isolated browser playback 供参与者输入。显式输入命令保留其配置的捕获路径。 GPT-Live with Cove 使用配置的 OpenAI 帐户；请参阅 Live 配置。

googlemeet doctor [session-id] 打印会话、节点、通话状态、手动操作原因、实时提供商连接、realtimeReady、音频 input/output 活动、最后音频时间戳、字节计数器和浏览器 URL。使用 googlemeet status [session-id] --json 作为原始 JSON 和 googlemeet doctor --oauth（添加 --meeting 或 --create-space）来验证 OAuth 刷新而不暴露令牌。

如果 agent 超时且已经打开了一个 Meet 标签页，请在不再打开新标签页的情况下检查它：

openclaw googlemeet recover-tabopenclaw googlemeet recover-tab https://meet.google.com/abc-defg-hij

对应的工具操作是 recover_current_tab：它会聚焦并检查所选传输方式的现有 Meet 标签页（chrome 使用本地浏览器控制，chrome-node 使用已配置的节点），而不会打开新标签页或新会话，并报告当前阻塞原因（登录、准入、权限、音频选择状态）。CLI 命令会连接到已配置的 Gateway，而 Gateway 必须正在运行；chrome-node 还要求节点已连接。

Live 听不到中断或浏览器捕获失败

将 bidi 模式与显式 Live 模型结合使用。在保持 agent 模式的情况下设置语音模型仍然使用常规 TTS。 GPT-Live 自行处理中断，因此 chrome.bargeInInputCommand 不是必需的，也不会为 Live 启动。

对于直播，参与者输入必须来自独立的浏览器播放。删除显式 chrome.audioInputCommand 以选择该托管路径；自定义命令仍然是其他模型的提供者输入，并且不会被默默地替换。如果桥报告它需要隔离会议音频或无法捕获浏览器播放，请检查跟踪的“会议”选项卡及其报告的浏览器错误。使用 chrome-node 时更新网关和配对节点，然后在浏览器播放可用后重试。桥接器在捕获失败时停止，而不是将辅助输出反馈回 Live。没有远程媒体的空房间仍然可以保持连接和空闲。

请勿将参与者回放路由回虚拟麦克风以解决捕获错误。要验证双工行为，请使用受控的第二个参与者来确认可以听到响应并在响应期间讲话；仅本地test-speech验证不能证明往返。

Twilio 设置检查失败

当不允许或未启用 voice-call 时，twilio-voice-call-plugin 会失败：将其添加到 plugins.allow，启用 plugins.entries.voice-call，并在应用更改后重新运行安装程序。

当 Twilio 后端缺少 account SID、auth token 或呼叫号码时，twilio-voice-call-credentials 会失败：

export TWILIO_ACCOUNT_SID=AC...export TWILIO_AUTH_TOKEN=...export TWILIO_FROM_NUMBER=+15550001234

当 voice-call 没有公共 webhook 暴露或 publicUrl 指向 loopback/private 网络空间时，twilio-voice-call-webhook 失败。请勿将 localhost、127.0.0.1、0.0.0.0、10.x、172.16.x-172.31.x、192.168.x、169.254.x、fc00::/7 或 fd00::/8 用作publicUrl；运营商回调无法到达这些。将 plugins.entries.voice-call.config.publicUrl 设置为公共 URL，或者配置 tunnel/Tailscale 曝光：

{  plugins: {    entries: {      "voice-call": {        enabled: true,        config: {          provider: "twilio",          fromNumber: "+15550001234",          publicUrl: "https://voice.example.com/voice/webhook",        },      },    },  },}

对于本地开发，请使用隧道或 Tailscale 暴露，而不是私有主机 URL：

{  plugins: {    entries: {      "voice-call": {        config: {          tunnel: { provider: "ngrok" },          // or          tailscale: { mode: "funnel", path: "/voice/webhook" },        },      },    },  },}

插件配置更改会自动应用默认的混合重新加载模式（请参阅 Hot reload）。如果您更改了基于环境的凭据，请使用更新后的环境重新启动网关。然后验证：

openclaw googlemeet setup --transport twilioopenclaw voicecall setupopenclaw voicecall smoke

默认情况下，voicecall smoke 仅进行就绪性检查。对指定号码做干运行：

openclaw voicecall smoke --to "+15555550123"

只有在明确要发起一次真实的外呼时才添加 --yes：

openclaw voicecall smoke --to "+15555550123" --yes

Twilio 呼叫开始了，但从未进入会议

确认 Meet 事件公开了电话拨入详情，并传入准确的拨入号码以及 PIN，或自定义 DTMF 序列：

openclaw googlemeet join https://meet.google.com/abc-defg-hij \  --transport twilio \  --dial-in-number +15551234567 \  --dtmf-sequence ww123456#

在 PIN 之前使用前导 w 或 --dtmf-sequence 中的逗号作为暂停。

如果呼叫已创建但 Meet 名单中始终没有显示拨入参与者：

• openclaw googlemeet doctor <session-id>：确认委派的 Twilio 呼叫 ID、是否已排队 DTMF，以及是否请求了开场问候。
• openclaw voicecall status --call-id <id>：确认呼叫仍处于活动状态。
• openclaw voicecall tail：确认 Twilio webhook 正在到达 Gateway。
• openclaw logs --follow：查找 Twilio Meet 序列：Google Meet 委派加入，Voice Call 存储并提供预连接 DTMF TwiML，Voice Call 为 Twilio 呼叫提供实时 TwiML，然后 Google Meet 通过 voicecall.speak 请求开场语音。
• 重新运行 openclaw googlemeet setup --transport twilio；绿色的 setup 检查是必需的，但并不能证明会议 PIN 序列正确。
• 确认拨入号码与 PIN 属于同一个 Meet 邀请和地区。
• 如果 Meet 应答缓慢或发送预连接 DTMF 后通话记录仍显示 PIN 提示，则从 12 秒默认值增加 voiceCall.dtmfDelayMs。
• 如果参与者已加入但你听不到问候语，请检查 openclaw logs --follow 中 DTMF 之后的 voicecall.speak 请求，以及媒体流 TTS 播放或 Twilio <Say> 回退。如果转录仍显示“请输入会议 PIN”，说明电话线路还未加入 Meet 房间，因此参与者不会听到语音。

如果 webhook 没有到达，请先调试 Voice Call 插件：提供方必须能够访问 plugins.entries.voice-call.config.publicUrl 或已配置的隧道。参见 语音呼叫故障排查。