Google Meet 插件

google-meet 插件代表 OpenClaw 智能体加入明确指定的 Meet URL。其功能范围刻意保持精简：

它只加入 https://meet.google.com/... URL；绝不会使用自行发现的电话号码拨入会议。
googlemeet create 可以通过 Google Meet API（或浏览器回退方案）创建新的 Meet URL，并默认加入该会议。
通过 Chrome 参会时使用已登录的 Chrome 配置文件，也可以选择在已配对节点上运行。通过 Twilio 参会时，会借助语音通话插件，使用电话号码加 PIN/DTMF 拨入；它无法直接拨打 Meet URL。
mode: "agent"（默认）使用实时提供商转录参会者语音，将其路由到已配置的 OpenClaw 智能体，并使用常规 OpenClaw TTS 朗读回答。mode: "bidi" 允许实时语音模型直接回答。mode: "transcribe" 以仅观察模式加入，不进行语音回应。
插件加入通话时不会自动播放同意声明。
CLI 命令为 googlemeet；meet 保留用于更广泛的智能体电话会议工作流。

快速开始

安装插件和本地音频依赖项，然后设置实时提供商密钥。OpenAI 是 agent 模式的默认转录提供商；Google Gemini Live 可用作 bidi 模式的语音提供商：

openclaw plugins install npm:@openclaw/google-meet
brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# 仅当 bidi 模式的 realtime.voiceProvider 为 "google" 时才需要
export GEMINI_API_KEY=...

blackhole-2ch 会安装供 Chrome 路由音频的 BlackHole 2ch 虚拟音频设备。Homebrew 安装程序要求重新启动后，macOS 才会显示该设备：

sudo reboot

重启后，验证这两个组件：

system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

安装后，插件默认启用。仅在需要自定义时添加配置项：

{
  plugins: {
    entries: {
      "google-meet": {
        config: {},
      },
    },
  },
}

如果不希望启用该插件，请运行 openclaw plugins disable google-meet。检查设置，然后加入会议：

openclaw googlemeet setup
openclaw googlemeet join https://meet.google.com/abc-defg-hij

setup 的输出可供智能体读取，并能感知模式和传输方式：它会报告 Chrome 配置文件、节点固定情况；对于通过 Chrome 实时加入的会话，还会报告 BlackHole/SoX 音频桥接和延迟开场白检查。仅观察模式的加入会跳过实时处理的前置条件：

openclaw googlemeet setup --transport chrome-node --mode transcribe

配置 Twilio 委派后，setup 还会报告 voice-call、Twilio 凭据和公共 webhook 暴露是否就绪。在智能体加入之前，应将任何 ok: false 检查视为相应传输方式/模式的阻塞项。使用 --json 获取机器可读输出，并使用 --transport chrome|chrome-node|twilio 提前预检特定传输方式：

openclaw googlemeet setup --transport twilio

也可以让智能体通过 google_meet 工具加入：

{
  "action": "join",
  "url": "https://meet.google.com/abc-defg-hij",
  "transport": "chrome-node",
  "mode": "agent"
}

在非 macOS Gateway 网关主机上，google_meet 仍可用于工件、日历、设置、转录、Twilio 和 chrome-node 操作，但本地 Chrome 语音回应（使用 mode: "agent" 或 "bidi" 的 transport: "chrome"）会在到达音频桥接前被阻止，因为该路径目前依赖 macOS BlackHole 2ch。请改用 mode: "transcribe"、Twilio 拨入或 macOS chrome-node 主机。

创建会议

openclaw googlemeet create --transport chrome-node --mode agent
openclaw googlemeet create --no-join

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 账号的默认值：

openclaw googlemeet create --access-type OPEN --transport chrome-node --mode agent

`--access-type`	无需请求准入即可加入的人员
`OPEN`	任何拥有 Meet URL 的人员
`TRUSTED`	主办方组织的受信任用户、受邀的外部用户和拨入用户
`RESTRICTED`	仅受邀者

此设置仅适用于通过 API 创建的会议室，因此必须配置 OAuth。如果在此选项推出之前已完成身份验证，请在 OAuth 同意屏幕中添加 meetings.space.settings 范围后，重新运行 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 尾部记录。要读取有界会话转录，请读取所跟踪的确切 Meet 标签页：

openclaw googlemeet transcript <session-id>
openclaw googlemeet transcript <session-id> --since <next-index> --json

