google-meet 插件会代表 OpenClaw 智能体加入显式 Meet URL。它有意保持范围很窄：
- 它只加入
https://meet.google.com/...URL；绝不会从它自行发现的电话号码拨入会议。 googlemeet create可以通过 Google Meet API（或浏览器回退）创建新的 Meet URL，并默认加入该会议。- Chrome 参与使用已登录的 Chrome 配置文件，也可以在已配对的节点上进行。Twilio 参与会通过 Voice call 插件拨打电话号码加 PIN/DTMF；它无法直接拨打 Meet URL。
mode: "agent"（默认）使用实时提供商转写参会者语音，将其路由到已配置的 OpenClaw 智能体，并使用常规 OpenClaw TTS 播报答案。mode: "bidi"让实时语音模型直接回答。mode: "transcribe"以仅观察方式加入，不回话。- 插件加入通话时不会自动播报同意声明。
- CLI 命令是
googlemeet；meet保留给更宽泛的智能体电话会议工作流。
快速开始
安装本地音频依赖，然后设置实时提供商密钥。OpenAI 是agent 模式的默认转写提供商；Google Gemini Live 可用作 bidi 模式的语音提供商：
blackhole-2ch 会安装 Chrome 路由所用的 BlackHole 2ch 虚拟音频设备。Homebrew 的安装器要求重启后 macOS 才会暴露该设备：
setup 输出可由智能体读取，并且会感知模式/传输方式：它会报告 Chrome 配置文件、节点固定，以及针对实时 Chrome 加入场景的 BlackHole/SoX 音频桥和延迟开场检查。仅观察加入会跳过实时前置条件：
setup 还会报告 voice-call、Twilio 凭证和公共 webhook 暴露是否就绪。在智能体加入之前，应将该传输方式/模式下任何 ok: false 检查视为阻断项。使用 --json 获取机器可读输出，并使用 --transport chrome|chrome-node|twilio 提前预检特定传输方式：
google_meet 工具加入：
google_meet 对 artifact、日历、设置、转写、Twilio 和 chrome-node 操作仍然可见，但本地 Chrome 回话（transport: "chrome" 搭配 mode: "agent" 或 "bidi"）会在到达音频桥之前被阻止，因为该路径当前依赖 macOS BlackHole 2ch。请改用 mode: "transcribe"、Twilio 拨入，或 macOS chrome-node 主机。
创建会议
create 有两条路径，结果的 source 字段会报告使用哪一条：
api：配置了 Google Meet OAuth 凭证时使用。行为确定；不依赖浏览器 UI 状态。browser：未配置 OAuth 凭证时使用。OpenClaw 会在固定的 Chrome 节点上打开https://meet.google.com/new，并等待 Google 重定向到真实的会议代码 URL；该节点上的 OpenClaw Chrome 配置文件必须已经登录 Google。加入和创建都会先复用现有 Meet 标签页（或正在进行的.../new/ Google 账号提示标签页），然后才打开新标签页；标签页匹配会忽略authuser这类无害查询字符串。
create 默认会加入，并返回 joined: true 以及加入会话。传入 --no-join（CLI）或 "join": false（工具）可只创建 URL。
对于通过 API 创建的房间，请设置显式访问策略，而不是继承 Google 账号默认值：
--access-type | 谁可以无需敲门加入 |
|---|---|
OPEN | 拥有 Meet URL 的任何人 |
TRUSTED | 主办方组织的受信任用户、受邀外部用户和拨入用户 |
RESTRICTED | 仅受邀者 |
meetings.space.settings scope 后，重新运行 openclaw googlemeet auth login --json。
如果浏览器回退遇到 Google 登录或 Meet 权限阻断，工具会返回 manualActionRequired: true，并附带 manualActionReason、manualActionMessage 以及 browser.nodeId/browser.targetId/browserUrl。报告该消息，并停止打开新的 Meet 标签页，直到操作员完成浏览器步骤。
仅观察加入
设置"mode": "transcribe" 可跳过双工实时桥（不需要 BlackHole/SoX，也不会回话）。转写模式的 Chrome 加入还会跳过 OpenClaw 的麦克风/摄像头权限授权以及 Meet Use microphone 路径；如果 Meet 显示音频选择插屏，自动化会先尝试 Continue without microphone。此模式下的托管 Chrome 传输会安装一个尽力而为的 Meet 字幕观察器。googlemeet status --json 和 googlemeet doctor 会报告 captioning、captionsEnabledAttempted、transcriptLines、lastCaptionAt、lastCaptionSpeaker、lastCaptionText 以及 recentTranscript 尾部。
用于是/否监听探测：
listenVerified、listenTimedOut、手动操作字段以及当前字幕健康状态。
实时会话健康
在回话会话期间，google_meet 状态会报告 Chrome/音频桥健康状态：inCall、manualActionRequired、providerConnected、realtimeReady、audioInputActive、audioOutputActive、最近输入/输出时间戳、字节计数器以及桥已关闭状态。托管 Chrome 会话只有在健康状态报告 inCall: true 后才会播报开场/测试短语；否则 speechReady: false，并且语音尝试会被阻止，而不是静默空操作。
本地 Chrome 会通过已登录的 OpenClaw 浏览器配置文件加入，并需要 BlackHole 2ch 提供麦克风/扬声器路径。单个 BlackHole 设备足以进行首次冒烟测试，但可能产生回声；若要获得干净的双工音频，请使用独立的虚拟设备或 Loopback 风格的图。
本地 Gateway 网关 + Parallels Chrome
如果只是为了给 macOS VM 提供 Chrome，则不需要在 VM 内部运行完整 Gateway 网关或配置模型 API key。在本地运行 Gateway 网关和智能体；在 VM 中运行节点主机。| 运行位置 | 内容 |
|---|---|
| Gateway 网关主机 | OpenClaw Gateway 网关、智能体工作区、模型/API keys、实时提供商、Google Meet 插件配置 |
| Parallels macOS VM | OpenClaw CLI/节点主机、Chrome、SoX、BlackHole 2ch、已登录 Google 的 Chrome 配置文件 |
| VM 中不需要 | Gateway 网关服务、智能体配置、模型提供商设置 |
<gateway-host> 是没有 TLS 的 LAN IP，请为该受信任私有网络显式启用：
openclaw.json 设置）：
googlemeet.chrome 和浏览器能力/browser.proxy：
manualActionRequired: true，并附带 manualActionReason 和 manualActionMessage。停止重试，报告该消息以及 browserUrl/browserTitle，并且仅在手动操作完成后重试。
如果省略 chromeNode.node，OpenClaw 只会在恰好有一个已连接节点同时声明 googlemeet.chrome 和浏览器控制时自动选择；当连接了多个具备能力的节点时，请固定 chromeNode.node（节点 id、显示名称或远程 IP）。
常见失败检查
| 症状 | 修复 |
|---|---|
Configured Google Meet node ... is not usable: offline | 固定的节点已知但不可用。报告设置阻塞问题；除非被要求，否则不要静默回退到其他传输方式。 |
No connected Google Meet-capable node | 在 VM 中运行 openclaw node run，批准配对，并在那里运行 openclaw plugins enable google-meet 和 openclaw plugins enable browser。确认 gateway.nodes.allowCommands 包含 googlemeet.chrome 和 browser.proxy。 |
BlackHole 2ch audio device not found | 在正在检查的主机上安装 blackhole-2ch 并重启。 |
BlackHole 2ch audio device not found on the node | 在 VM 中安装 blackhole-2ch 并重启 VM。 |
| Chrome 打开但无法加入 | 登录 VM 中的浏览器配置文件，或保持设置 chrome.guestName。访客自动加入会通过节点浏览器代理使用 OpenClaw 浏览器自动化；将节点的 browser.defaultProfile（或具名的现有会话配置文件）指向你想使用的配置文件。 |
| Meet 标签页重复 | 保持 chrome.reuseExistingTab: true。OpenClaw 会为相同 URL 激活现有标签页，并且在打开另一个标签页之前，创建流程会复用进行中的 .../new 或 Google 账号提示标签页。 |
| 没有音频 | 将 Meet 麦克风/扬声器路由到 OpenClaw 使用的虚拟音频路径；使用独立的虚拟设备或 Loopback 风格路由来获得干净的双工音频。 |
安装说明
Chrome 回话默认值使用两个 OpenClaw 不捆绑或再分发的外部工具；请通过 Homebrew 将它们安装为主机依赖：sox：命令行音频实用工具。该插件会为默认的 24 kHz PCM16 音频桥接发出显式 CoreAudio 设备命令。blackhole-2ch：macOS 虚拟音频驱动，提供 Chrome/Meet 路由经过的BlackHole 2ch设备。
LGPL-2.0-only AND GPL-2.0-only 许可；BlackHole 采用 GPL-3.0。如果你构建的安装程序或设备将 BlackHole 与 OpenClaw 捆绑，请审查 BlackHole 的上游许可，或从 Existential Audio 获取单独许可。
传输方式
| 传输方式 | 使用场景 |
|---|---|
chrome | Chrome/音频位于 Gateway 网关主机 |
chrome-node | Chrome/音频位于已配对节点上（例如 Parallels macOS VM） |
twilio | 当 Chrome 参与不可用时，通过 Voice Call 插件使用电话拨入回退 |
Chrome
通过 OpenClaw 浏览器控制打开 Meet URL，并以已登录的 OpenClaw 浏览器配置文件加入。在 macOS 上，该插件会在启动前检查BlackHole 2ch，并且如果已配置，会在打开 Chrome 前运行音频桥接健康/启动命令。对于本地 Chrome，使用 browser.defaultProfile 选择配置文件；chrome.browserProfile 会传递给 chrome-node 主机。
BlackHole 2ch，加入会以设置错误失败，而不是在没有音频路径的情况下加入。
Twilio
委托给 Voice call 插件的严格拨号计划。它不会解析 Meet 页面来查找电话号码；Google Meet 必须为该会议公开电话拨入号码和 PIN。 在 Gateway 网关主机上启用 Voice Call，而不是 Chrome 节点：openclaw.json：
realtime.provider: "openai" 和 OPENAI_API_KEY。
启用 voice-call 后重启或重新加载 Gateway 网关；插件配置变更在重新加载前不会生效。验证：
googlemeet setup 会包含 twilio-voice-call-plugin、twilio-voice-call-credentials 和 twilio-voice-call-webhook 检查。
--dtmf-sequence 指定自定义序列，并用开头的 w 或逗号在 PIN 前加入暂停：
OAuth 和预检
OAuth 对创建 Meet 链接是可选的，因为googlemeet create 可以回退到浏览器自动化。为官方 API 创建、空间解析或 Meet Media API 预检配置 OAuth。Chrome/Chrome-node 加入从不依赖 OAuth；无论如何，它们都使用已登录的 Chrome 配置文件、BlackHole/SoX，以及（对于 chrome-node）已连接节点。
创建 Google 凭证
在 Google Cloud Console 中：配置 OAuth 同意屏幕
对于 Google Workspace 组织，Internal 最简单。External 可用于个人/测试设置；当应用处于 Testing 状态时，将每个会授权它的 Google 账号添加为测试用户。
添加请求的作用域
https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonlyhttps://www.googleapis.com/auth/meetings.space.settingshttps://www.googleapis.com/auth/meetings.conference.media.readonlyhttps://www.googleapis.com/auth/calendar.events.readonly（Calendar 查找）https://www.googleapis.com/auth/drive.meet.readonly（转录/智能笔记文档正文导出）
meetings.space.created 是 spaces.create 必需的。meetings.space.readonly 会将 Meet URL/代码解析为空间。meetings.space.settings 允许 OpenClaw 在 API 房间创建期间传递 SpaceConfig 设置，例如 accessType。meetings.conference.media.readonly 用于 Meet Media API 预检和媒体工作；Google 可能要求为实际 Media API 使用加入 Developer Preview。calendar.events.readonly 仅在 --today/--event 日历查找时需要。drive.meet.readonly 仅在 --include-doc-bodies 导出时需要。如果你只需要基于浏览器的 Chrome 加入，请完全跳过 OAuth。
生成刷新令牌
配置oauth.clientId 和可选的 oauth.clientSecret（或以环境变量传入），然后运行：
http://localhost:8085/oauth2callback 上使用 localhost 回调，然后打印一个包含刷新令牌的 oauth 配置块。当浏览器无法访问本地回调时，添加 --manual 使用复制/粘贴流程：
oauth 对象存储在插件配置下：
openclaw googlemeet auth login --json，确保刷新令牌覆盖当前作用域集合。
使用 Doctor 验证 OAuth
ok、configured、tokenSource、expiresAt、检查消息），并且绝不会打印访问令牌、刷新令牌或客户端密钥。
| 检查 | 含义 |
|---|---|
oauth-config | 存在 oauth.clientId 加 oauth.refreshToken，或存在缓存的访问令牌 |
oauth-token | 缓存的访问令牌仍有效，或刷新令牌已生成新的访问令牌 |
meet-spaces-get | 可选的 --meeting 检查已解析现有 Meet 空间 |
meet-spaces-create | 可选的 --create-space 检查已创建新的 Meet 空间 |
spaces.create 权限范围可用：
403 通常意味着 Meet REST API 已禁用、刷新令牌缺少所需权限范围，或 Google 账号无法访问该空间。刷新令牌错误意味着需要重新运行 openclaw googlemeet auth login --json，并存储新的 oauth 块。
浏览器回退不需要 OAuth；其中的 Google 身份验证来自所选节点上已登录的 Chrome 配置文件，而不是 OpenClaw 配置。
以下环境变量可作为回退值使用：
OPENCLAW_GOOGLE_MEET_CLIENT_ID或GOOGLE_MEET_CLIENT_IDOPENCLAW_GOOGLE_MEET_CLIENT_SECRET或GOOGLE_MEET_CLIENT_SECRETOPENCLAW_GOOGLE_MEET_REFRESH_TOKEN或GOOGLE_MEET_REFRESH_TOKENOPENCLAW_GOOGLE_MEET_ACCESS_TOKEN或GOOGLE_MEET_ACCESS_TOKENOPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT或GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_ATOPENCLAW_GOOGLE_MEET_DEFAULT_MEETING或GOOGLE_MEET_DEFAULT_MEETINGOPENCLAW_GOOGLE_MEET_PREVIEW_ACK或GOOGLE_MEET_PREVIEW_ACK
解析、预检和读取工件
--meeting 时，artifacts 和 attendance 默认使用最新的会议记录；传入 --all-conference-records 可处理每条保留的记录。
Calendar 查找会先从 Google Calendar 解析会议 URL，然后再读取工件（需要包含 Calendar events readonly 权限范围的刷新令牌）：
--today 会在今天的 primary 日历中搜索带有 Meet 链接的事件；--event <query> 会搜索匹配的事件文本；--calendar <id> 会指定非主日历。calendar-events 会预览匹配的事件，并标记 latest/artifacts/attendance/export 将选择哪一个。
如果你已经知道会议记录 ID，可以直接指定它：
spaces.endActiveConference，并要求对授权账号可管理的空间使用带有 meetings.space.created 权限范围的 OAuth。接受 Meet URL、会议代码或 spaces/{id}，并先将其解析为 API 空间资源。这不同于 googlemeet leave：leave 会停止 OpenClaw 的本地/会话参与；end-active-conference 会请求 Google Meet 结束该空间的活动会议。
写入可读报告：
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 会通过 Drive files.export 导出链接的转录/智能笔记 Google Docs 文本（需要 Drive Meet readonly 权限范围）；不使用它时，导出只包含 Meet 元数据和结构化转录条目。部分工件失败（智能笔记列表、转录条目或文档正文错误）会将警告保留在摘要/清单中，而不是让整个导出失败。--dry-run 会获取相同数据并打印清单 JSON，而不创建文件夹或 ZIP。
智能体通过 google_meet 工具使用相同操作（export、带 accessType 的 create、end_active_conference、test_listen）；请参见工具。
实时烟雾测试
| 变量 | 用途 |
|---|---|
OPENCLAW_LIVE_TEST=1 | 启用受保护的实时测试 |
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_ 前缀的同名回退值也可使用 |
meetings.space.readonly 和 meetings.conference.media.readonly。Calendar 查找需要 calendar.events.readonly。Drive 文档正文导出需要 drive.meet.readonly。
创建示例
google_meet 会返回结构化详情，而不是纯字符串：
manualActionRequired: true 或浏览器回退错误，并要求操作员完成 Google 登录后重试。
只有在确认你的 Cloud 项目、OAuth 主体和会议参与者都已加入适用于 Meet 媒体 API 的 Google Workspace Developer Preview Program 后，才设置 preview.enrollmentAcknowledged: true。
配置
常见的 Chrome 智能体路径只需要启用插件、BlackHole、SoX、一个实时提供商密钥，以及已配置的 OpenClaw TTS 提供商：默认值
| 键 | 默认值 | 说明 |
|---|---|---|
defaultTransport | "chrome" | |
defaultMode | "agent" | "realtime" 作为 "agent" 的旧版别名被接受；新的调用方应使用 "agent" |
chromeNode.node | 未设置 | chrome-node 的节点 ID/名称/IP；当可能连接多个具备能力的节点时必填 |
chrome.launch | true | 为加入会议启动 Chrome；仅在复用已打开的会话时设置为 false |
chrome.audioBackend | "blackhole-2ch" | |
chrome.guestName | "OpenClaw Agent" | 显示在未登录的 Meet 访客屏幕上 |
chrome.autoJoin | true | 在 chrome-node 上尽力填充访客名称并点击“立即加入” |
chrome.reuseExistingTab | true | 激活现有的 Meet 标签页，而不是打开重复标签页 |
chrome.waitForInCallMs | 20000 | 在 Talk-back 简介触发前，等待 Meet 标签页报告已进入通话 |
chrome.audioFormat | "pcm16-24khz" | 命令对音频格式；"g711-ulaw-8khz" 仅用于发出电话音频的旧版/自定义命令对 |
chrome.audioBufferBytes | 4096 | 生成的命令对音频命令的 SoX 处理缓冲区（SoX 默认 8192 字节缓冲区的一半，可降低管道延迟）；值会被限制为最小 17 字节 |
chrome.audioInputCommand | 生成的 SoX 命令 | 从 CoreAudio BlackHole 2ch 读取，并以 chrome.audioFormat 写入音频 |
chrome.audioOutputCommand | 生成的 SoX 命令 | 以 chrome.audioFormat 读取音频，并写入 CoreAudio BlackHole 2ch |
chrome.bargeInInputCommand | 未设置 | 可选的本地麦克风命令，写入有符号 16 位小端单声道 PCM，用于在助手播放期间检测人工插话；适用于 Gateway 网关托管的命令对桥接 |
chrome.bargeInRmsThreshold | 650 | 计为人工打断的 RMS 电平 |
chrome.bargeInPeakThreshold | 2500 | 计为人工打断的峰值电平 |
chrome.bargeInCooldownMs | 900 | 重复清除打断之间的最小延迟 |
mode（每次请求） | "agent" | Talk-back 模式；参见 Agent 和 bidi 模式表 |
realtime.provider | "openai" | 当下面的作用域字段未设置时使用的兼容性回退 |
realtime.transcriptionProvider | "openai" | agent 模式用于实时转录的提供商 ID |
realtime.voiceProvider | 未设置 | bidi 模式用于直接实时语音的提供商 ID；设置为 "google" 可使用 Gemini Live，同时保持 Agent 模式转录使用 OpenAI。与 realtime.model 搭配使用以选择具体的 Gemini Live 模型。 |
realtime.toolPolicy | "safe-read-only" | 参见 Agent 和 bidi 模式 |
realtime.instructions | 简短口头回复指令 | 告诉模型简短发言，并使用 openclaw_agent_consult 处理更深入的回答 |
realtime.introMessage | "Say exactly: I'm here and listening." | 实时桥接连接时播放一次；设置为 "" 可静默加入 |
realtime.agentId | "main" | openclaw_agent_consult 使用的 OpenClaw 智能体 ID |
voiceCall.enabled | true | 将 Twilio PSTN 呼叫、DTMF 和开场问候委托给 Voice Call 插件 |
voiceCall.dtmfDelayMs | 12000 | 通过 Twilio 播放从 PIN 派生的 DTMF 序列前的前置等待 |
voiceCall.postDtmfSpeechDelayMs | 5000 | Voice Call 启动 Twilio 呼叫段后，请求实时开场问候前的延迟 |
chrome.audioBridgeCommand 和 chrome.audioBridgeHealthCommand 允许外部桥接拥有整个本地音频路径，而不是使用 chrome.audioInputCommand/chrome.audioOutputCommand；关于哪些模式可以使用它们的限制，请参见说明。
存在一个用于旧版 realtime.provider: "google" 形状的 openclaw doctor --fix 迁移：当这些字段尚未设置时，它会将该意图移动到 realtime.voiceProvider: "google" 加上 realtime.transcriptionProvider: "openai"。
可选覆盖
messages.tts.providers.elevenlabs.speakerVoiceId。当启用 TTS 模型覆盖时，Agent 回复也可以使用每条回复的 [[tts:speakerVoiceId=... model=eleven_v3]] 指令，但配置是会议的确定性默认值。加入时，日志会显示 transcriptionProvider=elevenlabs，每条语音回复都会记录 provider=elevenlabs model=eleven_v3 speakerVoiceId=<voiceId>。
仅 Twilio 配置：
voiceCall.enabled: true（默认值）和 Twilio 传输时，Voice Call 会在打开实时媒体流之前放置 DTMF 序列，然后使用保存的简介文本作为初始实时问候。如果未启用 voice-call，Google Meet 仍可验证并记录拨号方案，但无法发起 Twilio 呼叫。
工具
智能体使用google_meet 工具：
action | 用途 |
|---|---|
join | 加入明确的 Meet URL |
create | 创建空间（并默认加入）；支持 accessType/entryPointAccess |
status | 列出活动会话，或通过 sessionId 检查某个会话 |
setup_status | 运行与 googlemeet setup 相同的检查 |
resolve_space | 通过 spaces.get 解析 URL/代码/spaces/{id} |
preflight | 验证 OAuth + 会议解析前提条件 |
latest | 查找会议的最新会议记录 |
calendar_events | 预览带有 Meet 链接的 Calendar 事件 |
artifacts | 列出会议记录以及参与者/录制/转写/智能笔记元数据 |
attendance | 列出参与者和参与者会话 |
export | 写入工件/出席情况/转写/清单包；设置 "dryRun": true 可仅生成清单 |
recover_current_tab | 聚焦/检查现有 Meet 标签页，而不打开新标签页 |
leave | 结束会话（对委托会话会挂断底层 Twilio 通话） |
end_active_conference | 结束 API 管理空间的活动 Google Meet 会议 |
speak | 在给定 sessionId 和 message 时，让实时智能体立即发言 |
test_speech | 创建/复用会话，触发已知短语，返回 Chrome 健康状态 |
test_listen | 创建/复用仅观察会话，等待字幕/转写发生变化 |
test_speech 始终强制使用 mode: "agent" 或 "bidi"，如果要求在 mode: "transcribe" 中运行则会失败，因为仅观察会话无法发出语音。它的 speechOutputVerified 结果基于该调用期间实时音频输出字节数是否增加，因此复用的会话中较早的音频不会被算作新的检查。
当 Chrome 在 Gateway 网关主机上运行时使用 transport: "chrome"；当它在已配对节点上运行时使用 transport: "chrome-node"。两种情况下，模型提供商和 openclaw_agent_consult 都在 Gateway 网关主机上运行，因此模型凭据保留在那里。智能体模式日志会在桥接启动时包含解析到的转写提供商/模型，并在每次合成回复后包含 TTS 提供商/模型/语音/输出格式/采样率。原始 mode: "realtime" 仍作为 mode: "agent" 的旧版兼容别名被接受，但不再在该工具的 mode 枚举中宣传。
使用 API 支持的房间和明确访问策略的 create：
status 会在可用时包含 Chrome 健康状态：
| 字段 | 含义 |
|---|---|
inCall | Chrome 似乎已进入 Meet 通话 |
micMuted | 尽力判断的 Meet 麦克风状态 |
manualActionRequired / manualActionReason / manualActionMessage | 浏览器配置文件需要手动登录、Meet 主持人准入、权限，或在语音可用前修复浏览器控制 |
speechReady / speechBlockedReason / speechBlockedMessage | 当前是否允许托管 Chrome 语音；speechReady: false 表示 OpenClaw 未发送开场/测试短语 |
providerConnected / realtimeReady | 实时语音桥接状态 |
lastInputAt / lastOutputAt | 上次从桥接收到/发送到桥接的音频 |
audioOutputRouted / audioOutputDeviceLabel | Meet 标签页的媒体输出是否已主动路由到桥接的 BlackHole 设备 |
lastSuppressedInputAt / suppressedInputBytes | 助手播放处于活动状态时被忽略的环回输入 |
智能体和 bidi 模式
| 模式 | 由谁决定答案 | 语音输出路径 | 使用场景 |
|---|---|---|---|
agent | 已配置的 OpenClaw 智能体 | 常规 OpenClaw TTS 运行时 | 你想要“我的智能体正在会议中”的行为 |
bidi | 实时语音模型 | 实时语音提供商音频响应 | 你想要最低延迟的对话式语音循环 |
agent 模式：实时转写提供商会听取会议音频，最终参与者转写会路由到已配置的 OpenClaw 智能体，答案通过常规 OpenClaw TTS 播放。在咨询前会合并相邻的最终转写片段，避免一个口头轮次产生多个过时的部分答案；当排队的助手音频仍在播放时会抑制实时输入，并且会在咨询前忽略近期类似助手的转写回声，避免 BlackHole 环回让智能体回答自己的语音。
bidi 模式：实时语音模型直接回答，并且可以调用 openclaw_agent_consult 进行更深入的推理、获取当前信息，或使用常规 OpenClaw 工具。咨询工具会在后台运行常规 OpenClaw 智能体，带上近期会议转写上下文，并返回简洁的口头答案；在 agent 模式下，OpenClaw 会将该答案直接发送给 TTS；在 bidi 模式下，实时语音模型可以把它说出来。它使用与 Voice Call 相同的共享咨询机制。
默认情况下，咨询会针对 main 智能体运行；设置 realtime.agentId 可将 Meet 通道指向专用的 Agent 工作区、模型默认值、工具策略、记忆和会话历史。智能体模式咨询使用按会议划分的 agent:<id>:subagent:google-meet:<session> 会话键，因此后续问题会保留会议上下文，同时继承常规智能体策略。当智能体在智能体模式下调用 google_meet 时，顾问会话会在回答参与者语音前分叉调用方的当前转写；Meet 会话保持独立，因此会议后续问题不会直接修改调用方转写。
realtime.toolPolicy 控制咨询运行：
| 策略 | 行为 |
|---|---|
safe-read-only | 暴露咨询工具；将常规智能体限制为 read、web_search、web_fetch、x_search、memory_search、memory_get |
owner | 暴露咨询工具；允许常规智能体使用其正常工具策略 |
none | 不向实时语音模型暴露咨询工具 |
实时测试清单
在把会议交给无人值守智能体之前：googlemeet setup全部为绿色，并且当 Chrome-node 是默认传输或已固定某个节点时包含chrome-node-connected。nodes status显示所选节点已连接，并公布googlemeet.chrome和browser.proxy。- Meet 标签页已加入，且
test-speech返回包含inCall: true的 Chrome 健康状态。
googlemeet setup包含绿色的twilio-voice-call-plugin、twilio-voice-call-credentials和twilio-voice-call-webhook检查。- Gateway 网关重新加载后，
voicecall在 CLI 中可用。 - 返回的会话包含
transport: "twilio"和twilio.voiceCallId。 openclaw logs --follow显示在实时 TwiML 之前已提供 DTMF TwiML，然后显示实时桥接以及已排队的初始问候。googlemeet leave <sessionId>会挂断委托的语音通话。
故障排查
智能体看不到 Google Meet 工具
确认插件已启用并重新加载 Gateway 网关；正在运行的智能体只能看到当前 Gateway 网关进程注册的插件工具：google_meet 仍然可见，但本地 Chrome 回话操作会在进入音频桥之前被阻止。请使用 mode: "transcribe"、Twilio 拨入，或 macOS chrome-node 主机，而不是默认的本地 Chrome agent 路径。
没有已连接且支持 Google Meet 的节点
在节点主机上：googlemeet.chrome 和 browser.proxy；Gateway 网关配置必须允许两者：
googlemeet setup 在 chrome-node-connected 处失败，或 Gateway 网关日志报告 gateway token mismatch，请使用当前 Gateway 网关令牌重新安装或重启节点：
浏览器打开但 agent 无法加入
运行googlemeet test-listen 进行仅观察加入，或运行 googlemeet test-speech 进行实时加入，然后检查返回的 Chrome 健康状态。如果任一报告 manualActionRequired: true，请向操作员显示 manualActionMessage，并在浏览器操作完成前停止重试。
常见的手动操作：登录 Chrome 配置文件；从 Meet 主持账号准入访客；在原生提示出现时授予 Chrome 麦克风/摄像头权限；关闭或修复卡住的 Meet 权限对话框。
不要仅因为 Meet 询问 “Do you want people to hear you in the meeting?” 就报告 “未登录”；那是 Meet 的音频选择插页。OpenClaw 会在可用时通过浏览器自动化点击 Use microphone，并继续等待真实会议状态；对于仅创建的浏览器回退，它可能改为点击 Continue without microphone，因为生成 URL 不需要实时音频路径。
会议创建失败
googlemeet create 在配置 OAuth 时使用 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 账号提示标签页，再打开新标签页；重试工具调用，而不是手动再打开一个标签页。 - 手动操作：如果工具返回
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，并继续等待生成的 URL；如果无法执行，错误应提及
meet-audio-choice-required，而不是google-login-required。
agent 已加入但不说话
mode: "agent" 走 STT -> OpenClaw agent -> TTS 路径，使用 mode: "bidi" 走直接实时语音回退。mode: "transcribe" 有意不启动回话桥。对于仅观察调试，请在参与者发言后运行 openclaw googlemeet status --json <session-id>，并检查 captioning、transcriptLines、lastCaptionText。如果 inCall 为 true 但 transcriptLines 一直是 0，可能是 Meet 字幕被禁用、观察者安装后还没有人发言、Meet UI 已更改，或该会议语言/账号不可用实时字幕。
googlemeet test-speech 始终检查实时路径，并报告此次调用是否观察到桥输出字节。如果 speechOutputVerified 为 false 且 speechOutputTimedOut 为 true，实时提供商可能已接受话语，但 OpenClaw 没有看到新的输出字节到达 Chrome 音频桥。
还要验证：Gateway 网关主机上有可用的实时提供商密钥（OPENAI_API_KEY 或 GEMINI_API_KEY）；Chrome 主机上可见 BlackHole 2ch；那里存在 sox；Meet 麦克风/扬声器通过虚拟音频路径路由（对于本地 Chrome 实时加入，doctor 应显示 meet output routed: yes）。
googlemeet doctor [session-id] 会打印会话、节点、通话中状态、手动操作原因、实时提供商连接、realtimeReady、音频输入/输出活动、最后音频时间戳、字节计数器和浏览器 URL。使用 googlemeet status [session-id] --json 查看原始 JSON，并使用 googlemeet doctor --oauth（添加 --meeting 或 --create-space）验证 OAuth 刷新且不暴露令牌。
如果 agent 超时且 Meet 标签页已经打开，请检查它，而不要再打开一个：
recover_current_tab：它会为所选传输聚焦并检查现有 Meet 标签页（chrome 使用本地浏览器控制，chrome-node 使用配置的节点），不打开新标签页或会话，并报告当前阻塞项（登录、准入、权限、音频选择状态）。CLI 命令会连接到配置的 Gateway 网关，该 Gateway 网关必须正在运行；chrome-node 还要求节点已连接。
Twilio 设置检查失败
当不允许或未启用voice-call 时，twilio-voice-call-plugin 会失败：将它添加到 plugins.allow，启用 plugins.entries.voice-call，然后重新加载 Gateway 网关。
当 Twilio 后端缺少账号 SID、认证令牌或主叫号码时，twilio-voice-call-credentials 会失败：
voice-call 没有公开 webhook 暴露，或 publicUrl 指向 loopback/专用网络空间时，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，或配置隧道/Tailscale 暴露：
voicecall smoke 默认仅检查就绪状态。对特定号码执行 dry-run：
--yes：
Twilio 呼叫开始但从未进入会议
确认 Meet 事件暴露电话拨入详情，并传入准确的拨入号码加 PIN，或自定义 DTMF 序列：--dtmf-sequence 中使用前导 w 或逗号，在 PIN 前加入暂停。
如果呼叫已创建，但 Meet 名单中始终没有显示拨入参与者：
openclaw googlemeet doctor <session-id>：确认委托的 Twilio 呼叫 ID、DTMF 是否已排队，以及是否请求了介绍问候语。openclaw voicecall status --call-id <id>：确认呼叫仍处于活动状态。openclaw voicecall tail：确认 Twilio webhooks 正在到达 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；绿色设置检查是必需的，但不能证明会议 PIN 序列正确。 - 确认拨入号码属于与 PIN 相同的 Meet 邀请和地区。
- 如果 Meet 应答较慢，或在发送连接前 DTMF 后呼叫转录仍显示 PIN 提示，请将
voiceCall.dtmfDelayMs从默认的 12 秒调高。 - 如果参与者加入但你听不到问候语，请检查
openclaw logs --follow中的 DTMF 后voicecall.speak请求，以及媒体流 TTS 播放或 Twilio<Say>回退。如果转录仍显示 “enter the meeting PIN”，电话链路尚未加入 Meet 房间，因此参与者不会听到语音。
plugins.entries.voice-call.config.publicUrl 或配置的隧道。参见 语音呼叫故障排除。
说明
Google Meet 的官方媒体 API 以接收为导向，因此向通话中说话仍需要参与者路径。此插件让该边界保持可见：Chrome 处理浏览器参与和本地音频路由；Twilio 处理电话拨入参与。 Chrome 回话模式需要BlackHole 2ch，并且需要以下任一项：
chrome.audioInputCommand加chrome.audioOutputCommand：OpenClaw 拥有桥，并以chrome.audioFormat在这些命令与所选提供商之间传输音频。agent模式使用实时转录加常规 TTS；bidi模式使用实时语音提供商。默认路径是 24 kHz PCM16，chrome.audioBufferBytes: 4096；8 kHz G.711 mu-law 仍可用于旧版命令对。chrome.audioBridgeCommand：外部桥命令拥有整个本地音频路径，并且必须在启动或验证其守护进程后退出。仅对bidi有效，因为agent模式需要直接访问命令对以用于 TTS。
chrome.bargeInInputCommand 可以监听单独的本地麦克风，并在人类开始说话时清除助手播放，使人类语音即使在助手播放期间共享 BlackHole loopback 输入被暂时抑制时也能优先于助手输出。与 chrome.audioInputCommand/chrome.audioOutputCommand 一样，它是操作员配置的本地命令：使用明确受信任的命令路径或参数列表，绝不要使用来自不受信任位置的脚本。
为获得干净的双工音频，请将 Meet 输出和 Meet 麦克风路由到不同的虚拟设备，或使用类似 Loopback 的虚拟设备图；单个共享 BlackHole 设备可能会把其他参与者的声音回声回通话中。
googlemeet speak 会为 Chrome 会话触发活动的语音回复音频桥接；googlemeet leave 会停止它（并且对于通过 Voice Call 委派的 Twilio 会话，会挂断底层通话）。使用 googlemeet end-active-conference 还可以关闭 API 管理空间中的活动 Google Meet 会议。