OpenClaw 接入 Google Meet:安装、配置、使用与服务推荐-夜雨聆风

OpenClaw 接入 Google Meet:安装、配置、使用与服务推荐

OpenClaw 2026.4.24 起内置 Google Meet 插件，AI agent 可实时加入会议——安装、配置、使用及服务推荐全指南

我是 AI灵感闪现，使用 OpenClaw 小龙虾让 AI 自主管理工作和生活上的问题；使用 Claude Code + BMAD AI 驱动敏捷开发框架，让 AI 自主开发和交付软件来表达想法和灵感。是 MoneyMind 省钱思维 App 和 HeartPetBond 心宠纽带 App 开发者。正在实践和分享让 AI 自主解决健康、生活、投资和等方面的问题。我尽可能让 AI 自己完成从目标到交付以及演进的闭环，以最少的人为交互与监督，让 AI 自己跑流程。我只给 AI 想法或目标，全程不陪跑，让 AI 自主运行类似 Tesla FSD 自动驾驶。

TL;DR

OpenClaw 2026.4.24 起内置 Google Meet 插件，AI agent 可以实时加入会议——边听边说、转录、甚至回调主 agent 做深度推理。核心架构：

Chrome 浏览器 作为 Meet 客户端 → BlackHole 2ch 虚拟声卡 → SoX 音频桥接 → Realtime API（OpenAI gpt-realtime-1.5 或 Gemini Live）→ agent 工具回调
支持三种 transport：本地 Chrome、配对 node Chrome、Twilio 电话拨入
Realtime 默认，也支持仅转录/控制模式（不说话）

一、环境依赖（macOS）

# 安装虚拟声卡 + 音频工具brew install blackhole-2ch sox# BlackHole 必须重启后才生效sudo reboot

重启后验证：

system_profiler SPAudioDataType | grep -i BlackHolecommand -v rec play

二、启用插件

openclaw.json 最小配置：

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

重启 Gateway 后自检：

openclaw googlemeet setup        # 人读openclaw googlemeet setup --json # 机读（供 agent 调用前校验）

任何 ok: false 的检查项都应先解决，不要让 agent 带着坏状态加入会议。

三、配置 Realtime 语音 Provider

OPENAI_API_KEY 并非必须。Google Meet 插件本身不调用 OpenAI——它需要的是一个 realtime voice provider（实时双工语音模型），OpenAI 只是默认值。

3.1 方案 A：OpenAI Realtime（默认）

export OPENAI_API_KEY=sk-...

默认模型：gpt-realtime-1.5，走 wss://api.openai.com/v1/realtime。

3.2 方案 B：Google Gemini Live（推荐国内）

export GEMINI_API_KEY=...

{  plugins: {    entries: {      "google-meet": {        config: {          realtime: { provider: "google" }        }      }    }  }}

模型：gemini-2.5-flash-native-audio-preview-12-2025。Gemini Live 国内直连比 OpenAI 友好，无需代理。

3.3 方案 C：走自定义 realtime 端点

{  plugins: {    entries: {      "google-meet": {        config: {          realtime: {            provider: "openai",            providers: {              openai: {                apiBase: "https://your-proxy.example.com/v1",                apiKey: "${YOUR_API_KEY}",                model: "gpt-realtime-1.5"              }            }          }        }      }    }  }}

这适合通过 self-host 代理路由 OpenAI 请求，或对接第三方 OpenAI Realtime 兼容端点。

注意： 目前没有开源/本地化替代。Realtime 双工模型需要 <500ms 端到端延迟，本地拼装 STT+LLM+TTS pipeline 延迟 1-3s，不适合会议场景。阿里通义/字节豆包/MiniMax 的部分 beta 端点正在出 OpenAI Realtime 兼容层，届时改 apiBase 即可接入。

四、基础使用

4.1 加入已有会议

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

或让 agent 调 google_meet 工具：

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

4.2 创建新会议并加入

openclaw googlemeet create --transport chrome --mode realtime

创建但不加入（只拿 URL）：

openclaw googlemeet create --no-join

create 有两条路径：

API create： 配了 Google Meet OAuth 时用，最快最可靠
Browser fallback： 无 OAuth 时自动打开 meet.google.com/new，等 Google 跳转生成 URL

4.3 烟雾测试

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

创建或复用 session，说一句固定短语，打印 session 健康状态。

4.4 两种 Mode

mode	行为
`realtime` （默认）	双工实时语音，agent 能听能说；必要时回调主 agent 做深度推理或调用工具
`transcribe`	浏览器控制但不启动语音桥接——agent 不讲话，适合旁听/记录

mode

行为

realtime

（默认）

双工实时语音，agent 能听能说；必要时回调主 agent 做深度推理或调用工具

transcribe

浏览器控制但不启动语音桥接——agent 不讲话，适合旁听/记录

五、Transport 选择与配置

5.1 Chrome（本地）

Chrome 跑在 Gateway 主机上，需要本地 BlackHole + SoX。加入后 Meet 里手动选 BlackHole 2ch 做麦克风/扬声器。