观察器在 Meet 页面中最多保留 2,000 行已完成字幕。可见的渐进式文本会保留在状态健康尾部记录中，直到字幕行完成，因此保存 nextIndex 不会漏掉稍后的文本扩展；离开会议时，会先将可见行标记为完成，再创建快照。超过上限时，droppedLines 会报告从开头丢失的行数。有界的 googlemeet transcript 尾部记录仍只保留最近结束的四个会话，并随 Gateway 网关重置。另外，OpenClaw 会在整个会议期间将已完成的字幕行追加到共享状态数据库，并在离开时写入派生摘要。使用 openclaw transcripts 检查或导出这些持久化笔记。自动笔记默认启用。将 transcripts.enabled: false 设置为可在全局禁用持久化笔记；显式 transcribe 模式仍只会公开其有界实时尾部记录。Twilio 加入没有浏览器字幕流，因此不会通过此路径捕获。要执行“是/否”监听探测：

openclaw googlemeet test-listen <meet-url> --transport chrome-node

它会以转录模式加入，等待新的字幕/转录发生变化，并返回 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 虚拟机提供 Chrome，则无需在虚拟机中运行完整的 Gateway 网关或配置模型 API key。在本地运行 Gateway 网关和智能体；在虚拟机中运行节点主机。

运行位置	运行内容
Gateway 网关主机	OpenClaw Gateway 网关、Agent 工作区、模型/API key、实时提供商、Google Meet 插件配置
Parallels macOS 虚拟机	OpenClaw CLI/节点主机、Chrome、SoX、BlackHole 2ch、已登录 Google 的 Chrome 配置文件
虚拟机中不需要	Gateway 网关服务、智能体配置、模型提供商设置

安装虚拟机依赖项、重启并验证：

brew install blackhole-2ch sox
sudo reboot
system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

在虚拟机中安装插件（默认启用），然后启动节点主机：

openclaw plugins install npm:@openclaw/google-meet
openclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos

如果 <gateway-host> 是不使用 TLS 的 LAN IP，请针对该受信任的专用网络显式启用：

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

安装为 LaunchAgent 时请使用相同的标志（它是进程环境变量，如果安装命令中存在，则会存储在 LaunchAgent 环境中，而不是 openclaw.json 设置）：

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

从 Gateway 网关主机批准节点，然后确认它同时公布 googlemeet.chrome 和浏览器能力/browser.proxy：

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status

通过该节点路由 Meet：

{
  gateway: {
    nodes: {
      commands: { allow: ["googlemeet.chrome", "browser.proxy"] },
    },
  },
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          chrome: {
            guestName: "OpenClaw Agent",
            autoJoin: true,
            reuseExistingTab: true,
          },
          chromeNode: {
            node: "parallels-macos",
          },
        },
      },
    },
  },
}

现在可以从 Gateway 网关主机正常加入：

openclaw googlemeet join https://meet.google.com/abc-defg-hij

要运行单命令冒烟测试以创建或复用会话、朗读已知短语并打印会话健康状态：

openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij

