Google Meet plugin'i

google-meet plugini, bir OpenClaw agentı adına açık Meet URL'lerine katılır. Bilerek dar kapsamlıdır:

• Yalnızca https://meet.google.com/... URL'lerine katılır; kendi bulduğu bir telefon numarasından toplantıya asla bağlanmaz.
• googlemeet create, Google Meet API'si (veya tarayıcı yedeği) üzerinden yeni bir Meet URL'si oluşturabilir ve varsayılan olarak bu URL'ye katılabilir.
• Chrome katılımı, isteğe bağlı olarak eşleştirilmiş bir node üzerinde, oturum açılmış bir Chrome profili kullanır. Twilio katılımı, Sesli arama plugini üzerinden bir telefon numarasını ve PIN/DTMF'yi çevirir; doğrudan bir Meet URL'sini arayamaz.
• mode: "agent" (varsayılan), katılımcı konuşmalarını gerçek zamanlı bir sağlayıcıyla yazıya döker, yapılandırılmış OpenClaw agentına yönlendirir ve yanıtı standart OpenClaw TTS ile seslendirir. mode: "bidi", gerçek zamanlı bir ses modelinin doğrudan yanıt vermesini sağlar. mode: "transcribe", geri konuşma olmadan yalnızca gözlem amacıyla katılır.
• Plugin bir aramaya katıldığında otomatik bir onay duyurusu yapılmaz.
• CLI komutu googlemeet; meet ise daha geniş kapsamlı agent telekonferans iş akışları için ayrılmıştır.

Hızlı başlangıç

Yerel ses bağımlılıklarını yükleyin, ardından gerçek zamanlı bir sağlayıcı anahtarı ayarlayın. OpenAI, agent modu için varsayılan yazıya dökme sağlayıcısıdır; Google Gemini Live, bidi modu ses sağlayıcısı olarak kullanılabilir:

brew install blackhole-2ch soxexport OPENAI_API_KEY=sk-...# yalnızca bidi modu için realtime.voiceProvider "google" olduğunda gereklidirexport GEMINI_API_KEY=...

blackhole-2ch, Chrome'un yönlendirme yaptığı BlackHole 2ch sanal ses aygıtını yükler. Homebrew yükleyicisi, macOS'un aygıtı kullanıma sunabilmesi için yeniden başlatma gerektirir:

sudo reboot

Yeniden başlattıktan sonra her iki bileşeni de doğrulayın:

system_profiler SPAudioDataType | grep -i BlackHolecommand -v sox

Plugini etkinleştirin:

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

Kurulumu kontrol edin, ardından katılın:

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

setup çıktısı agent tarafından okunabilir ve mod/aktarım yöntemine duyarlıdır: Chrome profilini, node sabitlemesini ve gerçek zamanlı Chrome katılımları için BlackHole/SoX ses köprüsünü ve gecikmeli giriş kontrolünü bildirir. Yalnızca gözlem katılımlarında gerçek zamanlı ön koşullar atlanır:

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

Twilio yetkilendirmesi yapılandırıldığında setup, ayrıca voice-call, Twilio kimlik bilgilerinin ve herkese açık Webhook erişiminin hazır olup olmadığını bildirir. Bir agent katılmadan önce tüm ok: false kontrollerini ilgili aktarım yöntemi/mod için engelleyici olarak değerlendirin. Makine tarafından okunabilir çıktı için --json, belirli bir aktarım yöntemini önceden kontrol etmek için --transport chrome|chrome-node|twilio kullanın:

openclaw googlemeet setup --transport twilio

Veya bir agentın google_meet aracı üzerinden katılmasını sağlayın:

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

macOS dışındaki Gateway ana makinelerinde google_meet; yapıt, takvim, kurulum, yazıya dökme, Twilio ve chrome-node eylemleri için görünür kalır ancak yerel Chrome geri konuşması (transport: "chrome" ile mode: "agent" veya "bidi"), ses köprüsüne ulaşmadan önce engellenir çünkü bu yol şu anda macOS BlackHole 2ch bileşenine bağlıdır. Bunun yerine mode: "transcribe", Twilio telefonla katılımı veya bir macOS chrome-node ana makinesi kullanın.

Toplantı oluşturma

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

create, sonuçtaki source alanında bildirilen iki yola sahiptir:

• api: Google Meet OAuth kimlik bilgileri yapılandırıldığında kullanılır. Belirlenimlidir; tarayıcı arayüzünün durumuna bağlı değildir.
• browser: OAuth kimlik bilgileri olmadan kullanılır. OpenClaw, sabitlenmiş Chrome node üzerinde https://meet.google.com/new öğesini açar ve Google'ın gerçek bir toplantı kodu URL'sine yönlendirmesini bekler; bu node üzerindeki OpenClaw Chrome profilinde Google oturumu önceden açılmış olmalıdır. Hem katılma hem de oluşturma işlemi, yeni bir sekme açmadan önce mevcut bir Meet sekmesini (veya devam eden bir .../new / Google hesabı istemi sekmesini) yeniden kullanır; sekme eşleştirmesi authuser gibi zararsız sorgu dizelerini yok sayar.

create, varsayılan olarak katılır ve joined: true ile katılım oturumunu döndürür. Yalnızca URL'yi oluşturmak için --no-join (CLI) veya "join": false (araç) aktarın.

API ile oluşturulan odalarda Google hesabının varsayılanını devralmak yerine açık bir erişim politikası belirleyin:

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

Bu yalnızca API ile oluşturulan odalar için geçerlidir, dolayısıyla OAuth yapılandırılmalıdır. Bu seçenek kullanıma sunulmadan önce kimlik doğrulaması yaptıysanız OAuth onay ekranınıza meetings.space.settings kapsamını ekledikten sonra openclaw googlemeet auth login --json işlemini yeniden çalıştırın.

Tarayıcı yedeği bir Google oturum açma veya Meet izin engelleyicisiyle karşılaşırsa araç; manualActionReason, manualActionMessage ve browser.nodeId/browser.targetId/browserUrl ile birlikte manualActionRequired: true döndürür. Bu mesajı bildirin ve operatör tarayıcı adımını tamamlayana kadar yeni Meet sekmeleri açmayı bırakın.

Yalnızca gözlem katılımı

Çift yönlü gerçek zamanlı köprüyü atlamak için "mode": "transcribe" ayarlayın (BlackHole/SoX gereksinimi ve geri konuşma yoktur). Yazıya dökme modundaki Chrome katılımları ayrıca OpenClaw'un mikrofon/kamera izin verme işlemini ve Meet'in Use microphone yolunu atlar; Meet ses seçimi geçiş ekranını gösterirse otomasyon önce Continue without microphone seçeneğini dener. Bu moddaki yönetilen Chrome aktarım yöntemleri, elinden geldiğince çalışan bir Meet altyazı gözlemcisi yükler. googlemeet status --json ve googlemeet doctor; captioning, captionsEnabledAttempted, transcriptLines, lastCaptionAt, lastCaptionSpeaker, lastCaptionText ve bir recentTranscript kuyruğu bildirir.

