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" 會以僅觀察模式加入，不提供語音回應。
• 外掛加入通話時不會自動播放同意聲明。
• 命令列介面命令是 googlemeet；meet 保留給更廣泛的代理程式電話會議工作流程。

快速開始

安裝本機音訊相依套件，然後設定即時供應商金鑰。OpenAI 是 agent 模式的預設轉錄供應商；Google Gemini Live 可作為 bidi 模式的語音供應商：

brew install blackhole-2ch soxexport 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 BlackHolecommand -v sox

啟用外掛：

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

檢查設定，然後加入：

openclaw googlemeet setupopenclaw 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 認證資訊和公開網路鉤子是否已準備就緒。代理程式加入前，應將該傳輸方式／模式中任何 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 的閘道主機上，google_meet 仍會顯示，可用於成品、行事曆、設定、轉錄、Twilio 和 chrome-node 動作；但本機 Chrome 語音回應（transport: "chrome" 搭配 mode: "agent" 或 "bidi"）會在抵達音訊橋接前遭到阻擋，因為該路徑目前依賴 macOS 的 BlackHole 2ch。請改用 mode: "transcribe"、Twilio 撥入，或 macOS chrome-node 主機。

建立會議

openclaw googlemeet create --transport chrome-node --mode agentopenclaw 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（命令列介面）或 "join": false（工具）可只建立 URL。

對於透過 API 建立的會議室，請設定明確的存取原則，而不要沿用 Google 帳戶預設值：

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

這僅適用於透過 API 建立的會議室，因此必須設定 OAuth。如果你是在此選項推出前完成驗證，請先將 meetings.space.settings 範圍新增至 OAuth 同意畫面，再重新執行 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 會回報超過上限時從開頭遺失的行數。最近結束的四個工作階段逐字稿在閘道重新啟動前仍可讀取。更早結束的逐字稿會傳回 evicted: true。這是刻意設計的執行階段記憶體，而非永久會議歷程儲存空間：重新啟動閘道、在建立快照前關閉分頁，或超過文件記載的上限，都可能導致字幕遺失。

若要進行是／否的聆聽探測：

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 類型的路由圖。

本機閘道 + Parallels Chrome

如果只是要讓 macOS VM 提供 Chrome，VM 內不需要完整的閘道或模型 API 金鑰。在本機執行閘道和代理程式；在 VM 中執行節點主機。

安裝 VM 相依套件、重新啟動並驗證：

brew install blackhole-2ch soxsudo rebootsystem_profiler SPAudioDataType | grep -i BlackHolecommand -v sox

在 VM 中啟用外掛並啟動節點主機：

openclaw plugins enable google-meetopenclaw 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 --forceopenclaw node restart

從閘道主機核准節點，然後確認它同時公告 googlemeet.chrome 以及瀏覽器功能／browser.proxy：

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

透過該節點路由 Meet：

{  gateway: {    nodes: {      allowCommands: ["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",          },        },      },    },  },}

現在從閘道主機正常加入：

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）。

常見失敗檢查

安裝注意事項

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

透過 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 chromeopenclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome-node

Chrome 麥克風／喇叭音訊會透過本機 OpenClaw 音訊橋接器路由。如果未安裝 BlackHole 2ch，加入作業會因設定錯誤而失敗，而不是在沒有音訊路徑的情況下加入。

Twilio

委派給 Voice Call 外掛的嚴格撥號方案。它不會剖析 Meet 頁面來取得電話號碼；Google Meet 必須為會議提供電話撥入號碼和 PIN。

請在閘道主機上啟用 Voice Call，而不是在 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=+15550001234export GEMINI_API_KEY=...

如果 OpenAI 是即時語音提供者，請改用 realtime.provider: "openai" 與 OPENAI_API_KEY。

啟用 voice-call 後，請重新啟動或重新載入閘道；外掛設定變更在重新載入前不會生效。驗證方式：

openclaw config validateopenclaw 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 節點的加入流程一律不依賴 OAuth；無論如何，它們都會使用已登入的 Chrome 設定檔、BlackHole／SoX，以及（對於 chrome-node）已連線的節點。

建立 Google 認證資訊

在 Google Cloud Console 中：

http://localhost:8085/oauth2callback

spaces.create 需要 meetings.space.created。meetings.space.readonly 會將 Meet URL／代碼解析為空間。meetings.space.settings 可讓 OpenClaw 在透過 API 建立會議室時傳遞 SpaceConfig 設定，例如 accessType。meetings.conference.media.readonly 用於 Meet Media API 前置檢查和媒體作業；Google 可能要求加入 Developer Preview，才能實際使用 Media API。只有使用 --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、檢查訊息），絕不會列印存取權杖、重新整理權杖或用戶端密鑰。

使用會產生副作用的建立檢查，證明 Meet API 已啟用且具備 spaces.create 範圍：

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