在实时加入期间，浏览器自动化会填写访客姓名，点击 Join/Ask to join，并在 Meet 首次运行时出现“Use microphone”提示时接受该提示（在仅观察模式加入和仅通过浏览器创建会议时，则选择“Continue without microphone”）。如果配置文件已退出登录、Meet 正在等待主持人准入、Chrome 需要麦克风/摄像头权限，或者 Meet 卡在未解决的提示上，结果会报告 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`	在虚拟机中安装 `npm:@openclaw/google-meet`，运行 `openclaw plugins enable browser`，启动 `openclaw node run`，然后批准配对。如果已明确禁用 Google Meet，也请将其启用。确认 `gateway.nodes.commands.allow` 包含 `googlemeet.chrome` 和 `browser.proxy`。
`BlackHole 2ch audio device not found`	在要检查的主机上安装 `blackhole-2ch`，然后重启。
`BlackHole 2ch audio device not found on the node`	在虚拟机中安装 `blackhole-2ch`，然后重启虚拟机。
Chrome 已打开但无法加入	在虚拟机中登录浏览器配置文件，或保持设置 `chrome.guestName`。访客自动加入通过节点浏览器代理使用 OpenClaw 浏览器自动化；将节点的 `browser.defaultProfile`（或命名的现有会话配置文件）指向所需的配置文件。
重复的 Meet 标签页	保持 `chrome.reuseExistingTab: true`。在打开其他标签页之前，OpenClaw 会激活相同 URL 的现有标签页，并且创建操作会复用正在进行的 `.../new` 或 Google 账号提示标签页。
无音频	通过 OpenClaw 使用的虚拟音频路径路由 Meet 麦克风/扬声器；使用独立的虚拟设备或 Loopback 风格的路由，以获得清晰的双工音频。

安装说明

Chrome 回传语音的默认方式使用两种 OpenClaw 不内置或再分发的外部工具；请通过 Homebrew 将它们安装为主机依赖项：

sox：命令行音频工具。该插件为默认的 24 kHz PCM16 音频桥接发出明确的 CoreAudio 设备命令。
blackhole-2ch：macOS 虚拟音频驱动程序，提供 Chrome/Meet 用于路由的 BlackHole 2ch 设备。

SoX 采用 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 虚拟机）
`twilio`	无法通过 Chrome 参与时，通过语音通话插件使用电话拨入回退方案

Chrome

通过 OpenClaw 浏览器控制打开 Meet URL，并以已登录的 OpenClaw 浏览器配置文件加入。在 macOS 上，该插件会在启动前检查 BlackHole 2ch，并且在已配置时，于打开 Chrome 前运行音频桥接健康检查/启动命令。对于本地 Chrome，请使用 browser.defaultProfile 选择配置文件；chrome.browserProfile 则会传递给 chrome-node 主机。

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，加入操作会失败并显示设置错误，而不是在没有音频路径的情况下加入。

Twilio

委托给语音通话插件的严格拨号方案。它不会解析 Meet 页面以查找电话号码；Google Meet 必须为会议提供电话拨入号码和 PIN。请在 Gateway 网关主机上启用语音通话，而不是在 Chrome 节点上启用：

{
  plugins: {
    allow: ["google-meet", "voice-call", "google"],
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          // 或者，如果 Twilio 应作为默认方式，则设置为 "twilio"
        },
      },
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio",
          inboundPolicy: "allowlist",
          realtime: {
            enabled: true,
            provider: "google",
            instructions: "以 OpenClaw 智能体身份加入此 Google Meet。保持简洁。",
            toolPolicy: "safe-read-only",
            providers: {
              google: {
                silenceDurationMs: 500,
                startSensitivity: "high",
              },
            },
          },
        },
      },
      google: {
        enabled: true,
      },
    },
  },
}

通过环境提供 Twilio 凭据，以避免将机密信息写入 openclaw.json：

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

如果 OpenAI 是实时语音提供商，请改用 realtime.provider: "openai" 和 OPENAI_API_KEY。启用 voice-call 后，重启或重新加载 Gateway 网关；插件配置更改在重新加载前不会生效。验证：

openclaw config validate
openclaw plugins list | grep -E 'google-meet|voice-call'
openclaw googlemeet setup

连接好 Twilio 委托后，googlemeet setup 会包含 twilio-voice-call-plugin、twilio-voice-call-credentials 和 twilio-voice-call-webhook 检查。

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

如需自定义序列，请使用 --dtmf-sequence；可在开头使用 w 或逗号，以便在输入 PIN 前暂停：

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

OAuth 和预检

创建 Meet 链接时 OAuth 是可选的，因为 googlemeet create 可以回退到浏览器自动化。请为通过官方 API 创建、解析会议空间或 Meet Media API 预检配置 OAuth。Chrome/Chrome-node 加入从不依赖 OAuth；无论哪种情况，它们都使用已登录的 Chrome 配置文件、BlackHole/SoX，并且（对于 chrome-node）还使用一个已连接节点。

创建 Google 凭据

在 Google Cloud Console 中：

创建或选择项目

启用 Google Meet REST API

配置 OAuth 同意屏幕

对于 Google Workspace 组织，Internal 最简单。External 适用于个人/测试设置；当应用处于 Testing 状态时，请将每个要授权该应用的 Google 账号添加为测试用户。

添加请求的权限范围

https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
https://www.googleapis.com/auth/meetings.space.settings
https://www.googleapis.com/auth/meetings.conference.media.readonly
https://www.googleapis.com/auth/calendar.events.readonly（日历查找）
https://www.googleapis.com/auth/drive.meet.readonly（转录/智能笔记文档正文导出）

创建 OAuth 客户端 ID

应用类型选择 Web application。已获授权的重定向 URI：

http://localhost:8085/oauth2callback

复制客户端 ID 和客户端密钥

spaces.create 需要 meetings.space.created。meetings.space.readonly 将 Meet URL/代码解析为会议空间。meetings.space.settings 允许 OpenClaw 在通过 API 创建会议室时传递 SpaceConfig 设置，例如 accessType。meetings.conference.media.readonly 用于 Meet Media API 预检和媒体工作；实际使用 Media API 时，Google 可能要求加入 Developer Preview。仅在使用 --today/--event 进行日历查找时才需要 calendar.events.readonly。仅在导出 --include-doc-bodies 时才需要 drive.meet.readonly。如果只需要基于浏览器的 Chrome 加入，请完全跳过 OAuth。

生成刷新令牌

配置 oauth.clientId，并可选择配置 oauth.clientSecret（或将其作为环境变量传递），然后运行：

openclaw googlemeet auth login --json

这会通过 http://localhost:8085/oauth2callback 上的 localhost 回调运行 PKCE 流程，并打印包含刷新令牌的 oauth 配置块。当浏览器无法访问本地回调时，请添加 --manual 以使用复制/粘贴流程：

OPENCLAW_GOOGLE_MEET_CLIENT_ID="your-client-id" \
OPENCLAW_GOOGLE_MEET_CLIENT_SECRET="your-client-secret" \
openclaw googlemeet auth login --json --manual

JSON 输出：

{
  "oauth": {
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "refreshToken": "refresh-token",
    "accessToken": "access-token",
    "expiresAt": 1770000000000
  },
  "scope": "..."
}

将 oauth 对象存储在插件配置下：

{
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          oauth: {
            clientId: "your-client-id",
            clientSecret: "your-client-secret",
            refreshToken: "refresh-token",
          },
        },
      },
    },
  },
}

如果不希望刷新令牌出现在配置中，请优先使用环境变量；系统会先解析配置，然后以环境变量作为回退。如果在支持会议创建、日历查找或文档正文导出之前已完成身份验证，请重新运行 openclaw googlemeet auth login --json，使刷新令牌涵盖当前的权限范围集。

使用 Doctor 验证 OAuth

openclaw googlemeet doctor --oauth --json

此检查会验证 OAuth 配置是否存在，以及刷新令牌能否签发访问令牌，而无需加载 Chrome 运行时或要求节点已连接。报告仅包含状态字段（ok、configured、tokenSource、expiresAt、检查消息），绝不会输出访问令牌、刷新令牌或客户端密钥。

检查项	含义
`oauth-config`	存在 `oauth.clientId` 和 `oauth.refreshToken`，或已缓存的访问令牌
`oauth-token`	已缓存的访问令牌仍然有效，或刷新令牌已签发新令牌
`meet-spaces-get`	可选的 `--meeting` 检查解析到了现有 Meet 空间
`meet-spaces-create`	可选的 `--create-space` 检查创建了新的 Meet 空间

使用会产生副作用的创建检查来验证 Meet API 已启用且具有 spaces.create 权限范围：

openclaw googlemeet doctor --oauth --create-space --json

验证对现有空间的读取权限：

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

这些检查返回 403 通常表示 Meet REST API 已禁用、刷新令牌缺少所需权限范围，或 Google 账号无法访问该空间。刷新令牌错误表示需要重新运行 openclaw googlemeet auth login --json，并存储新的 oauth 块。浏览器回退不需要 OAuth；其中的 Google 身份验证来自所选节点上已登录的 Chrome 配置文件，而非 OpenClaw 配置。以下环境变量可用作回退：

OPENCLAW_GOOGLE_MEET_CLIENT_ID 或 GOOGLE_MEET_CLIENT_ID
OPENCLAW_GOOGLE_MEET_CLIENT_SECRET 或 GOOGLE_MEET_CLIENT_SECRET
OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN 或 GOOGLE_MEET_REFRESH_TOKEN
OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN 或 GOOGLE_MEET_ACCESS_TOKEN
OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT 或 GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT
OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING 或 GOOGLE_MEET_DEFAULT_MEETING
OPENCLAW_GOOGLE_MEET_PREVIEW_ACK 或 GOOGLE_MEET_PREVIEW_ACK

解析、预检和读取工件

openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij
openclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij

Meet 创建会议记录后：

openclaw googlemeet artifacts --meeting https://meet.google.com/abc-defg-hij
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 可处理所有保留的记录。日历查找会先从 Google Calendar 解析会议 URL，然后再读取工件（需要刷新令牌包含 Calendar 事件只读权限范围）：

openclaw googlemeet latest --today
openclaw googlemeet calendar-events --today --json
openclaw googlemeet artifacts --event "Weekly sync"
openclaw googlemeet attendance --today --format csv --output attendance.csv

--today 会在今天的 primary 日历中搜索包含 Meet 链接的事件；--event <query> 搜索匹配的事件文本；--calendar <id> 指定非主日历。calendar-events 会预览匹配的事件，并标记 latest/artifacts/attendance/export 将选择哪一个。如果已知会议记录 ID，可直接指定：

openclaw googlemeet latest --meeting https://meet.google.com/abc-defg-hij
openclaw googlemeet artifacts --conference-record conferenceRecords/abc123 --json
openclaw googlemeet attendance --conference-record conferenceRecords/abc123 --json

关闭通过 API 创建的空间：

openclaw googlemeet end-active-conference https://meet.google.com/abc-defg-hij

此命令会调用 spaces.endActiveConference，并且对于已授权账号可管理的空间，需要具有 meetings.space.created 权限范围的 OAuth。它接受 Meet URL、会议代码或 spaces/{id}，并先将其解析为 API 空间资源。这与 googlemeet leave 不同：leave 会停止 OpenClaw 的本地/会话参与；end-active-conference 会请求 Google Meet 结束该空间的活动会议。写入易读的报告：

openclaw googlemeet artifacts --conference-record conferenceRecords/abc123 \
  --format markdown --output meet-artifacts.md
openclaw googlemeet attendance --conference-record conferenceRecords/abc123 \
  --format csv --output meet-attendance.csv
openclaw googlemeet export --conference-record conferenceRecords/abc123 \
  --include-doc-bodies --zip --output meet-export
openclaw googlemeet export --conference-record conferenceRecords/abc123 \
  --include-doc-bodies --dry-run

artifacts 会返回会议记录元数据，以及 Google 提供的参与者、录制内容、转写文本、结构化转写条目和智能笔记资源元数据。--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 只读权限范围）；如果未启用，导出仅包含 Meet 元数据和结构化转写条目。如果部分工件失败（智能笔记列表、转写条目或文档正文错误），警告会保留在摘要/清单中，而不会导致整个导出失败。--dry-run 会获取相同的数据并输出清单 JSON，而不创建文件夹或 ZIP。智能体通过 google_meet 工具使用相同的操作（export、带 accessType 的 create、end_active_conference、test_listen）；参见工具。

实时冒烟测试

OPENCLAW_LIVE_TEST=1 \
OPENCLAW_GOOGLE_MEET_LIVE_MEETING=https://meet.google.com/abc-defg-hij \
pnpm test:live -- extensions/google-meet/google-meet.live.test.ts

openclaw googlemeet setup --transport chrome-node --mode transcribe
openclaw googlemeet test-listen https://meet.google.com/abc-defg-hij --transport chrome-node --timeout-ms 30000

变量	用途
`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.events.readonly。Drive 文档正文导出需要 drive.meet.readonly。