openclaw googlemeet join URL --transport chrome

单 BlackHole 设备够冒烟测试但可能回声。生产建议双虚拟设备或 Loopback 路由。

5.2 Chrome-node（配对节点）

Chrome + 音频跑在另一台机器（如 Parallels macOS VM）上，Gateway 主机只管 agent 和 model。

VM 端（节点主机）：

# 安装依赖brew install blackhole-2ch sox && sudo reboot# 启用插件openclaw plugins enable google-meetopenclaw plugins enable browser# 启动 nodeopenclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos

若 Gateway 用 LAN IP 且无 TLS：

OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node run --host 192.168.x.x --port 18789 --display-name parallels-macos

若需常驻（LaunchAgent）：

OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node install --host 192.168.x.x --port 18789 --display-name parallels-macos --forceopenclaw node restart

Gateway 端（主机）：

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status   # 确认有 googlemeet.chrome + browser.proxy

配置：

{  gateway: {    nodes: {      allowCommands: ["googlemeet.chrome", "browser.proxy"]    }  },  plugins: {    entries: {      "google-meet": {        enabled: true,        config: {          defaultTransport: "chrome-node",          chrome: {            guestName: "AI 助手",            autoJoin: true,            reuseExistingTab: true          },          chromeNode: {            node: "parallels-macos"          }        }      }    }  }}

现在在 Gateway 主机上正常 join 即可，Chrome 操作全部代理到节点上。

5.3 Twilio（电话拨入）

当无法用 Chrome 时，走电话拨入 fallback。需同时启用 voice-call 插件：

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

{  plugins: {    allow: ["google-meet", "voice-call"],    entries: {      "google-meet": {        enabled: true,        config: { defaultTransport: "twilio" }      },      "voice-call": {        enabled: true,        config: { provider: "twilio" }      }    }  }}

openclaw googlemeet join URL \  --transport twilio \  --dial-in-number +15551234567 \  --pin 123456

需要 DTMF 序列时（如按 1 确认、输 PIN）：

openclaw googlemeet join URL \  --transport twilio \  --dial-in-number +15551234567 \  --dtmf-sequence ww123456#

注意： Twilio transport 不解析 Meet 页面找电话号码，你必须自己提供 dial-in number 和 PIN。

六、Google Meet API OAuth（可选）

OAuth 只用于 API 创建会议、空间解析、Meet Media API preflight。如果只做 Chrome 浏览器加入，不需要 OAuth。

Google Cloud Console → 创建项目 → 启用 Google Meet REST API
配置 OAuth 同意屏幕（Internal 对 Workspace 组织，External 加 test user 给个人）
添加 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

创建 Web OAuth client ID，回调 http://localhost:8085/oauth2callback
授权：

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

输出包含 refresh token，写入 oauth.refreshToken 配置。浏览器无法带回调时加 --manual。

七、服务推荐

场景	Transport	Provider	Mode	说明
日常团队周会	chrome / chrome-node	gemini	realtime	低资源消耗，够记录+参与
客户会议	chrome-node	openai	realtime	更高准确性，支持回调工具查资料
旁听/会议纪要	chrome-node	gemini	transcribe	不说话，HTML 页面里做 CTRL+C摘要
技术讨论	chrome-node	openai	realtime	完整模式，含浏览器自动化操作回调
无 Chrome 环境	twilio	gemini	realtime	电话拨入，需 Meet 端有 dial-in
API 批量创建会议	OAuth + api	—	—	`googlemeet create` 返回 URL，不加入
国内直连场景	chrome-node	gemini	realtime	Gemini Live 国内直连，无需代理

八、常见问题与排查

自检不通过

openclaw googlemeet setup --json

逐条检查 ok: true/false，重点关注：

检查项	失败原因
`blackhole-2ch-audio-device`	没装 `blackhole-2ch` 或没重启
`sox-commands`	没装 `sox`
`realtime-voice-provider`	`OPENAI_API_KEY` 或 `GEMINI_API_KEY` 没设置，或 provider 未注册
`configured-google-meet-node`	node 离线或未配对
`twilio-voice-call-plugin`	未启用 `voice-call` 插件
`twilio-voice-call-credentials`	Twilio 环境变量缺失

Chrome 打开了但加不进去

Chrome profile 没登录 Google → 设 chrome.guestName 走 Guest join
Host 没放人 → 等 host 准入后 agent 重试
浏览器/OS 麦/摄像头权限弹窗 → 人手动点允许

以上情况 join 结果里会 manualActionRequired: true + manualActionReason + manualActionMessage，agent 应 停止重试，把信息报给人处理。

node 相关问题

Configured Google Meet node ... is not usable: offline → node 离线，agent 应诊断而非 fallback
No connected Google Meet-capable node → VM 端没跑 openclaw node run、没 approve pairing、或没 openclaw plugins enable google-meet
多个 node → 必须显式设 chromeNode.node