Sınırlandırılmış oturum dökümü için tam olarak izlenen Meet sekmesini okuyun:

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

Gözlemci, Meet sayfasında en fazla 2.000 tamamlanmış altyazı satırı tutar. Görünür ilerleyen metin, altyazı satırı tamamlanana kadar durum sağlığı kuyruğunda kalır; dolayısıyla nextIndex kaydedildiğinde daha sonraki bir metin genişletmesi atlanamaz. Ayrılma işlemi, anlık görüntüden önce görünür satırları sonlandırır. droppedLines, sınır aşıldığında baştan kaybedilen satırları bildirir. En son sona eren dört oturumun dökümleri, gateway yeniden başlatılana kadar okunabilir kalır. Daha eski sona ermiş dökümler evicted: true döndürür. Bu, kasıtlı olarak çalışma zamanı belleğidir; kalıcı toplantı geçmişi depolaması değildir: gateway'in yeniden başlatılması, anlık görüntü alınmadan önce sekmenin kapatılması veya belgelenen sınırların aşılması altyazıların kaybedilmesine neden olabilir.

Evet/hayır dinleme yoklaması için:

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

Yazıya dökme modunda katılır, yeni altyazı/döküm hareketini bekler ve listenVerified, listenTimedOut, manuel eylem alanları ve mevcut altyazı sağlığını döndürür.

Gerçek zamanlı oturum sağlığı

Geri konuşmalı oturumlar sırasında google_meet durumu; inCall, manualActionRequired, providerConnected, realtimeReady, audioInputActive, audioOutputActive, son giriş/çıkış zaman damgaları, bayt sayaçları ve köprünün kapalı olma durumu dâhil Chrome/ses köprüsü sağlığını bildirir. Yönetilen Chrome oturumları, giriş/test ifadesini yalnızca sağlık durumu inCall: true bildirdikten sonra seslendirir; aksi takdirde speechReady: false oluşur ve konuşma denemesi sessizce hiçbir şey yapmamak yerine engellenir.

Yerel Chrome katılımları, oturum açılmış OpenClaw tarayıcı profili üzerinden gerçekleşir ve mikrofon/hoparlör yolu için BlackHole 2ch gerektirir. İlk duman testi için tek bir BlackHole aygıtı yeterlidir ancak yankı yapabilir; temiz çift yönlü ses için ayrı sanal aygıtlar veya Loopback tarzı bir grafik kullanın.

Yerel Gateway + Parallels Chrome

Bir macOS sanal makinesine yalnızca Chrome sağlamak için sanal makine içinde tam bir Gateway veya model API anahtarı gerekmez. Gateway'i ve agentı yerel olarak çalıştırın; node ana makinesini sanal makinede çalıştırın.

Sanal makine bağımlılıklarını yükleyin, yeniden başlatın ve doğrulayın:

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

Plugini sanal makinede etkinleştirin ve node ana makinesini başlatın:

openclaw plugins enable google-meetopenclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos

<gateway-host>, TLS kullanmayan bir LAN IP'siyse bu güvenilir özel ağ için açıkça izin verin:

OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node run --host <gateway-lan-ip> --port 18789 --display-name parallels-macos

LaunchAgent olarak yüklerken aynı bayrağı kullanın (bu bir işlem ortamıdır; yükleme komutunda bulunduğunda LaunchAgent ortamında saklanır, bir openclaw.json ayarı değildir):

OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node install --host <gateway-lan-ip> --port 18789 --display-name parallels-macos --forceopenclaw node restart

Node'u Gateway ana makinesinden onaylayın, ardından hem googlemeet.chrome hem de tarayıcı yeteneği/browser.proxy sunduğunu doğrulayın:

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

Meet'i bu node üzerinden yönlendirin:

