OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Plugin guides

Google Meet plugin

The google-meet plugin joins explicit Meet URLs on behalf of an OpenClaw agent. It is deliberately narrow:

  • It only joins https://meet.google.com/... URLs; it never dials into a meeting from a phone number it discovers itself.
  • googlemeet create can mint a new Meet URL through the Google Meet API (or a browser fallback) and join it by default.
  • Chrome participation uses a signed-in Chrome profile, optionally on a paired node. Twilio participation dials a phone number plus PIN/DTMF through the Voice call plugin; it cannot dial a Meet URL directly.
  • mode: "agent" (default) transcribes participant speech with a realtime provider, routes it to the configured OpenClaw agent, and speaks the answer with regular OpenClaw TTS. mode: "bidi" lets a realtime voice model answer directly. mode: "transcribe" joins observe-only with no talk-back.
  • There is no automatic consent announcement when the plugin joins a call.
  • The CLI command is googlemeet; meet is reserved for broader agent teleconference workflows.

Quick start

Install the plugin and the native audio dependencies for the Chrome host, then set a realtime provider key. OpenAI is the default transcription provider for agent mode; Google Gemini Live is available as the bidi-mode voice provider. On macOS:

bash
openclaw plugins install @openclaw/google-meetbrew install blackhole-2ch soxexport OPENAI_API_KEY=sk-...# only needed when realtime.voiceProvider is "google" for bidi modeexport GEMINI_API_KEY=...

blackhole-2ch installs the BlackHole 2ch virtual audio device Chrome routes through. Homebrew's installer requires a reboot before macOS exposes the device:

bash
sudo reboot

After reboot, verify both pieces:

bash
system_profiler SPAudioDataType | grep -i BlackHolecommand -v sox

On a Linux desktop with PipeWire-Pulse:

bash
sudo apt install pipewire-audio pulseaudio-utils # Debian/Ubuntusystemctl --user --now enable pipewire pipewire-pulse wireplumberpactl infocommand -v pactl pacat parec

OpenClaw provisions an OpenClaw Meeting Audio null sink and matching source in that desktop user's audio session. Run the Gateway or paired node as the same user that runs Chrome.

The plugin is enabled by default after installation. Add an entry only to customize it:

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

Run openclaw plugins disable google-meet if you do not want the plugin active.

Check setup, then join:

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

setup output is agent-readable and mode/transport-aware: it reports Chrome profile, node pinning, and, for realtime Chrome joins, the native virtual-audio backend and delayed-intro check. Observe-only joins skip realtime prerequisites:

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

When Twilio delegation is configured, setup also reports whether voice-call, Twilio credentials, and public webhook exposure are ready. Treat any ok: false check as a blocker for that transport/mode before an agent joins. Use --json for machine-readable output, and --transport chrome|chrome-node|twilio to preflight a specific transport ahead of time:

bash
openclaw googlemeet setup --transport twilio

Or let an agent join through the google_meet tool:

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

Local Chrome talk-back supports macOS with BlackHole 2ch and SoX, or Linux with PipeWire-Pulse and pactl/pacat/parec. On other operating systems, use mode: "transcribe", Twilio dial-in, or a supported macOS/Linux chrome-node host.

Create a meeting

bash
openclaw googlemeet create --transport chrome-node --mode agentopenclaw googlemeet create --no-join

create has two paths, reported in the result's source field:

  • api: used when Google Meet OAuth credentials are configured. Deterministic; does not depend on browser UI state.
  • browser: used without OAuth credentials. OpenClaw opens https://meet.google.com/new on the pinned Chrome node and waits for Google to redirect to a real meeting-code URL; the OpenClaw Chrome profile on that node must already be signed in to Google. Join and create both reuse an existing Meet tab (or an in-progress .../new / Google account prompt tab) before opening a new one; tab matching ignores harmless query strings like authuser.

create joins by default and returns joined: true plus the join session. Pass --no-join (CLI) or "join": false (tool) to mint the URL only.

For API-created rooms, set an explicit access policy instead of inheriting the Google account default:

bash
openclaw googlemeet create --access-type OPEN --transport chrome-node --mode agent
--access-type Who can join without knocking
OPEN Anyone with the Meet URL
TRUSTED Host org's trusted users, invited external users, and dial-in users
RESTRICTED Invitees only

This only applies to API-created rooms, so OAuth must be configured. If you authorized OpenClaw before access-type control shipped in 2026.5.2, rerun openclaw googlemeet auth login --json after adding the meetings.space.settings scope to your OAuth consent screen.

If the browser fallback hits a Google login or Meet permission blocker, the tool returns manualAction: { reason, message } with the browser.nodeId/browser.targetId/browserUrl. Report that message and stop opening new Meet tabs until the operator finishes the browser step.

Observe-only join