创建示例

openclaw googlemeet create

输出新会议 URI、来源和加入会话。使用 OAuth 时会使用 Meet API；未使用 OAuth 时，则使用固定 Chrome 节点的已登录配置文件。浏览器回退 JSON：

{
  "source": "browser",
  "meetingUri": "https://meet.google.com/abc-defg-hij",
  "joined": true,
  "browser": {
    "nodeId": "ba0f4e4bc...",
    "targetId": "tab-1"
  },
  "join": {
    "session": {
      "id": "meet_...",
      "url": "https://meet.google.com/abc-defg-hij"
    }
  }
}

如果浏览器回退首先遇到 Google 登录或 Meet 权限阻止页面，google_meet 会返回结构化详细信息，而非纯字符串：

{
  "source": "browser",
  "error": "google-login-required: 登录 OpenClaw 浏览器配置文件中的 Google 账号，然后重试创建会议。",
  "manualActionRequired": true,
  "manualActionReason": "google-login-required",
  "manualActionMessage": "登录 OpenClaw 浏览器配置文件中的 Google 账号，然后重试创建会议。",
  "browser": {
    "nodeId": "ba0f4e4bc...",
    "targetId": "tab-1",
    "browserUrl": "https://accounts.google.com/signin",
    "browserTitle": "登录 - Google 账号"
  }
}