{  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",          },        },      },    },  },}

Şimdi Gateway ana makinesinden normal şekilde katılın:

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

Bir oturum oluşturan veya yeniden kullanan, bilinen bir ifadeyi seslendiren ve oturum sağlığını yazdıran tek komutluk bir duman testi için:

openclaw googlemeet test-speech https://meet.google.com/abc-defg-hij

Gerçek zamanlı katılım sırasında tarayıcı otomasyonu konuk adını doldurur, Join/Ask to join öğesine tıklar ve göründüğünde Meet'in ilk çalıştırmadaki "Use microphone" istemini (veya yalnızca gözlem katılımında ve yalnızca tarayıcıyla toplantı oluştururken "Continue without microphone" seçeneğini) kabul eder. Profilde oturum kapalıysa, Meet toplantı sahibinin kabulünü bekliyorsa, Chrome mikrofon/kamera iznine ihtiyaç duyuyorsa veya Meet çözümlenmemiş bir istemde takılı kalmışsa sonuç, manualActionReason ve manualActionMessage ile birlikte manualActionRequired: true bildirir. Yeniden denemeyi bırakın, bu mesajı browserUrl/browserTitle ile birlikte bildirin ve yalnızca manuel eylem tamamlandıktan sonra yeniden deneyin.

chromeNode.node belirtilmezse OpenClaw yalnızca tam olarak bir bağlı Node hem googlemeet.chrome hem de tarayıcı denetimi sunduğunda otomatik seçim yapar; birden fazla uygun Node bağlı olduğunda chromeNode.node değerini (Node kimliği, görünen ad veya uzak IP) sabitleyin.

Yaygın hata kontrolleri

Yükleme notları

Chrome geri konuşma varsayılanı, OpenClaw'ın paketlemediği veya yeniden dağıtmadığı iki harici araç kullanır; bunları Homebrew aracılığıyla ana makine bağımlılıkları olarak yükleyin:

• sox: komut satırı ses yardımcı programı. Plugin, varsayılan 24 kHz PCM16 ses köprüsü için açık CoreAudio aygıt komutları çalıştırır.
• blackhole-2ch: Chrome/Meet'in yönlendirildiği BlackHole 2ch aygıtını sağlayan macOS sanal ses sürücüsü.

SoX, LGPL-2.0-only AND GPL-2.0-only kapsamında lisanslanmıştır; BlackHole GPL-3.0 kapsamındadır. BlackHole'u OpenClaw ile birlikte paketleyen bir yükleyici veya cihaz oluşturursanız BlackHole'un üst kaynak lisansını inceleyin ya da Existential Audio'dan ayrı bir lisans alın.

Aktarımlar

Chrome

Meet URL'sini OpenClaw tarayıcı denetimi üzerinden açar ve oturum açılmış OpenClaw tarayıcı profili olarak katılır. Plugin, macOS'te başlatmadan önce BlackHole 2ch öğesini denetler ve yapılandırılmışsa Chrome'u açmadan önce bir ses köprüsü sağlık/başlatma komutu çalıştırır. Yerel Chrome için profili browser.defaultProfile ile seçin; bunun yerine chrome.browserProfile, chrome-node ana makinelerine iletilir.

openclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chromeopenclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome-node

Chrome mikrofon/hoparlör sesi, yerel OpenClaw ses köprüsü üzerinden yönlendirilir. BlackHole 2ch yüklü değilse ses yolu olmadan katılmak yerine katılım işlemi bir kurulum hatasıyla başarısız olur.

Twilio

Voice Call Plugin için devredilen katı bir arama planıdır. Telefon numaraları için Meet sayfalarını ayrıştırmaz; Google Meet, toplantı için bir telefonla arama numarası ve PIN sunmalıdır.

Voice Call'u Chrome Node üzerinde değil, Gateway ana makinesinde etkinleştirin:

{  plugins: {    allow: ["google-meet", "voice-call", "google"],    entries: {      "google-meet": {        enabled: true,        config: {          defaultTransport: "chrome-node",          // veya Twilio varsayılan olacaksa "twilio" olarak ayarlayın        },      },      "voice-call": {        enabled: true,        config: {          provider: "twilio",          inboundPolicy: "allowlist",          realtime: {            enabled: true,            provider: "google",            instructions: "Bu Google Meet'e bir OpenClaw aracısı olarak katıl. Kısa konuş.",            toolPolicy: "safe-read-only",            providers: {              google: {                silenceDurationMs: 500,                startSensitivity: "high",              },            },          },        },      },      google: {        enabled: true,      },    },  },}

Gizli bilgileri openclaw.json dışında tutmak için Twilio kimlik bilgilerini ortam aracılığıyla sağlayın:

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

Gerçek zamanlı ses sağlayıcısı OpenAI ise bunun yerine realtime.provider: "openai" öğesini OPENAI_API_KEY ile kullanın.

voice-call etkinleştirildikten sonra Gateway'i yeniden başlatın veya yeniden yükleyin; Plugin yapılandırması değişiklikleri yeniden yüklenene kadar etkili olmaz. Doğrulayın:

openclaw config validateopenclaw plugins list | grep -E 'google-meet|voice-call'openclaw googlemeet setup

Twilio devri bağlandığında googlemeet setup; twilio-voice-call-plugin, twilio-voice-call-credentials ve twilio-voice-call-webhook kontrollerini içerir.

openclaw googlemeet join https://meet.google.com/abc-defg-hij \  --transport twilio \  --dial-in-number +15551234567 \  --pin 123456

Özel bir dizi için --dtmf-sequence kullanın; PIN'den önce duraklama için başına w veya virgüller ekleyin:

openclaw googlemeet join https://meet.google.com/abc-defg-hij \  --transport twilio \  --dial-in-number +15551234567 \  --dtmf-sequence ww123456#

OAuth ve ön kontrol

Meet bağlantısı oluşturmak için OAuth isteğe bağlıdır, çünkü googlemeet create tarayıcı otomasyonuna geri dönebilir. Resmî API ile oluşturma, alan çözümleme veya Meet Media API ön kontrolü için OAuth'u yapılandırın. Chrome/Chrome-node katılımları hiçbir zaman OAuth'a bağlı değildir; her iki durumda da oturum açılmış bir Chrome profili, BlackHole/SoX ve (chrome-node için) bağlı bir Node kullanırlar.

Google kimlik bilgilerini oluşturma

Google Cloud Console'da:

http://localhost:8085/oauth2callback

meetings.space.created, spaces.create tarafından gereklidir. meetings.space.readonly, Meet URL'lerini/kodlarını alanlara çözümler. meetings.space.settings, OpenClaw'ın API ile oda oluşturma sırasında accessType gibi SpaceConfig ayarlarını iletmesini sağlar. meetings.conference.media.readonly, Meet Media API ön kontrolü ve medya çalışmaları içindir; Google, gerçek Media API kullanımı için Developer Preview kaydı gerektirebilir. calendar.events.readonly yalnızca --today/--event takvim araması için gereklidir. drive.meet.readonly yalnızca --include-doc-bodies dışa aktarımı için gereklidir. Yalnızca tarayıcı tabanlı Chrome katılımlarına ihtiyacınız varsa OAuth'u tamamen atlayın.

Yenileme belirtecini oluşturma

oauth.clientId ve isteğe bağlı olarak oauth.clientSecret değerini yapılandırın (veya bunları ortam değişkenleri olarak iletin), ardından şunu çalıştırın:

openclaw googlemeet auth login --json

Bu komut, http://localhost:8085/oauth2callback üzerinde localhost geri çağrısı kullanan bir PKCE akışı çalıştırır ve yenileme belirteci içeren bir oauth yapılandırma bloğu yazdırır. Tarayıcı yerel geri çağrıya ulaşamadığında kopyala/yapıştır akışı için --manual ekleyin:

OPENCLAW_GOOGLE_MEET_CLIENT_ID="your-client-id" \OPENCLAW_GOOGLE_MEET_CLIENT_SECRET="your-client-secret" \openclaw googlemeet auth login --json --manual

JSON çıktısı:

{  "oauth": {    "clientId": "your-client-id",    "clientSecret": "your-client-secret",    "refreshToken": "refresh-token",    "accessToken": "access-token",    "expiresAt": 1770000000000  },  "scope": "..."}

oauth nesnesini Plugin yapılandırması altında saklayın:

{  plugins: {    entries: {      "google-meet": {        enabled: true,        config: {          oauth: {            clientId: "your-client-id",            clientSecret: "your-client-secret",            refreshToken: "refresh-token",          },        },      },    },  },}

Yenileme belirtecini yapılandırmada tutmak istemediğinizde ortam değişkenlerini tercih edin; önce yapılandırma çözümlenir, ardından yedek olarak ortam kullanılır. Toplantı oluşturma, takvim araması veya belge gövdesi dışa aktarma desteği mevcut olmadan önce kimlik doğrulaması yaptıysanız yenileme belirtecinin geçerli kapsam kümesini kapsaması için openclaw googlemeet auth login --json komutunu yeniden çalıştırın.

OAuth'u doctor ile doğrulama

openclaw googlemeet doctor --oauth --json

Bu komut, Chrome çalışma zamanını yüklemeden veya bağlı bir Node gerektirmeden OAuth yapılandırmasının mevcut olduğunu ve yenileme belirtecinin erişim belirteci oluşturabildiğini denetler. Rapor yalnızca durum alanlarını (ok, configured, tokenSource, expiresAt, kontrol iletileri) içerir ve erişim belirtecini, yenileme belirtecini veya istemci gizli anahtarını hiçbir zaman yazdırmaz.

Yan etkiye sahip oluşturma denetimiyle Meet API'nin etkinleştirildiğini ve spaces.create kapsamını doğrulayın:

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

Mevcut bir alana okuma erişimini doğrulayın:

openclaw googlemeet doctor --oauth --meeting https://meet.google.com/abc-defg-hij --jsonopenclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij

Bu denetimlerden gelen bir 403 genellikle Meet REST API'nin devre dışı olduğu, yenileme token'ında gerekli kapsamın bulunmadığı veya Google hesabının bu alana erişemediği anlamına gelir. Yenileme token'ı hatası, openclaw googlemeet auth login --json komutunu yeniden çalıştırmanız ve yeni oauth bloğunu kaydetmeniz gerektiği anlamına gelir.

Tarayıcı geri dönüşü için OAuth gerekmez; buradaki Google kimlik doğrulaması OpenClaw yapılandırmasından değil, seçili Node üzerindeki oturum açılmış Chrome profilinden gelir.

Bu ortam değişkenleri geri dönüş olarak kabul edilir:

• OPENCLAW_GOOGLE_MEET_CLIENT_ID veya GOOGLE_MEET_CLIENT_ID
• OPENCLAW_GOOGLE_MEET_CLIENT_SECRET veya GOOGLE_MEET_CLIENT_SECRET
• OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN veya GOOGLE_MEET_REFRESH_TOKEN
• OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN veya GOOGLE_MEET_ACCESS_TOKEN
• OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT veya GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT
• OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING veya GOOGLE_MEET_DEFAULT_MEETING
• OPENCLAW_GOOGLE_MEET_PREVIEW_ACK veya GOOGLE_MEET_PREVIEW_ACK

Çözümleme, ön kontrol ve yapıtları okuma

openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij

Meet konferans kayıtlarını oluşturduktan sonra:

openclaw googlemeet artifacts --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet attendance --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet export --meeting https://meet.google.com/abc-defg-hij --output ./meet-export

--meeting ile artifacts ve attendance varsayılan olarak en son konferans kaydını kullanır; saklanan her kayıt için --all-conference-records iletin.

Takvim araması, yapıtları okumadan önce toplantı URL'sini Google Calendar'dan çözümler (Calendar etkinliklerini salt okunur kapsamda içeren bir yenileme token'ı gerektirir):

openclaw googlemeet latest --todayopenclaw googlemeet calendar-events --today --jsonopenclaw googlemeet artifacts --event "Weekly sync"openclaw googlemeet attendance --today --format csv --output attendance.csv

--today, bugünün primary takviminde Meet bağlantısı bulunan bir etkinliği arar; --event <query> eşleşen etkinlik metnini arar; --calendar <id> birincil olmayan bir takvimi hedefler. calendar-events eşleşen etkinlikleri önizler ve latest/artifacts/attendance/export seçeneklerinin hangisini seçeceğini işaretler.

Konferans kaydı kimliğini zaten biliyorsanız doğrudan belirtin:

openclaw googlemeet latest --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet artifacts --conference-record conferenceRecords/abc123 --jsonopenclaw googlemeet attendance --conference-record conferenceRecords/abc123 --json

API tarafından oluşturulan bir alanın odasını kapatın:

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

spaces.endActiveConference çağrısını yapar ve yetkilendirilmiş hesabın yönetebildiği bir alan için meetings.space.created kapsamına sahip OAuth gerektirir. Meet URL'sini, toplantı kodunu veya spaces/{id} değerini kabul eder ve önce bunu API alan kaynağına çözümler. Bu, googlemeet leave işleminden ayrıdır: leave, OpenClaw'ın yerel/oturum katılımını durdurur; end-active-conference, Google Meet'ten alanın etkin konferansını sonlandırmasını ister.

Okunabilir bir rapor yazın:

openclaw googlemeet artifacts --conference-record conferenceRecords/abc123 \  --format markdown --output meet-artifacts.mdopenclaw googlemeet attendance --conference-record conferenceRecords/abc123 \  --format csv --output meet-attendance.csvopenclaw googlemeet export --conference-record conferenceRecords/abc123 \  --include-doc-bodies --zip --output meet-exportopenclaw googlemeet export --conference-record conferenceRecords/abc123 \  --include-doc-bodies --dry-run

artifacts, Google bunları sunduğunda konferans kaydı meta verilerinin yanı sıra katılımcı, kayıt, transkript, yapılandırılmış transkript girdisi ve akıllı not kaynağı meta verilerini döndürür. --no-transcript-entries, büyük toplantılarda girdi aramasını atlar. attendance, katılımcıları ilk/son görülme zamanlarını, toplam oturum süresini, geç kalma/erken ayrılma bayraklarını içeren katılımcı oturumu satırlarına genişletir ve yinelenen katılımcı kaynaklarını oturum açmış kullanıcıya veya görünen ada göre birleştirir; --no-merge-duplicates ham kaynakları ayrı tutar, --late-after-minutes/--early-before-minutes eşikleri ayarlar.

export; summary.md, attendance.csv, transcript.md, artifacts.json, attendance.json ve manifest.json içeren bir klasör yazar. manifest.json; seçilen girdiyi, dışa aktarma seçeneklerini, konferans kayıtlarını, çıktı dosyalarını, sayıları, token kaynağını, kullanılan Calendar etkinliklerini ve kısmi alma uyarılarını kaydeder. --zip ayrıca klasörün yanına taşınabilir bir arşiv yazar. --include-doc-bodies, bağlantılı transkript/akıllı not Google Docs metnini Drive files.export üzerinden dışa aktarır (Drive Meet salt okunur kapsamını gerektirir); bu olmadan dışa aktarımlar yalnızca Meet meta verilerini ve yapılandırılmış transkript girdilerini içerir. Kısmi bir yapıt hatası (akıllı not listeleme, transkript girdisi veya belge gövdesi hatası), dışa aktarımın tamamını başarısız kılmak yerine uyarıyı özet/manifest içinde tutar. --dry-run, aynı verileri getirir ve klasörü veya ZIP dosyasını oluşturmadan manifest JSON'unu yazdırır.

Aracılar aynı eylemleri google_meet aracı üzerinden kullanır (export, accessType ile create, end_active_conference, test_listen); bkz. Araç.

Canlı duman testi

OPENCLAW_LIVE_TEST=1 \OPENCLAW_GOOGLE_MEET_LIVE_MEETING=https://meet.google.com/abc-defg-hij \pnpm test:live -- extensions/google-meet/google-meet.live.test.ts

openclaw googlemeet setup --transport chrome-node --mode transcribeopenclaw googlemeet test-listen https://meet.google.com/abc-defg-hij --transport chrome-node --timeout-ms 30000

Temel yapıt/katılım duman testi meetings.space.readonly ve meetings.conference.media.readonly gerektirir. Calendar araması calendar.events.readonly gerektirir. Drive belge gövdesi dışa aktarımı drive.meet.readonly gerektirir.

Oluşturma örnekleri

openclaw googlemeet create

Yeni toplantı URI'sini, kaynağı ve katılım oturumunu yazdırır. OAuth ile Meet API'yi; OAuth olmadan sabitlenmiş Chrome Node'un oturum açılmış profilini kullanır. Tarayıcı geri dönüşü JSON'u:

{  "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"    }  }}

Tarayıcı geri dönüşü önce Google oturum açma sayfasıyla veya bir Meet izin engeliyle karşılaşırsa google_meet, düz bir dize yerine yapılandırılmış ayrıntılar döndürür:

{  "source": "browser",  "error": "google-login-required: OpenClaw tarayıcı profilinde Google'da oturum açın, ardından toplantı oluşturmayı yeniden deneyin.",  "manualActionRequired": true,  "manualActionReason": "google-login-required",  "manualActionMessage": "OpenClaw tarayıcı profilinde Google'da oturum açın, ardından toplantı oluşturmayı yeniden deneyin.",  "browser": {    "nodeId": "ba0f4e4bc...",    "targetId": "tab-1",    "browserUrl": "https://accounts.google.com/signin",    "browserTitle": "Sign in - Google Accounts"  }}

API oluşturma JSON'u:

{  "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"    }  }}

Oluşturma işlemi varsayılan olarak katılım sağlar ancak Chrome/Chrome Node'un tarayıcı üzerinden katılabilmesi için yine de oturum açılmış bir Google profili gerekir; oturum kapalıysa OpenClaw manualActionRequired: true veya bir tarayıcı geri dönüşü hatası bildirir ve yeniden denemeden önce operatörden Google oturum açma işlemini tamamlamasını ister.

preview.enrollmentAcknowledged: true değerini yalnızca Cloud projenizin, OAuth sorumlusunun ve toplantı katılımcılarının Meet medya API'leri için Google Workspace Developer Preview Program'a kaydolduğunu doğruladıktan sonra ayarlayın.

Yapılandırma

Ortak Chrome aracı yolu yalnızca Plugin'in etkinleştirilmesini, BlackHole'u, SoX'u, gerçek zamanlı bir sağlayıcı anahtarını ve yapılandırılmış bir OpenClaw TTS sağlayıcısını gerektirir:

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

Varsayılanlar

chrome.audioBridgeCommand ve chrome.audioBridgeHealthCommand, chrome.audioInputCommand/chrome.audioOutputCommand yerine harici bir köprünün tüm yerel ses yolunu yönetmesine olanak tanır; bunları hangi modun kullanabileceğine ilişkin kısıtlama için Notlar bölümüne bakın.

Eski realtime.provider: "google" biçimi için bir openclaw doctor --fix geçişi vardır: Bu alanlar zaten ayarlanmamışsa söz konusu amacı realtime.voiceProvider: "google" ve realtime.transcriptionProvider: "openai" alanlarına taşır.

İsteğe bağlı geçersiz kılmalar

{  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",      },    },  },}

Hem ajan modu dinleme hem de konuşma için ElevenLabs:

{  messages: {    tts: {      provider: "elevenlabs",      providers: {        elevenlabs: {          modelId: "eleven_v3",          speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",        },      },    },  },  plugins: {    entries: {      "google-meet": {        config: {          realtime: {            transcriptionProvider: "elevenlabs",            providers: {              elevenlabs: {                modelId: "scribe_v2_realtime",                audioFormat: "ulaw_8000",                sampleRate: 8000,                commitStrategy: "vad",              },            },          },        },      },    },  },}

Kalıcı Meet sesi messages.tts.providers.elevenlabs.speakerVoiceId üzerinden gelir. TTS modeli geçersiz kılmaları etkinleştirildiğinde ajan yanıtları, yanıt başına [[tts:speakerVoiceId=... model=eleven_v3]] yönergelerini de kullanabilir; ancak toplantılar için yapılandırma belirleyici varsayılandır. Katılma sırasında günlüklerde transcriptionProvider=elevenlabs gösterilir ve seslendirilen her yanıt için provider=elevenlabs model=eleven_v3 speakerVoiceId=<voiceId> günlüğe kaydedilir.

Yalnızca Twilio yapılandırması:

{  defaultTransport: "twilio",  twilio: {    defaultDialInNumber: "+15551234567",    defaultPin: "123456",  },  voiceCall: {    gatewayUrl: "ws://127.0.0.1:18789",  },}

voiceCall.enabled: true (varsayılan) ve Twilio aktarımıyla Voice Call, gerçek zamanlı medya akışını açmadan önce DTMF dizisini gönderir ve ardından kaydedilen tanıtım metnini ilk gerçek zamanlı karşılama olarak kullanır. voice-call etkinleştirilmemişse Google Meet arama planını doğrulayıp kaydetmeye devam edebilir ancak Twilio çağrısını gerçekleştiremez.

Yerel güvenilir Gateway çalışma zamanını kullanmak için voiceCall.gatewayUrl ayarını yapmayın; bu, çağrıyı başlatan agent'ı çağrının tamamı boyunca korur. Yapılandırılmış bir Gateway URL'si açık bir WebSocket hedefi olarak kalır ve plugin kaynağının kimliğini doğrulayamaz; varsayılan olmayan agent katılımları sessizce başka bir agent kullanmak yerine güvenli biçimde başarısız olur. Agent başına yönlendirme gerektiğinde Google Meet ve Voice Call'u aynı Gateway sürecinde çalıştırın.

Araç

Agent'lar google_meet aracını kullanır:

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

test_speech her zaman mode: "agent" veya "bidi" kullanımını zorunlu kılar ve yalnızca gözlem oturumları konuşma üretemediğinden mode: "transcribe" içinde çalıştırılması istenirse başarısız olur. speechOutputVerified sonucu, bu çağrı sırasında gerçek zamanlı ses çıkışı baytlarının artmasına dayanır; dolayısıyla eski ses içeren yeniden kullanılan bir oturum yeni bir denetim olarak sayılmaz.

Chrome aktarımlarında leave, Meet'in Leave çağrı düğmesine tıklandıktan sonra yeniden kullanılan ve kullanıcıya ait sekmeyi açık tutar. OpenClaw tarafından açılan sekmeler ayrıldıktan sonra kapatılır.

Chrome Gateway ana makinesinde çalıştığında transport: "chrome", eşleştirilmiş bir Node üzerinde çalıştığında transport: "chrome-node" kullanın. Her iki durumda da model sağlayıcıları ve openclaw_agent_consult Gateway ana makinesinde çalışır; böylece model kimlik bilgileri orada kalır. Agent modu günlükleri, köprü başlatılırken çözümlenen transkripsiyon sağlayıcısını/modelini ve sentezlenen her yanıttan sonra TTS sağlayıcısını/modelini/sesini/çıkış biçimini/örnekleme hızını içerir. Ham mode: "realtime", mode: "agent" için eski bir uyumluluk diğer adı olarak hâlâ kabul edilir ancak artık aracın mode enum'unda duyurulmaz.

API destekli bir oda ve açık erişim ilkesiyle create:

{  "action": "create",  "transport": "chrome-node",  "mode": "agent",  "accessType": "OPEN"}

Bilinen bir odanın etkin konferansını sonlandırma:

{  "action": "end_active_conference",  "meeting": "https://meet.google.com/abc-defg-hij"}

Bir toplantının yararlı olduğunu belirtmeden önce dinleme öncelikli doğrulama:

{  "action": "test_listen",  "url": "https://meet.google.com/abc-defg-hij",  "transport": "chrome-node",  "timeoutMs": 30000}

İstek üzerine konuşma:

{  "action": "speak",  "sessionId": "meet_...",  "message": "Tam olarak şunu söyle: Buradayım ve dinliyorum."}

status, kullanılabildiğinde Chrome durumunu içerir:

Agent ve çift yönlü modlar

agent modu: gerçek zamanlı transkripsiyon sağlayıcısı toplantı sesini duyar, nihai katılımcı transkriptleri yapılandırılmış OpenClaw agent'ı üzerinden yönlendirilir ve yanıt normal OpenClaw TTS aracılığıyla seslendirilir. Yakın zamanlı nihai transkript parçaları danışmadan önce birleştirilir; böylece tek bir konuşma sırası birkaç eski kısmi yanıt üretmez. Kuyruktaki asistan sesi oynatılmaya devam ederken gerçek zamanlı giriş engellenir ve BlackHole geri döngüsünün agent'ın kendi konuşmasına yanıt vermesine yol açmaması için yakın tarihli asistan benzeri transkript yankıları danışmadan önce yok sayılır.

bidi modu: gerçek zamanlı ses modeli doğrudan yanıt verir ve daha derin akıl yürütme, güncel bilgiler veya normal OpenClaw araçları için openclaw_agent_consult çağırabilir. Danışma aracı, yakın tarihli toplantı transkripti bağlamıyla normal OpenClaw agent'ını arka planda çalıştırır ve kısa bir sözlü yanıt döndürür; agent modunda OpenClaw bu yanıtı doğrudan TTS'ye gönderir, bidi modunda ise gerçek zamanlı ses modeli yanıtı seslendirebilir. Voice Call ile aynı paylaşılan danışma mekanizmasını kullanır.

Danışmalar varsayılan olarak main agent'ında çalışır; bir Meet hattını özel bir agent çalışma alanına, model varsayılanlarına, araç ilkesine, belleğe ve oturum geçmişine yönlendirmek için realtime.agentId ayarlayın. Agent modu danışmaları, takip sorularının normal agent ilkesini devralırken toplantı bağlamını koruması için toplantı başına bir agent:<id>:subagent:google-meet:<session> oturum anahtarı kullanır. Bir agent, agent modunda google_meet çağırdığında danışman oturumu, katılımcı konuşmasına yanıt vermeden önce çağıranın geçerli transkriptini çatallar; Meet oturumu ayrı kalır, böylece toplantı takipleri çağıranın transkriptini doğrudan değiştirmez.

realtime.toolPolicy, danışma çalışmasını denetler:

Danışma oturumu anahtarı Meet oturumu başına kapsanır; dolayısıyla takip danışma çağrıları aynı toplantı sırasında önceki danışma bağlamını yeniden kullanır.

Chrome tamamen katıldıktan sonra sesli bir hazır olma denetimini zorlayın:

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

Tam katılma ve konuşma duman testi:

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

Canlı test kontrol listesi

Bir toplantıyı gözetimsiz bir agent'a devretmeden önce:

openclaw googlemeet setupopenclaw nodes statusopenclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \  --transport chrome-node \  --message "Say exactly: Google Meet speech test complete."

Beklenen Chrome-node durumu:

• googlemeet setup tamamen yeşildir ve Chrome-node varsayılan aktarım olduğunda veya bir Node sabitlendiğinde chrome-node-connected içerir.
• nodes status, seçilen Node'un bağlı olduğunu ve hem googlemeet.chrome hem de browser.proxy sunduğunu gösterir.
• Meet sekmesi katılır ve test-speech, inCall: true ile Chrome durumunu döndürür.

Parallels macOS VM gibi uzak bir Chrome ana makinesi için Gateway veya VM güncellendikten sonraki en kısa güvenli denetim:

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

Bu, bir agent gerçek bir toplantı sekmesi açmadan önce Gateway Plugin'inin yüklendiğini, VM Node'unun geçerli token ile bağlı olduğunu ve Meet ses köprüsünün kullanılabilir olduğunu kanıtlar.

Twilio duman testi için telefonla katılım ayrıntılarını sunan bir toplantı kullanın:

openclaw googlemeet setupopenclaw googlemeet join https://meet.google.com/abc-defg-hij \  --transport twilio \  --dial-in-number +15551234567 \  --pin 123456

Beklenen Twilio durumu:

• googlemeet setup; yeşil twilio-voice-call-plugin, twilio-voice-call-credentials ve twilio-voice-call-webhook denetimlerini içerir.
• voicecall, Gateway yeniden yüklendikten sonra CLI'da kullanılabilir.
• Döndürülen oturumda transport: "twilio" ve bir twilio.voiceCallId bulunur.
• openclaw logs --follow, gerçek zamanlı TwiML'den önce DTMF TwiML'in sunulduğunu, ardından ilk karşılamanın kuyruğa alındığı gerçek zamanlı bir köprüyü gösterir.
• googlemeet leave <sessionId>, devredilen sesli aramayı sonlandırır.

Sorun giderme

Aracı Google Meet aracını göremiyor

Plugin'in etkin olduğunu doğrulayın ve Gateway'i yeniden yükleyin; çalışan aracı yalnızca mevcut Gateway işlemi tarafından kaydedilen Plugin araçlarını görür:

openclaw plugins list | grep google-meetopenclaw googlemeet setup

macOS dışındaki Gateway ana makinelerinde google_meet görünür kalır ancak yerel Chrome geri konuşma eylemleri, ses köprüsüne ulaşmadan engellenir. Varsayılan yerel Chrome aracı yolu yerine mode: "transcribe", Twilio telefonla katılımı veya bir macOS chrome-node ana makinesi kullanın.

Bağlı, Google Meet özellikli Node yok

Node ana makinesinde:

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

Gateway ana makinesinde:

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

Node bağlı olmalı ve googlemeet.chrome ile browser.proxy öğelerini listelemelidir; Gateway yapılandırması her ikisine de izin vermelidir:

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

googlemeet setup, chrome-node-connected işleminde başarısız olursa veya Gateway günlüğü gateway token mismatch bildirirse Node'u geçerli Gateway belirteciyle yeniden yükleyin ya da yeniden başlatın:

OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node install \  --host <gateway-lan-ip> \  --port 18789 \  --display-name parallels-macos \  --force

Ardından Node hizmetini yeniden yükleyip şu komutları tekrar çalıştırın:

openclaw googlemeet setupopenclaw nodes status --connected

Tarayıcı açılıyor ancak aracı katılamıyor

Yalnızca gözlem amaçlı katılımlar için googlemeet test-listen, gerçek zamanlı katılımlar için googlemeet test-speech çalıştırın ve ardından döndürülen Chrome durumunu inceleyin. Bunlardan biri manualActionRequired: true bildirirse operatöre manualActionMessage gösterin ve tarayıcı eylemi tamamlanana kadar yeniden denemeyi bırakın.

Yaygın manuel eylemler: Chrome profiline giriş yapmak; konuğu Meet ana makine hesabından kabul etmek; yerel istem görüntülendiğinde Chrome mikrofon/kamera izinlerini vermek; takılı kalmış bir Meet izin iletişim kutusunu kapatmak veya onarmak.

Meet yalnızca "Do you want people to hear you in the meeting?" diye sorduğu için "oturum açılmamış" şeklinde bildirimde bulunmayın; bu, Meet'in ses seçimi ara ekranıdır. OpenClaw, kullanılabildiğinde tarayıcı otomasyonu aracılığıyla Use microphone öğesine tıklar ve gerçek toplantı durumunu beklemeye devam eder; yalnızca oluşturma amaçlı tarayıcı yedeğinde bunun yerine Continue without microphone öğesine tıklayabilir çünkü URL oluşturmak gerçek zamanlı ses yolunu gerektirmez.

Toplantı oluşturma başarısız oluyor

OAuth yapılandırılmışsa googlemeet create, Meet API spaces.create öğesini; aksi takdirde sabitlenmiş Chrome Node tarayıcısını kullanır. Şunları doğrulayın:

• API ile oluşturma: oauth.clientId ve oauth.refreshToken (veya eşleşen OPENCLAW_GOOGLE_MEET_* ortam değişkenleri) mevcut olmalı ve yenileme belirteci, oluşturma desteği eklendikten sonra üretilmiş olmalıdır; eski belirteçlerde meetings.space.created eksik olabilir, bu nedenle openclaw googlemeet auth login --json komutunu yeniden çalıştırın.
• Tarayıcı yedeği: defaultTransport: "chrome-node" ve chromeNode.node, browser.proxy ve googlemeet.chrome öğelerine sahip bağlı bir Node'u göstermelidir; bu Node'daki OpenClaw Chrome profilinde oturum açılmış olmalı ve profil https://meet.google.com/new öğesini açabilmelidir.
• Tarayıcı yedeği yeniden denemeleri: yeni bir sekme açmadan önce mevcut bir .../new veya Google hesabı istemi sekmesini yeniden kullanın; manuel olarak başka bir sekme açmak yerine araç çağrısını yeniden deneyin.
• Manuel eylem: araç manualActionRequired: true döndürürse operatöre yol göstermek için browser.nodeId, browser.targetId, browserUrl ve manualActionMessage öğelerini kullanın; döngü içinde yeniden denemeyin.
• Ses seçimi ara ekranı: Meet "Do you want people to hear you in the meeting?" iletisini gösterirse sekmeyi açık bırakın. OpenClaw, Use microphone veya (yalnızca oluşturma için) Continue without microphone öğesine tıklayıp oluşturulan URL'yi beklemeye devam etmelidir; bunu yapamazsa hata google-login-required değil, meet-audio-choice-required öğesini belirtmelidir.

Aracı katılıyor ancak konuşmuyor

openclaw googlemeet setupopenclaw googlemeet doctor

STT -> OpenClaw aracısı -> TTS yolu için mode: "agent", doğrudan gerçek zamanlı ses yedeği için mode: "bidi" kullanın. mode: "transcribe" kasıtlı olarak geri konuşma köprüsü başlatmaz. Yalnızca gözlem amaçlı hata ayıklamak için katılımcılar konuştuktan sonra openclaw googlemeet status --json <session-id> çalıştırın ve captioning, transcriptLines, lastCaptionText öğelerini denetleyin. inCall doğruysa ancak transcriptLines, 0 olarak kalıyorsa Meet altyazıları devre dışı bırakılmış olabilir, gözlemci yüklendiğinden beri kimse konuşmamış olabilir, Meet kullanıcı arayüzü değişmiş olabilir veya toplantı dili/hesabı için canlı altyazılar kullanılamıyor olabilir.

googlemeet test-speech her zaman gerçek zamanlı yolu denetler ve bu çağrı için köprü çıkış baytlarının gözlemlenip gözlemlenmediğini bildirir. speechOutputVerified yanlış ve speechOutputTimedOut doğruysa gerçek zamanlı sağlayıcı ifadeyi kabul etmiş olabilir ancak OpenClaw, Chrome ses köprüsüne ulaşan yeni çıkış baytlarını görmemiştir.

Ayrıca şunları doğrulayın: Gateway ana makinesinde bir gerçek zamanlı sağlayıcı anahtarı (OPENAI_API_KEY veya GEMINI_API_KEY) kullanılabilir olmalıdır; Chrome ana makinesinde BlackHole 2ch görünür olmalıdır; orada sox bulunmalıdır; Meet mikrofonu/hoparlörü sanal ses yolu üzerinden yönlendirilmelidir (yerel Chrome gerçek zamanlı katılımları için doctor, meet output routed: yes göstermelidir).

googlemeet doctor [session-id]; oturumu, Node'u, arama içi durumunu, manuel eylem nedenini, gerçek zamanlı sağlayıcı bağlantısını, realtimeReady, ses giriş/çıkış etkinliğini, son ses zaman damgalarını, bayt sayaçlarını ve tarayıcı URL'sini yazdırır. Ham JSON için googlemeet status [session-id] --json; belirteçleri açığa çıkarmadan OAuth yenilemeyi doğrulamak için googlemeet doctor --oauth (--meeting veya --create-space ekleyin) kullanın.

Bir aracı zaman aşımına uğradıysa ve bir Meet sekmesi zaten açıksa başka bir sekme açmadan onu inceleyin:

openclaw googlemeet recover-tabopenclaw googlemeet recover-tab https://meet.google.com/abc-defg-hij

Eşdeğer araç eylemi recover_current_tab öğesidir: yeni bir sekme veya oturum açmadan seçilen aktarım için mevcut bir Meet sekmesine odaklanır ve sekmeyi inceler (chrome için yerel tarayıcı denetimi, chrome-node için yapılandırılmış Node) ve mevcut engelleyiciyi (oturum açma, kabul, izinler, ses seçimi durumu) bildirir. CLI komutu, çalışıyor olması gereken yapılandırılmış Gateway ile iletişim kurar; chrome-node ayrıca Node'un bağlı olmasını gerektirir.

Twilio kurulum denetimleri başarısız oluyor

voice-call öğesine izin verilmediğinde veya bu öğe etkin olmadığında twilio-voice-call-plugin başarısız olur: öğeyi plugins.allow içine ekleyin, plugins.entries.voice-call öğesini etkinleştirin ve Gateway'i yeniden yükleyin.

Twilio arka ucunda hesap SID'si, kimlik doğrulama belirteci veya arayan numarası eksik olduğunda twilio-voice-call-credentials başarısız olur:

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

voice-call için genel Webhook erişimi olmadığında veya publicUrl geri döngü/özel ağ alanını gösterdiğinde twilio-voice-call-webhook başarısız olur. 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 veya fd00::/8 öğelerini publicUrl olarak kullanmayın; operatör geri çağrıları bunlara ulaşamaz. plugins.entries.voice-call.config.publicUrl öğesini genel bir URL olarak ayarlayın veya bir tünel/Tailscale erişimi yapılandırın:

{  plugins: {    entries: {      "voice-call": {        enabled: true,        config: {          provider: "twilio",          fromNumber: "+15550001234",          publicUrl: "https://voice.example.com/voice/webhook",        },      },    },  },}

Yerel geliştirme için özel ana makine URL'si yerine bir tünel veya Tailscale erişimi kullanın:

{  plugins: {    entries: {      "voice-call": {        config: {          tunnel: { provider: "ngrok" },          // veya          tailscale: { mode: "funnel", path: "/voice/webhook" },        },      },    },  },}

Gateway'i yeniden başlatın veya yeniden yükleyin, ardından:

openclaw googlemeet setup --transport twilioopenclaw voicecall setupopenclaw voicecall smoke

voicecall smoke varsayılan olarak yalnızca hazır olma durumunu denetler. Belirli bir numara için deneme çalıştırması yapın:

openclaw voicecall smoke --to "+15555550123"

Canlı bir giden aramayı yalnızca kasıtlı olarak başlatmak için --yes ekleyin:

openclaw voicecall smoke --to "+15555550123" --yes

Twilio araması başlıyor ancak toplantıya hiç girmiyor

Meet etkinliğinin telefonla katılım ayrıntılarını sunduğunu doğrulayın ve tam telefonla katılım numarasını PIN veya özel DTMF dizisiyle birlikte iletin:

openclaw googlemeet join https://meet.google.com/abc-defg-hij \  --transport twilio \  --dial-in-number +15551234567 \  --dtmf-sequence ww123456#

PIN'den önce duraklama sağlamak için --dtmf-sequence içinde başta w veya virgüller kullanın.

Arama oluşturulduğu hâlde Meet katılımcı listesinde telefonla katılan kişi hiç görünmüyorsa:

• openclaw googlemeet doctor <session-id>: devredilen Twilio arama kimliğini, DTMF'nin kuyruğa alınıp alınmadığını ve giriş karşılamasının istenip istenmediğini doğrulayın.
• openclaw voicecall status --call-id <id>: aramanın hâlâ etkin olduğunu doğrulayın.
• openclaw voicecall tail: Twilio Webhook'larının Gateway'e ulaştığını doğrulayın.
• openclaw logs --follow: Twilio Meet dizisini arayın: Google Meet katılımı devreder, Voice Call bağlantı öncesi DTMF TwiML'i depolar ve sunar, Voice Call Twilio araması için gerçek zamanlı TwiML'i sunar, ardından Google Meet voicecall.speak ile giriş konuşması ister.
• openclaw googlemeet setup --transport twilio komutunu yeniden çalıştırın; yeşil kurulum denetimi gereklidir ancak toplantı PIN dizisinin doğru olduğunu kanıtlamaz.
• Telefonla katılım numarasının PIN ile aynı Meet davetine ve bölgesine ait olduğunu doğrulayın.
• Meet yavaş yanıt veriyorsa veya bağlantı öncesi DTMF gönderildikten sonra arama dökümü hâlâ PIN istemini gösteriyorsa voiceCall.dtmfDelayMs değerini varsayılan 12 saniyeden artırın.
• Katılımcı katıldığı hâlde karşılamayı duymuyorsanız DTMF sonrası voicecall.speak isteği ve medya akışı TTS oynatımı ya da Twilio OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 yedeği için openclaw logs --follow öğesini denetleyin. Döküm hâlâ "enter the meeting PIN" gösteriyorsa telefon ayağı henüz Meet odasına katılmamıştır; bu nedenle katılımcılar konuşmayı duymayacaktır.

Webhook'lar ulaşmıyorsa önce Voice Call Plugin'inde hata ayıklayın: sağlayıcı plugins.entries.voice-call.config.publicUrl öğesine veya yapılandırılmış tünele ulaşabilmelidir. Bkz. Sesli arama sorunlarını giderme.

Notlar

Google Meet'in resmî medya API'si alım odaklıdır; bu nedenle bir aramada konuşmak hâlâ bir katılımcı yolu gerektirir. Bu Plugin söz konusu sınırı görünür tutar: Chrome, tarayıcı katılımını ve yerel ses yönlendirmesini; Twilio ise telefonla katılımı yönetir.

Chrome geri konuşma modları BlackHole 2ch ile birlikte şunlardan birini gerektirir:

• chrome.audioInputCommand artı chrome.audioOutputCommand: OpenClaw, köprünün sahibidir ve bu komutlarla seçilen sağlayıcı arasında chrome.audioFormat içinde ses aktarımı yapar. agent modu, gerçek zamanlı transkripsiyonla birlikte standart TTS kullanır; bidi modu ise gerçek zamanlı ses sağlayıcısını kullanır. Varsayılan yol, chrome.audioBufferBytes: 4096 ile 24 kHz PCM16'dır; eski komut çiftleri için 8 kHz G.711 mu-law kullanılmaya devam edilebilir.
• chrome.audioBridgeCommand: harici bir köprü komutu, yerel ses yolunun tamamını yönetir ve daemon'ını başlattıktan veya doğruladıktan sonra çıkmalıdır. Yalnızca bidi için geçerlidir; çünkü agent modu, TTS için komut çiftine doğrudan erişim gerektirir.

Komut çiftli Chrome köprüsüyle chrome.bargeInInputCommand, ayrı bir yerel mikrofonu dinleyebilir ve bir insan konuşmaya başladığında asistan oynatımını temizleyebilir; böylece paylaşılan BlackHole geri döngü girişi asistan oynatımı sırasında geçici olarak bastırılsa bile insan konuşması asistan çıktısından önce gelir. chrome.audioInputCommand/chrome.audioOutputCommand gibi bu da operatör tarafından yapılandırılan yerel bir komuttur: açıkça belirtilmiş güvenilir bir komut yolu veya bağımsız değişken listesi kullanın; güvenilmeyen bir konumdaki betiği asla kullanmayın.

Temiz çift yönlü ses için Meet çıkışını ve Meet mikrofonunu ayrı sanal cihazlar veya Loopback tarzı bir sanal cihaz grafiği üzerinden yönlendirin; tek bir paylaşılan BlackHole cihazı, diğer katılımcıların sesini çağrıya geri yansıtabilir.

googlemeet speak, bir Chrome oturumu için etkin geri konuşma ses köprüsünü tetikler; googlemeet leave bunu durdurur (ve Voice Call üzerinden devredilen Twilio oturumlarında alttaki çağrıyı sonlandırır). API tarafından yönetilen bir alanın etkin Google Meet konferansını da kapatmak için googlemeet end-active-conference kullanın.

İlgili

• Sesli arama plugini
• Konuşma modu
• Plugin oluşturma