證明對現有空間具有讀取存取權：

openclaw googlemeet doctor --oauth --meeting https://meet.google.com/abc-defg-hij --jsonopenclaw 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-hijopenclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij

Meet 建立會議記錄後：

openclaw googlemeet artifacts --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet attendance --meeting https://meet.google.com/abc-defg-hijopenclaw 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 --todayopenclaw googlemeet calendar-events --today --jsonopenclaw googlemeet artifacts --event "每週同步"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-hijopenclaw googlemeet artifacts --conference-record conferenceRecords/abc123 --jsonopenclaw googlemeet attendance --conference-record conferenceRecords/abc123 --json

關閉由 API 建立之空間的會議室：

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

這會呼叫 spaces.endActiveConference，並要求 OAuth 對已授權帳戶可管理的空間具備 meetings.space.created 範圍。它接受 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.mdopenclaw googlemeet attendance --conference-record conferenceRecords/abc123 \  --format csv --output meet-attendance.csvopenclaw googlemeet export --conference-record conferenceRecords/abc123 \  --include-doc-bodies --zip --output meet-exportopenclaw 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 可調整閾值。

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 transcribeopenclaw googlemeet test-listen https://meet.google.com/abc-defg-hij --transport chrome-node --timeout-ms 30000

基本成品／出席情況冒煙測試需要 meetings.space.readonly 和 meetings.conference.media.readonly。行事曆查詢需要 calendar.events.readonly。Drive 文件本文匯出需要 drive.meet.readonly。

建立範例

openclaw googlemeet create

列印新的會議 URI、來源和加入工作階段。使用 OAuth 時會使用 Meet API；未使用時，則使用已固定 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 主體及會議參與者皆已加入 Meet 媒體 API 的 Google Workspace Developer Preview Program 後，才能設定 preview.enrollmentAcknowledged: true。

設定

一般 Chrome 代理程式路徑只需要啟用外掛、BlackHole、SoX、即時提供者金鑰，以及已設定的 OpenClaw TTS 提供者：

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

預設值

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：

