Vai al contenuto principale

​
Google Meet (Plugin)

Supporto ai partecipanti Google Meet per OpenClaw. Il Plugin è esplicito per progettazione:
  • Si unisce solo a un URL esplicito https://meet.google.com/....
  • La voce realtime è la modalità predefinita.
  • La voce in tempo reale può richiamare l’agente OpenClaw completo quando sono necessari ragionamenti più approfonditi o strumenti.
  • L’autenticazione inizia come OAuth Google personale o come profilo Chrome già connesso.
  • Non c’è alcun annuncio automatico di consenso.
  • Il backend audio Chrome predefinito è BlackHole 2ch.
  • Chrome può essere eseguito localmente o su un host Node associato.
  • Twilio accetta un numero di accesso telefonico più un PIN opzionale o una sequenza DTMF.
  • Il comando CLI è googlemeet; meet è riservato a flussi di teleconferenza dell’agente più ampi.

​
Avvio rapido

Installa le dipendenze audio locali e configura un provider vocale in tempo reale backend. OpenAI è quello predefinito; anche Google Gemini Live funziona con realtime.provider: "google": 
brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# or
export GEMINI_API_KEY=...
blackhole-2ch installa il dispositivo audio virtuale BlackHole 2ch. Il programma di installazione di Homebrew richiede un riavvio prima che macOS esponga il dispositivo: 
sudo reboot
Dopo il riavvio, verifica entrambi i componenti: 
system_profiler SPAudioDataType | grep -i BlackHole
command -v rec play
Abilita il Plugin: 
{
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {},
      },
    },
  },
}
Controlla la configurazione: 
openclaw googlemeet setup
Unisciti a una riunione: 
openclaw googlemeet join https://meet.google.com/abc-defg-hij
Oppure lascia che un agente si unisca tramite lo strumento google_meet: 
{
  "action": "join",
  "url": "https://meet.google.com/abc-defg-hij"
}
Chrome si unisce come profilo Chrome connesso. In Meet, scegli BlackHole 2ch per il percorso microfono/altoparlante usato da OpenClaw. Per un audio duplex pulito, usa dispositivi virtuali separati o un grafo in stile Loopback; un singolo dispositivo BlackHole è sufficiente per un primo smoke test, ma può creare eco.

​
Gateway locale + Chrome in Parallels

NON hai bisogno di un Gateway OpenClaw completo o di una chiave API del modello dentro una VM macOS solo per fare in modo che la VM ospiti Chrome. Esegui il Gateway e l’agente localmente, poi esegui un host Node nella VM. Abilita una volta il Plugin incluso sulla VM così il Node pubblicizza il comando Chrome: Cosa viene eseguito dove:
  • Host Gateway: OpenClaw Gateway, workspace dell’agente, chiavi modello/API, provider in tempo reale e configurazione del Plugin Google Meet.
  • VM macOS Parallels: CLI/host Node OpenClaw, Google Chrome, SoX, BlackHole 2ch e un profilo Chrome connesso a Google.
  • Non necessari nella VM: servizio Gateway, configurazione dell’agente, chiave OpenAI/GPT o configurazione del provider del modello.
Installa le dipendenze della VM: 
brew install blackhole-2ch sox
Riavvia la VM dopo aver installato BlackHole così macOS espone BlackHole 2ch: 
sudo reboot
Dopo il riavvio, verifica che la VM possa vedere il dispositivo audio e i comandi SoX: 
system_profiler SPAudioDataType | grep -i BlackHole
command -v rec play
Installa o aggiorna OpenClaw nella VM, poi abilita lì il Plugin incluso: 
openclaw plugins enable google-meet
Avvia l’host Node nella VM: 
openclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos
Se <gateway-host> è un IP LAN e non stai usando TLS, il Node rifiuta il WebSocket in testo semplice a meno che tu non acconsenta esplicitamente per quella rete privata fidata: 
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \
  openclaw node run --host <gateway-lan-ip> --port 18789 --display-name parallels-macos