Set "mode": "transcribe" to skip the duplex realtime bridge (no virtual-audio requirement, no talk-back). Transcribe-mode Chrome joins also skip OpenClaw's microphone/camera permission grant and the Meet Use microphone path; if Meet shows the audio-choice interstitial, automation tries Continue without microphone first. Managed Chrome transports install a best-effort Meet caption observer in every mode so durable notes are available without changing the live agent-consult path. googlemeet status --json and googlemeet doctor report captioning, captionsEnabledAttempted, transcriptLines, lastCaptionAt, lastCaptionSpeaker, lastCaptionText, and a recentTranscript tail.

For the bounded session transcript, read the exact tracked Meet tab:

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

The observer keeps at most 2,000 completed caption lines in the Meet page. Visible progressive text stays in the status health tail until the caption row completes, so saving nextIndex cannot skip a later text expansion; leaving finalizes visible rows before the snapshot. droppedLines reports lines lost from the head when the cap is exceeded. The bounded googlemeet transcript tail still keeps only the four most recently ended sessions and resets with the Gateway. Separately, OpenClaw appends completed caption rows to the shared state database throughout the meeting and writes a derived summary on leave. Use openclaw transcripts to inspect or export those durable notes.

Automatic notes are enabled by default. Set transcripts.enabled: false to disable durable notes globally; explicit transcribe mode still exposes only its bounded live tail. Twilio joins do not have the browser caption stream and are not captured by this path.

For a yes/no listen probe:

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

It joins in transcribe mode, waits for fresh caption/transcript movement, and returns listenVerified, listenTimedOut, manual-action fields, and current caption health.

Audio bridge architecture

Google Meet's official media API is receive-oriented, so speaking into a call still needs a participant path. This plugin keeps that boundary visible: Chrome handles browser participation and local audio routing; Twilio handles phone dial-in participation.

Chrome talk-back modes need a supported native virtual-audio backend plus either:

  • chrome.audioInputCommand plus chrome.audioOutputCommand: OpenClaw owns the bridge and pipes audio in chrome.audioFormat between those commands and the selected provider. agent mode uses realtime transcription plus regular TTS; bidi mode uses the realtime voice provider. The default path is 24 kHz PCM16 with chrome.audioBufferBytes: 4096; 8 kHz G.711 mu-law remains available for legacy command pairs.
  • chrome.audioBridgeCommand: an external bridge command owns the whole local audio path and must exit after starting or validating its daemon. Valid only for bidi, because agent mode needs direct command-pair access for TTS.

With the command-pair Chrome bridge, chrome.bargeInInputCommand can listen to a separate local microphone and clear assistant playback when a human starts talking, keeping human speech ahead of assistant output even while the shared virtual loopback input is temporarily suppressed during assistant playback. Like chrome.audioInputCommand/chrome.audioOutputCommand, it is an operator-configured local command: use an explicit trusted command path or argument list, never a script from an untrusted location.

For clean duplex audio, route Meet output and Meet microphone through separate virtual devices or a Loopback-style virtual device graph; the default shared loopback device can echo other participants back into the call.

googlemeet speak triggers the active talk-back audio bridge for a Chrome session; googlemeet leave stops it (and, for Twilio sessions delegated through Voice Call, hangs up the underlying call). Use googlemeet end-active-conference to also close the active Google Meet conference for an API-managed space.

Realtime session health

During talk-back sessions, google_meet status reports Chrome/audio bridge health: inCall, manualAction, providerConnected, realtimeReady, audioInputActive, audioOutputActive, last input/output timestamps, byte counters, and bridge-closed state. Managed Chrome sessions only speak the intro/test phrase after health reports inCall: true; otherwise speechReady: false and the speech attempt is blocked rather than silently no-opping.

Local Chrome joins through the signed-in OpenClaw browser profile and routes its microphone and speaker through the native backend selected by chrome.audioBackend. The default shared loopback device is enough for a first smoke test but can echo; use separate virtual devices or a Loopback-style graph for clean duplex audio.

Where each section moved

Every section of the single-page version now lives on this page or on one of the five child pages below. The anchors from the single-page version still resolve here.

Google Meet transports and hosts

Google Meet transports and hosts — Chrome, Chrome node, and Twilio transports, the Parallels macOS VM topology, and the host audio tools they need.

Google Meet OAuth and artifacts

Google Meet OAuth and artifacts — Google Cloud credentials, the refresh token, OAuth verification, and reading Meet artifacts, attendance, and exports.

Google Meet configuration

Google Meet configuration — Plugin config defaults, optional overrides, and the ElevenLabs and Twilio config examples.

Google Meet tool and modes

Google Meet tool and modes — Tool actions for agents, session status fields, and the agent and bidi talk-back modes.

Google Meet troubleshooting

Google Meet troubleshooting — The pre-flight live test checklist and fixes for join, speech, creation, and Twilio failures.

Was this useful?
On this page

On this page