API 创建 JSON：

{
  "source": "api",
  "meetingUri": "https://meet.google.com/abc-defg-hij",
  "joined": true,
  "space": {
    "name": "spaces/abc-defg-hij",
    "meetingCode": "abc-defg-hij",
    "meetingUri": "https://meet.google.com/abc-defg-hij"
  },
  "join": {
    "session": {
      "id": "meet_...",
      "url": "https://meet.google.com/abc-defg-hij"
    }
  }
}

创建后默认加入，但 Chrome/Chrome 节点仍需要已登录的 Google 配置文件才能通过浏览器加入；如果已退出登录，OpenClaw 会报告 manualActionRequired: true 或浏览器回退错误，并要求操作员完成 Google 登录后再重试。仅在确认你的 Cloud 项目、OAuth 主体和会议参与者均已加入 Google Workspace Developer Preview Program for Meet media APIs 后，才设置 preview.enrollmentAcknowledged: true。

配置

常规 Chrome 智能体路径只需要启用插件、BlackHole、SoX、实时提供商密钥，以及已配置的 OpenClaw TTS 提供商：

{
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {},
      },
    },
  },
}

默认值

键	默认值	说明
`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` 上尽力填写访客姓名并点击 Join Now
`chrome.reuseExistingTab`	`true`	激活现有的 Meet 标签页，而不是打开重复标签页
`chrome.waitForInCallMs`	`20000`	等待 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"`	回话模式；参见 Agent 和双向模式表
`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 和双向模式
`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 和开场问候委托给语音通话插件
`voiceCall.dtmfDelayMs`	`12000`	通过 Twilio 播放由 PIN 派生的 DTMF 序列前的等待时间
`voiceCall.postDtmfSpeechDelayMs`	`5000`	语音通话启动 Twilio 通话线路后，请求实时开场问候前的延迟

chrome.audioBridgeCommand 和 chrome.audioBridgeHealthCommand 允许外部桥接接管整个本地音频路径，而不使用 chrome.audioInputCommand/chrome.audioOutputCommand；有关哪些模式可以使用它们的限制，请参见说明。存在针对旧版 realtime.provider: "google" 结构的 openclaw doctor --fix 迁移：当 realtime.voiceProvider: "google" 和 realtime.transcriptionProvider: "openai" 尚未设置时，它会将该意图迁移到这两个字段。