Usa la stessa variabile d’ambiente quando installi il Node come LaunchAgent: 
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \
  openclaw node install --host <gateway-lan-ip> --port 18789 --display-name parallels-macos --force
openclaw node restart
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 è un ambiente di processo, non un’impostazione openclaw.json. openclaw node install lo memorizza nell’ambiente LaunchAgent quando è presente nel comando di installazione. Approva il Node dall’host Gateway: 
openclaw devices list
openclaw devices approve <requestId>
Conferma che il Gateway veda il Node e che pubblicizzi googlemeet.chrome: 
openclaw nodes status
Instrada Meet attraverso quel Node sull’host Gateway: 
{
  gateway: {
    nodes: {
      allowCommands: ["googlemeet.chrome"],
    },
  },
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          chromeNode: {
            node: "parallels-macos",
          },
        },
      },
    },
  },
}
Ora unisciti normalmente dall’host Gateway: 
openclaw googlemeet join https://meet.google.com/abc-defg-hij
oppure chiedi all’agente di usare lo strumento google_meet con transport: "chrome-node". Se chromeNode.node viene omesso, OpenClaw seleziona automaticamente solo quando esattamente un Node connesso pubblicizza googlemeet.chrome. Se sono connessi più Node compatibili, imposta chromeNode.node sull’id del Node, sul nome visualizzato o sull’IP remoto. Controlli comuni in caso di errore:
  • No connected Google Meet-capable node: avvia openclaw node run nella VM, approva l’associazione e assicurati che openclaw plugins enable google-meet sia stato eseguito nella VM. Conferma anche che l’host Gateway consenta il comando del Node con gateway.nodes.allowCommands: ["googlemeet.chrome"].
  • BlackHole 2ch audio device not found on the node: installa blackhole-2ch nella VM e riavvia la VM.
  • Chrome si apre ma non riesce a unirsi: accedi a Chrome nella VM e conferma che quel profilo possa unirsi manualmente all’URL Meet.
  • Nessun audio: in Meet, instrada microfono/altoparlante attraverso il percorso del dispositivo audio virtuale usato da OpenClaw; usa dispositivi virtuali separati o instradamento in stile Loopback per un audio duplex pulito.

​
Note di installazione

Il valore predefinito Chrome in tempo reale usa due strumenti esterni:
  • sox: utilità audio da riga di comando. Il Plugin usa i suoi comandi rec e play per il bridge audio predefinito G.711 mu-law a 8 kHz.
  • blackhole-2ch: driver audio virtuale macOS. Crea il dispositivo audio BlackHole 2ch attraverso cui Chrome/Meet può essere instradato.
OpenClaw non include né ridistribuisce nessuno dei due pacchetti. La documentazione chiede agli utenti di installarli come dipendenze host tramite Homebrew. SoX è concesso in licenza come LGPL-2.0-only AND GPL-2.0-only; BlackHole è GPL-3.0. Se crei un programma di installazione o un’appliance che include BlackHole con OpenClaw, esamina i termini di licenza upstream di BlackHole oppure ottieni una licenza separata da Existential Audio.

​
Trasporti

​
Chrome

Il trasporto Chrome apre l’URL Meet in Google Chrome e si unisce come profilo Chrome connesso. Su macOS, il Plugin controlla la presenza di BlackHole 2ch prima dell’avvio. Se configurato, esegue anche un comando di controllo integrità del bridge audio e un comando di avvio prima di aprire Chrome. Usa chrome quando Chrome/audio si trovano sull’host Gateway; usa chrome-node quando Chrome/audio si trovano su un Node associato come una VM macOS Parallels. 
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
Instrada l’audio di microfono e altoparlante di Chrome attraverso il bridge audio locale OpenClaw. Se BlackHole 2ch non è installato, l’accesso alla riunione fallisce con un errore di configurazione invece di unirsi silenziosamente senza un percorso audio.

​
Twilio

