- Es tritt nur einer expliziten
https://meet.google.com/...-URL bei. - Es kann über die Google Meet API einen neuen Meet-Raum erstellen und dann der zurückgegebenen URL beitreten.
agentist der Standardmodus für Rücksprache: Echtzeit-Transkription hört zu, der konfigurierte OpenClaw-Agent antwortet, und reguläres OpenClaw TTS spricht in Meet.bidibleibt als Fallback-Modus für das direkte Echtzeit-Sprachmodell verfügbar.- Agenten wählen das Beitrittsverhalten mit
mode: Verwenden Sieagentfür Live- Zuhören/Rücksprache,bidifür den direkten Echtzeit-Sprach-Fallback odertranscribe, um den Browser ohne Rücksprache-Bridge beizutreten/zu steuern. - Die Authentifizierung beginnt als persönliches Google OAuth oder als bereits angemeldetes Chrome-Profil.
- Es gibt keine automatische Zustimmungshinweis-Ansage.
- Das standardmäßige Chrome-Audio-Backend ist
BlackHole 2ch. - Chrome kann lokal oder auf einem gekoppelten Node-Host ausgeführt werden.
- Twilio akzeptiert eine Einwahlnummer plus optionale PIN oder DTMF-Sequenz; es kann eine Meet-URL nicht direkt anwählen.
- Der CLI-Befehl ist
googlemeet;meetist für umfassendere Agent- Telefonkonferenz-Workflows reserviert.
Schnellstart
Installieren Sie die lokalen Audio-Abhängigkeiten und konfigurieren Sie einen Provider für Echtzeit-Transkription plus reguläres OpenClaw TTS. OpenAI ist der Standard- Transkriptions-Provider; Google Gemini Live funktioniert außerdem als separaterbidi-
Sprach-Fallback mit realtime.voiceProvider: "google":
blackhole-2ch installiert das virtuelle Audiogerät BlackHole 2ch. Der Installer
von Homebrew erfordert einen Neustart, bevor macOS das Gerät bereitstellt:
--mode transcribe; dieser Modus überspringt Echtzeit-Audio-
Voraussetzungen, weil er nicht über die Bridge zuhört oder spricht:
voice-call-Plugin, die Twilio-Anmeldedaten und die öffentliche Webhook-Freigabe bereit sind.
Behandeln Sie jede ok: false-Prüfung als Blocker für den geprüften Transport und Modus,
bevor Sie einen Agenten beitreten lassen. Verwenden Sie openclaw googlemeet setup --json
für Skripte oder maschinenlesbare Ausgabe. Verwenden Sie --transport chrome,
--transport chrome-node oder --transport twilio, um einen bestimmten
Transport vorab zu prüfen, bevor ein Agent ihn ausprobiert.
Führen Sie für Twilio immer explizit eine Vorabprüfung des Transports durch, wenn der Standardtransport
Chrome ist:
voice-call-Verdrahtung, Twilio-Anmeldedaten oder nicht erreichbare
Webhook-Freigabe erkannt, bevor der Agent versucht, das Meeting anzuwählen.
Treten Sie einem Meeting bei:
google_meet-Tool beitreten:
google_meet-Tool bleibt auf Nicht-macOS-Hosts für
Artefakt-, Kalender-, Setup-, Transkriptions-, Twilio- und chrome-node-Abläufe verfügbar.
Lokale Chrome-Rücksprache-Aktionen sind dort blockiert, weil der gebündelte Chrome-Audiopfad
derzeit von macOS BlackHole 2ch abhängt. Verwenden Sie unter Linux mode: "transcribe",
Twilio-Einwahl oder einen macOS-chrome-node-Host für Chrome-Rücksprache-
Teilnahme.
Erstellen Sie ein neues Meeting und treten Sie ihm bei:
SpaceConfig.accessType, wenn die
No-Knock-Richtlinie des Raums explizit sein soll, statt aus den Standardeinstellungen des Google-
Kontos übernommen zu werden:
OPEN lässt jeden mit der Meet-URL ohne Anklopfen beitreten. TRUSTED lässt
vertrauenswürdige Benutzer der Host-Organisation, eingeladene externe Benutzer und Einwahlbenutzer
ohne Anklopfen beitreten. RESTRICTED beschränkt den Eintritt ohne Anklopfen auf Eingeladene. Diese
Einstellungen gelten nur für den offiziellen Google Meet API-Erstellungspfad, daher müssen OAuth-
Anmeldedaten konfiguriert sein.
Wenn Sie Google Meet authentifiziert haben, bevor diese Option verfügbar war, führen Sie
openclaw googlemeet auth login --json erneut aus, nachdem Sie den Scope
meetings.space.settings zu Ihrem Google OAuth-Zustimmungsbildschirm hinzugefügt haben.
Nur die URL erstellen, ohne beizutreten:
googlemeet create hat zwei Pfade:
- API-Erstellung: Wird verwendet, wenn Google Meet OAuth-Anmeldedaten konfiguriert sind. Dies ist der deterministischste Pfad und hängt nicht vom Zustand der Browseroberfläche ab.
- Browser-Fallback: Wird verwendet, wenn OAuth-Anmeldedaten fehlen. OpenClaw verwendet den
gepinnten Chrome-Node, öffnet
https://meet.google.com/new, wartet, bis Google zu einer echten Meeting-Code-URL umleitet, und gibt dann diese URL zurück. Dieser Pfad setzt voraus, dass das OpenClaw Chrome-Profil auf dem Node bereits bei Google angemeldet ist. Browserautomatisierung behandelt Meets eigene Mikrofonaufforderung beim ersten Start; diese Aufforderung wird nicht als Google-Anmeldefehler behandelt. Beitritts- und Erstellungsabläufe versuchen außerdem, einen bestehenden Meet-Tab wiederzuverwenden, bevor ein neuer geöffnet wird. Beim Abgleich werden harmlose URL-Abfragezeichenfolgen wieauthuserignoriert, sodass ein Agenten-Wiederholungsversuch das bereits geöffnete Meeting fokussieren sollte, statt einen zweiten Chrome-Tab zu erstellen.
source-Feld (api oder browser), damit Agenten
erklären können, welcher Pfad verwendet wurde. create tritt dem neuen Meeting standardmäßig bei und
gibt joined: true plus die Beitrittssitzung zurück. Um nur die URL zu erzeugen, verwenden Sie
create --no-join in der CLI oder übergeben Sie "join": false an das Tool.
Oder sagen Sie einem Agenten: „Erstellen Sie ein Google Meet, treten Sie ihm im Agenten-Rücksprachemodus bei
und senden Sie mir den Link.“ Der Agent sollte google_meet mit
action: "create" aufrufen und anschließend das zurückgegebene meetingUri teilen.
"mode": "transcribe". Dadurch wird
die Duplex-Echtzeit-Sprach-Bridge nicht gestartet, BlackHole oder SoX werden nicht benötigt,
und es wird nicht zurück ins Meeting gesprochen. Chrome-Beitritte in diesem Modus vermeiden außerdem
OpenClaws Mikrofon-/Kamera-Berechtigungserteilung und den Meet-Pfad Mikrofon verwenden.
Wenn Meet einen Audioauswahl-Zwischenschritt anzeigt, versucht die Automatisierung den Pfad ohne Mikrofon
und meldet andernfalls eine manuelle Aktion, statt das lokale Mikrofon zu öffnen. Im Transkriptionsmodus
installieren verwaltete Chrome-Transporte außerdem einen Best-Effort-Meet-Untertitelbeobachter.
googlemeet status --json und
googlemeet doctor zeigen captioning, captionsEnabledAttempted,
transcriptLines, lastCaptionAt, lastCaptionSpeaker, lastCaptionText
und einen kurzen recentTranscript-Auszug an, damit Operatoren erkennen können, ob der Browser
dem Anruf beigetreten ist und ob Meet-Untertitel Text liefern.
Verwenden Sie openclaw googlemeet test-listen <meet-url> --transport chrome-node, wenn
Sie eine Ja/Nein-Prüfung benötigen: Es tritt im Transkriptionsmodus bei, wartet auf frische Untertitel- oder
Transkriptbewegung und gibt listenVerified, listenTimedOut, Felder für manuelle
Aktionen und den neuesten Untertitelzustand zurück.
Während Echtzeitsitzungen enthält der google_meet-Status Browser- und Audio-Bridge-
Zustand wie inCall, manualActionRequired, providerConnected,
realtimeReady, audioInputActive, audioOutputActive, Zeitstempel der letzten Eingabe/Ausgabe,
Byte-Zähler und den geschlossenen Bridge-Zustand. Wenn eine sichere Meet-Seitenaufforderung
erscheint, behandelt die Browserautomatisierung sie, wenn möglich. Anmeldung, Host-Zulassung und
Browser-/OS-Berechtigungsaufforderungen werden als manuelle Aktion mit Grund und
Nachricht gemeldet, die der Agent weitergeben kann. Verwaltete Chrome-Sitzungen geben die Intro- oder
Testphrase erst aus, nachdem der Browserzustand inCall: true meldet; andernfalls meldet der Status
speechReady: false, und der Sprechversuch wird blockiert, statt vorzugeben, der
Agent habe ins Meeting gesprochen.
Lokale Chrome-Beitritte erfolgen über das angemeldete OpenClaw-Browserprofil. Der Echtzeitmodus
erfordert BlackHole 2ch für den von OpenClaw verwendeten Mikrofon-/Lautsprecherpfad. Für
sauberes Duplex-Audio verwenden Sie separate virtuelle Geräte oder einen Loopback-artigen Graphen; ein
einzelnes BlackHole-Gerät reicht für einen ersten Smoke-Test aus, kann aber Echo erzeugen.
Lokaler Gateway + Parallels Chrome
Sie benötigen keinen vollständigen OpenClaw Gateway oder Modell-API-Schlüssel in einer macOS-VM, nur damit die VM Chrome besitzt. Führen Sie Gateway und Agent lokal aus und starten Sie dann einen Node-Host in der VM. Aktivieren Sie das gebündelte Plugin einmal in der VM, damit der Node den Chrome-Befehl bewirbt: Was wo läuft:- Gateway-Host: OpenClaw Gateway, Agent-Arbeitsbereich, Modell-/API-Schlüssel, Echtzeit- Provider und die Google Meet-Plugin-Konfiguration.
- Parallels-macOS-VM: OpenClaw CLI/Node-Host, Google Chrome, SoX, BlackHole 2ch und ein bei Google angemeldetes Chrome-Profil.
- In der VM nicht benötigt: Gateway-Dienst, Agent-Konfiguration, OpenAI/GPT-Schlüssel oder Modell- Provider-Einrichtung.
BlackHole 2ch bereitstellt:
<gateway-host> eine LAN-IP ist und Sie kein TLS verwenden, lehnt der Node den
Klartext-WebSocket ab, sofern Sie diese vertrauenswürdige private Netzwerkverbindung nicht ausdrücklich erlauben:
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 ist Prozessumgebung, keine
openclaw.json-Einstellung. openclaw node install speichert sie in der LaunchAgent-
Umgebung, wenn sie beim Installationsbefehl vorhanden ist.
Genehmigen Sie den Node vom Gateway-Host aus:
googlemeet.chrome
als auch Browser-Fähigkeit/browser.proxy bewirbt:
google_meet-Tool mit transport: "chrome-node" zu verwenden.
Für einen Smoke-Test mit einem Befehl, der eine Sitzung erstellt oder wiederverwendet, eine bekannte
Phrase spricht und den Sitzungszustand ausgibt:
manualActionRequired: true mit manualActionReason und
manualActionMessage. Agents sollten den erneuten Beitrittsversuch stoppen, genau diese
Meldung plus die aktuelle browserUrl/browserTitle melden und erst dann erneut versuchen,
wenn die manuelle Browseraktion abgeschlossen ist.
Wenn chromeNode.node ausgelassen wird, wählt OpenClaw nur dann automatisch aus, wenn genau ein
verbundener Node sowohl googlemeet.chrome als auch Browsersteuerung ankündigt. Wenn
mehrere geeignete Nodes verbunden sind, setzen Sie chromeNode.node auf die Node-ID,
den Anzeigenamen oder die Remote-IP.
Häufige Fehlerprüfungen:
Configured Google Meet node ... is not usable: offline: Der fest zugewiesene Node ist dem Gateway bekannt, aber nicht verfügbar. Agents sollten diesen Node als Diagnosezustand behandeln, nicht als nutzbaren Chrome-Host, und den Setup-Blocker melden, anstatt auf einen anderen Transport zurückzufallen, sofern der Benutzer dies nicht angefordert hat.No connected Google Meet-capable node: Starten Sieopenclaw node runin der VM, genehmigen Sie das Pairing und stellen Sie sicher, dassopenclaw plugins enable google-meetundopenclaw plugins enable browserin der VM ausgeführt wurden. Bestätigen Sie außerdem, dass der Gateway-Host beide Node-Befehle mitgateway.nodes.allowCommands: ["googlemeet.chrome", "browser.proxy"]erlaubt.BlackHole 2ch audio device not found: Installieren Sieblackhole-2chauf dem geprüften Host und starten Sie neu, bevor Sie lokales Chrome-Audio verwenden.BlackHole 2ch audio device not found on the node: Installieren Sieblackhole-2chin der VM und starten Sie die VM neu.- Chrome wird geöffnet, kann aber nicht beitreten: Melden Sie sich im Browserprofil innerhalb der VM an, oder
lassen Sie
chrome.guestNamefür den Gastbeitritt gesetzt. Der automatische Gastbeitritt verwendet die OpenClaw-Browserautomatisierung über den Node-Browser-Proxy; stellen Sie sicher, dass die Node-Browser- Konfiguration auf das gewünschte Profil zeigt, zum Beispielbrowser.defaultProfile: "user"oder ein benanntes Profil einer bestehenden Sitzung. - Doppelte Meet-Tabs: Lassen Sie
chrome.reuseExistingTab: trueaktiviert. OpenClaw aktiviert einen vorhandenen Tab für dieselbe Meet-URL, bevor ein neuer geöffnet wird, und die Browser-Meeting-Erstellung verwendet einen laufendenhttps://meet.google.com/new- oder Google-Konto-Aufforderungstab wieder, bevor ein weiterer geöffnet wird. - Kein Audio: Leiten Sie in Meet Mikrofon-/Lautsprecher-Audio über den von OpenClaw verwendeten Pfad des virtuellen Audiogeräts; verwenden Sie separate virtuelle Geräte oder Loopback-ähnliches Routing für sauberes Duplex-Audio.
Installationshinweise
Der Chrome-Talkback-Standard verwendet zwei externe Werkzeuge:sox: Befehlszeilen-Audio-Dienstprogramm. Das Plugin verwendet explizite CoreAudio- Gerätebefehle für die standardmäßige 24-kHz-PCM16-Audiobrücke.blackhole-2ch: virtueller macOS-Audiotreiber. Er erstellt das AudiogerätBlackHole 2ch, über das Chrome/Meet routen kann.
LGPL-2.0-only AND GPL-2.0-only lizenziert; BlackHole ist GPL-3.0. Wenn Sie einen
Installer oder eine Appliance erstellen, die BlackHole mit OpenClaw bündelt, prüfen Sie die
Upstream-Lizenzbedingungen von BlackHole oder beziehen Sie eine separate Lizenz von Existential Audio.
Transporte
Chrome
Der Chrome-Transport öffnet die Meet-URL über die OpenClaw-Browsersteuerung und tritt als angemeldetes OpenClaw-Browserprofil bei. Unter macOS prüft das Plugin vor dem Start aufBlackHole 2ch. Wenn konfiguriert, führt es außerdem vor dem Öffnen von Chrome einen
Health-Befehl und einen Startbefehl für die Audiobrücke aus. Verwenden Sie chrome, wenn
Chrome/Audio auf dem Gateway-Host laufen; verwenden Sie chrome-node, wenn Chrome/Audio
auf einem gekoppelten Node wie einer Parallels-macOS-VM laufen. Wählen Sie für lokales Chrome das
Profil mit browser.defaultProfile; chrome.browserProfile wird an
chrome-node-Hosts übergeben.
BlackHole 2ch nicht installiert ist, schlägt der Beitritt mit einem Setup-Fehler fehl,
anstatt stillschweigend ohne Audiopfad beizutreten.
Twilio
Der Twilio-Transport ist ein strikter Wählplan, der an das Voice Call-Plugin delegiert wird. Er parst keine Meet-Seiten nach Telefonnummern. Verwenden Sie dies, wenn eine Chrome-Teilnahme nicht verfügbar ist oder Sie einen Telefon-Einwahl- Fallback wünschen. Google Meet muss für das Meeting eine Telefonnummer und PIN für die Einwahl bereitstellen; OpenClaw ermittelt diese nicht von der Meet-Seite. Aktivieren Sie das Voice Call-Plugin auf dem Gateway-Host, nicht auf dem Chrome-Node:openclaw.json heraus:
realtime.provider: "openai" mit dem OpenAI-Provider-Plugin und
OPENAI_API_KEY, wenn dies Ihr Echtzeit-Sprach-Provider ist.
Starten oder laden Sie das Gateway nach dem Aktivieren von voice-call neu; Änderungen an der
Plugin-Konfiguration erscheinen in einem bereits laufenden Gateway-Prozess erst nach dem Neuladen.
Überprüfen Sie anschließend:
googlemeet setup erfolgreiche
Prüfungen für twilio-voice-call-plugin, twilio-voice-call-credentials und
twilio-voice-call-webhook.
--dtmf-sequence, wenn das Meeting eine benutzerdefinierte Sequenz benötigt:
OAuth und Vorabprüfung
OAuth ist für das Erstellen eines Meet-Links optional, dagooglemeet create auf
Browserautomatisierung zurückfallen kann. Konfigurieren Sie OAuth, wenn Sie die offizielle API-Erstellung,
Space-Auflösung oder Vorabprüfungen der Meet Media API wünschen.
Der Zugriff auf die Google Meet API verwendet Benutzer-OAuth: Erstellen Sie einen Google Cloud-OAuth-Client,
fordern Sie die erforderlichen Scopes an, autorisieren Sie ein Google-Konto und speichern Sie dann das
resultierende Refresh-Token in der Konfiguration des Google Meet-Plugins oder stellen Sie die
Umgebungsvariablen OPENCLAW_GOOGLE_MEET_* bereit.
OAuth ersetzt den Chrome-Beitrittspfad nicht. Chrome- und Chrome-node-Transporte
treten weiterhin über ein angemeldetes Chrome-Profil, BlackHole/SoX und einen verbundenen
Node bei, wenn Sie Browserteilnahme verwenden. OAuth dient nur dem offiziellen Google
Meet API-Pfad: Meeting-Spaces erstellen, Spaces auflösen und Vorabprüfungen der Meet Media API
ausführen.
Google-Anmeldedaten erstellen
In der Google Cloud Console:- Erstellen oder wählen Sie ein Google Cloud-Projekt aus.
- Aktivieren Sie Google Meet REST API für dieses Projekt.
-
Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Internal ist für eine Google Workspace-Organisation am einfachsten.
- External funktioniert für persönliche/Test-Setups; solange sich die App im Testing befindet, fügen Sie jedes Google-Konto, das die App autorisieren soll, als Testbenutzer hinzu.
-
Fügen Sie die von OpenClaw angeforderten Scopes hinzu:
https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonlyhttps://www.googleapis.com/auth/meetings.space.settingshttps://www.googleapis.com/auth/meetings.conference.media.readonly
-
Erstellen Sie eine OAuth-Client-ID.
- Anwendungstyp: Web application.
-
Autorisierte Weiterleitungs-URI:
- Kopieren Sie die Client-ID und das Client-Secret.
meetings.space.created wird von Google Meet spaces.create benötigt.
meetings.space.readonly ermöglicht OpenClaw, Meet-URLs/-Codes zu Spaces aufzulösen.
meetings.space.settings ermöglicht OpenClaw, SpaceConfig-Einstellungen wie
accessType bei der API-Raumerstellung zu übergeben.
meetings.conference.media.readonly ist für die Vorabprüfung der Meet Media API und Medienarbeit
gedacht; Google kann für die tatsächliche Nutzung der Media API eine Developer Preview-Registrierung verlangen.
Wenn Sie nur browserbasierte Chrome-Beitritte benötigen, überspringen Sie OAuth vollständig.
Refresh-Token ausstellen
Konfigurieren Sieoauth.clientId und optional oauth.clientSecret, oder übergeben Sie sie als
Umgebungsvariablen, und führen Sie dann aus:
oauth-Konfigurationsblock mit einem Refresh-Token aus. Er verwendet PKCE,
einen localhost-Callback auf http://localhost:8085/oauth2callback und einen manuellen
Kopieren/Einfügen-Ablauf mit --manual.
Beispiele:
oauth-Objekt unter der Google Meet-Plugin-Konfiguration:
openclaw googlemeet auth login --json erneut aus, damit das Refresh-
Token den Scope meetings.space.created hat.
OAuth mit Doctor überprüfen
Führen Sie den OAuth-Doctor aus, wenn Sie eine schnelle, nicht geheime Zustandsprüfung wünschen:ok, configured,
tokenSource, expiresAt und Prüfnachrichten; er gibt weder Access-
Token, Refresh-Token noch Client-Secret aus.
Häufige Ergebnisse:
| Prüfung | Bedeutung |
|---|---|
oauth-config | oauth.clientId plus oauth.refreshToken oder ein zwischengespeichertes Zugriffstoken ist vorhanden. |
oauth-token | Das zwischengespeicherte Zugriffstoken ist noch gültig, oder das Aktualisierungstoken hat ein neues Zugriffstoken ausgestellt. |
meet-spaces-get | Optionale --meeting-Prüfung hat einen vorhandenen Meet-Bereich aufgelöst. |
meet-spaces-create | Optionale --create-space-Prüfung hat einen neuen Meet-Bereich erstellt. |
spaces.create-Scope nachzuweisen, führen Sie die
Erstellungsprüfung mit Seiteneffekt aus:
--create-space erstellt eine wegwerfbare Meet-URL. Verwenden Sie es, wenn Sie bestätigen müssen,
dass im Google Cloud-Projekt die Meet API aktiviert ist und dass das autorisierte
Konto den Scope meetings.space.created hat.
Um Lesezugriff für einen vorhandenen Meeting-Bereich nachzuweisen:
doctor --oauth --meeting und resolve-space weisen Lesezugriff auf einen vorhandenen
Bereich nach, auf den das autorisierte Google-Konto zugreifen kann. Ein 403 von diesen Prüfungen
bedeutet in der Regel, dass die Google Meet REST API deaktiviert ist, dem zugestimmten Aktualisierungstoken
der erforderliche Scope fehlt oder das Google-Konto nicht auf diesen Meet-
Bereich zugreifen kann. Ein Aktualisierungstoken-Fehler bedeutet, dass Sie openclaw googlemeet auth login --json erneut ausführen und den neuen oauth-Block speichern müssen.
Für den Browser-Fallback werden keine OAuth-Anmeldedaten benötigt. In diesem Modus stammt die Google-
Authentifizierung aus dem angemeldeten Chrome-Profil auf dem ausgewählten Node, nicht aus der
OpenClaw-Konfiguration.
Diese Umgebungsvariablen werden als Fallbacks akzeptiert:
OPENCLAW_GOOGLE_MEET_CLIENT_IDoderGOOGLE_MEET_CLIENT_IDOPENCLAW_GOOGLE_MEET_CLIENT_SECREToderGOOGLE_MEET_CLIENT_SECRETOPENCLAW_GOOGLE_MEET_REFRESH_TOKENoderGOOGLE_MEET_REFRESH_TOKENOPENCLAW_GOOGLE_MEET_ACCESS_TOKENoderGOOGLE_MEET_ACCESS_TOKENOPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AToderGOOGLE_MEET_ACCESS_TOKEN_EXPIRES_ATOPENCLAW_GOOGLE_MEET_DEFAULT_MEETINGoderGOOGLE_MEET_DEFAULT_MEETINGOPENCLAW_GOOGLE_MEET_PREVIEW_ACKoderGOOGLE_MEET_PREVIEW_ACK
spaces/{id} über spaces.get auf:
--meeting verwenden artifacts und attendance standardmäßig den neuesten Konferenzdatensatz.
Übergeben Sie --all-conference-records, wenn Sie alle aufbewahrten Datensätze
für dieses Meeting möchten.
Die Kalendersuche kann die Meeting-URL aus Google Calendar auflösen, bevor
Meet-Artefakte gelesen werden:
--today durchsucht den heutigen primary-Kalender nach einem Calendar-Ereignis mit einem
Google Meet-Link. Verwenden Sie --event <query>, um passenden Ereignistext zu durchsuchen, und
--calendar <id> für einen nicht primären Kalender. Die Kalendersuche erfordert eine frische
OAuth-Anmeldung, die den Calendar-Events-Readonly-Scope enthält.
calendar-events zeigt eine Vorschau der passenden Meet-Ereignisse und markiert das Ereignis, das
latest, artifacts, attendance oder export auswählen wird.
Wenn Sie die Konferenzdatensatz-ID bereits kennen, adressieren Sie sie direkt:
spaces.endActiveConference auf und erfordert OAuth mit dem
Scope meetings.space.created für einen Bereich, den das autorisierte Konto verwalten kann.
OpenClaw akzeptiert eine Meet-URL, einen Meeting-Code oder eine spaces/{id}-Eingabe und löst sie
in die API-Bereichsressource auf, bevor die aktive Konferenz beendet wird.
Dies ist getrennt von googlemeet leave: leave beendet die lokale/Sitzungs-
Teilnahme von OpenClaw, während end-active-conference Google Meet auffordert, die aktive
Konferenz für den Bereich zu beenden.
Schreiben Sie einen lesbaren Bericht:
artifacts gibt Konferenzdatensatz-Metadaten plus Teilnehmer-, Aufzeichnungs-,
Transkript-, strukturierte Transkripteintrags- und Smart-Note-Ressourcenmetadaten zurück, wenn
Google sie für das Meeting bereitstellt. Verwenden Sie --no-transcript-entries, um die
Eintragssuche bei großen Meetings zu überspringen. attendance erweitert Teilnehmer zu
Teilnehmersitzungszeilen mit Zeiten für zuerst/zuletzt gesehen, gesamter Sitzungsdauer,
Kennzeichnungen für Verspätung/frühes Verlassen und zusammengeführten doppelten Teilnehmerressourcen nach angemeldetem
Benutzer oder Anzeigename. Übergeben Sie --no-merge-duplicates, um rohe Teilnehmer-
ressourcen getrennt zu halten, --late-after-minutes, um die Verspätungserkennung abzustimmen, und
--early-before-minutes, um die Erkennung frühen Verlassens abzustimmen.
export schreibt einen Ordner mit summary.md, attendance.csv,
transcript.md, artifacts.json, attendance.json und manifest.json.
manifest.json erfasst die gewählte Eingabe, Exportoptionen, Konferenzdatensätze,
Ausgabedateien, Zählwerte, Tokenquelle, das Calendar-Ereignis, wenn eines verwendet wurde, und alle
Warnungen zu teilweisem Abruf. Übergeben Sie --zip, um zusätzlich ein portables Archiv neben
dem Ordner zu schreiben. Übergeben Sie --include-doc-bodies, um verknüpfte Transkript- und
Smart-Note-Google Docs-Texte über Google Drive files.export zu exportieren; dies erfordert eine
frische OAuth-Anmeldung, die den Drive-Meet-Readonly-Scope enthält. Ohne
--include-doc-bodies enthalten Exporte nur Meet-Metadaten und strukturierte Transkript-
einträge. Wenn Google einen teilweisen Artefaktfehler zurückgibt, etwa einen Smart-Note-
Listing-, Transkripteintrags- oder Drive-Dokumenttextfehler, behalten Zusammenfassung und
Manifest die Warnung bei, statt den gesamten Export fehlschlagen zu lassen.
Verwenden Sie --dry-run, um dieselben Artefakt-/Teilnahmedaten abzurufen und das
Manifest-JSON auszugeben, ohne den Ordner oder ZIP zu erstellen. Das ist nützlich, bevor Sie
einen großen Export schreiben oder wenn ein Agent nur Zählwerte, ausgewählte Datensätze und
Warnungen benötigt.
Agenten können dasselbe Bündel auch über das google_meet-Tool erstellen:
"dryRun": true, um nur das Exportmanifest zurückzugeben und Dateischreibvorgänge zu überspringen.
Agenten können auch einen API-gestützten Raum mit einer expliziten Zugriffsrichtlinie erstellen:
test_listen verwenden, bevor sie behaupten, das
Meeting sei nützlich:
OPENCLAW_LIVE_TEST=1aktiviert abgesicherte Live-Tests.OPENCLAW_GOOGLE_MEET_LIVE_MEETINGverweist auf eine aufbewahrte Meet-URL, einen Code oderspaces/{id}.OPENCLAW_GOOGLE_MEET_CLIENT_IDoderGOOGLE_MEET_CLIENT_IDstellt die OAuth- Client-ID bereit.OPENCLAW_GOOGLE_MEET_REFRESH_TOKENoderGOOGLE_MEET_REFRESH_TOKENstellt das Aktualisierungstoken bereit.- Optional:
OPENCLAW_GOOGLE_MEET_CLIENT_SECRET,OPENCLAW_GOOGLE_MEET_ACCESS_TOKENundOPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_ATverwenden dieselben Fallback-Namen ohne das PräfixOPENCLAW_.
https://www.googleapis.com/auth/meetings.space.readonly und
https://www.googleapis.com/auth/meetings.conference.media.readonly. Die Kalendersuche
benötigt https://www.googleapis.com/auth/calendar.events.readonly. Der Export von
Drive-Dokumenttext benötigt
https://www.googleapis.com/auth/drive.meet.readonly.
Erstellen Sie einen frischen Meet-Bereich:
meeting uri, Quelle und Beitrittssitzung aus. Mit OAuth-
Anmeldedaten verwendet er die offizielle Google Meet API. Ohne OAuth-Anmeldedaten
verwendet er als Fallback das angemeldete Browserprofil des angehefteten Chrome-Node. Agenten können
das google_meet-Tool mit action: "create" verwenden, um in einem
Schritt zu erstellen und beizutreten. Für eine reine URL-Erstellung übergeben Sie "join": false.
Beispielhafte JSON-Ausgabe aus dem Browser-Fallback:
google_meet-Tool gibt strukturierte Details statt einer einfachen Zeichenkette zurück:
manualActionRequired: true sieht, sollte er die
manualActionMessage plus den Browser-Node/Tab-Kontext melden und keine neuen
Meet-Tabs öffnen, bis der Bediener den Browser-Schritt abgeschlossen hat.
Beispielhafte JSON-Ausgabe von API-Erstellung:
manualActionRequired: true oder einen Browser-Fallback-Fehler und fordert den Operator auf, die Google-Anmeldung abzuschließen, bevor er es erneut versucht.
Setzen Sie preview.enrollmentAcknowledged: true erst, nachdem Sie bestätigt haben, dass Ihr Cloud-Projekt, Ihr OAuth-Principal und die Meeting-Teilnehmer für das Google Workspace Developer Preview Program für Meet-Medien-APIs registriert sind.
Konfiguration
Der gemeinsame Chrome-Agent-Pfad benötigt nur ein aktiviertes Plugin, BlackHole, SoX, einen Provider-Schlüssel für Echtzeit-Transkription und einen konfigurierten OpenClaw-TTS-Provider. OpenAI ist der Standard-Provider für Transkription; setzen Sierealtime.voiceProvider auf "google" und realtime.model, um Google Gemini Live für den bidi-Modus zu verwenden, ohne den standardmäßigen Transkriptions-Provider im Agent-Modus zu ändern:
plugins.entries.google-meet.config fest:
defaultTransport: "chrome"defaultMode: "agent"("realtime"wird nur als Legacy-Kompatibilitätsalias für"agent"akzeptiert; neue Tool-Aufrufe sollten"agent"verwenden)chromeNode.node: optionale Node-ID, optionaler Node-Name oder optionale IP fürchrome-nodechrome.audioBackend: "blackhole-2ch"chrome.guestName: "OpenClaw Agent": Name, der auf dem Meet-Gastbildschirm im abgemeldeten Zustand verwendet wirdchrome.autoJoin: true: Best-Effort-Ausfüllen des Gastnamens und Klicken auf „Jetzt beitreten“ durch OpenClaw-Browserautomatisierung aufchrome-nodechrome.reuseExistingTab: true: einen vorhandenen Meet-Tab aktivieren, statt Duplikate zu öffnenchrome.waitForInCallMs: 20000: warten, bis der Meet-Tab meldet, dass er sich im Anruf befindet, bevor die gesprochene Einführung ausgelöst wirdchrome.audioFormat: "pcm16-24khz": Audioformat für Befehlspaare. Verwenden Sie"g711-ulaw-8khz"nur für Legacy- oder benutzerdefinierte Befehlspaare, die weiterhin Telefonie-Audio ausgeben.chrome.audioBufferBytes: 4096: SoX-Verarbeitungspuffer für generierte Chrome-Audiobefehle für Befehlspaare. Dies ist die Hälfte des standardmäßigen 8192-Byte-Puffers von SoX, wodurch die standardmäßige Pipe-Latenz reduziert wird, während Spielraum bleibt, ihn auf ausgelasteten Hosts zu erhöhen. Werte unterhalb des SoX-Minimums werden auf 17 Byte begrenzt.chrome.audioInputCommand: SoX-Befehl, der aus CoreAudioBlackHole 2chliest und Audio inchrome.audioFormatschreibtchrome.audioOutputCommand: SoX-Befehl, der Audio inchrome.audioFormatliest und nach CoreAudioBlackHole 2chschreibtchrome.bargeInInputCommand: optionaler lokaler Mikrofonbefehl, der vorzeichenbehaftetes 16-Bit-Little-Endian-Mono-PCM für die Erkennung menschlicher Unterbrechungen schreibt, während die Assistentenwiedergabe aktiv ist. Dies gilt derzeit für die vom Gateway gehostetechrome-Befehlspaar-Bridge.chrome.bargeInRmsThreshold: 650: RMS-Pegel, der beichrome.bargeInInputCommandals menschliche Unterbrechung zähltchrome.bargeInPeakThreshold: 2500: Spitzenpegel, der beichrome.bargeInInputCommandals menschliche Unterbrechung zähltchrome.bargeInCooldownMs: 900: Mindestverzögerung zwischen wiederholten Freigaben nach menschlichen Unterbrechungenmode: "agent": standardmäßiger Antwortmodus. Teilnehmersprache wird vom konfigurierten Echtzeit-Transkriptions-Provider transkribiert, in einer Sub-Agent-Sitzung pro Meeting an den konfigurierten OpenClaw-Agent gesendet und über die normale OpenClaw-TTS-Laufzeit zurückgesprochen.mode: "bidi": Fallback-Modus mit direktem bidirektionalem Echtzeitmodell. Der Echtzeit-Sprach-Provider beantwortet Teilnehmersprache direkt und kannopenclaw_agent_consultfür tiefere oder toolgestützte Antworten aufrufen.mode: "transcribe": reiner Beobachtungsmodus ohne Antwort-Bridge.realtime.provider: "openai": Kompatibilitäts-Fallback, der verwendet wird, wenn die unten stehenden bereichsbezogenen Provider-Felder nicht gesetzt sind.realtime.transcriptionProvider: "openai": Provider-ID, die imagent-Modus für Echtzeit-Transkription verwendet wird.realtime.voiceProvider: Provider-ID, die imbidi-Modus für direkte Echtzeit-Sprache verwendet wird. Setzen Sie dies auf"google", um Gemini Live zu verwenden, während die Transkription im Agent-Modus auf OpenAI bleibt.realtime.toolPolicy: "safe-read-only"realtime.instructions: kurze gesprochene Antworten, mitopenclaw_agent_consultfür tiefere Antwortenrealtime.introMessage: kurze gesprochene Bereitschaftsprüfung, wenn die Echtzeit-Bridge verbindet; setzen Sie sie auf"", um still beizutretenrealtime.agentId: optionale OpenClaw-Agent-ID füropenclaw_agent_consult; Standard istmain
messages.tts.providers.elevenlabs.speakerVoiceId. Agent-Antworten können auch antwortbezogene [[tts:speakerVoiceId=... model=eleven_v3]]-Direktiven verwenden, wenn Überschreibungen des TTS-Modells aktiviert sind, aber die Konfiguration ist der deterministische Standard für Meetings. Beim Beitritt sollten die Logs transcriptionProvider=elevenlabs anzeigen, und jede gesprochene Antwort sollte provider=elevenlabs model=eleven_v3 speakerVoiceId=<voiceId> protokollieren.
Nur-Twilio-Konfiguration:
voiceCall.enabled ist standardmäßig true; mit Twilio-Transport delegiert es den tatsächlichen PSTN-Anruf, DTMF und die einleitende Begrüßung an das Voice-Call-Plugin. Voice Call spielt die DTMF-Sequenz ab, bevor der Echtzeit-Medienstream geöffnet wird, und verwendet dann den gespeicherten Einführungstext als erste Echtzeit-Begrüßung. Wenn voice-call nicht aktiviert ist, kann Google Meet den Wählplan weiterhin validieren und aufzeichnen, aber den Twilio-Anruf nicht platzieren.
Werkzeug
Agenten können das Toolgoogle_meet verwenden:
transport: "chrome", wenn Chrome auf dem Gateway-Host läuft. Verwenden Sie transport: "chrome-node", wenn Chrome auf einem gekoppelten Node wie einer Parallels-VM läuft. In beiden Fällen laufen die Modell-Provider und openclaw_agent_consult auf dem Gateway-Host, sodass die Modell-Zugangsdaten dort bleiben. Mit dem standardmäßigen mode: "agent" übernimmt der Echtzeit-Transkriptions-Provider das Zuhören, der konfigurierte OpenClaw-Agent erzeugt die Antwort, und reguläres OpenClaw-TTS spricht sie in Meet. Verwenden Sie mode: "bidi", wenn das Echtzeit-Sprachmodell direkt antworten soll. Rohes mode: "realtime" bleibt als Legacy-Kompatibilitätsalias für mode: "agent" akzeptiert, wird aber nicht mehr im Agent-Tool-Schema beworben. Logs im Agent-Modus enthalten den aufgelösten Transkriptions-Provider und das Modell beim Start der Bridge sowie den TTS-Provider, das Modell, die Stimme, das Ausgabeformat und die Abtastrate nach jeder synthetisierten Antwort.
Verwenden Sie action: "status", um aktive Sitzungen aufzulisten oder eine Sitzungs-ID zu prüfen. Verwenden Sie action: "speak" mit sessionId und message, damit der Echtzeit-Agent sofort spricht. Verwenden Sie action: "test_speech", um die Sitzung zu erstellen oder wiederzuverwenden, eine bekannte Phrase auszulösen und den inCall-Zustand zurückzugeben, wenn der Chrome-Host ihn melden kann. test_speech erzwingt immer mode: "agent" und schlägt fehl, wenn es aufgefordert wird, in mode: "transcribe" zu laufen, da reine Beobachtungssitzungen absichtlich keine Sprache ausgeben können. Das Ergebnis speechOutputVerified basiert darauf, dass die Echtzeit-Audioausgabebytes während dieses Testaufrufs zunehmen, sodass eine wiederverwendete Sitzung mit älterem Audio nicht als frische erfolgreiche Sprachprüfung zählt. Verwenden Sie action: "leave", um eine Sitzung als beendet zu markieren.
status enthält Chrome-Zustand, wenn verfügbar:
inCall: Chrome scheint sich im Meet-Anruf zu befindenmicMuted: Best-Effort-Status des Meet-MikrofonsmanualActionRequired/manualActionReason/manualActionMessage: das Browserprofil benötigt manuelle Anmeldung, Zulassung durch den Meet-Host, Berechtigungen oder Browsersteuerungs-Reparatur, bevor Sprache funktionieren kannspeechReady/speechBlockedReason/speechBlockedMessage: ob verwaltete Chrome-Sprache jetzt erlaubt ist.speechReady: falsebedeutet, dass OpenClaw die Einführungs- oder Testphrase nicht in die Audio-Bridge gesendet hat.providerConnected/realtimeReady: Zustand der Echtzeit-Sprach-BridgelastInputAt/lastOutputAt: zuletzt von der Bridge gesehenes oder an sie gesendetes AudioaudioOutputRouted/audioOutputDeviceLabel: ob die Medienausgabe des Meet-Tabs aktiv an das von der Bridge verwendete BlackHole-Gerät geleitet wurdelastSuppressedInputAt/suppressedInputBytes: Loopback-Eingabe, die ignoriert wurde, während die Assistentenwiedergabe aktiv ist
Agent- und bidi-Modi
Der Chrome-agent-Modus ist für das Verhalten „mein Agent ist im Meeting“ optimiert. Der Echtzeit-Transkriptions-Provider hört das Meeting-Audio, finale Teilnehmertranskripte werden durch den konfigurierten OpenClaw-Agent geleitet, und die Antwort wird über die normale OpenClaw-TTS-Laufzeit gesprochen. Setzen Sie mode: "bidi", wenn das Echtzeit-Sprachmodell direkt antworten soll. Nahe beieinander liegende finale Transkriptfragmente werden vor der Konsultation zusammengeführt, damit ein gesprochener Turn nicht mehrere veraltete Teilantworten erzeugt. Echtzeiteingabe wird außerdem unterdrückt, während in die Warteschlange eingereihtes Assistentenaudio noch abgespielt wird, und aktuelle assistentenähnliche Transkriptechos werden vor der Agent-Konsultation ignoriert, damit der BlackHole-Loopback den Agent nicht auf seine eigene Sprache antworten lässt.
| Modus | Wer entscheidet die Antwort | Sprachausgabepfad | Verwenden, wenn |
|---|---|---|---|
agent | Der konfigurierte OpenClaw-Agent | Normale OpenClaw-TTS-Laufzeit | Sie das Verhalten „mein Agent ist im Meeting“ wollen |
bidi | Das Echtzeit-Sprachmodell | Audioantwort des Echtzeit-Sprach-Providers | Sie die Sprachschleife mit der niedrigsten Latenz wollen |
bidi-Modus kann das Echtzeitmodell openclaw_agent_consult aufrufen, wenn es tieferes Schlussfolgern, aktuelle Informationen oder normale OpenClaw-Tools benötigt.
Das Consult-Tool führt im Hintergrund den regulären OpenClaw-Agenten mit aktuellem
Meeting-Transkriptkontext aus und gibt eine knappe gesprochene Antwort zurück. Im agent-Modus
sendet OpenClaw diese Antwort direkt an die TTS-Laufzeitumgebung; im bidi-Modus kann das
Echtzeit-Sprachmodell das Consult-Ergebnis zurück in das Meeting sprechen. Es verwendet
dieselbe gemeinsame Consult-Mechanik wie Voice Call.
Standardmäßig laufen Consults gegen den main-Agenten. Setzen Sie realtime.agentId, wenn eine
Meet-Lane einen dedizierten OpenClaw-Agent-Workspace, Modell-Defaults,
Tool-Richtlinie, Speicher und Sitzungsverlauf konsultieren soll.
Consults im Agent-Modus verwenden einen sitzungsbezogenen Schlüssel
agent:<id>:subagent:google-meet:<session>, damit Folgefragen den Meeting-Kontext
beibehalten und zugleich die normale Agent-Richtlinie vom konfigurierten Agenten erben.
realtime.toolPolicy steuert den Consult-Lauf:
safe-read-only: stellt das Consult-Tool bereit und beschränkt den regulären Agenten aufread,web_search,web_fetch,x_search,memory_searchundmemory_get.owner: stellt das Consult-Tool bereit und lässt den regulären Agenten die normale Agent-Tool-Richtlinie verwenden.none: stellt dem Echtzeit-Sprachmodell das Consult-Tool nicht bereit.
Live-Test-Checkliste
Verwenden Sie diese Sequenz, bevor Sie ein Meeting einem unbeaufsichtigten Agenten übergeben:googlemeet setupist vollständig grün.googlemeet setupenthältchrome-node-connected, wenn Chrome-node der Standardtransport ist oder ein Node festgelegt ist.nodes statuszeigt, dass der ausgewählte Node verbunden ist.- Der ausgewählte Node kündigt sowohl
googlemeet.chromeals auchbrowser.proxyan. - Der Meet-Tab tritt dem Anruf bei und
test-speechgibt Chrome-Zustand mitinCall: truezurück.
googlemeet setupenthält grüne Prüfungen fürtwilio-voice-call-plugin,twilio-voice-call-credentialsundtwilio-voice-call-webhook.voicecallist nach dem Neuladen des Gateway in der CLI verfügbar.- Die zurückgegebene Sitzung hat
transport: "twilio"und einetwilio.voiceCallId. openclaw logs --followzeigt, dass DTMF-TwiML vor Echtzeit-TwiML ausgeliefert wurde, danach eine Echtzeit-Bridge mit der eingereihten anfänglichen Begrüßung.googlemeet leave <sessionId>legt den delegierten Sprachanruf auf.
Fehlerbehebung
Agent kann das Google-Meet-Tool nicht sehen
Bestätigen Sie, dass das Plugin in der Gateway-Konfiguration aktiviert ist, und laden Sie das Gateway neu:plugins.entries.google-meet bearbeitet haben, starten oder laden Sie das Gateway neu.
Der laufende Agent sieht nur Plugin-Tools, die vom aktuellen Gateway-Prozess
registriert wurden.
Auf Nicht-macOS-Gateway-Hosts bleibt das agentenseitige google_meet-Tool sichtbar,
aber lokale Chrome-Rücksprechaktionen werden blockiert, bevor sie die Audio-Bridge erreichen.
Lokale Chrome-Rücksprechaudio hängt derzeit von macOS BlackHole 2ch ab, daher
sollten Linux-Agenten mode: "transcribe", Twilio-Einwahl oder stattdessen einen macOS-
chrome-node-Host anstelle des lokalen Standard-Chrome-Agent-Pfads verwenden.
Kein verbundener Google-Meet-fähiger Node
Führen Sie auf dem Node-Host aus:googlemeet.chrome sowie browser.proxy auflisten.
Die Gateway-Konfiguration muss diese Node-Befehle zulassen:
googlemeet setup bei chrome-node-connected fehlschlägt oder das Gateway-Log
gateway token mismatch meldet, installieren oder starten Sie den Node mit dem aktuellen Gateway-
Token neu. Für ein LAN-Gateway bedeutet das üblicherweise:
Browser öffnet sich, aber Agent kann nicht beitreten
Führen Siegooglemeet test-listen für reine Beobachtungsbeitritte oder googlemeet test-speech
für Echtzeitbeitritte aus und prüfen Sie anschließend den zurückgegebenen Chrome-Zustand. Wenn einer der Tests
manualActionRequired: true meldet, zeigen Sie dem Operator manualActionMessage
und beenden Sie weitere Wiederholungen, bis die Browseraktion abgeschlossen ist.
Häufige manuelle Aktionen:
- Beim Chrome-Profil anmelden.
- Den Gast über das Meet-Hostkonto zulassen.
- Chrome Mikrofon-/Kameraberechtigungen erteilen, wenn Chromes native Berechtigungsabfrage erscheint.
- Einen blockierten Meet-Berechtigungsdialog schließen oder reparieren.
Meeting-Erstellung schlägt fehl
googlemeet create verwendet zuerst den Google-Meet-API-Endpunkt spaces.create,
wenn OAuth-Anmeldedaten konfiguriert sind. Ohne OAuth-Anmeldedaten fällt es auf
den festgelegten Chrome-Node-Browser zurück. Prüfen Sie:
- Für API-Erstellung:
oauth.clientIdundoauth.refreshTokensind konfiguriert, oder passendeOPENCLAW_GOOGLE_MEET_*-Umgebungsvariablen sind vorhanden. - Für API-Erstellung: Das Refresh-Token wurde erstellt, nachdem Erstellungsunterstützung
hinzugefügt wurde. Älteren Tokens fehlt möglicherweise der Scope
meetings.space.created; führen Sieopenclaw googlemeet auth login --jsonerneut aus und aktualisieren Sie die Plugin-Konfiguration. - Für Browser-Fallback:
defaultTransport: "chrome-node"undchromeNode.nodeverweisen auf einen verbundenen Node mitbrowser.proxyundgooglemeet.chrome. - Für Browser-Fallback: Das OpenClaw-Chrome-Profil auf diesem Node ist bei Google angemeldet
und kann
https://meet.google.com/newöffnen. - Für Browser-Fallback: Wiederholungen verwenden einen vorhandenen Tab
https://meet.google.com/newoder eine Google-Kontoaufforderung erneut, bevor ein neuer Tab geöffnet wird. Wenn ein Agent eine Zeitüberschreitung hat, wiederholen Sie den Tool-Aufruf, statt manuell einen weiteren Meet-Tab zu öffnen. - Für Browser-Fallback: Wenn das Tool
manualActionRequired: truezurückgibt, verwenden Sie die zurückgegebenen Wertebrowser.nodeId,browser.targetId,browserUrlundmanualActionMessage, um den Operator anzuleiten. Wiederholen Sie nicht in einer Schleife, bis diese Aktion abgeschlossen ist. - Für Browser-Fallback: Wenn Meet „Do you want people to hear you in the
meeting?“ anzeigt, lassen Sie den Tab geöffnet. OpenClaw sollte Use microphone oder, für
reinen Erstellungs-Fallback, Continue without microphone per Browser-
Automatisierung anklicken und weiter auf die generierte Meet-URL warten. Wenn dies nicht möglich ist, sollte der
Fehler
meet-audio-choice-requirederwähnen, nichtgoogle-login-required.
Agent tritt bei, spricht aber nicht
Prüfen Sie den Echtzeitpfad:mode: "agent" für den normalen Pfad STT -> OpenClaw-Agent -> TTS-Rücksprache,
oder mode: "bidi" für den direkten Echtzeit-Sprach-Fallback. mode: "transcribe"
startet absichtlich keine Rücksprech-Bridge. Für reines Beobachtungs-Debugging
führen Sie openclaw googlemeet status --json <session-id> aus, nachdem Teilnehmer gesprochen haben,
und prüfen Sie captioning, transcriptLines und lastCaptionText. Wenn inCall
true ist, aber transcriptLines bei 0 bleibt, sind Meet-Untertitel möglicherweise deaktiviert, seit Installation des Beobachters
hat niemand gesprochen, die Meet-UI hat sich geändert, oder Live-
Untertitel sind für die Meeting-Sprache bzw. das Konto nicht verfügbar.
googlemeet test-speech prüft immer den Echtzeitpfad und meldet, ob
Bridge-Ausgabebytes für diesen Aufruf beobachtet wurden. Wenn speechOutputVerified false ist und
speechOutputTimedOut true ist, hat der Echtzeit-Provider die
Äußerung möglicherweise akzeptiert, aber OpenClaw hat keine neuen Ausgabebytes bis zur Chrome-Audio-
Bridge gesehen.
Prüfen Sie außerdem:
- Auf dem Gateway-Host ist ein Echtzeit-Provider-Schlüssel verfügbar, etwa
OPENAI_API_KEYoderGEMINI_API_KEY. BlackHole 2chist auf dem Chrome-Host sichtbar.soxexistiert auf dem Chrome-Host.- Meet-Mikrofon und -Lautsprecher sind über den von OpenClaw verwendeten virtuellen Audiopfad geroutet.
doctorsollte für lokale Chrome-Echtzeitbeitrittemeet output routed: yesanzeigen.
googlemeet doctor [session-id] gibt Sitzung, Node, Im-Anruf-Zustand,
Grund für manuelle Aktion, Echtzeit-Provider-Verbindung, realtimeReady, Audio-
Eingabe-/Ausgabeaktivität, letzte Audio-Zeitstempel, Byte-Zähler und Browser-URL aus.
Verwenden Sie googlemeet status [session-id] --json, wenn Sie das rohe JSON benötigen. Verwenden Sie
googlemeet doctor --oauth, wenn Sie die Google-Meet-OAuth-Aktualisierung
ohne Offenlegung von Tokens prüfen müssen; fügen Sie --meeting oder --create-space hinzu, wenn Sie
zusätzlich einen Google-Meet-API-Nachweis benötigen.
Wenn bei einem Agenten eine Zeitüberschreitung aufgetreten ist und Sie bereits einen geöffneten Meet-Tab sehen, inspizieren Sie diesen Tab,
ohne einen weiteren zu öffnen:
recover_current_tab. Sie fokussiert und inspiziert einen
vorhandenen Meet-Tab für den ausgewählten Transport. Mit chrome verwendet sie lokale
Browsersteuerung über das Gateway; mit chrome-node verwendet sie den konfigurierten
Chrome-Node. Sie öffnet keinen neuen Tab und erstellt keine neue Sitzung; sie meldet den
aktuellen Blocker, etwa Anmeldung, Zulassung, Berechtigungen oder Audioauswahlzustand.
Der CLI-Befehl spricht mit dem konfigurierten Gateway, daher muss das Gateway laufen;
chrome-node erfordert außerdem, dass der Chrome-Node verbunden ist.
Twilio-Setup-Prüfungen schlagen fehl
twilio-voice-call-plugin schlägt fehl, wenn voice-call nicht erlaubt oder nicht aktiviert ist.
Fügen Sie es zu plugins.allow hinzu, aktivieren Sie plugins.entries.voice-call, und laden Sie das
Gateway neu.
twilio-voice-call-credentials schlägt fehl, wenn dem Twilio-Backend Account-
SID, Auth-Token oder Anrufernummer fehlen. Setzen Sie diese auf dem Gateway-Host:
twilio-voice-call-webhook schlägt fehl, wenn voice-call keine öffentliche Webhook-
Bereitstellung hat oder wenn publicUrl auf Loopback oder privaten Netzwerkbereich zeigt.
Setzen Sie plugins.entries.voice-call.config.publicUrl auf die öffentliche Provider-URL oder
konfigurieren Sie eine voice-call-Tunnel-/Tailscale-Bereitstellung.
Loopback- und private URLs sind für Carrier-Callbacks nicht gültig. Verwenden Sie nicht
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 oder fd00::/8 als publicUrl.
Für eine stabile öffentliche URL:
voicecall smoke prüft standardmäßig nur die Bereitschaft. Für einen Probelauf mit einer bestimmten Nummer:
--yes nur hinzu, wenn Sie bewusst einen echten ausgehenden Benachrichtigungsanruf
auslösen möchten:
Twilio-Anruf startet, tritt dem Meeting aber nie bei
Bestätigen Sie, dass das Meet-Ereignis Telefon-Einwahldaten bereitstellt. Übergeben Sie die genaue Einwahl- nummer und PIN oder eine benutzerdefinierte DTMF-Sequenz:w oder Kommas in --dtmf-sequence, wenn der Provider vor
der PIN-Eingabe eine Pause benötigt.
Wenn der Telefonanruf erstellt wird, die Meet-Teilnehmerliste den Einwahl-
teilnehmer aber nie anzeigt:
- Führen Sie
openclaw googlemeet doctor <session-id>aus, um die delegierte Twilio- Anruf-ID zu bestätigen, ob DTMF eingereiht wurde und ob die Begrüßung angefordert wurde. - Führen Sie
openclaw voicecall status --call-id <id>aus und bestätigen Sie, dass der Anruf weiterhin aktiv ist. - Führen Sie
openclaw voicecall tailaus und prüfen Sie, ob Twilio-Webhooks beim Gateway eingehen. - Führen Sie
openclaw logs --followaus und suchen Sie nach der Twilio-Meet-Sequenz: Google Meet delegiert den Beitritt, Voice Call speichert und liefert Pre-Connect-DTMF-TwiML, Voice Call liefert Echtzeit-TwiML für den Twilio-Anruf, anschließend fordert Google Meet Begrüßungssprache mitvoicecall.speakan. - Führen Sie
openclaw googlemeet setup --transport twilioerneut aus; eine grüne Setup-Prüfung ist erforderlich, beweist aber nicht, dass die Meeting-PIN-Sequenz korrekt ist. - Bestätigen Sie, dass die Einwahlnummer zur selben Meet-Einladung und Region gehört wie die PIN.
- Erhöhen Sie
voiceCall.dtmfDelayMsgegenüber dem Standardwert von 12 Sekunden, wenn Meet langsam annimmt oder das Anruftranskript weiterhin die Aufforderung zur PIN-Eingabe anzeigt, nachdem Pre-Connect-DTMF gesendet wurde. - Wenn der Teilnehmer beitritt, Sie die Begrüßung aber nicht hören, prüfen Sie
openclaw logs --followauf die post-DTMF-Anforderungvoicecall.speakund entweder die Medienstream-TTS-Wiedergabe oder den Twilio-<Say>-Fallback. Wenn das Anruf- transkript weiterhin “enter the meeting PIN” enthält, ist der Telefonzweig dem Meet-Raum noch nicht beigetreten, sodass Meeting-Teilnehmer keine Sprache hören.
plugins.entries.voice-call.config.publicUrl oder den konfigurierten Tunnel erreichen.
Siehe Voice-Call-Fehlerbehebung.
Hinweise
Die offizielle Medien-API von Google Meet ist empfangsorientiert, daher braucht das Sprechen in einen Meet- Anruf weiterhin einen Teilnehmerpfad. Dieses Plugin hält diese Grenze sichtbar: Chrome übernimmt die Browser-Teilnahme und das lokale Audio-Routing; Twilio übernimmt die Teilnahme per Telefoneinwahl. Chrome-Talkback-Modi benötigenBlackHole 2ch sowie entweder:
chrome.audioInputCommandpluschrome.audioOutputCommand: OpenClaw besitzt die Brücke und leitet Audio inchrome.audioFormatzwischen diesen Befehlen und dem ausgewählten Provider weiter. Der Agent-Modus verwendet Echtzeit-Transkription plus reguläre TTS; der bidi-Modus verwendet den Echtzeit-Sprach-Provider. Der standardmäßige Chrome-Pfad ist 24 kHz PCM16 mitchrome.audioBufferBytes: 4096; 8 kHz G.711 mu-law bleibt für ältere Befehlspaare verfügbar.chrome.audioBridgeCommand: Ein externer Brückenbefehl besitzt den gesamten lokalen Audiopfad und muss nach dem Starten oder Validieren seines Daemons beendet werden. Dies ist nur fürbidigültig, weil deragent-Modus direkten Zugriff auf Befehlspaare für TTS benötigt.
google_meet aufruft, forkt die Meeting-Berater-
Sitzung das aktuelle Transkript des Aufrufers, bevor sie auf Teilnehmersprache antwortet.
Die Meet-Sitzung bleibt weiterhin separat (agent:<agentId>:subagent:google-meet:<sessionId>),
sodass Meeting-Folgeaktionen das Transkript des Aufrufers nicht direkt verändern.
Für sauberes Duplex-Audio routen Sie Meet-Ausgabe und Meet-Mikrofon über separate
virtuelle Geräte oder einen virtuellen Gerätegraphen im Loopback-Stil. Ein einzelnes gemeinsam genutztes
BlackHole-Gerät kann andere Teilnehmer zurück in den Anruf echoen.
Mit der Chrome-Brücke per Befehlspaar kann chrome.bargeInInputCommand ein
separates lokales Mikrofon abhören und die Assistentenwiedergabe löschen, wenn der Mensch zu
sprechen beginnt. So bleibt menschliche Sprache der Assistentenausgabe voraus, selbst wenn die gemeinsam genutzte
BlackHole-Loopback-Eingabe während der Assistentenwiedergabe vorübergehend unterdrückt wird.
Wie chrome.audioInputCommand und chrome.audioOutputCommand ist dies ein
lokaler, vom Operator konfigurierter Befehl. Verwenden Sie einen explizit vertrauenswürdigen Befehlspfad oder
eine Argumentliste und verweisen Sie nicht auf Skripte aus nicht vertrauenswürdigen Speicherorten.
googlemeet speak löst die aktive Talkback-Audiobrücke für eine Chrome-
Sitzung aus. googlemeet leave stoppt diese Brücke. Bei Twilio-Sitzungen, die
über das Voice-Call-Plugin delegiert wurden, legt leave auch den zugrunde liegenden Sprachanruf auf.
Verwenden Sie googlemeet end-active-conference, wenn Sie auch die aktive
Google-Meet-Konferenz für einen API-verwalteten Bereich schließen möchten.