可选覆盖项

{
  defaults: {
    meeting: "https://meet.google.com/abc-defg-hij",
  },
  browser: {
    defaultProfile: "openclaw",
  },
  chrome: {
    guestName: "OpenClaw Agent",
    waitForInCallMs: 30000,
    bargeInInputCommand: [
      "sox",
      "-q",
      "-t",
      "coreaudio",
      "External Microphone",
      "-r",
      "24000",
      "-c",
      "1",
      "-b",
      "16",
      "-e",
      "signed-integer",
      "-t",
      "raw",
      "-",
    ],
  },
  chromeNode: {
    node: "parallels-macos",
  },
  defaultMode: "agent",
  realtime: {
    provider: "openai",
    transcriptionProvider: "openai",
    voiceProvider: "google",
    model: "gemini-3.1-flash-live-preview",
    agentId: "jay",
    toolPolicy: "owner",
    introMessage: "Say exactly: I'm here.",
    providers: {
      google: {
        speakerVoice: "Kore",
      },
    },
  },
}

使用 ElevenLabs 进行 Agent 模式的聆听和语音输出：

{
  tts: {
    provider: "elevenlabs",
    providers: {
      elevenlabs: {
        modelId: "eleven_v3",
        speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",
      },
    },
  },
  plugins: {
    entries: {
      "google-meet": {
        config: {
          realtime: {
            transcriptionProvider: "elevenlabs",
            providers: {
              elevenlabs: {
                modelId: "scribe_v2_realtime",
                audioFormat: "ulaw_8000",
                sampleRate: 8000,
                commitStrategy: "vad",
              },
            },
          },
        },
      },
    },
  },
}

Meet 的持久语音来自 tts.providers.elevenlabs.speakerVoiceId。启用 TTS 模型覆盖后，Agent 回复也可以使用按回复指定的 [[tts:speakerVoiceId=... model=eleven_v3]] 指令，但对于会议而言，配置是确定性的默认设置。加入时，日志会显示 transcriptionProvider=elevenlabs；每次语音回复都会记录 provider=elevenlabs model=eleven_v3 speakerVoiceId=<voiceId>。仅限 Twilio 的配置：

{
  defaultTransport: "twilio",
  twilio: {
    defaultDialInNumber: "+15551234567",
    defaultPin: "123456",
  },
  voiceCall: {
    gatewayUrl: "ws://127.0.0.1:18789",
  },
}

使用 voiceCall.enabled: true（默认值）和 Twilio 传输时，语音通话会在打开实时媒体流之前发送 DTMF 序列，然后将已保存的开场文本用作初始实时问候。如果未启用 voice-call，Google Meet 仍可验证并记录拨号方案，但无法发起 Twilio 通话。将 voiceCall.gatewayUrl 保持未设置即可使用本地可信的 Gateway 网关运行时，该运行时会在整个调用期间保留发起调用的智能体。已配置的 Gateway 网关 URL 仍是显式的 WebSocket 目标，且无法验证插件来源；非默认智能体加入时会以失败关闭，而不会静默改用其他智能体。当需要按智能体路由时，请在同一 Gateway 网关进程中运行 Google Meet 和 Voice Call。

工具

智能体使用 google_meet 工具：

{
  "action": "join",
  "url": "https://meet.google.com/abc-defg-hij",
  "transport": "chrome-node",
  "mode": "agent"
}