Il trasporto Twilio è un piano di composizione rigoroso delegato al Plugin Voice Call. Non analizza le pagine Meet per trovare numeri di telefono. 
openclaw googlemeet join https://meet.google.com/abc-defg-hij \
  --transport twilio \
  --dial-in-number +15551234567 \
  --pin 123456
Usa --dtmf-sequence quando la riunione richiede una sequenza personalizzata: 
openclaw googlemeet join https://meet.google.com/abc-defg-hij \
  --transport twilio \
  --dial-in-number +15551234567 \
  --dtmf-sequence ww123456#

​
OAuth e preflight

L’accesso alla Google Meet Media API usa prima un client OAuth personale. Configura oauth.clientId e facoltativamente oauth.clientSecret, poi esegui: 
openclaw googlemeet auth login --json
Il comando stampa un blocco di configurazione oauth con un refresh token. Usa PKCE, callback localhost su http://localhost:8085/oauth2callback e un flusso manuale copia/incolla con --manual. Queste variabili d’ambiente sono accettate come fallback:
  • OPENCLAW_GOOGLE_MEET_CLIENT_ID o GOOGLE_MEET_CLIENT_ID
  • OPENCLAW_GOOGLE_MEET_CLIENT_SECRET o GOOGLE_MEET_CLIENT_SECRET
  • OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN o GOOGLE_MEET_REFRESH_TOKEN
  • OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN o GOOGLE_MEET_ACCESS_TOKEN
  • OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT o GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT
  • OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING o GOOGLE_MEET_DEFAULT_MEETING
  • OPENCLAW_GOOGLE_MEET_PREVIEW_ACK o GOOGLE_MEET_PREVIEW_ACK
Risolvi un URL Meet, un codice o spaces/{id} tramite spaces.get: 
openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij
Esegui il preflight prima del lavoro sui contenuti multimediali: 
openclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij
Imposta preview.enrollmentAcknowledged: true solo dopo aver confermato che il tuo progetto Cloud, il principal OAuth e i partecipanti alla riunione siano iscritti al Google Workspace Developer Preview Program per le Meet media APIs.

​
Configurazione

Il percorso Chrome in tempo reale comune richiede solo il Plugin abilitato, BlackHole, SoX e una chiave provider vocale in tempo reale backend. OpenAI è quello predefinito; imposta realtime.provider: "google" per usare Google Gemini Live: 
brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# or
export GEMINI_API_KEY=...
Imposta la configurazione del Plugin sotto plugins.entries.google-meet.config: 
{
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {},
      },
    },
  },
}
Valori predefiniti:
  • defaultTransport: "chrome"
  • defaultMode: "realtime"
  • chromeNode.node: id/nome/IP del Node facoltativo per chrome-node
  • chrome.audioBackend: "blackhole-2ch"
  • chrome.audioInputCommand: comando SoX rec che scrive audio G.711 mu-law a 8 kHz su stdout
  • chrome.audioOutputCommand: comando SoX play che legge audio G.711 mu-law a 8 kHz da stdin
  • realtime.provider: "openai"
  • realtime.toolPolicy: "safe-read-only"
  • realtime.instructions: risposte vocali brevi, con openclaw_agent_consult per risposte più approfondite
  • realtime.introMessage: breve controllo vocale di disponibilità quando il bridge realtime si connette; impostalo su "" per unirti in silenzio
Sostituzioni facoltative: 
{
  defaults: {
    meeting: "https://meet.google.com/abc-defg-hij",
  },
  chrome: {
    browserProfile: "Default",
  },
  chromeNode: {
    node: "parallels-macos",
  },
  realtime: {
    provider: "google",
    toolPolicy: "owner",
    introMessage: "Say exactly: I'm here.",
    providers: {
      google: {
        model: "gemini-2.5-flash-native-audio-preview-12-2025",
        voice: "Kore",
      },
    },
  },
}
Configurazione solo Twilio: 
{
  defaultTransport: "twilio",
  twilio: {
    defaultDialInNumber: "+15551234567",
    defaultPin: "123456",
  },
  voiceCall: {
    gatewayUrl: "ws://127.0.0.1:18789",
  },
}