{  messages: {    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 的固定語音來自 messages.tts.providers.elevenlabs.speakerVoiceId。啟用 TTS 模型覆寫時，代理回覆也可使用每則回覆專屬的 [[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",  },}

使用 Twilio 傳輸且 voiceCall.enabled: true（預設值）時，Voice Call 會先輸入 DTMF 序列，再開啟即時媒體串流，接著以已儲存的開場文字作為最初的即時問候。若未啟用 voice-call，Google Meet 仍可驗證並記錄撥號方案，但無法撥打 Twilio 通話。

將 voiceCall.gatewayUrl 保持未設定，即可使用本機受信任的閘道執行階段，並在整通通話期間保留 呼叫它的代理程式。已設定的閘道 URL 仍是明確的 WebSocket 目標，且 無法驗證外掛來源；非預設代理程式加入時會採取封閉式失敗，而不會默默 改用其他代理程式。需要依代理程式進行路由時，請在同一個閘道程序中執行 Google Meet 和 Voice Call。

工具

代理程式使用 google_meet 工具：

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

test_speech 一律強制使用 mode: "agent" 或 "bidi"；若要求以 mode: "transcribe" 執行則會失敗，因為僅觀察工作階段無法輸出語音。其 speechOutputVerified 結果是根據該次呼叫期間即時音訊輸出位元組是否增加，因此重複使用的工作階段即使有較舊的音訊，也不算新的檢查。

對於 Chrome 傳輸，leave 會在點擊 Meet 的離開通話按鈕後，讓重複使用且由使用者擁有的分頁保持開啟。由 OpenClaw 開啟的分頁會在離開後關閉。

Chrome 在閘道主機上執行時使用 transport: "chrome"；在已配對的節點上執行時使用 transport: "chrome-node"。無論哪種情況，模型提供者和 openclaw_agent_consult 都在閘道主機上執行，因此模型認證資訊會保留在該處。代理程式模式的記錄會在橋接啟動時包含解析後的轉錄提供者／模型，並在每次合成回覆後包含 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 健康狀態：

代理程式與 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 控制諮詢執行：

諮詢工作階段金鑰的範圍限定於每個 Meet 工作階段，因此同一場會議期間的後續諮詢呼叫會重複使用先前的諮詢內容。

Chrome 完全加入後，強制執行口語就緒檢查：

openclaw googlemeet speak meet_... "Say exactly: I'm here and listening."

完整的加入並說話冒煙測試：

openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \  --transport chrome-node \  --message "Say exactly: I'm here and listening."

即時測試檢查清單

將會議交給無人看管的代理程式之前：

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 傳回 Chrome 健康狀態，其中 inCall: true。

對於 Parallels macOS VM 等遠端 Chrome 主機，在更新閘道或 VM 後，最簡短且安全的檢查方式如下：

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

這可證明閘道外掛已載入、VM 節點已使用目前的權杖連線，且在代理程式開啟真正的會議分頁之前，Meet 音訊橋接已可使用。

若要進行 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。
• 傳回的工作階段具有 transport: "twilio" 和 twilio.voiceCallId。
• openclaw logs --follow 顯示先提供 DTMF TwiML，再提供即時 TwiML，接著建立即時橋接並將初始問候語加入佇列。
• googlemeet leave <sessionId> 會掛斷委派的語音通話。

疑難排解

代理程式看不到 Google Meet 工具

確認外掛已啟用並重新載入閘道；執行中的代理程式只能看到目前閘道程序所註冊的外掛工具：

openclaw plugins list | grep google-meetopenclaw googlemeet setup

在非 macOS 的閘道主機上，google_meet 仍會顯示，但本機 Chrome 的回話動作會在到達音訊橋接之前遭到封鎖。請使用 mode: "transcribe"、Twilio 電話撥入，或 macOS chrome-node 主機，而非預設的本機 Chrome 代理程式路徑。

沒有已連線且支援 Google Meet 的節點

在節點主機上：

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

在閘道主機上：

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

節點必須已連線，並列出 googlemeet.chrome 和 browser.proxy；閘道設定也必須允許兩者：

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

如果 googlemeet setup 的 chrome-node-connected 檢查失敗，或閘道日誌回報 gateway token mismatch，請使用目前的閘道權杖重新安裝或重新啟動節點：

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

瀏覽器已開啟，但代理程式無法加入

針對僅觀察的加入執行 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 不需要即時音訊路徑。

無法建立會議

設定 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 顯示 “Do you want people to hear you in the meeting?”，請保持分頁開啟。OpenClaw 應點選 Use microphone 或（僅建立會議時）Continue without microphone，並繼續等待產生的 URL；如果無法這麼做，錯誤應提及 meet-audio-choice-required，而不是 google-login-required。

代理程式已加入但沒有說話

openclaw googlemeet setupopenclaw 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 使用者介面已變更，或該會議語言／帳戶無法使用即時字幕。

googlemeet test-speech 一律檢查即時路徑，並回報該次叫用是否觀察到橋接輸出位元組。如果 speechOutputVerified 為 false 且 speechOutputTimedOut 為 true，即時提供者可能已接受該段話語，但 OpenClaw 未觀察到新的輸出位元組抵達 Chrome 音訊橋接。

另請確認：閘道主機上有可用的即時提供者金鑰（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-tabopenclaw googlemeet recover-tab https://meet.google.com/abc-defg-hij

對應的工具動作是 recover_current_tab：它會針對所選傳輸方式聚焦並檢查現有的 Meet 分頁（chrome 使用本機瀏覽器控制，chrome-node 使用已設定的節點），不會開啟新分頁或工作階段，並回報目前的阻礙因素（登入、准許加入、權限、音訊選擇狀態）。命令列介面命令會與已設定且必須執行中的閘道通訊；chrome-node 還要求節點已連線。

Twilio 設定檢查失敗

當 voice-call 不在允許清單中或尚未啟用時，twilio-voice-call-plugin 會失敗：將它加入 plugins.allow、啟用 plugins.entries.voice-call，然後重新載入閘道。

當 Twilio 後端缺少帳戶 SID、驗證權杖或撥出號碼時，twilio-voice-call-credentials 會失敗：

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

當 voice-call 沒有公開網路鉤子暴露方式，或 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" },        },      },    },  },}

重新啟動或重新載入閘道，然後執行：

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#

在 --dtmf-sequence 中使用開頭的 w 或逗號，在輸入 PIN 前暫停。

如果通話已建立，但 Meet 參與者名單始終未顯示電話撥入參與者：

• openclaw googlemeet doctor <session-id>：確認委派的 Twilio 通話 ID、DTMF 是否已加入佇列，以及是否已要求播放介紹問候語。
• openclaw voicecall status --call-id <id>：確認通話仍在進行中。
• openclaw voicecall tail：確認 Twilio 網路鉤子正在抵達閘道。
• 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 提示，請從預設的 12 秒增加 voiceCall.dtmfDelayMs。
• 如果參與者已加入，但你聽不到問候語，請在 openclaw logs --follow 中檢查 DTMF 後的 voicecall.speak 要求，以及媒體串流 TTS 播放或 Twilio OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 備援。如果逐字稿仍顯示 “enter the meeting PIN”，表示電話端尚未加入 Meet 會議室，因此參與者不會聽到語音。

如果網路鉤子未抵達，請先偵錯 Voice Call 外掛：提供者必須能連線至 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 μ-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 管理空間的作用中 Google Meet 會議，請使用 googlemeet end-active-conference。

相關內容

• 語音通話外掛
• 交談模式
• 建置外掛