`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 链接的日历事件
`artifacts`	列出会议记录以及参与者、录制、文字记录和智能笔记元数据
`attendance`	列出参与者和参与者会话
`export`	写入工件、出席记录、文字记录和清单包；设置 `"dryRun": true` 可仅生成清单
`recover_current_tab`	聚焦或检查现有 Meet 标签页，而不打开新标签页
`transcript`	读取有界字幕文字记录；`sinceIndex` 从上一个 `nextIndex` 继续
`leave`	结束会话（Chrome 点击 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 传输，leave 会在点击 Meet 的 Leave 通话按钮后，让复用的用户自有标签页保持打开。由 OpenClaw 打开的标签页会在离开后关闭。当 Chrome 在 Gateway 网关主机上运行时使用 transport: "chrome"，在已配对节点上运行时使用 transport: "chrome-node"。在这两种情况下，模型提供商和 openclaw_agent_consult 都在 Gateway 网关主机上运行，因此模型凭据会保留在那里。智能体模式日志会在桥接器启动时包含解析后的转录提供商和模型，并在每次合成回复后包含 TTS 提供商、模型、语音、输出格式和采样率。原始 mode: "realtime" 仍作为 mode: "agent" 的旧版兼容别名被接受，但工具的 mode 枚举中不再公布该值。使用 API 支持的房间和显式访问策略的 create：

{
  "action": "create",
  "transport": "chrome-node",
  "mode": "agent",
  "accessType": "OPEN"
}

结束已知房间中的活跃会议：

{
  "action": "end_active_conference",
  "meeting": "https://meet.google.com/abc-defg-hij"
}

在声称会议可用之前，先执行收听验证：

{
  "action": "test_listen",
  "url": "https://meet.google.com/abc-defg-hij",
  "transport": "chrome-node",
  "timeoutMs": 30000
}

按需说话：

{
  "action": "speak",
  "sessionId": "meet_...",
  "message": "准确地说：我已加入，正在聆听。"
}

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 设备
`lastOutputLoopbackAt` / `outputLoopbackSignalBytes`	波形指纹已在 BlackHole 麦克风捕获路径上建立关联的新输出
`lastOutputLoopbackCorrelation`	将捕获的信号与当前助手输出生成关联起来的相关性分数
`outputGeneration` / `verifiedOutputGeneration`	单调递增 ID；二者相等表示通过回环验证的是当前输出，而不是较早的话语
`lastOutputLoopbackRms` / `lastOutputLoopbackPeak`	最近一次通过验证的回环捕获音频块的音频能量诊断
`lastSuppressedInputAt` / `suppressedInputBytes`	助手播放音频时忽略回环输入

智能体和双向模式

模式	由谁决定回答	语音输出路径	适用场景
`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:<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`	不向实时语音模型提供咨询工具

咨询会话键按 Meet 会话划分作用域，因此在同一场会议期间，后续咨询调用会复用先前的咨询上下文。在 Chrome 完全加入后，强制执行口头就绪检查：

openclaw googlemeet speak meet_... "准确地说：我已加入，正在聆听。"

完整的加入并说话冒烟测试：

openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \
  --transport chrome-node \
  --message "准确地说：我已加入，正在聆听。"

实时测试检查清单

将会议交给无人值守的智能体之前：

openclaw googlemeet setup
openclaw nodes status
openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \
  --transport chrome-node \
  --message "准确地说：Google Meet 语音测试完成。"

预期的 Chrome 节点状态：

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

对于 Parallels macOS 虚拟机等远程 Chrome 主机，更新 Gateway 网关或虚拟机后最简短且安全的检查方法如下：

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

这可以证明 Gateway 网关插件已加载、虚拟机节点已使用当前令牌连接，并且在智能体打开真实会议标签页之前，Meet 音频桥接已可用。对于 Twilio 冒烟测试，请使用提供电话拨入信息的会议：

openclaw googlemeet setup
openclaw 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 检查。
Gateway 网关重新加载后，CLI 中可以使用 voicecall。
返回的会话具有 transport: "twilio" 和一个 twilio.voiceCallId。
openclaw logs --follow 显示先提供 DTMF TwiML，再提供实时 TwiML，随后建立实时桥接并将初始问候语加入队列。
googlemeet leave <sessionId> 挂断委托的语音通话。

故障排查

智能体看不到 Google Meet 工具

确认插件已启用并重新加载 Gateway 网关；正在运行的智能体只能看到当前 Gateway 网关进程注册的插件工具：

openclaw plugins list | grep google-meet
openclaw googlemeet setup

在非 macOS 的 Gateway 网关主机上，google_meet 仍然可见，但本地 Chrome 回话操作会在到达音频桥接之前被阻止。请使用 mode: "transcribe"、Twilio 拨入，或 macOS chrome-node 主机，而不要使用默认的本地 Chrome 智能体路径。

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

在节点主机上：

openclaw plugins install npm:@openclaw/google-meet
openclaw plugins enable browser
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \
  openclaw node run --host <gateway-lan-ip> --port 18789 --display-name parallels-macos

在 Gateway 网关主机上：

openclaw devices list
openclaw 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 网关令牌重新安装或重启节点：

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

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

openclaw googlemeet setup
openclaw nodes status --connected

浏览器已打开，但智能体无法加入

对于仅观察加入，请运行 googlemeet test-listen；对于实时加入，请运行 googlemeet test-speech，然后检查返回的 Chrome 健康状态。如果任一操作报告 manualActionRequired: true，请向操作员显示 manualActionMessage，并停止重试，直到浏览器操作完成。常见的手动操作包括：登录 Chrome 配置文件；通过 Meet 主持人账户准许访客加入；出现原生提示时授予 Chrome 麦克风/摄像头权限；关闭或修复卡住的 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 账户提示标签页；应重试工具调用，而不是手动再打开一个标签页。
手动操作：如果工具返回 manualActionRequired: true，请使用 browser.nodeId、browser.targetId、browserUrl 和 manualActionMessage 指导操作员；不要循环重试。
音频选择过渡页面：如果 Meet 显示“是否希望会议中的其他人听到你的声音？”，请保持该标签页打开。OpenClaw 应点击 使用麦克风 或（仅创建时）不使用麦克风继续，并继续等待生成的 URL；如果无法执行，错误应提及 meet-audio-choice-required，而不是 google-login-required。

智能体已加入但不说话

openclaw googlemeet setup
openclaw googlemeet doctor

对于 STT -> OpenClaw 智能体 -> TTS 路径，请使用 mode: "agent"；对于直接实时语音回退，请使用 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 刷新，而不暴露令牌。如果智能体已超时且 Meet 标签页已打开，请在不打开其他标签页的情况下检查它：

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

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

Twilio 设置检查失败

当不允许或未启用 voice-call 时，twilio-voice-call-plugin 会失败：将其添加到 plugins.allow，启用 plugins.entries.voice-call，然后重新加载 Gateway 网关。当 Twilio 后端缺少账户 SID、身份验证令牌或主叫号码时，twilio-voice-call-credentials 会失败：

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

当 voice-call 没有公开 Webhook 暴露，或 publicUrl 指向环回/专用网络空间时，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 暴露：

{
  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" },
          // 或
          tailscale: { mode: "funnel", path: "/voice/webhook" },
        },
      },
    },
  },
}

重启或重新加载 Gateway 网关，然后运行：

openclaw googlemeet setup --transport twilio
openclaw voicecall setup
openclaw 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#

在 --dtmf-sequence 中使用开头的 w 或逗号，以便在输入 PIN 前暂停。如果通话已创建，但 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 委托加入操作，语音通话存储并提供连接前 DTMF TwiML，语音通话为 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> 回退。如果转录仍显示“输入会议 PIN”，则电话线路尚未加入 Meet 会议室，因此参与者听不到语音。

如果 Webhooks 未到达，请先调试语音通话插件：提供商必须能够访问 plugins.entries.voice-call.config.publicUrl 或已配置的隧道。请参阅语音通话故障排查。

注意事项

Google Meet 的官方媒体 API 以接收为主，因此要在通话中发言，仍需通过参与者路径。此插件明确保留了这一边界：Chrome 负责浏览器参会和本地音频路由；Twilio 负责电话拨入参会。 Chrome 回话模式需要 BlackHole 2ch，并加上以下任一选项：

chrome.audioInputCommand 加 chrome.audioOutputCommand：OpenClaw 负责桥接，并在这些命令与所选提供商之间通过 chrome.audioFormat 传输音频。agent 模式使用实时转录加常规 TTS；bidi 模式使用实时语音提供商。默认路径为采用 chrome.audioBufferBytes: 4096 的 24 kHz PCM16；8 kHz G.711 mu-law 仍可用于旧版命令对。
chrome.audioBridgeCommand：外部桥接命令负责整个本地音频路径，并且必须在启动或验证其守护进程后退出。仅适用于 bidi，因为 agent 模式需要直接访问命令对来执行 TTS。

使用命令对 Chrome 桥接时，chrome.bargeInInputCommand 可以监听单独的本地麦克风，并在人开始说话时清除智能体的播放内容。这样，即使智能体播放期间共享的 BlackHole 回环输入被暂时抑制，也能让人的语音优先于智能体输出。与 chrome.audioInputCommand/chrome.audioOutputCommand 一样，它是由操作员配置的本地命令：请使用明确且可信的命令路径或参数列表，绝不要使用来自不可信位置的脚本。为获得清晰的双工音频，请通过不同的虚拟设备或 Loopback 风格的虚拟设备拓扑，分别路由 Meet 输出和 Meet 麦克风；单个共享的 BlackHole 设备可能会将其他参与者的声音回传到通话中。 googlemeet speak 会触发 Chrome 会话的活动回话音频桥接；googlemeet leave 会将其停止（对于通过语音通话插件委派的 Twilio 会话，还会挂断底层通话）。对于由 API 管理的空间，可使用 googlemeet end-active-conference 同时关闭活动的 Google Meet 会议。

​快速开始

​创建会议

​以仅观察模式加入

​实时会话健康状态

​本地 Gateway 网关 + Parallels Chrome

​常见故障检查

​安装说明

​传输方式

​Chrome

​Twilio

​OAuth 和预检

​创建 Google 凭据

​生成刷新令牌

​使用 Doctor 验证 OAuth

​解析、预检和读取工件

​实时冒烟测试

​创建示例

​配置

​默认值

​可选覆盖项

​工具

​智能体和双向模式

​实时测试检查清单

​故障排查

​智能体看不到 Google Meet 工具

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

​浏览器已打开，但智能体无法加入

​创建会议失败

​智能体已加入但不说话

​Twilio 设置检查失败

​Twilio 通话已开始，但始终未进入会议

​注意事项

​相关内容