​
Strumento

Gli agenti possono usare lo strumento google_meet: 
{
  "action": "join",
  "url": "https://meet.google.com/abc-defg-hij",
  "transport": "chrome-node",
  "mode": "realtime"
}
Usa transport: "chrome" quando Chrome viene eseguito sull’host Gateway. Usa transport: "chrome-node" quando Chrome viene eseguito su un Node associato come una VM Parallels. In entrambi i casi il modello realtime e openclaw_agent_consult vengono eseguiti sull’host Gateway, quindi le credenziali del modello restano lì. Usa action: "status" per elencare le sessioni attive o ispezionare un ID sessione. Usa action: "speak" con sessionId e message per far parlare immediatamente l’agente realtime. Usa action: "leave" per contrassegnare una sessione come terminata. 
{
  "action": "speak",
  "sessionId": "meet_...",
  "message": "Say exactly: I'm here and listening."
}

​
Consultazione dell’agente in tempo reale

La modalità realtime di Chrome è ottimizzata per un ciclo vocale dal vivo. Il provider vocale realtime ascolta l’audio della riunione e parla attraverso il bridge audio configurato. Quando il modello realtime ha bisogno di ragionamenti più approfonditi, informazioni aggiornate o dei normali strumenti OpenClaw, può chiamare openclaw_agent_consult. Lo strumento di consultazione esegue dietro le quinte il normale agente OpenClaw con il contesto recente della trascrizione della riunione e restituisce una risposta parlata concisa alla sessione vocale realtime. Il modello vocale può quindi pronunciare quella risposta nella riunione. realtime.toolPolicy controlla l’esecuzione della consultazione:
  • safe-read-only: espone lo strumento di consultazione e limita l’agente normale a read, web_search, web_fetch, x_search, memory_search e memory_get.
  • owner: espone lo strumento di consultazione e consente all’agente normale di usare la normale policy degli strumenti dell’agente.
  • none: non espone lo strumento di consultazione al modello vocale realtime.
La chiave della sessione di consultazione è limitata a ogni sessione Meet, quindi le chiamate di consultazione successive possono riutilizzare il contesto precedente della consultazione durante la stessa riunione. Per forzare un controllo vocale di disponibilità dopo che Chrome si è unito completamente alla chiamata: 
openclaw googlemeet speak meet_... "Say exactly: I'm here and listening."

​
Note

La media API ufficiale di Google Meet è orientata alla ricezione, quindi per parlare in una chiamata Meet serve comunque un percorso da partecipante. Questo Plugin mantiene visibile quel confine: Chrome gestisce la partecipazione dal browser e l’instradamento audio locale; Twilio gestisce la partecipazione tramite accesso telefonico. La modalità realtime di Chrome richiede una delle due opzioni:
  • chrome.audioInputCommand più chrome.audioOutputCommand: OpenClaw gestisce il bridge del modello realtime e convoglia audio G.711 mu-law a 8 kHz tra quei comandi e il provider vocale realtime selezionato.
  • chrome.audioBridgeCommand: un comando bridge esterno gestisce l’intero percorso audio locale e deve terminare dopo aver avviato o convalidato il proprio demone.
Per un audio duplex pulito, instrada l’uscita Meet e il microfono Meet attraverso dispositivi virtuali separati o un grafo di dispositivi virtuali in stile Loopback. Un singolo dispositivo BlackHole condiviso può rimandare in eco nella chiamata l’audio degli altri partecipanti. googlemeet speak attiva il bridge audio realtime attivo per una sessione Chrome. googlemeet leave arresta quel bridge. Per le sessioni Twilio delegate tramite il Plugin Voice Call, leave riaggancia anche la chiamata vocale sottostante.

​
Correlati