--- read_when: - 你想讓 OpenClaw 代理程式加入 Google Meet 通話 - 你想要 OpenClaw 代理程式建立新的 Google Meet 通話 - 你正在將 Chrome、Chrome 節點或 Twilio 設定為 Google Meet 傳輸方式 summary: Google Meet 外掛：透過 Chrome 或 Twilio 加入明確指定的 Meet URL，並採用代理程式回話預設值 title: Google Meet 外掛 x-i18n: generated_at: "2026-07-12T14:38:07Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 15 provider: openai source_hash: 5a3a0d2675bdfaeaa869652593fd1931c3afdefe0ed95f13935dade976ff038c source_path: plugins/google-meet.md workflow: 16 --- `google-meet` 外掛會代表 OpenClaw 代理程式加入明確指定的 Meet URL。其設計刻意限定於狹窄範圍： - 它只會加入 `https://meet.google.com/...` URL；絕不會根據自行找到的電話號碼撥入會議。 - `googlemeet create` 可透過 Google Meet API（或瀏覽器備援路徑）建立新的 Meet URL，並預設加入該會議。 - Chrome 參與方式會使用已登入的 Chrome 設定檔，也可選擇在已配對的節點上執行。Twilio 參與方式會透過[語音通話外掛](/zh-TW/plugins/voice-call)撥打電話號碼並輸入 PIN/DTMF；它無法直接撥打 Meet URL。 - `mode: "agent"`（預設）會使用即時供應商轉錄參與者的語音，將內容路由至設定的 OpenClaw 代理程式，再透過一般 OpenClaw TTS 說出回答。`mode: "bidi"` 讓即時語音模型直接回答。`mode: "transcribe"` 會以僅觀察模式加入，不提供語音回應。 - 外掛加入通話時不會自動播放同意聲明。 - 命令列介面命令是 `googlemeet`；`meet` 保留給更廣泛的代理程式電話會議工作流程。 ## 快速開始 安裝本機音訊相依套件，然後設定即時供應商金鑰。OpenAI 是 `agent` 模式的預設轉錄供應商；Google Gemini Live 可作為 `bidi` 模式的語音供應商： ```bash 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 才會顯示該裝置： ```bash sudo reboot ``` 重新啟動後，驗證兩者： ```bash system_profiler SPAudioDataType | grep -i BlackHole command -v sox ``` 啟用外掛： ```json5 { plugins: { entries: { "google-meet": { enabled: true, config: {}, }, }, }, } ``` 檢查設定，然後加入： ```bash openclaw googlemeet setup openclaw googlemeet join https://meet.google.com/abc-defg-hij ``` `setup` 輸出可供代理程式讀取，並會依模式與傳輸方式調整：它會回報 Chrome 設定檔、節點釘選，以及即時 Chrome 加入所需的 BlackHole/SoX 音訊橋接與延遲開場白檢查。僅觀察模式加入會略過即時處理的先決條件： ```bash openclaw googlemeet setup --transport chrome-node --mode transcribe ``` 設定 Twilio 委派後，`setup` 也會回報 `voice-call`、Twilio 認證資訊和公開網路鉤子是否已準備就緒。代理程式加入前，應將該傳輸方式／模式中任何 `ok: false` 的檢查視為阻擋條件。使用 `--json` 取得機器可讀輸出，並使用 `--transport chrome|chrome-node|twilio` 提前對特定傳輸方式執行預檢： ```bash openclaw googlemeet setup --transport twilio ``` 或讓代理程式透過 `google_meet` 工具加入： ```json { "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` 主機。 ### 建立會議 ```bash 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`（命令列介面）或 `"join": false`（工具）可只建立 URL。 對於透過 API 建立的會議室，請設定明確的存取原則，而不要沿用 Google 帳戶預設值： ```bash openclaw googlemeet create --access-type OPEN --transport chrome-node --mode agent ``` | `--access-type` | 無須敲門即可加入的人員 | | --------------- | ------------------------------------------------------------------- | | `OPEN` | 任何擁有 Meet URL 的人 | | `TRUSTED` | 主辦方機構的受信任使用者、受邀的外部使用者和撥入使用者 | | `RESTRICTED` | 僅限受邀者 | 這僅適用於透過 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 分頁： ```bash openclaw googlemeet transcript openclaw googlemeet transcript --since --json ``` 觀察器最多會在 Meet 頁面中保留 2,000 行已完成的字幕。可見的漸進式文字會保留在狀態健康狀況尾端，直到字幕列完成，因此儲存 `nextIndex` 不會略過後續的文字擴充；離開時會先完成可見列，再建立快照。`droppedLines` 會回報超過上限時從開頭遺失的行數。最近結束的四個工作階段逐字稿在閘道重新啟動前仍可讀取。更早結束的逐字稿會傳回 `evicted: true`。這是刻意設計的執行階段記憶體，而非永久會議歷程儲存空間：重新啟動閘道、在建立快照前關閉分頁，或超過文件記載的上限，都可能導致字幕遺失。 若要進行是／否的聆聽探測： ```bash openclaw googlemeet test-listen --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 中執行節點主機。 | 執行位置 | 執行內容 | | -------------------- | ----------------------------------------------------------------------------------------------- | | 閘道主機 | OpenClaw 閘道、代理程式工作區、模型／API 金鑰、即時供應商、Google Meet 外掛設定 | | Parallels macOS VM | OpenClaw 命令列介面／節點主機、Chrome、SoX、BlackHole 2ch、已登入 Google 的 Chrome 設定檔 | | VM 中不需要 | 閘道服務、代理程式設定、模型供應商設定 | 安裝 VM 相依套件、重新啟動並驗證： ```bash brew install blackhole-2ch sox sudo reboot system_profiler SPAudioDataType | grep -i BlackHole command -v sox ``` 在 VM 中啟用外掛並啟動節點主機： ```bash openclaw plugins enable google-meet openclaw node run --host --port 18789 --display-name parallels-macos ``` 如果 `` 是未使用 TLS 的 LAN IP，請為該受信任的私人網路選擇加入： ```bash OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \ openclaw node run --host --port 18789 --display-name parallels-macos ``` 安裝為 LaunchAgent 時也請使用相同旗標（它是程序環境，若安裝命令中存在，便會儲存在 LaunchAgent 環境中，而不是 `openclaw.json` 設定）： ```bash OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \ openclaw node install --host --port 18789 --display-name parallels-macos --force openclaw node restart ``` 從閘道主機核准節點，然後確認它同時公告 `googlemeet.chrome` 以及瀏覽器功能／`browser.proxy`： ```bash openclaw devices list openclaw devices approve openclaw nodes status ``` 透過該節點路由 Meet： ```json5 { 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", }, }, }, }, }, } ``` 現在從閘道主機正常加入： ```bash openclaw googlemeet join https://meet.google.com/abc-defg-hij ``` 若要使用單一命令執行煙霧測試，建立或重複使用工作階段、說出已知片語並列印工作階段健康狀況： ```bash 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` | 在 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` 裝置。 SoX 採用 `LGPL-2.0-only AND GPL-2.0-only` 授權；BlackHole 採用 GPL-3.0 授權。如果你建置的安裝程式或設備會將 BlackHole 與 OpenClaw 一起封裝，請檢閱 BlackHole 的上游授權，或向 Existential Audio 取得個別授權。 ## 傳輸方式 | 傳輸方式 | 適用情況 | | ------------- | -------------------------------------------------------------------------------------------- | | `chrome` | Chrome／音訊位於閘道主機上 | | `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` 主機。 ```bash 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 委派給 [Voice Call 外掛](/zh-TW/plugins/voice-call)的嚴格撥號方案。它不會剖析 Meet 頁面來取得電話號碼；Google Meet 必須為會議提供電話撥入號碼和 PIN。 請在閘道主機上啟用 Voice Call，而不是在 Chrome 節點上： ```json5 { 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`： ```bash 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` 後，請重新啟動或重新載入閘道；外掛設定變更在重新載入前不會生效。驗證方式： ```bash 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` 檢查。 ```bash openclaw googlemeet join https://meet.google.com/abc-defg-hij \ --transport twilio \ --dial-in-number +15551234567 \ --pin 123456 ``` 若要使用自訂序列，請使用 `--dtmf-sequence`，並以開頭的 `w` 或逗號在輸入 PIN 前暫停： ```bash 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 中： 對 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`（匯出逐字稿／智慧筆記文件內文） 應用程式類型為 **Web application**。已授權的重新導向 URI： ```text 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`（或透過環境變數傳入），然後執行： ```bash openclaw googlemeet auth login --json ``` 這會透過 `http://localhost:8085/oauth2callback` 上的 localhost 回呼執行 PKCE 流程，並列印包含重新整理權杖的 `oauth` 設定區塊。當瀏覽器無法連線至本機回呼時，請新增 `--manual` 以使用複製／貼上流程： ```bash OPENCLAW_GOOGLE_MEET_CLIENT_ID="your-client-id" \ OPENCLAW_GOOGLE_MEET_CLIENT_SECRET="your-client-secret" \ openclaw googlemeet auth login --json --manual ``` JSON 輸出： ```json { "oauth": { "clientId": "your-client-id", "clientSecret": "your-client-secret", "refreshToken": "refresh-token", "accessToken": "access-token", "expiresAt": 1770000000000 }, "scope": "..." } ``` 將 `oauth` 物件儲存在外掛設定下： ```json5 { 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 ```bash 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` 範圍： ```bash openclaw googlemeet doctor --oauth --create-space --json ``` 證明對現有空間具有讀取存取權： ```bash 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` ### 解析、預檢及讀取成品 ```bash openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij openclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij ``` Meet 建立會議記錄後： ```bash 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 活動唯讀範圍）： ```bash openclaw googlemeet latest --today openclaw googlemeet calendar-events --today --json openclaw googlemeet artifacts --event "每週同步" openclaw googlemeet attendance --today --format csv --output attendance.csv ``` `--today` 會在今天的 `primary` 行事曆中搜尋含有 Meet 連結的活動；`--event ` 會搜尋相符的活動文字；`--calendar ` 會指定非主要行事曆。`calendar-events` 會預覽相符的活動，並標示 `latest`/`artifacts`/`attendance`/`export` 將選擇哪一個。 如果你已知道會議記錄 ID，可直接指定： ```bash 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 建立之空間的會議室： ```bash 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 結束該空間中的進行中會議。 寫入易讀的報告： ```bash 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 ``` 當 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`）；請參閱[工具](#tool)。 ### 即時冒煙測試 ```bash 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 ``` ```bash 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`。 ### 建立範例 ```bash openclaw googlemeet create ``` 列印新的會議 URI、來源和加入工作階段。使用 OAuth 時會使用 Meet API；未使用時，則使用已固定 Chrome 節點的已登入設定檔。瀏覽器備援 JSON： ```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` 會傳回結構化詳細資料，而非純文字字串： ```json { "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： ```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 提供者： ```json5 { 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，以便在助理播放期間偵測人類插話；適用於由閘道託管的命令配對橋接器 | | `chrome.bargeInRmsThreshold` | `650` | 視為人類打斷的 RMS 音量 | | `chrome.bargeInPeakThreshold` | `2500` | 視為人類打斷的峰值音量 | | `chrome.bargeInCooldownMs` | `900` | 重複清除打斷狀態之間的最短延遲 | | `mode`（每個請求） | `"agent"` | 回話模式；請參閱[代理與雙向模式](#agent-and-bidi-modes)表格 | | `realtime.provider` | `"openai"` | 當下列限定範圍的欄位未設定時使用的相容性備援 | | `realtime.transcriptionProvider` | `"openai"` | `agent` 模式用於即時轉錄的供應商 ID | | `realtime.voiceProvider` | 未設定 | `bidi` 模式用於直接即時語音的供應商 ID；設為 `"google"` 可使用 Gemini Live，同時讓代理模式的轉錄繼續使用 OpenAI。搭配 `realtime.model` 選擇特定的 Gemini Live 模型。 | | `realtime.toolPolicy` | `"safe-read-only"` | 請參閱[代理與雙向模式](#agent-and-bidi-modes) | | `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`，接管整個本機音訊路徑；哪些模式可使用它們的限制請參閱[備註](#notes)。 舊版 `realtime.provider: "google"` 結構已有對應的 `openclaw doctor --fix` 遷移：若相關欄位尚未設定，會將該意圖移至 `realtime.voiceProvider: "google"`，並加上 `realtime.transcriptionProvider: "openai"`。 ### 選用覆寫 ```json5 { 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： ```json5 { 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=`。 僅使用 Twilio 的設定： ```json5 { 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` 工具： ```json { "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 連結的 Calendar 活動 | | `artifacts` | 列出會議記錄，以及參與者／錄製內容／逐字稿／智慧筆記中繼資料 | | `attendance` | 列出參與者及參與者工作階段 | | `export` | 寫入產物／出席情況／逐字稿／資訊清單套件組；設定 `"dryRun": true` 則僅產生資訊清單 | | `recover_current_tab` | 聚焦／檢查現有的 Meet 分頁，而不開啟新分頁 | | `transcript` | 讀取有界的字幕逐字稿；`sinceIndex` 會從先前的 `nextIndex` 繼續 | | `leave` | 結束工作階段（Chrome 會點擊離開；僅關閉它開啟的分頁；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 的離開通話按鈕後，讓重複使用且由使用者擁有的分頁保持開啟。由 OpenClaw 開啟的分頁會在離開後關閉。 Chrome 在閘道主機上執行時使用 `transport: "chrome"`；在已配對的節點上執行時使用 `transport: "chrome-node"`。無論哪種情況，模型提供者和 `openclaw_agent_consult` 都在閘道主機上執行，因此模型認證資訊會保留在該處。代理程式模式的記錄會在橋接啟動時包含解析後的轉錄提供者／模型，並在每次合成回覆後包含 TTS 提供者／模型／語音／輸出格式／取樣率。原始的 `mode: "realtime"` 仍可作為 `mode: "agent"` 的舊版相容別名使用，但工具的 `mode` 列舉已不再公布它。 使用 API 支援的會議室與明確存取原則執行 `create`： ```json { "action": "create", "transport": "chrome-node", "mode": "agent", "accessType": "OPEN" } ``` 結束已知會議室中作用中的會議： ```json { "action": "end_active_conference", "meeting": "https://meet.google.com/abc-defg-hij" } ``` 在宣稱會議可用之前，先進行聆聽驗證： ```json { "action": "test_listen", "url": "https://meet.google.com/abc-defg-hij", "transport": "chrome-node", "timeoutMs": 30000 } ``` 依需求說話： ```json { "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 裝置 | | `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::subagent:google-meet:` 工作階段金鑰，因此後續問題可保留會議內容，同時繼承一般代理程式原則。當代理程式在代理程式模式下呼叫 `google_meet` 時，顧問工作階段會先分叉呼叫者目前的逐字稿，再回答參與者的話語；Meet 工作階段會保持分離，因此會議中的後續問題不會直接修改呼叫者的逐字稿。 `realtime.toolPolicy` 控制諮詢執行： | 原則 | 行為 | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `safe-read-only` | 公開諮詢工具；將一般代理程式限制為 `read`、`web_search`、`web_fetch`、`x_search`、`memory_search`、`memory_get` | | `owner` | 公開諮詢工具；允許一般代理程式使用其正常工具原則 | | `none` | 不向即時語音模型公開諮詢工具 | 諮詢工作階段金鑰的範圍限定於每個 Meet 工作階段，因此同一場會議期間的後續諮詢呼叫會重複使用先前的諮詢內容。 Chrome 完全加入後，強制執行口語就緒檢查： ```bash openclaw googlemeet speak meet_... "Say exactly: I'm here and listening." ``` 完整的加入並說話冒煙測試： ```bash openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \ --transport chrome-node \ --message "Say exactly: I'm here and listening." ``` ## 即時測試檢查清單 將會議交給無人看管的代理程式之前： ```bash openclaw googlemeet setup openclaw nodes status openclaw 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 後，最簡短且安全的檢查方式如下： ```bash openclaw googlemeet setup openclaw nodes status --connected openclaw nodes invoke \ --node parallels-macos \ --command googlemeet.chrome \ --params '{"action":"setup"}' ``` 這可證明閘道外掛已載入、VM 節點已使用目前的權杖連線，且在代理程式開啟真正的會議分頁之前，Meet 音訊橋接已可使用。 若要進行 Twilio 冒煙測試，請使用提供電話撥入詳細資料的會議： ```bash 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` 檢查。 - 重新載入閘道後，命令列介面中即可使用 `voicecall`。 - 傳回的工作階段具有 `transport: "twilio"` 和 `twilio.voiceCallId`。 - `openclaw logs --follow` 顯示先提供 DTMF TwiML，再提供即時 TwiML，接著建立即時橋接並將初始問候語加入佇列。 - `googlemeet leave ` 會掛斷委派的語音通話。 ## 疑難排解 ### 代理程式看不到 Google Meet 工具 確認外掛已啟用並重新載入閘道；執行中的代理程式只能看到目前閘道程序所註冊的外掛工具： ```bash openclaw plugins list | grep google-meet openclaw googlemeet setup ``` 在非 macOS 的閘道主機上，`google_meet` 仍會顯示，但本機 Chrome 的回話動作會在到達音訊橋接之前遭到封鎖。請使用 `mode: "transcribe"`、Twilio 電話撥入，或 macOS `chrome-node` 主機，而非預設的本機 Chrome 代理程式路徑。 ### 沒有已連線且支援 Google Meet 的節點 在節點主機上： ```bash openclaw plugins enable google-meet openclaw plugins enable browser OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \ openclaw node run --host --port 18789 --display-name parallels-macos ``` 在閘道主機上： ```bash openclaw devices list openclaw devices approve openclaw nodes status ``` 節點必須已連線，並列出 `googlemeet.chrome` 和 `browser.proxy`；閘道設定也必須允許兩者： ```json5 { gateway: { nodes: { allowCommands: ["browser.proxy", "googlemeet.chrome"], }, }, } ``` 如果 `googlemeet setup` 的 `chrome-node-connected` 檢查失敗，或閘道日誌回報 `gateway token mismatch`，請使用目前的閘道權杖重新安裝或重新啟動節點： ```bash OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \ openclaw node install \ --host \ --port 18789 \ --display-name parallels-macos \ --force ``` 接著重新載入節點服務並再次執行： ```bash openclaw googlemeet setup openclaw 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`。 ### 代理程式已加入但沒有說話 ```bash openclaw googlemeet setup openclaw googlemeet doctor ``` STT -> OpenClaw 代理程式 -> TTS 路徑請使用 `mode: "agent"`，直接即時語音備援請使用 `mode: "bidi"`。`mode: "transcribe"` 刻意不啟動回話橋接。進行僅觀察的偵錯時，請在參與者說話後執行 `openclaw googlemeet status --json `，並檢查 `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 分頁已經開啟，請在不開啟另一個分頁的情況下檢查它： ```bash openclaw googlemeet recover-tab openclaw 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` 會失敗： ```bash 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 暴露方式： ```json5 { plugins: { entries: { "voice-call": { enabled: true, config: { provider: "twilio", fromNumber: "+15550001234", publicUrl: "https://voice.example.com/voice/webhook", }, }, }, }, } ``` 本機開發請使用通道或 Tailscale 暴露方式，而非私人主機 URL： ```json5 { plugins: { entries: { "voice-call": { config: { tunnel: { provider: "ngrok" }, // 或 tailscale: { mode: "funnel", path: "/voice/webhook" }, }, }, }, }, } ``` 重新啟動或重新載入閘道，然後執行： ```bash openclaw googlemeet setup --transport twilio openclaw voicecall setup openclaw voicecall smoke ``` `voicecall smoke` 預設只檢查就緒狀態。針對特定號碼進行試執行： ```bash openclaw voicecall smoke --to "+15555550123" ``` 只有在刻意撥出實際通話時才加入 `--yes`： ```bash openclaw voicecall smoke --to "+15555550123" --yes ``` ### Twilio 通話已開始，但始終未進入會議 確認 Meet 事件公開電話撥入詳細資訊，並傳入確切的撥入號碼與 PIN，或自訂 DTMF 序列： ```bash 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 `：確認委派的 Twilio 通話 ID、DTMF 是否已加入佇列，以及是否已要求播放介紹問候語。 - `openclaw voicecall status --call-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 `` 備援。如果逐字稿仍顯示 “enter the meeting PIN”，表示電話端尚未加入 Meet 會議室，因此參與者不會聽到語音。 如果網路鉤子未抵達，請先偵錯 Voice Call 外掛：提供者必須能連線至 `plugins.entries.voice-call.config.publicUrl` 或已設定的通道。請參閱[語音通話疑難排解](/zh-TW/plugins/voice-call#troubleshooting)。 ## 注意事項 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`。 ## 相關內容 - [語音通話外掛](/zh-TW/plugins/voice-call) - [交談模式](/zh-TW/nodes/talk) - [建置外掛](/zh-TW/plugins/building-plugins)