- Yalnızca açık bir
https://meet.google.com/...URL’sine katılır. - Google Meet API aracılığıyla yeni bir Meet alanı oluşturabilir, ardından döndürülen URL’ye katılabilir.
agentvarsayılan geri konuşma modudur: gerçek zamanlı transkripsiyon dinler, yapılandırılmış OpenClaw agent yanıt verir ve normal OpenClaw TTS Meet içinde konuşur.bidi, yedek doğrudan gerçek zamanlı ses modeli modu olarak kullanılabilir kalır.- Agents katılma davranışını
modeile seçer: canlı dinleme/geri konuşma içinagent, doğrudan gerçek zamanlı ses yedeği içinbidiveya geri konuşma köprüsü olmadan tarayıcıya katılmak/kontrol etmek içintranscribekullanın. - Auth kişisel Google OAuth veya zaten oturum açılmış bir Chrome profili olarak başlar.
- Otomatik onay duyurusu yoktur.
- Varsayılan Chrome ses arka ucu
BlackHole 2ch’dir. - Chrome yerel olarak veya eşleştirilmiş bir node host üzerinde çalışabilir.
- Twilio bir arama numarası ve isteğe bağlı PIN veya DTMF dizisi kabul eder; bir Meet URL’sini doğrudan arayamaz.
- CLI komutu
googlemeettir;meetdaha geniş agent telekonferans iş akışları için ayrılmıştır.
Hızlı başlangıç
Yerel ses bağımlılıklarını kurun ve bir gerçek zamanlı transkripsiyon sağlayıcısı ile normal OpenClaw TTS’yi yapılandırın. OpenAI varsayılan transkripsiyon sağlayıcısıdır; Google Gemini Live ayrıcarealtime.voiceProvider: "google" ile ayrı bir bidi ses yedeği olarak çalışır:
blackhole-2ch, BlackHole 2ch sanal ses aygıtını kurar. Homebrew’in
kurucusu, macOS aygıtı göstermeden önce yeniden başlatma gerektirir:
--mode transcribe ile kontrol edin; bu mod gerçek zamanlı ses ön koşullarını atlar
çünkü köprü üzerinden dinlemez veya konuşmaz:
voice-call Plugin’inin, Twilio kimlik bilgilerinin ve herkese açık Webhook erişiminin hazır olup olmadığını raporlar.
Herhangi bir ok: false kontrolünü, bir agent’tan katılmasını istemeden önce kontrol edilen transport ve mod için engelleyici kabul edin. Scriptler veya makine tarafından okunabilir çıktı için openclaw googlemeet setup --json kullanın. Bir agent denemeden önce belirli bir
transportu ön kontrolden geçirmek için --transport chrome,
--transport chrome-node veya --transport twilio kullanın.
Twilio için, varsayılan transport Chrome olduğunda transportu her zaman açıkça ön kontrolden geçirin:
voice-call bağlantısını, Twilio kimlik bilgilerini veya erişilemeyen
Webhook erişimini yakalar.
Bir toplantıya katılın:
google_meet aracı üzerinden katılmasına izin verin:
google_meet aracı, macOS olmayan hostlarda artifact, calendar, setup, transcribe, Twilio ve chrome-node akışları için kullanılabilir kalır. Yerel
Chrome geri konuşma eylemleri orada engellenir çünkü paketli Chrome ses yolu
şu anda macOS BlackHole 2ch’ye bağlıdır. Linux’ta Chrome geri konuşmalı katılım için mode: "transcribe",
Twilio araması veya bir macOS chrome-node host kullanın.
Yeni bir toplantı oluşturun ve katılın:
SpaceConfig.accessType kullanın:
OPEN, Meet URL’sine sahip herkesin kapı çalmadan katılmasına izin verir. TRUSTED,
host kuruluşun güvenilir kullanıcılarının, davet edilmiş harici kullanıcıların ve aramayla katılan kullanıcıların
kapı çalmadan katılmasına izin verir. RESTRICTED, kapı çalmadan girişi davetlilerle sınırlar. Bu
ayarlar yalnızca resmi Google Meet API oluşturma yolu için geçerlidir, bu nedenle OAuth
kimlik bilgileri yapılandırılmış olmalıdır.
Bu seçenek kullanılabilir olmadan önce Google Meet kimlik doğrulaması yaptıysanız,
Google OAuth onay ekranınıza meetings.space.settings kapsamını ekledikten sonra
openclaw googlemeet auth login --json komutunu yeniden çalıştırın.
Katılmadan yalnızca URL oluşturun:
googlemeet create iki yola sahiptir:
- API oluşturma: Google Meet OAuth kimlik bilgileri yapılandırıldığında kullanılır. Bu, en deterministik yoldur ve tarayıcı UI durumuna bağlı değildir.
- Tarayıcı yedeği: OAuth kimlik bilgileri yokken kullanılır. OpenClaw
sabitlenmiş Chrome node’unu kullanır,
https://meet.google.com/newadresini açar, Google’ın gerçek bir toplantı kodu URL’sine yönlendirmesini bekler, ardından bu URL’yi döndürür. Bu yol, node üzerindeki OpenClaw Chrome profilinin Google’da zaten oturum açmış olmasını gerektirir. Tarayıcı otomasyonu Meet’in kendi ilk çalıştırma mikrofon istemini yönetir; bu istem bir Google giriş hatası olarak değerlendirilmez. Katılma ve oluşturma akışları ayrıca yeni bir sekme açmadan önce mevcut bir Meet sekmesini yeniden kullanmayı dener. Eşleştirme,authusergibi zararsız URL sorgu dizelerini yok sayar; böylece bir agent yeniden denemesi ikinci bir Chrome sekmesi oluşturmak yerine zaten açık toplantıya odaklanmalıdır.
source alanı (api veya browser) içerir; böylece agents
hangi yolun kullanıldığını açıklayabilir. create, varsayılan olarak yeni toplantıya katılır ve
joined: true ile katılım oturumunu döndürür. Yalnızca URL oluşturmak için
CLI’da create --no-join kullanın veya araca "join": false geçirin.
Ya da bir agent’a şunu söyleyin: “Bir Google Meet oluştur, agent geri konuşma moduyla katıl
ve bağlantıyı bana gönder.” Agent, action: "create" ile google_meet çağırmalı
ve ardından döndürülen meetingUri değerini paylaşmalıdır.
"mode": "transcribe" ayarlayın. Bu,
duplex gerçek zamanlı ses köprüsünü başlatmaz, BlackHole veya SoX gerektirmez
ve toplantıya geri konuşmaz. Bu moddaki Chrome katılımları ayrıca
OpenClaw’ın mikrofon/kamera izin verme işleminden ve Meet Mikrofon kullan
yolundan kaçınır. Meet bir ses seçimi ara ekranı gösterirse, otomasyon
mikrofonsuz yolu dener ve aksi halde yerel mikrofonu açmak yerine
manuel işlem bildirir. Transcribe modunda, yönetilen Chrome transportları ayrıca
en iyi çaba Meet altyazı gözlemcisi kurar. googlemeet status --json ve
googlemeet doctor, operatörlerin tarayıcının aramaya katılıp katılmadığını ve Meet altyazılarının metin üretip üretmediğini anlayabilmesi için captioning, captionsEnabledAttempted,
transcriptLines, lastCaptionAt, lastCaptionSpeaker, lastCaptionText
ve kısa bir recentTranscript kuyruğunu gösterir.
Evet/hayır probuna ihtiyaç duyduğunuzda openclaw googlemeet test-listen <meet-url> --transport chrome-node kullanın:
transcribe modunda katılır, yeni altyazı veya transkript hareketini bekler
ve listenVerified, listenTimedOut, manuel işlem alanları ile en son altyazı sağlığını döndürür.
Gerçek zamanlı 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 kapanma durumu gibi tarayıcı ve ses köprüsü
sağlığını içerir. Güvenli bir Meet sayfası istemi görünürse, tarayıcı otomasyonu mümkün olduğunda
bunu yönetir. Giriş, host kabulü ve tarayıcı/OS izin istemleri, agent’ın iletmesi için bir neden ve
mesajla manuel işlem olarak raporlanır. Yönetilen Chrome oturumları giriş veya
test ifadesini yalnızca tarayıcı sağlığı inCall: true raporladıktan sonra yayınlar; aksi halde durum
speechReady: false bildirir ve konuşma denemesi, agent toplantıya konuşmuş gibi davranmak yerine engellenir.
Yerel Chrome katılımları, oturum açılmış OpenClaw tarayıcı profili üzerinden yapılır. Gerçek zamanlı mod,
OpenClaw tarafından kullanılan mikrofon/hoparlör yolu için BlackHole 2ch gerektirir. Temiz
duplex ses için ayrı sanal aygıtlar veya Loopback tarzı bir grafik kullanın; tek
bir BlackHole aygıtı ilk smoke test için yeterlidir ancak yankı yapabilir.
Yerel Gateway + Parallels Chrome
Yalnızca VM’nin Chrome’a sahip olmasını sağlamak için bir macOS VM içinde tam bir OpenClaw Gateway’e veya model API anahtarına ihtiyacınız yoktur. Gateway’i ve agent’ı yerel olarak çalıştırın, ardından VM’de bir node host çalıştırın. Node’un Chrome komutunu duyurması için paketli Plugin’i VM’de bir kez etkinleştirin: Nerede ne çalışır:- Gateway host: OpenClaw Gateway, agent workspace, model/API anahtarları, gerçek zamanlı sağlayıcı ve Google Meet Plugin yapılandırması.
- Parallels macOS VM: OpenClaw CLI/node host, Google Chrome, SoX, BlackHole 2ch ve Google’da oturum açmış bir Chrome profili.
- VM’de gerekli olmayanlar: Gateway servisi, agent yapılandırması, OpenAI/GPT anahtarı veya model sağlayıcı kurulumu.
BlackHole 2ch aygıtını göstermesi için BlackHole’u kurduktan sonra VM’yi yeniden başlatın:
<gateway-host> bir LAN IP’siyse ve TLS kullanmıyorsanız, node bu güvenilir özel ağ için açıkça izin vermediğiniz sürece
düz metin WebSocket’i reddeder:
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1, openclaw.json ayarı değil, process ortamıdır. openclaw node install, kurulum komutunda mevcut olduğunda bunu LaunchAgent
ortamına kaydeder.
Node’u Gateway host’tan onaylayın:
googlemeet.chrome
hem de tarayıcı capability/browser.proxy duyurduğunu doğrulayın:
transport: "chrome-node" ile google_meet aracını kullanmasını isteyin.
Bir oturum oluşturan veya yeniden kullanan, bilinen bir ifadeyi söyleyen
ve oturum sağlığını yazdıran tek komutluk smoke test için:
manualActionRequired: true değerini manualActionReason
ve manualActionMessage ile bildirir. Aracılar katılmayı yeniden denemeyi bırakmalı,
bu tam mesajı geçerli browserUrl/browserTitle ile birlikte bildirmeli ve yalnızca
manuel tarayıcı işlemi tamamlandıktan sonra yeniden denemelidir.
chromeNode.node atlanırsa, OpenClaw yalnızca tam olarak bir bağlı node hem
googlemeet.chrome hem de tarayıcı denetimi ilan ettiğinde otomatik seçim yapar.
Birden çok uygun node bağlıysa, chromeNode.node değerini node kimliği, görünen ad
veya uzak IP olarak ayarlayın.
Yaygın hata denetimleri:
Configured Google Meet node ... is not usable: offline: sabitlenmiş node Gateway tarafından biliniyor ancak kullanılamıyor. Aracılar bu node’u kullanılabilir bir Chrome ana makinesi olarak değil, tanılama durumu olarak ele almalı ve kullanıcı bunu istemedikçe başka bir taşıma yöntemine geri düşmek yerine kurulum engelini bildirmelidir.No connected Google Meet-capable node: VM içindeopenclaw node runbaşlatın, eşleştirmeyi onaylayın ve VM içindeopenclaw plugins enable google-meetileopenclaw plugins enable browserkomutlarının çalıştırıldığından emin olun. Ayrıca Gateway ana makinesinin her iki node komutuna dagateway.nodes.allowCommands: ["googlemeet.chrome", "browser.proxy"]ile izin verdiğini doğrulayın.BlackHole 2ch audio device not found: denetlenen ana makineyeblackhole-2chyükleyin ve yerel Chrome sesi kullanmadan önce yeniden başlatın.BlackHole 2ch audio device not found on the node: VM içineblackhole-2chyükleyin ve VM’i yeniden başlatın.- Chrome açılıyor ancak katılamıyorsa: VM içindeki tarayıcı profiline oturum açın
veya konuk katılımı için
chrome.guestNamedeğerini ayarlı tutun. Konuk otomatik katılımı, node tarayıcı proxy’si üzerinden OpenClaw tarayıcı otomasyonunu kullanır; node tarayıcı yapılandırmasının istediğiniz profile işaret ettiğinden emin olun, örneğinbrowser.defaultProfile: "user"veya adlandırılmış bir mevcut oturum profili. - Yinelenen Meet sekmeleri:
chrome.reuseExistingTab: trueetkin kalsın. OpenClaw yeni bir sekme açmadan önce aynı Meet URL’si için var olan sekmeyi etkinleştirir ve tarayıcıyla toplantı oluşturma, başka bir sekme açmadan önce devam eden birhttps://meet.google.com/newveya Google hesabı istem sekmesini yeniden kullanır. - Ses yok: Meet içinde mikrofon/hoparlör sesini OpenClaw tarafından kullanılan sanal ses aygıtı yolundan yönlendirin; temiz çift yönlü ses için ayrı sanal aygıtlar veya Loopback tarzı yönlendirme kullanın.
Kurulum notları
Chrome geri konuşma varsayılanı iki harici araç kullanır: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ı kullanır.blackhole-2ch: macOS sanal ses sürücüsü. Chrome/Meet’in üzerinden yönlendirme yapabileceğiBlackHole 2chses aygıtını oluşturur.
LGPL-2.0-only AND GPL-2.0-only; BlackHole ise GPL-3.0
lisanslıdır. BlackHole’u OpenClaw ile birlikte paketleyen bir yükleyici veya cihaz
oluşturuyorsanız, BlackHole’un upstream lisans koşullarını inceleyin veya Existential
Audio’dan ayrı bir lisans alın.
Taşımalar
Chrome
Chrome taşıması Meet URL’sini OpenClaw tarayıcı denetimi üzerinden açar ve oturum açmış OpenClaw tarayıcı profili olarak katılır. macOS üzerinde Plugin, başlatmadan önceBlackHole 2ch denetimi yapar. Yapılandırılmışsa, Chrome’u açmadan önce bir
ses köprüsü sağlık komutu ve başlangıç komutu da çalıştırır. Chrome/ses Gateway
ana makinesinde çalışıyorsa chrome; Chrome/ses Parallels macOS VM gibi eşleştirilmiş
bir node üzerinde çalışıyorsa chrome-node kullanın. Yerel Chrome için profili
browser.defaultProfile ile seçin; chrome.browserProfile, chrome-node ana
makinelerine geçirilir.
BlackHole 2ch yüklü değilse, katılım ses yolu olmadan sessizce katılmak yerine bir
kurulum hatasıyla başarısız olur.
Twilio
Twilio taşıması, Voice Call plugin’e devredilen katı bir arama planıdır. Telefon numaraları için Meet sayfalarını ayrıştırmaz. Bunu Chrome katılımı kullanılamadığında veya telefonla arama yedeği istediğinizde kullanın. Google Meet, toplantı için telefonla arama numarası ve PIN göstermelidir; OpenClaw bunları Meet sayfasından keşfetmez. Voice Call plugin’i Chrome node üzerinde değil, Gateway ana makinesinde etkinleştirin:openclaw.json dışında tutar:
OPENAI_API_KEY ile realtime.provider: "openai" kullanın.
voice-call etkinleştirildikten sonra Gateway’i yeniden başlatın veya yeniden
yükleyin; Plugin yapılandırma değişiklikleri, yeniden yüklenene kadar zaten çalışan
bir Gateway sürecinde görünmez.
Ardından doğrulayın:
googlemeet setup başarılı twilio-voice-call-plugin,
twilio-voice-call-credentials ve twilio-voice-call-webhook denetimlerini içerir.
--dtmf-sequence kullanın:
OAuth ve ön denetim
OAuth, Meet bağlantısı oluşturmak için isteğe bağlıdır çünkügooglemeet create
tarayıcı otomasyonuna geri düşebilir. Resmi API ile oluşturma, alan çözümleme veya
Meet Media API ön denetimleri istediğinizde OAuth yapılandırın.
Google Meet API erişimi kullanıcı OAuth kullanır: bir Google Cloud OAuth istemcisi
oluşturun, gerekli kapsamları isteyin, bir Google hesabını yetkilendirin, ardından
ortaya çıkan yenileme belirtecini Google Meet plugin yapılandırmasında saklayın veya
OPENCLAW_GOOGLE_MEET_* ortam değişkenlerini sağlayın.
OAuth, Chrome katılım yolunun yerini almaz. Chrome ve Chrome-node taşımaları,
tarayıcı katılımı kullandığınızda hâlâ oturum açmış bir Chrome profili, BlackHole/SoX
ve bağlı bir node üzerinden katılır. OAuth yalnızca resmi Google Meet API yolu içindir:
toplantı alanları oluşturma, alanları çözümleme ve Meet Media API ön denetimlerini
çalıştırma.
Google kimlik bilgilerini oluşturun
Google Cloud Console içinde:- Bir Google Cloud projesi oluşturun veya seçin.
- Bu proje için Google Meet REST API özelliğini etkinleştirin.
-
OAuth izin ekranını yapılandırın.
- Bir Google Workspace kuruluşu için Internal en basit seçenektir.
- External kişisel/test kurulumları için çalışır; uygulama Testing durumundayken, uygulamayı yetkilendirecek her Google hesabını test kullanıcısı olarak ekleyin.
-
OpenClaw’ın istediği kapsamları ekleyin:
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
-
Bir OAuth istemci kimliği oluşturun.
- Uygulama türü: Web application.
-
Yetkili yönlendirme URI’si:
- İstemci kimliğini ve istemci gizli anahtarını kopyalayın.
meetings.space.created, Google Meet spaces.create tarafından gereklidir.
meetings.space.readonly, OpenClaw’ın Meet URL’lerini/kodlarını alanlara çözmesine
izin verir. meetings.space.settings, OpenClaw’ın API oda oluşturma sırasında
accessType gibi SpaceConfig ayarlarını geçirmesine izin verir.
meetings.conference.media.readonly, Meet Media API ön denetimi ve medya çalışması
içindir; Google gerçek Media API kullanımı için Developer Preview kaydı gerektirebilir.
Yalnızca tarayıcı tabanlı Chrome katılımlarına ihtiyacınız varsa OAuth’u tamamen
atlayın.
Yenileme belirtecini üretin
oauth.clientId ve isteğe bağlı olarak oauth.clientSecret yapılandırın ya da bunları
ortam değişkenleri olarak geçirin, ardından şunu çalıştırın:
oauth yapılandırma bloğu yazdırır. PKCE,
http://localhost:8085/oauth2callback üzerinde localhost geri çağrısı ve --manual
ile manuel kopyala/yapıştır akışı kullanır.
Örnekler:
oauth nesnesini Google Meet plugin yapılandırmasının altında saklayın:
meetings.space.created kapsamına sahip olması için
openclaw googlemeet auth login --json komutunu yeniden çalıştırın.
OAuth’u doctor ile doğrulayın
Hızlı, gizli bilgi içermeyen bir sağlık denetimi istediğinizde OAuth doctor çalıştırın:ok, configured, tokenSource,
expiresAt ve denetim mesajları gibi durum alanlarını içerir; erişim belirtecini,
yenileme belirtecini veya istemci gizli anahtarını yazdırmaz.
Yaygın sonuçlar:
| Kontrol | Anlam |
|---|---|
oauth-config | oauth.clientId ile oauth.refreshToken veya önbelleğe alınmış bir erişim token’ı mevcut. |
oauth-token | Önbelleğe alınmış erişim token’ı hâlâ geçerli veya yenileme token’ı yeni bir erişim token’ı üretti. |
meet-spaces-get | İsteğe bağlı --meeting kontrolü mevcut bir Meet alanını çözdü. |
meet-spaces-create | İsteğe bağlı --create-space kontrolü yeni bir Meet alanı oluşturdu. |
spaces.create kapsamını da kanıtlamak
için yan etkili oluşturma kontrolünü çalıştırın:
--create-space kullan-at bir Meet URL’si oluşturur. Google Cloud projesinde
Meet API’nin etkin olduğunu ve yetkilendirilmiş hesabın
meetings.space.created kapsamına sahip olduğunu doğrulamanız gerektiğinde
bunu kullanın.
Mevcut bir toplantı alanı için okuma erişimini kanıtlamak üzere:
doctor --oauth --meeting ve resolve-space, yetkilendirilmiş Google hesabının
erişebildiği mevcut bir alana okuma erişimini kanıtlar. Bu kontrollerden gelen
bir 403 genellikle Google Meet REST API’nin devre dışı olduğu, onaylanmış
yenileme token’ında gerekli kapsamın eksik olduğu veya Google hesabının o Meet
alanına 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 saklamanız gerektiği anlamına gelir.
Tarayıcı yedeği için OAuth kimlik bilgileri gerekmez. Bu modda Google kimlik
doğrulaması OpenClaw yapılandırmasından değil, seçili node’da oturum açılmış
Chrome profilinden gelir.
Bu ortam değişkenleri yedek olarak kabul edilir:
OPENCLAW_GOOGLE_MEET_CLIENT_IDveyaGOOGLE_MEET_CLIENT_IDOPENCLAW_GOOGLE_MEET_CLIENT_SECRETveyaGOOGLE_MEET_CLIENT_SECRETOPENCLAW_GOOGLE_MEET_REFRESH_TOKENveyaGOOGLE_MEET_REFRESH_TOKENOPENCLAW_GOOGLE_MEET_ACCESS_TOKENveyaGOOGLE_MEET_ACCESS_TOKENOPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_ATveyaGOOGLE_MEET_ACCESS_TOKEN_EXPIRES_ATOPENCLAW_GOOGLE_MEET_DEFAULT_MEETINGveyaGOOGLE_MEET_DEFAULT_MEETINGOPENCLAW_GOOGLE_MEET_PREVIEW_ACKveyaGOOGLE_MEET_PREVIEW_ACK
spaces/{id} değerini spaces.get üzerinden
çözün:
--meeting ile artifacts ve attendance varsayılan olarak en son konferans
kaydını kullanır. O toplantı için saklanan her kaydı istediğinizde
--all-conference-records geçirin.
Takvim araması, Meet yapıtlarını okumadan önce toplantı URL’sini Google
Calendar’dan çözebilir:
--today, Google Meet bağlantısı olan bir Calendar etkinliği için bugünün
primary takviminde arama yapar. Eşleşen etkinlik metnini aramak için
--event <query>, birincil olmayan bir takvim için --calendar <id> kullanın.
Takvim araması, Calendar events readonly kapsamını içeren yeni bir OAuth oturumu
gerektirir. calendar-events, eşleşen Meet etkinliklerini önizler ve latest,
artifacts, attendance veya export tarafından seçilecek etkinliği işaretler.
Konferans kaydı kimliğini zaten biliyorsanız, doğrudan adresleyin:
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. OpenClaw bir Meet URL’si, toplantı kodu veya spaces/{id}
girdisini kabul eder ve aktif konferansı sonlandırmadan önce bunu API alan
kaynağına çözer. Bu, googlemeet leave komutundan ayrıdır: leave OpenClaw’ın
yerel/oturum katılımını durdururken, end-active-conference Google Meet’ten o
alanın aktif konferansını sonlandırmasını ister.
Okunabilir bir rapor yazın:
artifacts, Google toplantı için 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 kaynak meta verilerini döndürür. Büyük toplantılarda girdi aramasını
atlamak için --no-transcript-entries kullanın. attendance, katılımcıları
ilk/son görülme zamanları, toplam oturum süresi, geç/erken ayrılma bayrakları ve
oturum açmış kullanıcıya veya görünen ada göre birleştirilmiş yinelenen
katılımcı kaynaklarıyla katılımcı oturumu satırlarına genişletir. Ham katılımcı
kaynaklarını ayrı tutmak için --no-merge-duplicates, geç algılamayı ayarlamak
için --late-after-minutes ve erken ayrılma algılamasını ayarlamak için
--early-before-minutes geçirin.
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ımları, token kaynağını, kullanıldıysa Calendar etkinliğini ve
kısmi alma uyarılarını kaydeder. Klasörün yanına taşınabilir bir arşiv de yazmak
için --zip geçirin. Bağlantılı transkript ve akıllı not Google Docs metnini
Google Drive files.export üzerinden dışa aktarmak için --include-doc-bodies
geçirin; bu, Drive Meet readonly kapsamını içeren yeni bir OAuth oturumu
gerektirir. --include-doc-bodies olmadan dışa aktarımlar yalnızca Meet meta
verilerini ve yapılandırılmış transkript girdilerini içerir. Google akıllı not
listeleme, transkript girdisi veya Drive belge gövdesi hatası gibi kısmi bir
yapıt hatası döndürürse, özet ve manifest tüm dışa aktarımı başarısız yapmak
yerine uyarıyı korur. Klasörü veya ZIP’i oluşturmadan aynı yapıt/katılım
verilerini almak ve manifest JSON’unu yazdırmak için --dry-run kullanın. Bu,
büyük bir dışa aktarma yazmadan önce veya bir agent yalnızca sayımlara, seçilen
kayıtlara ve uyarılara ihtiyaç duyduğunda kullanışlıdır.
Agent’lar aynı paketi google_meet aracı üzerinden de oluşturabilir:
"dryRun": true ayarlayın.
Agent’lar açık erişim politikasıyla API destekli bir oda da oluşturabilir:
test_listen kullanmalıdır:
OPENCLAW_LIVE_TEST=1korunan canlı testleri etkinleştirir.OPENCLAW_GOOGLE_MEET_LIVE_MEETINGsaklanmış bir Meet URL’sini, kodunu veyaspaces/{id}değerini gösterir.OPENCLAW_GOOGLE_MEET_CLIENT_IDveyaGOOGLE_MEET_CLIENT_IDOAuth istemci kimliğini sağlar.OPENCLAW_GOOGLE_MEET_REFRESH_TOKENveyaGOOGLE_MEET_REFRESH_TOKENyenileme token’ını sağlar.- İsteğe bağlı:
OPENCLAW_GOOGLE_MEET_CLIENT_SECRET,OPENCLAW_GOOGLE_MEET_ACCESS_TOKENveOPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT,OPENCLAW_öneki olmadan aynı yedek adları kullanır.
https://www.googleapis.com/auth/meetings.space.readonly ve
https://www.googleapis.com/auth/meetings.conference.media.readonly gerektirir.
Takvim araması https://www.googleapis.com/auth/calendar.events.readonly
gerektirir. Drive belge gövdesi dışa aktarma
https://www.googleapis.com/auth/drive.meet.readonly gerektirir.
Yeni bir Meet alanı oluşturun:
meeting uri değerini, kaynağı ve katılım oturumunu yazdırır. OAuth
kimlik bilgileriyle resmi Google Meet API’yi kullanır. OAuth kimlik bilgileri
olmadan, yedek olarak sabitlenmiş Chrome node’unun oturum açılmış tarayıcı
profilini kullanır. Agent’lar tek adımda oluşturmak ve katılmak için
action: "create" ile google_meet aracını kullanabilir. Yalnızca URL
oluşturma için "join": false geçirin.
Tarayıcı yedeğinden örnek JSON çıktısı:
google_meet aracı düz bir dize yerine yapılandırılmış ayrıntılar döndürür:
manualActionRequired: true gördüğünde, manualActionMessage ile
tarayıcı node/sekme bağlamını bildirmeli ve operatör tarayıcı adımını
tamamlayana kadar yeni Meet sekmeleri açmayı durdurmalıdır.
API oluşturma işleminden örnek JSON çıktısı:
manualActionRequired: true
veya bir tarayıcı geri dönüş hatası bildirir ve operatörden yeniden denemeden önce
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 kaydedildiğini doğruladıktan sonra ayarlayın.
Yapılandırma
Ortak Chrome ajan yolu yalnızca Plugin’in etkinleştirilmesini, BlackHole’u, SoX’u, gerçek zamanlı bir yazıya döküm sağlayıcısı anahtarını ve yapılandırılmış bir OpenClaw TTS sağlayıcısını gerektirir. OpenAI varsayılan yazıya döküm sağlayıcısıdır; varsayılan ajan modu yazıya döküm sağlayıcısını değiştirmedenbidi modu için
Google Gemini Live kullanmak üzere realtime.voiceProvider değerini "google" ve
realtime.model değerini ayarlayın:
plugins.entries.google-meet.config altında ayarlayın:
defaultTransport: "chrome"defaultMode: "agent"("realtime"yalnızca"agent"için eski uyumluluk takma adı olarak kabul edilir; yeni araç çağrıları"agent"demelidir)chromeNode.node:chrome-nodeiçin isteğe bağlı node kimliği/adı/IP’sichrome.audioBackend: "blackhole-2ch"chrome.guestName: "OpenClaw Agent": oturum açılmamış Meet konuk ekranında kullanılan adchrome.autoJoin: true:chrome-nodeüzerinde OpenClaw tarayıcı otomasyonu aracılığıyla en iyi çabayla konuk adı doldurma ve Şimdi Katıl tıklamasıchrome.reuseExistingTab: true: yinelenen sekmeler açmak yerine mevcut bir Meet sekmesini etkinleştirirchrome.waitForInCallMs: 20000: konuşarak yanıt girişinin tetiklenmesinden önce Meet sekmesinin çağrı içinde olduğunu bildirmesini beklerchrome.audioFormat: "pcm16-24khz": komut çifti ses biçimi."g711-ulaw-8khz"değerini yalnızca hâlâ telefon sesi yayan eski/özel komut çiftleri için kullanın.chrome.audioBufferBytes: 4096: oluşturulan Chrome komut çifti ses komutları için SoX işleme arabelleği. Bu, SoX’un varsayılan 8192 baytlık arabelleğinin yarısıdır; yoğun ana makinelerde artırmaya alan bırakırken varsayılan boru gecikmesini azaltır. SoX’un minimumunun altındaki değerler 17 bayta sabitlenir.chrome.audioInputCommand: CoreAudioBlackHole 2chüzerinden okuyan ve sesichrome.audioFormatbiçiminde yazan SoX komutuchrome.audioOutputCommand: sesichrome.audioFormatbiçiminde okuyan ve CoreAudioBlackHole 2chhedefine yazan SoX komutuchrome.bargeInInputCommand: asistan oynatımı etkinken insan araya girme algılaması için işaretli 16 bit little-endian mono PCM yazan isteğe bağlı yerel mikrofon komutu. Bu şu anda Gateway üzerinde barındırılanchromekomut çifti köprüsüne uygulanır.chrome.bargeInRmsThreshold: 650:chrome.bargeInInputCommandüzerinde insan kesintisi sayılan RMS düzeyichrome.bargeInPeakThreshold: 2500:chrome.bargeInInputCommandüzerinde insan kesintisi sayılan tepe düzeyichrome.bargeInCooldownMs: 900: yinelenen insan kesintisi temizlemeleri arasındaki minimum gecikmemode: "agent": varsayılan konuşarak yanıt modu. Katılımcı konuşması yapılandırılmış gerçek zamanlı yazıya döküm sağlayıcısı tarafından yazıya dökülür, toplantı başına alt ajan oturumunda yapılandırılmış OpenClaw ajanına gönderilir ve normal OpenClaw TTS çalışma zamanı üzerinden seslendirilir.mode: "bidi": geri dönüş doğrudan çift yönlü gerçek zamanlı model modu. Gerçek zamanlı ses sağlayıcısı katılımcı konuşmasını doğrudan yanıtlar ve daha derin/araç destekli yanıtlar içinopenclaw_agent_consultçağırabilir.mode: "transcribe": konuşarak yanıt köprüsü olmayan yalnızca gözlem modu.realtime.provider: "openai": aşağıdaki kapsamlı sağlayıcı alanları ayarlanmamışsa kullanılan uyumluluk geri dönüşü.realtime.transcriptionProvider: "openai":agentmodu tarafından gerçek zamanlı yazıya döküm için kullanılan sağlayıcı kimliği.realtime.voiceProvider:bidimodu tarafından doğrudan gerçek zamanlı ses için kullanılan sağlayıcı kimliği. Ajan modu yazıya dökümünü OpenAI üzerinde tutarken Gemini Live kullanmak için bunu"google"olarak ayarlayın.realtime.toolPolicy: "safe-read-only"realtime.instructions: daha derin yanıtlar içinopenclaw_agent_consultile kısa sözlü yanıtlarrealtime.introMessage: gerçek zamanlı köprü bağlandığında kısa sözlü hazır olma denetimi; sessiz katılmak için bunu""olarak ayarlayınrealtime.agentId:openclaw_agent_consultiçin isteğe bağlı OpenClaw ajan kimliği; varsayılanımain
messages.tts.providers.elevenlabs.speakerVoiceId değerinden
gelir. TTS model geçersiz kılmaları etkinse ajan yanıtları yanıt başına
[[tts:speakerVoiceId=... model=eleven_v3]] yönergelerini de kullanabilir, ancak
toplantılar için belirleyici varsayılan yapılandırmadır. Katılım sırasında günlükler
transcriptionProvider=elevenlabs göstermeli ve her sözlü yanıt
provider=elevenlabs model=eleven_v3 speakerVoiceId=<voiceId> günlüğünü yazmalıdır.
Yalnızca Twilio yapılandırması:
voiceCall.enabled varsayılan olarak true olur; Twilio taşımasıyla gerçek PSTN
çağrısını, DTMF’yi ve giriş selamlamasını Voice Call Plugin’e devreder. Voice Call,
gerçek zamanlı medya akışını açmadan önce DTMF dizisini oynatır, ardından kaydedilen
giriş metnini ilk gerçek zamanlı selamlama olarak kullanır. voice-call etkin
değilse Google Meet yine de arama planını doğrulayabilir ve kaydedebilir, ancak
Twilio çağrısını gerçekleştiremez.
Araç
Ajanlargoogle_meet aracını kullanabilir:
transport: "chrome" kullanın. Chrome,
Parallels VM gibi 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, bu nedenle model kimlik
bilgileri orada kalır. Varsayılan mode: "agent" ile gerçek zamanlı yazıya döküm
sağlayıcısı dinlemeyi yürütür, yapılandırılmış OpenClaw ajanı yanıtı üretir ve
normal OpenClaw TTS bunu Meet içine seslendirir. Gerçek zamanlı ses modelinin
doğrudan yanıtlamasını istediğinizde mode: "bidi" kullanın. Ham
mode: "realtime" değeri mode: "agent" için eski uyumluluk takma adı olarak
kabul edilmeye devam eder, ancak artık ajan araç şemasında duyurulmaz. Ajan modu
günlükleri, köprü başlangıcında çözümlenen yazıya döküm sağlayıcısını/modelini ve
her sentezlenmiş yanıttan sonra TTS sağlayıcısını, modelini, sesini, çıktı biçimini
ve örnekleme hızını içerir.
Etkin oturumları listelemek veya bir oturum kimliğini incelemek için
action: "status" kullanın. Gerçek zamanlı ajanın hemen konuşmasını sağlamak için
sessionId ve message ile action: "speak" kullanın. Oturumu oluşturmak veya
yeniden kullanmak, bilinen bir ifadeyi tetiklemek ve Chrome ana makinesi bunu
bildirebildiğinde inCall sağlığını döndürmek için action: "test_speech" kullanın.
test_speech her zaman mode: "agent" değerini zorlar ve mode: "transcribe"
içinde çalıştırılması istenirse başarısız olur; çünkü yalnızca gözlem oturumları
bilerek konuşma yayamaz. speechOutputVerified sonucu, bu test çağrısı sırasında
gerçek zamanlı ses çıkışı baytlarının artmasına dayanır; bu nedenle eski sesi olan
yeniden kullanılan bir oturum yeni başarılı konuşma denetimi sayılmaz. Bir oturumu
sonlandı olarak işaretlemek için action: "leave" kullanın.
status, mevcut olduğunda Chrome sağlığını içerir:
inCall: Chrome Meet çağrısının içinde görünüyormicMuted: en iyi çabayla Meet mikrofon durumumanualActionRequired/manualActionReason/manualActionMessage: konuşmanın çalışabilmesi için tarayıcı profilinin manuel oturum açmaya, Meet sahibi kabulüne, izinlere veya tarayıcı denetimi onarımına ihtiyacı varspeechReady/speechBlockedReason/speechBlockedMessage: yönetilen Chrome konuşmasına şu anda izin verilip verilmediği.speechReady: false, OpenClaw’ın giriş/test ifadesini ses köprüsüne göndermediği anlamına gelir.providerConnected/realtimeReady: gerçek zamanlı ses köprüsü durumulastInputAt/lastOutputAt: köprüden görülen veya köprüye gönderilen son sesaudioOutputRouted/audioOutputDeviceLabel: Meet sekmesinin medya çıkışının köprü tarafından kullanılan BlackHole aygıtına etkin şekilde yönlendirilip yönlendirilmediğilastSuppressedInputAt/suppressedInputBytes: asistan oynatımı etkinken yok sayılan local loopback girişi
Ajan ve bidi modları
Chromeagent modu, “ajanım toplantıda” davranışı için optimize edilmiştir.
Gerçek zamanlı yazıya döküm sağlayıcısı toplantı sesini duyar, son katılımcı
dökümleri yapılandırılmış OpenClaw ajanı üzerinden yönlendirilir ve yanıt normal
OpenClaw TTS çalışma zamanı üzerinden seslendirilir. Gerçek zamanlı ses modelinin
doğrudan yanıtlamasını istediğinizde mode: "bidi" ayarlayın. Bir sözlü turun
birkaç eski kısmi yanıt üretmemesi için yakındaki nihai döküm parçaları danışmadan
önce birleştirilir. Gerçek zamanlı giriş, sıradaki asistan sesi hâlâ oynatılırken
de bastırılır ve BlackHole local loopback’inin ajanın kendi konuşmasına yanıt
vermesine neden olmaması için son asistan benzeri döküm yankıları ajan danışmasından
önce yok sayılır.
| Mod | Yanıta kim karar verir | Konuşma çıkışı yolu | Ne zaman kullanılır |
|---|---|---|---|
agent | Yapılandırılmış OpenClaw ajanı | Normal OpenClaw TTS çalışma zamanı | ”Ajanım toplantıda” davranışı istediğinizde |
bidi | Gerçek zamanlı ses modeli | Gerçek zamanlı ses sağlayıcı yanıtı | En düşük gecikmeli konuşma ses döngüsünü istediğinizde |
bidi modunda, gerçek zamanlı model daha derin akıl yürütmeye, güncel bilgilere
veya normal OpenClaw araçlarına ihtiyaç duyduğunda openclaw_agent_consult
çağırabilir.
Consult aracı, sahne arkasında düzenli OpenClaw agent’ını son toplantı dökümü bağlamıyla çalıştırır ve kısa, sözlü bir yanıt döndürür. agent modunda OpenClaw bu yanıtı doğrudan TTS runtime’ına gönderir; bidi modunda gerçek zamanlı ses modeli consult sonucunu toplantıya geri seslendirebilir. Voice Call ile aynı paylaşılan consult mekanizmasını kullanır.
Varsayılan olarak consult’lar main agent’ına karşı çalışır. Bir Meet hattının özel bir OpenClaw agent çalışma alanına, model varsayılanlarına, araç ilkesine, belleğe ve oturum geçmişine danışması gerekiyorsa realtime.agentId ayarlayın.
Agent modundaki consult’lar, takip sorularının yapılandırılan agent’tan normal agent ilkesini devralırken toplantı bağlamını koruması için toplantı başına agent:<id>:subagent:google-meet:<session> oturum anahtarı kullanır.
realtime.toolPolicy, consult çalıştırmasını denetler:
safe-read-only: consult aracını açığa çıkarın ve düzenli agent’ıread,web_search,web_fetch,x_search,memory_searchvememory_getile sınırlayın.owner: consult aracını açığa çıkarın ve düzenli agent’ın normal agent araç ilkesini kullanmasına izin verin.none: consult aracını gerçek zamanlı ses modeline açığa çıkarmayın.
Canlı test kontrol listesi
Bir toplantıyı gözetimsiz bir agent’a devretmeden önce şu sırayı kullanın:googlemeet setuptamamen yeşildir.- Chrome-node varsayılan aktarım olduğunda veya bir düğüm sabitlendiğinde
googlemeet setup,chrome-node-connectediçerir. nodes status, seçilen düğümün bağlı olduğunu gösterir.- Seçilen düğüm hem
googlemeet.chromehem debrowser.proxyduyurur. - Meet sekmesi çağrıya katılır ve
test-speech,inCall: trueile Chrome sağlık durumunu döndürür.
googlemeet setup, yeşiltwilio-voice-call-plugin,twilio-voice-call-credentialsvetwilio-voice-call-webhookdenetimlerini içerir.- Gateway yeniden yüklendikten sonra CLI’da
voicecallkullanılabilir. - Döndürülen oturumda
transport: "twilio"ve birtwilio.voiceCallIdbulunur. openclaw logs --follow, gerçek zamanlı TwiML’den önce DTMF TwiML’nin sunulduğunu, ardından ilk selamlamanın kuyruğa alındığı bir gerçek zamanlı köprüyü gösterir.googlemeet leave <sessionId>devredilmiş sesli çağrıyı kapatır.
Sorun giderme
Agent Google Meet aracını göremiyor
Plugin’in Gateway yapılandırmasında etkin olduğunu doğrulayın ve Gateway’i yeniden yükleyin:plugins.entries.google-meet değerini yeni düzenlediyseniz Gateway’i yeniden başlatın veya yeniden yükleyin. Çalışan agent yalnızca geçerli Gateway süreci tarafından kaydedilen Plugin araçlarını görür.
macOS olmayan Gateway ana makinelerinde, agent’a dönük google_meet aracı görünür kalır; ancak yerel Chrome konuşma-geri eylemleri ses köprüsüne ulaşmadan engellenir. Yerel Chrome konuşma-geri sesi şu anda macOS BlackHole 2ch bağımlıdır; bu nedenle Linux agent’ları varsayılan yerel Chrome agent yolu yerine mode: "transcribe", Twilio telefonla arama veya bir macOS chrome-node ana makinesi kullanmalıdır.
Bağlı Google Meet yetenekli düğüm yok
Düğüm ana makinesinde şunu çalıştırın:googlemeet.chrome ile browser.proxy listelemelidir. Gateway yapılandırması bu düğüm komutlarına izin vermelidir:
googlemeet setup, chrome-node-connected aşamasında başarısız olursa veya Gateway günlüğü gateway token mismatch bildirirse düğümü mevcut Gateway token ile yeniden yükleyin veya yeniden başlatın. Bir LAN Gateway için bu genellikle şu anlama gelir:
Tarayıcı açılıyor ancak agent katılamıyor
Yalnızca gözlem katılımları içingooglemeet test-listen veya gerçek zamanlı katılımlar için googlemeet test-speech çalıştırın, ardından döndürülen Chrome sağlık durumunu inceleyin. Herhangi bir yoklama 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 oturum açın.
- Konuğu Meet ana makine hesabından kabul edin.
- Chrome’un yerel izin istemi göründüğünde Chrome mikrofon/kamera izinlerini verin.
- Takılı kalmış bir Meet izin iletişim kutusunu kapatın veya onarın.
Toplantı oluşturma başarısız oluyor
googlemeet create, OAuth kimlik bilgileri yapılandırıldığında önce Google Meet API spaces.create uç noktasını kullanır. OAuth kimlik bilgileri olmadan sabitlenmiş Chrome düğümü tarayıcısına fallback yapar. Şunları doğrulayın:
- API oluşturma için:
oauth.clientIdveoauth.refreshTokenyapılandırılmıştır veya eşleşenOPENCLAW_GOOGLE_MEET_*ortam değişkenleri vardır. - API oluşturma için: yenileme token’ı oluşturma desteği eklendikten sonra üretilmiştir. Eski token’larda
meetings.space.createdkapsamı eksik olabilir;openclaw googlemeet auth login --jsonkomutunu yeniden çalıştırın ve Plugin yapılandırmasını güncelleyin. - Tarayıcı fallback’i için:
defaultTransport: "chrome-node"vechromeNode.node,browser.proxyvegooglemeet.chromeiçeren bağlı bir düğümü işaret eder. - Tarayıcı fallback’i için: o düğümdeki OpenClaw Chrome profili Google’da oturum açmıştır ve
https://meet.google.com/newaçabilir. - Tarayıcı fallback’i için: yeniden denemeler yeni bir sekme açmadan önce mevcut bir
https://meet.google.com/newveya Google hesabı istemi sekmesini yeniden kullanır. Bir agent zaman aşımına uğrarsa başka bir Meet sekmesini manuel olarak açmak yerine araç çağrısını yeniden deneyin. - Tarayıcı fallback’i için: araç
manualActionRequired: truedöndürürse operatörü yönlendirmek için döndürülenbrowser.nodeId,browser.targetId,browserUrlvemanualActionMessagedeğerlerini kullanın. Bu eylem tamamlanana kadar döngü içinde yeniden denemeyin. - Tarayıcı fallback’i için: Meet “Do you want people to hear you in the meeting?” gösterirse sekmeyi açık bırakın. OpenClaw, tarayıcı otomasyonu aracılığıyla Use microphone veya yalnızca oluşturma fallback’i için Continue without microphone seçeneğine tıklamalı ve oluşturulan Meet URL’sini beklemeye devam etmelidir. Bunu yapamazsa hata
google-login-requireddeğilmeet-audio-choice-requiredbelirtmelidir.
Agent katılıyor ancak konuşmuyor
Gerçek zamanlı yolu denetleyin:mode: "agent" veya doğrudan gerçek zamanlı ses fallback’i için mode: "bidi" kullanın. mode: "transcribe" bilinçli olarak konuşma-geri köprüsünü başlatmaz. Yalnızca gözlem hata ayıklaması için katılımcılar konuştuktan sonra openclaw googlemeet status --json <session-id> çalıştırın ve captioning, transcriptLines ve lastCaptionText değerlerini denetleyin. inCall true ise ancak transcriptLines 0 olarak kalıyorsa Meet altyazıları devre dışı olabilir, gözlemci yüklendiğinden beri kimse konuşmamış olabilir, Meet kullanıcı arayüzü değişmiş olabilir veya canlı altyazılar toplantı dili/hesabı için 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 false ve speechOutputTimedOut true ise gerçek zamanlı sağlayıcı ifadeyi kabul etmiş olabilir, ancak OpenClaw yeni çıkış baytlarının Chrome ses köprüsüne ulaştığını görmemiştir.
Ayrıca şunları doğrulayın:
- Gateway ana makinesinde
OPENAI_API_KEYveyaGEMINI_API_KEYgibi bir gerçek zamanlı sağlayıcı anahtarı kullanılabilir. BlackHole 2ch, Chrome ana makinesinde görünür.sox, Chrome ana makinesinde mevcuttur.- Meet mikrofonu ve hoparlörü OpenClaw tarafından kullanılan sanal ses yolundan yönlendirilir. Yerel Chrome gerçek zamanlı katılımları için
doctor,meet output routed: yesgöstermelidir.
googlemeet doctor [session-id]; oturumu, düğümü, çağrı içi durumunu, manuel eylem nedenini, gerçek zamanlı sağlayıcı bağlantısını, realtimeReady değerini, ses giriş/çıkış etkinliğini, son ses zaman damgalarını, bayt sayaçlarını ve tarayıcı URL’sini yazdırır. Ham JSON gerektiğinde googlemeet status [session-id] --json kullanın. Token’ları açığa çıkarmadan Google Meet OAuth yenilemesini doğrulamanız gerektiğinde googlemeet doctor --oauth kullanın; ayrıca Google Meet API kanıtı gerektiğinde --meeting veya --create-space ekleyin.
Bir agent zaman aşımına uğradıysa ve zaten açık bir Meet sekmesi görebiliyorsanız, başka bir sekme açmadan o sekmeyi inceleyin:
recover_current_tab değeridir. Seçilen aktarım için mevcut bir Meet sekmesine odaklanır ve onu inceler. chrome ile Gateway üzerinden yerel tarayıcı denetimini kullanır; chrome-node ile yapılandırılan Chrome düğümünü kullanır. Yeni sekme açmaz veya yeni oturum oluşturmaz; oturum açma, kabul, izinler veya ses seçimi durumu gibi mevcut engelleyiciyi bildirir. CLI komutu yapılandırılmış Gateway ile konuşur, bu nedenle Gateway çalışıyor olmalıdır; chrome-node ayrıca Chrome düğümünün bağlı olmasını gerektirir.
Twilio kurulum denetimleri başarısız oluyor
voice-call izinli veya etkin olmadığında twilio-voice-call-plugin başarısız olur. Bunu plugins.allow içine ekleyin, plugins.entries.voice-call etkinleştirin ve Gateway’i yeniden yükleyin.
Twilio arka ucunda hesap SID’si, auth token’ı veya arayan numara eksik olduğunda twilio-voice-call-credentials başarısız olur. Bunları Gateway ana makinesinde ayarlayın:
voice-call için herkese açık Webhook erişimi olmadığında veya publicUrl loopback ya da özel ağ alanını işaret ettiğinde twilio-voice-call-webhook başarısız olur. plugins.entries.voice-call.config.publicUrl değerini herkese açık sağlayıcı URL’sine ayarlayın veya bir voice-call tüneli/Tailscale erişimi yapılandırın.
Loopback ve özel URL’ler operatör callback’leri için geçerli değildir. publicUrl olarak 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 kullanmayın.
Kararlı bir herkese açık URL için:
voicecall smoke varsayılan olarak yalnızca hazırlık denetimidir. Belirli bir numara için deneme çalıştırması yapmak üzere:
--yes seçeneğini yalnızca bilerek canlı bir giden bildirim araması yapmak
istediğinizde ekleyin:
Twilio araması başlıyor ancak toplantıya hiç girmiyor
Meet etkinliğinin telefonla katılma ayrıntılarını sunduğunu doğrulayın. Tam telefonla katılma numarasını ve PIN’i veya özel bir DTMF dizisini geçirin:--dtmf-sequence içinde başta w
veya virgüller kullanın.
Telefon araması oluşturuluyor ancak Meet katılımcı listesi telefonla katılan
katılımcıyı hiç göstermiyorsa:
- Delege edilen Twilio arama kimliğini, DTMF’nin kuyruğa alınıp alınmadığını ve giriş selamlamasının istenip istenmediğini doğrulamak için
openclaw googlemeet doctor <session-id>çalıştırın. openclaw voicecall status --call-id <id>çalıştırın ve aramanın hâlâ etkin olduğunu doğrulayın.openclaw voicecall tailçalıştırın ve Twilio Webhook’larının Gateway’e ulaştığını kontrol edin.openclaw logs --followçalıştırın ve Twilio Meet dizisini arayın: Google Meet katılmayı delege eder, Voice Call bağlantı öncesi DTMF TwiML’yi depolar ve sunar, Voice Call Twilio araması için gerçek zamanlı TwiML sunar, ardından Google Meetvoicecall.speakile giriş konuşması ister.openclaw googlemeet setup --transport twiliokomutunu yeniden çalıştırın; yeşil kurulum denetimi gereklidir ancak toplantı PIN dizisinin doğru olduğunu kanıtlamaz.- Telefonla katılma numarasının PIN ile aynı Meet davetine ve bölgesine ait olduğunu doğrulayın.
- Meet yavaş yanıt veriyorsa veya arama transkripti bağlantı öncesi DTMF gönderildikten sonra bile
PIN isteyen istemi göstermeye devam ediyorsa
voiceCall.dtmfDelayMsdeğerini 12 saniyelik varsayılandan artırın. - Katılımcı katılıyor ancak selamlamayı duymuyorsanız, DTMF sonrası
voicecall.speakisteği ve medya akışı TTS oynatımı ya da Twilio<Say>yedeği içinopenclaw logs --followçıktısını kontrol edin. Arama transkripti hâlâ “enter the meeting PIN” içeriyorsa, telefon bacağı Meet odasına henüz katılmamıştır, bu nedenle toplantı katılımcıları konuşmayı duymayacaktır.
plugins.entries.voice-call.config.publicUrl adresine veya yapılandırılmış tünele
erişebilmesi gerekir.
Bkz. Sesli arama sorun giderme.
Notlar
Google Meet’in resmi medya API’si alma odaklıdır, bu nedenle bir Meet aramasında konuşmak hâlâ bir katılımcı yolu gerektirir. Bu Plugin bu sınırı görünür tutar: Chrome tarayıcı katılımını ve yerel ses yönlendirmesini yönetir; Twilio telefonla katılma katılımını yönetir. Chrome geri konuşma modlarıBlackHole 2ch ve ayrıca şunlardan birini gerektirir:
chrome.audioInputCommandilechrome.audioOutputCommand: OpenClaw köprüyü sahiplenir ve sesichrome.audioFormatiçinde bu komutlar ile seçilen sağlayıcı arasında borular. Agent modu gerçek zamanlı transkripsiyon ve normal TTS kullanır; bidi modu gerçek zamanlı ses sağlayıcısını kullanır. Varsayılan Chrome yolu,chrome.audioBufferBytes: 4096ile 24 kHz PCM16’dır; 8 kHz G.711 mu-law eski komut çiftleri için kullanılabilir kalır.chrome.audioBridgeCommand: harici bir köprü komutu tüm yerel ses yolunu sahiplenir ve daemon’unu başlattıktan veya doğruladıktan sonra çıkmalıdır. Bu yalnızcabidiiçin geçerlidir çünküagentmodu TTS için doğrudan komut çifti erişimine ihtiyaç duyar.
google_meet aracını çağırdığında, toplantı danışmanı
oturumu katılımcı konuşmasına yanıt vermeden önce çağıranın mevcut transkriptini çatallar. Meet oturumu yine de ayrı kalır (agent:<agentId>:subagent:google-meet:<sessionId>)
böylece toplantı takipleri çağıran transkriptini doğrudan değiştirmez.
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ı aramaya geri yankılayabilir.
Komut çifti Chrome köprüsüyle, chrome.bargeInInputCommand ayrı bir yerel mikrofonu dinleyebilir ve insan konuşmaya başladığında asistan oynatımını temizleyebilir. Bu, paylaşılan
BlackHole loopback girişi asistan oynatımı sırasında geçici olarak bastırılsa bile
insan konuşmasını asistan çıktısının önünde tutar.
chrome.audioInputCommand ve chrome.audioOutputCommand gibi, bu da
operatör tarafından yapılandırılmış yerel bir komuttur. Açık bir güvenilir komut yolu veya
bağımsız değişken listesi kullanın ve güvenilmeyen konumlardaki betiklere yönlendirmeyin.
googlemeet speak, bir Chrome oturumu için etkin geri konuşma ses köprüsünü tetikler.
googlemeet leave bu köprüyü durdurur. Voice Call plugin’i üzerinden delege edilen
Twilio oturumları için leave ayrıca alttaki sesli aramayı kapatır.
API tarafından yönetilen bir alan için etkin Google Meet konferansını da kapatmak istediğinizde
googlemeet end-active-conference kullanın.