English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Plugins

Plugin Google Meet

Dukungan peserta Google Meet untuk OpenClaw — Plugin ini eksplisit secara desain:

  • Plugin hanya bergabung ke URL https://meet.google.com/... yang eksplisit.
  • Plugin dapat membuat ruang Meet baru melalui Google Meet API, lalu bergabung ke URL yang dikembalikan.
  • agent adalah mode balasan bicara default: transkripsi realtime mendengarkan, agen OpenClaw yang dikonfigurasi menjawab, dan TTS OpenClaw reguler berbicara ke Meet.
  • bidi tetap tersedia sebagai mode fallback model suara realtime langsung.
  • Agen memilih perilaku bergabung dengan mode: gunakan agent untuk mendengar/berbalas bicara secara langsung, bidi untuk fallback suara realtime langsung, atau transcribe untuk bergabung/mengontrol browser tanpa jembatan balasan bicara.
  • Autentikasi dimulai sebagai Google OAuth pribadi atau profil Chrome yang sudah login.
  • Tidak ada pengumuman persetujuan otomatis.
  • Backend audio Chrome default adalah BlackHole 2ch.
  • Chrome dapat berjalan secara lokal atau pada host node yang dipasangkan.
  • Twilio menerima nomor dial-in plus PIN atau urutan DTMF opsional; Twilio tidak dapat menelepon URL Meet secara langsung.
  • Perintah CLI adalah googlemeet; meet dicadangkan untuk alur kerja telekonferensi agen yang lebih luas.

Mulai cepat

Instal dependensi audio lokal dan konfigurasikan penyedia transkripsi realtime plus TTS OpenClaw reguler. OpenAI adalah penyedia transkripsi default; Google Gemini Live juga berfungsi sebagai fallback suara bidi terpisah dengan realtime.voiceProvider: "google":

brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# hanya diperlukan ketika realtime.voiceProvider adalah "google" untuk mode bidi
export GEMINI_API_KEY=...

blackhole-2ch menginstal perangkat audio virtual BlackHole 2ch. Penginstal Homebrew memerlukan reboot sebelum macOS menampilkan perangkat tersebut:

sudo reboot

Setelah reboot, verifikasi kedua bagian:

system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

Aktifkan Plugin:

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

Periksa penyiapan:

openclaw googlemeet setup

Output penyiapan dimaksudkan agar dapat dibaca agen dan sadar mode. Output ini melaporkan profil Chrome, penguncian node, dan, untuk join Chrome realtime, jembatan audio BlackHole/SoX serta pemeriksaan intro realtime tertunda. Untuk join hanya-observasi, periksa transport yang sama dengan --mode transcribe; mode tersebut melewati prasyarat audio realtime karena tidak mendengarkan melalui atau berbicara melalui jembatan:

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

Ketika delegasi Twilio dikonfigurasi, penyiapan juga melaporkan apakah Plugin voice-call, kredensial Twilio, dan eksposur Webhook publik siap. Perlakukan setiap pemeriksaan ok: false sebagai pemblokir untuk transport dan mode yang diperiksa sebelum meminta agen bergabung. Gunakan openclaw googlemeet setup --json untuk skrip atau output yang dapat dibaca mesin. Gunakan --transport chrome, --transport chrome-node, atau --transport twilio untuk melakukan preflight transport tertentu sebelum agen mencobanya.

Untuk Twilio, selalu lakukan preflight transport secara eksplisit ketika transport default adalah Chrome:

openclaw googlemeet setup --transport twilio

Itu menangkap wiring voice-call yang hilang, kredensial Twilio, atau eksposur Webhook yang tidak dapat dijangkau sebelum agen mencoba menelepon rapat.

Bergabung ke rapat:

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

Atau biarkan agen bergabung melalui tool google_meet:

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

Tool google_meet yang menghadap agen tetap tersedia pada host non-macOS untuk alur artefak, kalender, penyiapan, transkripsi, Twilio, dan chrome-node. Aksi balasan bicara Chrome lokal diblokir di sana karena jalur audio Chrome bawaan saat ini bergantung pada BlackHole 2ch macOS. Di Linux, gunakan mode: "transcribe", dial-in Twilio, atau host chrome-node macOS untuk partisipasi balasan bicara Chrome.

Buat rapat baru dan bergabung ke dalamnya:

openclaw googlemeet create --transport chrome-node --mode agent

Untuk ruangan yang dibuat API, gunakan Google Meet SpaceConfig.accessType ketika Anda ingin kebijakan tanpa-ketuk ruangan dibuat eksplisit alih-alih diwarisi dari default akun Google:

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

OPEN memungkinkan siapa pun dengan URL Meet bergabung tanpa mengetuk. TRUSTED memungkinkan pengguna tepercaya organisasi host, pengguna eksternal yang diundang, dan pengguna dial-in bergabung tanpa mengetuk. RESTRICTED membatasi masuk tanpa-ketuk hanya untuk undangan. Pengaturan ini hanya berlaku untuk jalur pembuatan Google Meet API resmi, sehingga kredensial OAuth harus dikonfigurasi.

Jika Anda mengautentikasi Google Meet sebelum opsi ini tersedia, jalankan ulang openclaw googlemeet auth login --json setelah menambahkan cakupan meetings.space.settings ke layar persetujuan Google OAuth Anda.

Buat hanya URL tanpa bergabung:

openclaw googlemeet create --no-join

googlemeet create memiliki dua jalur:

  • Pembuatan API: digunakan ketika kredensial Google Meet OAuth dikonfigurasi. Ini adalah jalur paling deterministik dan tidak bergantung pada status UI browser.
  • Fallback browser: digunakan ketika kredensial OAuth tidak ada. OpenClaw menggunakan node Chrome yang dikunci, membuka https://meet.google.com/new, menunggu Google mengalihkan ke URL kode rapat nyata, lalu mengembalikan URL tersebut. Jalur ini mengharuskan profil Chrome OpenClaw pada node sudah login ke Google. Otomasi browser menangani prompt mikrofon pertama kali milik Meet; prompt itu tidak diperlakukan sebagai kegagalan login Google. Alur join dan create juga mencoba menggunakan ulang tab Meet yang ada sebelum membuka tab baru. Pencocokan mengabaikan string kueri URL yang tidak berbahaya seperti authuser, sehingga percobaan ulang agen seharusnya memfokuskan rapat yang sudah terbuka alih-alih membuat tab Chrome kedua.

Output perintah/tool menyertakan kolom source (api atau browser) sehingga agen dapat menjelaskan jalur mana yang digunakan. create bergabung ke rapat baru secara default dan mengembalikan joined: true plus sesi join. Untuk hanya mencetak URL, gunakan create --no-join pada CLI atau teruskan "join": false ke tool.

Atau beri tahu agen: "Buat Google Meet, bergabunglah dengan mode balasan bicara agen, dan kirimkan tautannya kepada saya." Agen harus memanggil google_meet dengan action: "create" lalu membagikan meetingUri yang dikembalikan.

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

Untuk join hanya-observasi/kontrol-browser, tetapkan "mode": "transcribe". Itu tidak memulai jembatan suara realtime duplex, tidak memerlukan BlackHole atau SoX, dan tidak akan berbicara balik ke rapat. Join Chrome dalam mode ini juga menghindari pemberian izin mikrofon/kamera OpenClaw dan menghindari jalur Meet Use microphone. Jika Meet menampilkan interstisial pilihan audio, otomasi mencoba jalur tanpa-mikrofon dan jika tidak berhasil melaporkan aksi manual alih-alih membuka mikrofon lokal. Dalam mode transcribe, transport Chrome terkelola juga memasang observer caption Meet upaya-terbaik. googlemeet status --json dan googlemeet doctor menampilkan captioning, captionsEnabledAttempted, transcriptLines, lastCaptionAt, lastCaptionSpeaker, lastCaptionText, dan ekor pendek recentTranscript agar operator dapat mengetahui apakah browser bergabung ke panggilan dan apakah caption Meet menghasilkan teks. Gunakan openclaw googlemeet test-listen <meet-url> --transport chrome-node ketika Anda memerlukan probe ya/tidak: perintah ini bergabung dalam mode transcribe, menunggu caption segar atau pergerakan transkrip, dan mengembalikan listenVerified, listenTimedOut, kolom aksi manual, serta kesehatan caption terbaru.

Selama sesi realtime, status google_meet menyertakan kesehatan browser dan jembatan audio seperti inCall, manualActionRequired, providerConnected, realtimeReady, audioInputActive, audioOutputActive, timestamp input/output terakhir, penghitung byte, dan status jembatan ditutup. Jika prompt halaman Meet yang aman muncul, otomasi browser menanganinya ketika bisa. Login, penerimaan host, dan prompt izin browser/OS dilaporkan sebagai aksi manual dengan alasan dan pesan untuk disampaikan agen. Sesi Chrome terkelola hanya mengeluarkan intro atau frasa uji setelah kesehatan browser melaporkan inCall: true; jika tidak, status melaporkan speechReady: false dan upaya bicara diblokir alih-alih berpura-pura agen telah berbicara ke rapat.

Join Chrome lokal melalui profil browser OpenClaw yang sudah login. Mode realtime memerlukan BlackHole 2ch untuk jalur mikrofon/speaker yang digunakan OpenClaw. Untuk audio duplex yang bersih, gunakan perangkat virtual terpisah atau grafik bergaya Loopback; satu perangkat BlackHole cukup untuk smoke test pertama tetapi dapat menimbulkan echo.

Gateway lokal + Chrome Parallels

Anda tidak memerlukan Gateway OpenClaw penuh atau kunci API model di dalam VM macOS hanya untuk membuat VM memiliki Chrome. Jalankan Gateway dan agen secara lokal, lalu jalankan host node di VM. Aktifkan Plugin bawaan pada VM sekali agar node mengiklankan perintah Chrome:

Apa yang berjalan di mana:

  • Host Gateway: Gateway OpenClaw, workspace agen, kunci model/API, penyedia realtime, dan konfigurasi Plugin Google Meet.
  • VM macOS Parallels: OpenClaw CLI/host node, Google Chrome, SoX, BlackHole 2ch, dan profil Chrome yang sudah login ke Google.
  • Tidak diperlukan di VM: layanan Gateway, konfigurasi agen, kunci OpenAI/GPT, atau penyiapan penyedia model.

Instal dependensi VM:

brew install blackhole-2ch sox

Reboot VM setelah menginstal BlackHole agar macOS menampilkan BlackHole 2ch:

sudo reboot

Setelah reboot, verifikasi VM dapat melihat perangkat audio dan perintah SoX:

system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

Instal atau perbarui OpenClaw di VM, lalu aktifkan Plugin bawaan di sana:

openclaw plugins enable google-meet

Mulai host node di VM:

openclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos

Jika <gateway-host> adalah IP LAN dan Anda tidak menggunakan TLS, node menolak WebSocket plaintext kecuali Anda ikut serta untuk jaringan privat tepercaya itu:

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

Gunakan variabel lingkungan yang sama ketika menginstal node sebagai LaunchAgent:

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

OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 adalah lingkungan proses, bukan pengaturan openclaw.json. openclaw node install menyimpannya dalam lingkungan LaunchAgent ketika variabel tersebut ada pada perintah instalasi.

Setujui node dari host Gateway:

openclaw devices list
openclaw devices approve <requestId>

Konfirmasi Gateway melihat node dan bahwa node mengiklankan googlemeet.chrome serta kapabilitas browser/browser.proxy:

openclaw nodes status

Rutekan Meet melalui node tersebut pada host Gateway:

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

Sekarang bergabung seperti biasa dari host Gateway:

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

atau minta agen menggunakan tool google_meet dengan transport: "chrome-node".

Untuk smoke test satu perintah yang membuat atau menggunakan ulang sesi, mengucapkan frasa yang diketahui, dan mencetak kesehatan sesi:

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

Selama bergabung realtime, automasi browser OpenClaw mengisi nama tamu, mengeklik Gabung/Minta bergabung, dan menerima pilihan pertama kali "Gunakan mikrofon" dari Meet saat prompt tersebut muncul. Selama bergabung hanya-observasi atau pembuatan rapat khusus-browser, automasi melanjutkan melewati prompt yang sama tanpa mikrofon saat pilihan itu tersedia. Jika profil browser belum masuk, Meet sedang menunggu izin masuk dari host, Chrome membutuhkan izin mikrofon/kamera untuk bergabung realtime, atau Meet macet pada prompt yang tidak dapat diselesaikan automasi, hasil join/test-speech melaporkan manualActionRequired: true dengan manualActionReason dan manualActionMessage. Agen harus berhenti mencoba ulang proses bergabung, melaporkan pesan persis itu beserta browserUrl/browserTitle saat ini, dan mencoba ulang hanya setelah tindakan browser manual selesai.

Jika chromeNode.node dihilangkan, OpenClaw memilih otomatis hanya saat tepat satu node tersambung mengiklankan googlemeet.chrome sekaligus kontrol browser. Jika beberapa node yang mampu tersambung, atur chromeNode.node ke id node, nama tampilan, atau IP jarak jauh.

Pemeriksaan kegagalan umum:

  • Configured Google Meet node ... is not usable: offline: node yang dipin diketahui oleh Gateway tetapi tidak tersedia. Agen harus memperlakukan node itu sebagai status diagnostik, bukan sebagai host Chrome yang dapat digunakan, dan melaporkan penghalang penyiapan alih-alih beralih ke transport lain kecuali pengguna meminta itu.
  • No connected Google Meet-capable node: jalankan openclaw node run di VM, setujui pairing, dan pastikan openclaw plugins enable google-meet serta openclaw plugins enable browser dijalankan di VM. Konfirmasi juga bahwa host Gateway mengizinkan kedua perintah node dengan gateway.nodes.allowCommands: ["googlemeet.chrome", "browser.proxy"].
  • BlackHole 2ch audio device not found: instal blackhole-2ch pada host yang sedang diperiksa dan reboot sebelum menggunakan audio Chrome lokal.
  • BlackHole 2ch audio device not found on the node: instal blackhole-2ch di VM dan reboot VM.
  • Chrome terbuka tetapi tidak dapat bergabung: masuk ke profil browser di dalam VM, atau tetap atur chrome.guestName untuk bergabung sebagai tamu. Bergabung otomatis sebagai tamu menggunakan automasi browser OpenClaw melalui proxy browser node; pastikan konfigurasi browser node menunjuk ke profil yang Anda inginkan, misalnya browser.defaultProfile: "user" atau profil sesi-eksisting bernama.
  • Tab Meet duplikat: biarkan chrome.reuseExistingTab: true tetap aktif. OpenClaw mengaktifkan tab yang ada untuk URL Meet yang sama sebelum membuka yang baru, dan pembuatan rapat browser menggunakan ulang tab https://meet.google.com/new yang sedang berlangsung atau tab prompt akun Google sebelum membuka tab lain.
  • Tidak ada audio: di Meet, arahkan audio mikrofon/speaker melalui jalur perangkat audio virtual yang digunakan oleh OpenClaw; gunakan perangkat virtual terpisah atau routing bergaya Loopback untuk audio duplex yang bersih.

Catatan instalasi

Default talk-back Chrome menggunakan dua alat eksternal:

  • sox: utilitas audio baris perintah. Plugin menggunakan perintah perangkat CoreAudio eksplisit untuk bridge audio PCM16 24 kHz default.
  • blackhole-2ch: driver audio virtual macOS. Ini membuat perangkat audio BlackHole 2ch yang dapat dirutekan oleh Chrome/Meet.

OpenClaw tidak membundel atau mendistribusikan ulang salah satu paket tersebut. Dokumentasi meminta pengguna untuk menginstalnya sebagai dependensi host melalui Homebrew. SoX berlisensi LGPL-2.0-only AND GPL-2.0-only; BlackHole berlisensi GPL-3.0. Jika Anda membuat installer atau appliance yang membundel BlackHole dengan OpenClaw, tinjau ketentuan lisensi upstream BlackHole atau dapatkan lisensi terpisah dari Existential Audio.

Transport

Chrome

Transport Chrome membuka URL Meet melalui kontrol browser OpenClaw dan bergabung sebagai profil browser OpenClaw yang sudah masuk. Di macOS, Plugin memeriksa BlackHole 2ch sebelum peluncuran. Jika dikonfigurasi, Plugin juga menjalankan perintah kesehatan bridge audio dan perintah startup sebelum membuka Chrome. Gunakan chrome saat Chrome/audio berada di host Gateway; gunakan chrome-node saat Chrome/audio berada di node yang dipasangkan seperti VM Parallels macOS. Untuk Chrome lokal, pilih profil dengan browser.defaultProfile; chrome.browserProfile diteruskan ke host chrome-node.

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

Rutekan audio mikrofon dan speaker Chrome melalui bridge audio OpenClaw lokal. Jika BlackHole 2ch tidak terinstal, proses bergabung gagal dengan kesalahan penyiapan alih-alih bergabung diam-diam tanpa jalur audio.

Twilio

Transport Twilio adalah dial plan ketat yang didelegasikan ke Plugin Voice Call. Ini tidak mengurai halaman Meet untuk nomor telepon.

Gunakan ini saat partisipasi Chrome tidak tersedia atau Anda menginginkan fallback dial-in telepon. Google Meet harus menyediakan nomor dial-in telepon dan PIN untuk rapat; OpenClaw tidak menemukan itu dari halaman Meet.

Aktifkan Plugin Voice Call pada host Gateway, bukan pada node Chrome:

{
  plugins: {
    allow: ["google-meet", "voice-call", "google"],
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          // or set "twilio" if Twilio should be the default
        },
      },
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio",
          inboundPolicy: "allowlist",
          realtime: {
            enabled: true,
            provider: "google",
            instructions: "Join this Google Meet as an OpenClaw agent. Be brief.",
            toolPolicy: "safe-read-only",
            providers: {
              google: {
                silenceDurationMs: 500,
                startSensitivity: "high",
              },
            },
          },
        },
      },
      google: {
        enabled: true,
      },
    },
  },
}

Berikan kredensial Twilio melalui environment atau konfigurasi. Environment menjaga secret tetap berada di luar openclaw.json:

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

Gunakan realtime.provider: "openai" dengan Plugin penyedia OpenAI dan OPENAI_API_KEY sebagai gantinya jika itu adalah penyedia suara realtime Anda.

Mulai ulang atau muat ulang Gateway setelah mengaktifkan voice-call; perubahan konfigurasi Plugin tidak muncul dalam proses Gateway yang sudah berjalan sampai dimuat ulang.

Lalu verifikasi:

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

Saat delegasi Twilio terhubung, googlemeet setup menyertakan pemeriksaan twilio-voice-call-plugin, twilio-voice-call-credentials, dan twilio-voice-call-webhook yang berhasil.

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

Gunakan --dtmf-sequence saat rapat membutuhkan urutan kustom:

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

OAuth dan preflight

OAuth bersifat opsional untuk membuat tautan Meet karena googlemeet create dapat fallback ke automasi browser. Konfigurasikan OAuth saat Anda menginginkan pembuatan API resmi, resolusi space, atau pemeriksaan preflight Meet Media API.

Akses Google Meet API menggunakan OAuth pengguna: buat klien OAuth Google Cloud, minta scope yang diperlukan, otorisasi akun Google, lalu simpan refresh token yang dihasilkan di konfigurasi Plugin Google Meet atau sediakan variabel environment OPENCLAW_GOOGLE_MEET_*.

OAuth tidak menggantikan jalur bergabung Chrome. Transport Chrome dan Chrome-node tetap bergabung melalui profil Chrome yang sudah masuk, BlackHole/SoX, dan node yang tersambung saat Anda menggunakan partisipasi browser. OAuth hanya untuk jalur Google Meet API resmi: membuat space rapat, menyelesaikan space, dan menjalankan pemeriksaan preflight Meet Media API.

Buat kredensial Google

Di Google Cloud Console:

  1. Buat atau pilih proyek Google Cloud.

  2. Aktifkan Google Meet REST API untuk proyek tersebut.

  3. Konfigurasikan layar persetujuan OAuth.

    • Internal paling sederhana untuk organisasi Google Workspace.
    • External berfungsi untuk penyiapan pribadi/tes; saat aplikasi berada dalam Testing, tambahkan setiap akun Google yang akan mengotorisasi aplikasi sebagai pengguna uji.

  4. Tambahkan scope yang diminta OpenClaw:

    • https://www.googleapis.com/auth/meetings.space.created
    • https://www.googleapis.com/auth/meetings.space.readonly
    • https://www.googleapis.com/auth/meetings.space.settings
    • https://www.googleapis.com/auth/meetings.conference.media.readonly

  5. Buat ID klien OAuth.

    • Jenis aplikasi: Aplikasi web.

    • URI redirect resmi:

      http://localhost:8085/oauth2callback

  6. Salin ID klien dan secret klien.

meetings.space.created diperlukan oleh Google Meet spaces.create. meetings.space.readonly memungkinkan OpenClaw menyelesaikan URL/kode Meet menjadi space. meetings.space.settings memungkinkan OpenClaw meneruskan pengaturan SpaceConfig seperti accessType selama pembuatan ruang API. meetings.conference.media.readonly ditujukan untuk preflight Meet Media API dan pekerjaan media; Google mungkin mewajibkan pendaftaran Developer Preview untuk penggunaan Media API aktual. Jika Anda hanya membutuhkan bergabung Chrome berbasis browser, lewati OAuth sepenuhnya.

Buat refresh token

Konfigurasikan oauth.clientId dan secara opsional oauth.clientSecret, atau berikan keduanya sebagai variabel environment, lalu jalankan:

openclaw googlemeet auth login --json

Perintah ini mencetak blok konfigurasi oauth dengan refresh token. Ini menggunakan PKCE, callback localhost di http://localhost:8085/oauth2callback, dan alur salin/tempel manual dengan --manual.

Contoh:

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

Gunakan mode manual saat browser tidak dapat menjangkau callback lokal:

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

Output JSON menyertakan:

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

Simpan objek oauth di bawah konfigurasi Plugin Google Meet:

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

Utamakan variabel environment saat Anda tidak ingin refresh token berada dalam konfigurasi. Jika nilai konfigurasi dan environment sama-sama ada, Plugin menyelesaikan konfigurasi terlebih dahulu lalu fallback ke environment.

Persetujuan OAuth mencakup pembuatan space Meet, akses baca space Meet, dan akses baca media konferensi Meet. Jika Anda melakukan autentikasi sebelum dukungan pembuatan rapat tersedia, jalankan ulang openclaw googlemeet auth login --json agar refresh token memiliki scope meetings.space.created.

Verifikasi OAuth dengan doctor

Jalankan doctor OAuth saat Anda menginginkan pemeriksaan kesehatan yang cepat dan tanpa secret:

openclaw googlemeet doctor --oauth --json

Ini tidak memuat runtime Chrome atau membutuhkan node Chrome yang tersambung. Ini memeriksa bahwa konfigurasi OAuth ada dan refresh token dapat membuat access token. Laporan JSON hanya menyertakan bidang status seperti ok, configured, tokenSource, expiresAt, dan pesan pemeriksaan; ini tidak mencetak access token, refresh token, atau secret klien.

Hasil umum:

Pemeriksaan Arti
oauth-config oauth.clientId plus oauth.refreshToken, atau token akses yang disimpan dalam cache, ada.
oauth-token Token akses yang disimpan dalam cache masih valid, atau token refresh menerbitkan token akses baru.
meet-spaces-get Pemeriksaan opsional --meeting menemukan ruang Meet yang sudah ada.
meet-spaces-create Pemeriksaan opsional --create-space membuat ruang Meet baru.

Untuk membuktikan pengaktifan Google Meet API dan cakupan spaces.create juga, jalankan pemeriksaan pembuatan yang memiliki efek samping:

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

--create-space membuat URL Meet sekali pakai. Gunakan ini saat Anda perlu mengonfirmasi bahwa proyek Google Cloud telah mengaktifkan Meet API dan akun yang diotorisasi memiliki cakupan meetings.space.created.

Untuk membuktikan akses baca bagi ruang rapat yang sudah ada:

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

doctor --oauth --meeting dan resolve-space membuktikan akses baca ke ruang yang sudah ada yang dapat diakses oleh akun Google yang diotorisasi. 403 dari pemeriksaan ini biasanya berarti Google Meet REST API dinonaktifkan, token refresh yang disetujui tidak memiliki cakupan yang diperlukan, atau akun Google tidak dapat mengakses ruang Meet tersebut. Kesalahan token refresh berarti jalankan ulang openclaw googlemeet auth login --json dan simpan blok oauth baru.

Kredensial OAuth tidak diperlukan untuk fallback browser. Dalam mode tersebut, autentikasi Google berasal dari profil Chrome yang sudah masuk pada node yang dipilih, bukan dari konfigurasi OpenClaw.

Variabel lingkungan ini diterima sebagai fallback:

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

Resolusi URL Meet, kode, atau spaces/{id} melalui spaces.get:

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

Jalankan preflight sebelum pekerjaan media:

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

Daftar artefak rapat dan kehadiran setelah Meet membuat catatan konferensi:

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

Dengan --meeting, artifacts dan attendance menggunakan catatan konferensi terbaru secara default. Berikan --all-conference-records saat Anda menginginkan setiap catatan tersimpan untuk rapat tersebut.

Pencarian Calendar dapat menyelesaikan URL rapat dari Google Calendar sebelum membaca artefak Meet:

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

--today mencari kalender primary hari ini untuk acara Calendar dengan tautan Google Meet. Gunakan --event <query> untuk mencari teks acara yang cocok, dan --calendar <id> untuk kalender non-utama. Pencarian Calendar memerlukan login OAuth baru yang menyertakan cakupan hanya baca acara Calendar. calendar-events menampilkan pratinjau acara Meet yang cocok dan menandai acara yang akan dipilih oleh latest, artifacts, attendance, atau export.

Jika Anda sudah mengetahui id catatan konferensi, rujuk langsung:

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

Akhiri konferensi aktif untuk ruang yang dibuat API saat Anda ingin menutup ruangan setelah panggilan:

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

Ini memanggil Google Meet spaces.endActiveConference dan memerlukan OAuth dengan cakupan meetings.space.created untuk ruang yang dapat dikelola akun yang diotorisasi. OpenClaw menerima input URL Meet, kode rapat, atau spaces/{id} dan meresolusikannya ke resource ruang API sebelum mengakhiri konferensi aktif. Ini terpisah dari googlemeet leave: leave menghentikan partisipasi lokal/sesi OpenClaw, sedangkan end-active-conference meminta Google Meet mengakhiri konferensi aktif untuk ruang tersebut.

Tulis laporan yang mudah dibaca:

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

artifacts mengembalikan metadata catatan konferensi plus metadata resource peserta, rekaman, transkrip, entri transkrip terstruktur, dan catatan pintar saat Google menyediakannya untuk rapat tersebut. Gunakan --no-transcript-entries untuk melewati pencarian entri untuk rapat besar. attendance memperluas peserta menjadi baris sesi peserta dengan waktu pertama/terakhir terlihat, total durasi sesi, flag terlambat/pulang-awal, dan resource peserta duplikat yang digabung berdasarkan pengguna yang masuk atau nama tampilan. Berikan --no-merge-duplicates untuk menjaga resource peserta mentah tetap terpisah, --late-after-minutes untuk menyesuaikan deteksi keterlambatan, dan --early-before-minutes untuk menyesuaikan deteksi pulang awal.

export menulis folder yang berisi summary.md, attendance.csv, transcript.md, artifacts.json, attendance.json, dan manifest.json. manifest.json mencatat input yang dipilih, opsi ekspor, catatan konferensi, file keluaran, jumlah, sumber token, acara Calendar saat digunakan, dan setiap peringatan pengambilan parsial. Berikan --zip untuk juga menulis arsip portabel di sebelah folder. Berikan --include-doc-bodies untuk mengekspor teks Google Docs transkrip tertaut dan catatan pintar melalui Google Drive files.export; ini memerlukan login OAuth baru yang menyertakan cakupan hanya baca Drive Meet. Tanpa --include-doc-bodies, ekspor hanya menyertakan metadata Meet dan entri transkrip terstruktur. Jika Google mengembalikan kegagalan artefak parsial, seperti kesalahan daftar catatan pintar, entri transkrip, atau isi dokumen Drive, ringkasan dan manifes menyimpan peringatan tersebut alih-alih menggagalkan seluruh ekspor. Gunakan --dry-run untuk mengambil data artefak/kehadiran yang sama dan mencetak JSON manifes tanpa membuat folder atau ZIP. Ini berguna sebelum menulis ekspor besar atau saat agen hanya membutuhkan jumlah, catatan yang dipilih, dan peringatan.

Agen juga dapat membuat bundel yang sama melalui alat google_meet:

{
  "action": "export",
  "conferenceRecord": "conferenceRecords/abc123",
  "includeDocumentBodies": true,
  "outputDir": "meet-export",
  "zip": true
}

Atur "dryRun": true untuk hanya mengembalikan manifes ekspor dan melewati penulisan file.

Agen juga dapat membuat ruang berbasis API dengan kebijakan akses eksplisit:

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

Dan mereka dapat mengakhiri konferensi aktif untuk ruang yang diketahui:

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

Untuk validasi dengarkan-dulu, agen sebaiknya menggunakan test_listen sebelum mengklaim rapat tersebut berguna:

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

Jalankan live smoke yang dijaga terhadap rapat tersimpan yang nyata:

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

Jalankan probe browser live dengarkan-dulu terhadap rapat tempat seseorang akan berbicara dengan caption Meet tersedia:

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

Lingkungan live smoke:

  • OPENCLAW_LIVE_TEST=1 mengaktifkan pengujian live yang dijaga.
  • OPENCLAW_GOOGLE_MEET_LIVE_MEETING menunjuk ke URL Meet, kode, atau spaces/{id} yang tersimpan.
  • OPENCLAW_GOOGLE_MEET_CLIENT_ID atau GOOGLE_MEET_CLIENT_ID menyediakan id klien OAuth.
  • OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN atau GOOGLE_MEET_REFRESH_TOKEN menyediakan token refresh.
  • Opsional: OPENCLAW_GOOGLE_MEET_CLIENT_SECRET, OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN, dan OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT menggunakan nama fallback yang sama tanpa prefiks OPENCLAW_.

Live smoke artefak/kehadiran dasar membutuhkan https://www.googleapis.com/auth/meetings.space.readonly dan https://www.googleapis.com/auth/meetings.conference.media.readonly. Pencarian Calendar membutuhkan https://www.googleapis.com/auth/calendar.events.readonly. Ekspor isi dokumen Drive membutuhkan https://www.googleapis.com/auth/drive.meet.readonly.

Buat ruang Meet baru:

openclaw googlemeet create

Perintah mencetak meeting uri, sumber, dan sesi bergabung yang baru. Dengan kredensial OAuth, ini menggunakan Google Meet API resmi. Tanpa kredensial OAuth, ini menggunakan profil browser node Chrome yang sudah masuk dan dipin sebagai fallback. Agen dapat menggunakan alat google_meet dengan action: "create" untuk membuat dan bergabung dalam satu langkah. Untuk pembuatan hanya URL, berikan "join": false.

Contoh keluaran JSON dari fallback browser:

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

Jika fallback browser terkena login Google atau pemblokir izin Meet sebelum dapat membuat URL, metode Gateway mengembalikan respons gagal dan alat google_meet mengembalikan detail terstruktur alih-alih string biasa:

{
  "source": "browser",
  "error": "google-login-required: Sign in to Google in the OpenClaw browser profile, then retry meeting creation.",
  "manualActionRequired": true,
  "manualActionReason": "google-login-required",
  "manualActionMessage": "Sign in to Google in the OpenClaw browser profile, then retry meeting creation.",
  "browser": {
    "nodeId": "ba0f4e4bc...",
    "targetId": "tab-1",
    "browserUrl": "https://accounts.google.com/signin",
    "browserTitle": "Sign in - Google Accounts"
  }
}

Saat agen melihat manualActionRequired: true, agen harus melaporkan manualActionMessage plus konteks node/tab browser dan berhenti membuka tab Meet baru sampai operator menyelesaikan langkah browser.

Contoh keluaran JSON dari pembuatan API:

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

Membuat Meet akan bergabung secara default. Transport Chrome atau Chrome-node masih memerlukan profil Google Chrome yang sudah login untuk bergabung melalui browser. Jika profil sudah logout, OpenClaw melaporkan manualActionRequired: true atau galat fallback browser dan meminta operator menyelesaikan login Google sebelum mencoba ulang.

Tetapkan preview.enrollmentAcknowledged: true hanya setelah mengonfirmasi bahwa proyek Cloud, prinsipal OAuth, dan peserta rapat Anda terdaftar dalam Google Workspace Developer Preview Program untuk Meet media APIs.

Konfigurasi

Jalur agen Chrome umum hanya memerlukan plugin diaktifkan, BlackHole, SoX, kunci penyedia transkripsi realtime, dan penyedia TTS OpenClaw yang dikonfigurasi. OpenAI adalah penyedia transkripsi default; tetapkan realtime.voiceProvider ke "google" dan realtime.model untuk menggunakan Google Gemini Live untuk mode bidi tanpa mengubah penyedia transkripsi mode agen default:

brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# or
export GEMINI_API_KEY=...

Tetapkan konfigurasi plugin di bawah plugins.entries.google-meet.config:

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

Default:

  • defaultTransport: "chrome"
  • defaultMode: "agent" ("realtime" hanya diterima sebagai alias kompatibilitas lama untuk "agent"; panggilan alat baru sebaiknya menyebut "agent")
  • chromeNode.node: id/nama/IP node opsional untuk chrome-node
  • chrome.audioBackend: "blackhole-2ch"
  • chrome.guestName: "OpenClaw Agent": nama yang digunakan pada layar tamu Meet yang belum login
  • chrome.autoJoin: true: pengisian nama tamu dan klik Join Now dengan upaya terbaik melalui otomatisasi browser OpenClaw pada chrome-node
  • chrome.reuseExistingTab: true: aktifkan tab Meet yang sudah ada alih-alih membuka duplikat
  • chrome.waitForInCallMs: 20000: tunggu tab Meet melaporkan sedang dalam panggilan sebelum intro talk-back dipicu
  • chrome.audioFormat: "pcm16-24khz": format audio pasangan perintah. Gunakan "g711-ulaw-8khz" hanya untuk pasangan perintah lama/kustom yang masih memancarkan audio telefoni.
  • chrome.audioBufferBytes: 4096: buffer pemrosesan SoX untuk perintah audio pasangan perintah Chrome yang dihasilkan. Ini adalah separuh dari buffer default SoX sebesar 8192 byte, sehingga mengurangi latensi pipe default sambil tetap memberi ruang untuk menaikkannya pada host yang sibuk. Nilai di bawah minimum SoX dibatasi menjadi 17 byte.
  • chrome.audioInputCommand: perintah SoX yang membaca dari CoreAudio BlackHole 2ch dan menulis audio dalam chrome.audioFormat
  • chrome.audioOutputCommand: perintah SoX yang membaca audio dalam chrome.audioFormat dan menulis ke CoreAudio BlackHole 2ch
  • chrome.bargeInInputCommand: perintah mikrofon lokal opsional yang menulis PCM mono little-endian 16-bit bertanda untuk deteksi interupsi manusia saat pemutaran asisten aktif. Ini saat ini berlaku untuk bridge pasangan perintah chrome yang dihosting Gateway.
  • chrome.bargeInRmsThreshold: 650: level RMS yang dihitung sebagai interupsi manusia pada chrome.bargeInInputCommand
  • chrome.bargeInPeakThreshold: 2500: level puncak yang dihitung sebagai interupsi manusia pada chrome.bargeInInputCommand
  • chrome.bargeInCooldownMs: 900: jeda minimum antara pembersihan interupsi manusia berulang
  • mode: "agent": mode talk-back default. Ucapan peserta ditranskripsikan oleh penyedia transkripsi realtime yang dikonfigurasi, dikirim ke agen OpenClaw yang dikonfigurasi dalam sesi sub-agen per rapat, dan diucapkan kembali melalui runtime TTS OpenClaw normal.
  • mode: "bidi": mode fallback model realtime dua arah langsung. Penyedia suara realtime menjawab ucapan peserta secara langsung dan dapat memanggil openclaw_agent_consult untuk jawaban yang lebih mendalam/berbasis alat.
  • mode: "transcribe": mode hanya mengamati tanpa bridge talk-back.
  • realtime.provider: "openai": fallback kompatibilitas yang digunakan saat kolom penyedia terscope di bawah ini belum diatur.
  • realtime.transcriptionProvider: "openai": id penyedia yang digunakan oleh mode agent untuk transkripsi realtime.
  • realtime.voiceProvider: id penyedia yang digunakan oleh mode bidi untuk suara realtime langsung. Tetapkan ini ke "google" untuk menggunakan Gemini Live sambil mempertahankan transkripsi mode agen pada OpenAI.
  • realtime.toolPolicy: "safe-read-only"
  • realtime.instructions: balasan lisan singkat, dengan openclaw_agent_consult untuk jawaban yang lebih mendalam
  • realtime.introMessage: pemeriksaan kesiapan lisan singkat saat bridge realtime terhubung; tetapkan ke "" untuk bergabung tanpa suara
  • realtime.agentId: id agen OpenClaw opsional untuk openclaw_agent_consult; default ke main

Override opsional:

{
  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-2.5-flash-native-audio-preview-12-2025",
    agentId: "jay",
    toolPolicy: "owner",
    introMessage: "Say exactly: I'm here.",
    providers: {
      google: {
        voice: "Kore",
      },
    },
  },
}

ElevenLabs untuk mendengarkan dan berbicara dalam mode agen:

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

Suara Meet persisten berasal dari messages.tts.providers.elevenlabs.voiceId. Balasan agen juga dapat menggunakan direktif per balasan [[tts:voiceId=... model=eleven_v3]] saat override model TTS diaktifkan, tetapi konfigurasi adalah default deterministik untuk rapat. Saat bergabung, log seharusnya menampilkan transcriptionProvider=elevenlabs dan setiap balasan lisan seharusnya mencatat provider=elevenlabs model=eleven_v3 voice=<voiceId>.

Konfigurasi khusus Twilio:

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

voiceCall.enabled default ke true; dengan transport Twilio, ini mendelegasikan panggilan PSTN aktual, DTMF, dan sapaan intro ke Plugin Voice Call. Voice Call memutar urutan DTMF sebelum membuka stream media realtime, lalu menggunakan teks intro yang tersimpan sebagai sapaan realtime awal. Jika voice-call tidak diaktifkan, Google Meet masih dapat memvalidasi dan merekam rencana panggilan, tetapi tidak dapat melakukan panggilan Twilio.

Alat

Agen dapat menggunakan alat google_meet:

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

Gunakan transport: "chrome" saat Chrome berjalan pada host Gateway. Gunakan transport: "chrome-node" saat Chrome berjalan pada node yang dipasangkan seperti VM Parallels. Dalam kedua kasus, penyedia model dan openclaw_agent_consult berjalan pada host Gateway, sehingga kredensial model tetap berada di sana. Dengan mode: "agent" default, penyedia transkripsi realtime menangani pendengaran, agen OpenClaw yang dikonfigurasi menghasilkan jawaban, dan TTS OpenClaw reguler mengucapkannya ke Meet. Gunakan mode: "bidi" saat Anda ingin model suara realtime menjawab secara langsung. mode: "realtime" mentah tetap diterima sebagai alias kompatibilitas lama untuk mode: "agent", tetapi tidak lagi diiklankan dalam skema alat agen. Log mode agen menyertakan penyedia/model transkripsi yang di-resolve saat startup bridge dan penyedia TTS, model, suara, format output, dan laju sampel setelah setiap balasan yang disintesis.

Gunakan action: "status" untuk mencantumkan sesi aktif atau memeriksa ID sesi. Gunakan action: "speak" dengan sessionId dan message untuk membuat agen realtime berbicara segera. Gunakan action: "test_speech" untuk membuat atau menggunakan ulang sesi, memicu frasa yang diketahui, dan mengembalikan kesehatan inCall saat host Chrome dapat melaporkannya. test_speech selalu memaksa mode: "agent" dan gagal jika diminta berjalan dalam mode: "transcribe" karena sesi hanya mengamati sengaja tidak dapat memancarkan ucapan. Hasil speechOutputVerified didasarkan pada byte output audio realtime yang meningkat selama panggilan uji ini, sehingga sesi yang digunakan ulang dengan audio lama tidak dihitung sebagai pemeriksaan ucapan yang baru berhasil. Gunakan action: "leave" untuk menandai sesi berakhir.

status menyertakan kesehatan Chrome saat tersedia:

  • inCall: Chrome tampaknya berada di dalam panggilan Meet
  • micMuted: status mikrofon Meet dengan upaya terbaik
  • manualActionRequired / manualActionReason / manualActionMessage: profil browser memerlukan login manual, izin masuk dari host Meet, izin, atau perbaikan kontrol browser sebelum ucapan dapat berfungsi
  • speechReady / speechBlockedReason / speechBlockedMessage: apakah ucapan Chrome terkelola diizinkan sekarang. speechReady: false berarti OpenClaw tidak mengirim frasa intro/uji ke bridge audio.
  • providerConnected / realtimeReady: status bridge suara realtime
  • lastInputAt / lastOutputAt: audio terakhir yang terlihat dari atau dikirim ke bridge
  • audioOutputRouted / audioOutputDeviceLabel: apakah output media tab Meet secara aktif dirutekan ke perangkat BlackHole yang digunakan oleh bridge
  • lastSuppressedInputAt / suppressedInputBytes: input loopback yang diabaikan saat pemutaran asisten aktif
{
  "action": "speak",
  "sessionId": "meet_...",
  "message": "Say exactly: I'm here and listening."
}

Mode agent dan bidi

Mode Chrome agent dioptimalkan untuk perilaku "agen saya ada dalam rapat". Penyedia transkripsi realtime mendengar audio rapat, transkrip akhir peserta dirutekan melalui agen OpenClaw yang dikonfigurasi, dan jawabannya diucapkan melalui runtime TTS OpenClaw normal. Tetapkan mode: "bidi" saat Anda ingin model suara realtime menjawab secara langsung. Fragmen transkrip akhir yang berdekatan digabungkan sebelum konsultasi sehingga satu giliran lisan tidak menghasilkan beberapa jawaban parsial yang kedaluwarsa. Input realtime juga diredam saat audio asisten yang diantrekan masih diputar, dan gema transkrip yang mirip asisten baru-baru ini diabaikan sebelum konsultasi agen agar loopback BlackHole tidak membuat agen menjawab ucapannya sendiri.

Mode Siapa yang menentukan jawaban Jalur output ucapan Gunakan saat
agent Agen OpenClaw yang dikonfigurasi Runtime TTS OpenClaw normal Anda menginginkan perilaku "agen saya ada dalam rapat"
bidi Model suara realtime Respons audio penyedia suara realtime Anda menginginkan loop suara percakapan latensi terendah

Dalam mode bidi, saat model realtime memerlukan penalaran yang lebih mendalam, informasi terkini, atau alat OpenClaw normal, model dapat memanggil openclaw_agent_consult.

Alat konsultasi menjalankan agen OpenClaw reguler di balik layar dengan konteks transkrip rapat terbaru dan mengembalikan jawaban lisan yang ringkas. Dalam mode agent, OpenClaw mengirim jawaban itu langsung ke runtime TTS; dalam mode bidi, model suara realtime dapat mengucapkan hasil konsultasi kembali ke rapat. Ini menggunakan mesin konsultasi bersama yang sama seperti Voice Call.

Secara default, konsultasi berjalan terhadap agen main. Atur realtime.agentId saat jalur Meet harus berkonsultasi dengan workspace agen OpenClaw khusus, default model, kebijakan alat, memori, dan riwayat sesi.

Konsultasi mode agen menggunakan kunci sesi per rapat agent:<id>:subagent:google-meet:<session> sehingga pertanyaan lanjutan tetap menyimpan konteks rapat sambil mewarisi kebijakan agen normal dari agen yang dikonfigurasi.

realtime.toolPolicy mengontrol proses konsultasi:

  • safe-read-only: tampilkan alat konsultasi dan batasi agen reguler ke read, web_search, web_fetch, x_search, memory_search, dan memory_get.
  • owner: tampilkan alat konsultasi dan izinkan agen reguler menggunakan kebijakan alat agen normal.
  • none: jangan tampilkan alat konsultasi kepada model suara realtime.

Kunci sesi konsultasi dicakup per sesi Meet, sehingga panggilan konsultasi lanjutan dapat menggunakan kembali konteks konsultasi sebelumnya selama rapat yang sama.

Untuk memaksa pemeriksaan kesiapan lisan setelah Chrome sepenuhnya bergabung ke panggilan:

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

Untuk smoke join-and-speak penuh:

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

Daftar Periksa Pengujian Live

Gunakan urutan ini sebelum menyerahkan rapat ke agen tanpa pengawasan:

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

Status Chrome-node yang diharapkan:

  • googlemeet setup semuanya hijau.
  • googlemeet setup menyertakan chrome-node-connected saat Chrome-node adalah transport default atau sebuah Node disematkan.
  • nodes status menampilkan Node yang dipilih terhubung.
  • Node yang dipilih mengiklankan googlemeet.chrome dan browser.proxy.
  • Tab Meet bergabung ke panggilan dan test-speech mengembalikan kesehatan Chrome dengan inCall: true.

Untuk host Chrome jarak jauh seperti VM Parallels macOS, ini adalah pemeriksaan aman tersingkat setelah memperbarui Gateway atau VM:

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

Itu membuktikan Plugin Gateway dimuat, Node VM terhubung dengan token saat ini, dan bridge audio Meet tersedia sebelum agen membuka tab rapat nyata.

Untuk smoke Twilio, gunakan rapat yang menampilkan detail panggilan masuk telepon:

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

Status Twilio yang diharapkan:

  • googlemeet setup menyertakan pemeriksaan hijau twilio-voice-call-plugin, twilio-voice-call-credentials, dan twilio-voice-call-webhook.
  • voicecall tersedia di CLI setelah Gateway dimuat ulang.
  • Sesi yang dikembalikan memiliki transport: "twilio" dan twilio.voiceCallId.
  • openclaw logs --follow menampilkan DTMF TwiML disajikan sebelum TwiML realtime, lalu bridge realtime dengan salam awal yang diantrikan.
  • googlemeet leave <sessionId> memutus panggilan suara yang didelegasikan.

Pemecahan Masalah

Agen tidak dapat melihat alat Google Meet

Konfirmasi Plugin diaktifkan di konfigurasi Gateway dan muat ulang Gateway:

openclaw plugins list | grep google-meet
openclaw googlemeet setup

Jika Anda baru saja mengedit plugins.entries.google-meet, mulai ulang atau muat ulang Gateway. Agen yang berjalan hanya melihat alat Plugin yang didaftarkan oleh proses Gateway saat ini.

Pada host Gateway non-macOS, alat google_meet yang menghadap agen tetap terlihat, tetapi aksi talk-back Chrome lokal diblokir sebelum mencapai bridge audio. Audio talk-back Chrome lokal saat ini bergantung pada macOS BlackHole 2ch, jadi agen Linux sebaiknya menggunakan mode: "transcribe", panggilan masuk Twilio, atau host chrome-node macOS alih-alih jalur agen Chrome lokal default.

Tidak ada Node berkemampuan Google Meet yang terhubung

Pada host Node, jalankan:

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

Pada host Gateway, setujui Node dan verifikasi perintah:

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status

Node harus terhubung dan mencantumkan googlemeet.chrome ditambah browser.proxy. Konfigurasi Gateway harus mengizinkan perintah Node tersebut:

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

Jika googlemeet setup gagal pada chrome-node-connected atau log Gateway melaporkan gateway token mismatch, instal ulang atau mulai ulang Node dengan token Gateway saat ini. Untuk Gateway LAN, ini biasanya berarti:

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

Kemudian muat ulang layanan Node dan jalankan ulang:

openclaw googlemeet setup
openclaw nodes status --connected

Browser terbuka tetapi agen tidak dapat bergabung

Jalankan googlemeet test-listen untuk bergabung hanya-observasi atau googlemeet test-speech untuk bergabung realtime, lalu periksa kesehatan Chrome yang dikembalikan. Jika salah satu probe melaporkan manualActionRequired: true, tampilkan manualActionMessage kepada operator dan hentikan percobaan ulang sampai aksi browser selesai.

Aksi manual umum:

  • Masuk ke profil Chrome.
  • Terima tamu dari akun host Meet.
  • Berikan izin mikrofon/kamera Chrome saat prompt izin native Chrome muncul.
  • Tutup atau perbaiki dialog izin Meet yang macet.

Jangan laporkan "not signed in" hanya karena Meet menampilkan "Do you want people to hear you in the meeting?" Itu adalah interstisial pilihan audio Meet; OpenClaw mengeklik Use microphone melalui automasi browser saat tersedia dan terus menunggu status rapat nyata. Untuk fallback browser hanya-pembuatan, OpenClaw mungkin mengeklik Continue without microphone karena pembuatan URL tidak membutuhkan jalur audio realtime.

Pembuatan rapat gagal

googlemeet create pertama-tama menggunakan endpoint Google Meet API spaces.create saat kredensial OAuth dikonfigurasi. Tanpa kredensial OAuth, perintah ini fallback ke browser Node Chrome yang disematkan. Konfirmasi:

  • Untuk pembuatan API: oauth.clientId dan oauth.refreshToken dikonfigurasi, atau variabel lingkungan OPENCLAW_GOOGLE_MEET_* yang cocok tersedia.
  • Untuk pembuatan API: token refresh dibuat setelah dukungan pembuatan ditambahkan. Token yang lebih lama mungkin tidak memiliki scope meetings.space.created; jalankan ulang openclaw googlemeet auth login --json dan perbarui konfigurasi Plugin.
  • Untuk fallback browser: defaultTransport: "chrome-node" dan chromeNode.node mengarah ke Node terhubung dengan browser.proxy dan googlemeet.chrome.
  • Untuk fallback browser: profil Chrome OpenClaw pada Node tersebut sudah masuk ke Google dan dapat membuka https://meet.google.com/new.
  • Untuk fallback browser: percobaan ulang menggunakan kembali tab https://meet.google.com/new atau prompt akun Google yang ada sebelum membuka tab baru. Jika agen time out, coba ulang panggilan alat alih-alih membuka tab Meet lain secara manual.
  • Untuk fallback browser: jika alat mengembalikan manualActionRequired: true, gunakan browser.nodeId, browser.targetId, browserUrl, dan manualActionMessage yang dikembalikan untuk memandu operator. Jangan mencoba ulang dalam loop sampai aksi tersebut selesai.
  • Untuk fallback browser: jika Meet menampilkan "Do you want people to hear you in the meeting?", biarkan tab tetap terbuka. OpenClaw seharusnya mengeklik Use microphone atau, untuk fallback hanya-pembuatan, Continue without microphone melalui automasi browser dan terus menunggu URL Meet yang dihasilkan. Jika tidak bisa, error seharusnya menyebut meet-audio-choice-required, bukan google-login-required.

Agen bergabung tetapi tidak berbicara

Periksa jalur realtime:

openclaw googlemeet setup
openclaw googlemeet doctor

Gunakan mode: "agent" untuk jalur talk-back STT -> agen OpenClaw -> TTS normal, atau mode: "bidi" untuk fallback suara realtime langsung. mode: "transcribe" secara sengaja tidak memulai bridge talk-back. Untuk debugging hanya-observasi, jalankan openclaw googlemeet status --json <session-id> setelah peserta berbicara dan periksa captioning, transcriptLines, dan lastCaptionText. Jika inCall bernilai true tetapi transcriptLines tetap 0, caption Meet mungkin dinonaktifkan, belum ada yang berbicara sejak observer dipasang, UI Meet berubah, atau caption live tidak tersedia untuk bahasa/akun rapat.

googlemeet test-speech selalu memeriksa jalur realtime dan melaporkan apakah byte output bridge teramati untuk pemanggilan tersebut. Jika speechOutputVerified bernilai false dan speechOutputTimedOut bernilai true, penyedia realtime mungkin telah menerima ujaran tetapi OpenClaw tidak melihat byte output baru mencapai bridge audio Chrome.

Verifikasi juga:

  • Kunci penyedia realtime tersedia di host Gateway, seperti OPENAI_API_KEY atau GEMINI_API_KEY.
  • BlackHole 2ch terlihat di host Chrome.
  • sox ada di host Chrome.
  • Mikrofon dan speaker Meet dirutekan melalui jalur audio virtual yang digunakan oleh OpenClaw. doctor seharusnya menampilkan meet output routed: yes untuk join realtime Chrome lokal.

googlemeet doctor [session-id] mencetak sesi, Node, status dalam-panggilan, alasan aksi manual, koneksi penyedia realtime, realtimeReady, aktivitas input/output audio, timestamp audio terakhir, penghitung byte, dan URL browser. Gunakan googlemeet status [session-id] --json saat Anda membutuhkan JSON mentah. Gunakan googlemeet doctor --oauth saat Anda perlu memverifikasi refresh OAuth Google Meet tanpa mengekspos token; tambahkan --meeting atau --create-space saat Anda juga membutuhkan bukti Google Meet API.

Jika agen time out dan Anda dapat melihat tab Meet sudah terbuka, periksa tab itu tanpa membuka tab lain:

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

Aksi alat yang setara adalah recover_current_tab. Aksi ini memfokuskan dan memeriksa tab Meet yang ada untuk transport yang dipilih. Dengan chrome, aksi ini menggunakan kontrol browser lokal melalui Gateway; dengan chrome-node, aksi ini menggunakan Node Chrome yang dikonfigurasi. Aksi ini tidak membuka tab baru atau membuat sesi baru; ia melaporkan pemblokir saat ini, seperti login, penerimaan, izin, atau status pilihan audio. Perintah CLI berbicara ke Gateway yang dikonfigurasi, jadi Gateway harus berjalan; chrome-node juga membutuhkan Node Chrome untuk terhubung.

Pemeriksaan penyiapan Twilio gagal

twilio-voice-call-plugin gagal saat voice-call tidak diizinkan atau tidak diaktifkan. Tambahkan ke plugins.allow, aktifkan plugins.entries.voice-call, dan muat ulang Gateway.

twilio-voice-call-credentials gagal saat backend Twilio tidak memiliki account SID, auth token, atau nomor penelepon. Atur ini pada host Gateway:

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

twilio-voice-call-webhook gagal saat voice-call tidak memiliki eksposur Webhook publik, atau saat publicUrl mengarah ke local loopback atau ruang jaringan privat. Atur plugins.entries.voice-call.config.publicUrl ke URL penyedia publik atau konfigurasikan tunnel/eksposur Tailscale voice-call.

URL loopback dan privat tidak valid untuk callback operator. Jangan gunakan 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, atau fd00::/8 sebagai publicUrl.

Untuk URL publik yang stabil:

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

Untuk pengembangan lokal, gunakan tunnel atau eksposur Tailscale alih-alih URL host privat:

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

Lalu mulai ulang atau muat ulang Gateway dan jalankan:

openclaw googlemeet setup --transport twilio
openclaw voicecall setup
openclaw voicecall smoke

voicecall smoke secara default hanya memeriksa kesiapan. Untuk menjalankan dry-run ke nomor tertentu:

openclaw voicecall smoke --to "+15555550123"

Hanya tambahkan --yes ketika Anda sengaja ingin melakukan panggilan notifikasi keluar langsung:

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

Panggilan Twilio dimulai tetapi tidak pernah masuk ke rapat

Pastikan acara Meet menampilkan detail dial-in telepon. Berikan nomor dial-in dan PIN persisnya atau urutan DTMF kustom:

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

Gunakan awalan w atau koma di --dtmf-sequence jika penyedia memerlukan jeda sebelum memasukkan PIN.

Jika panggilan telepon dibuat tetapi daftar peserta Meet tidak pernah menampilkan peserta dial-in:

  • Jalankan openclaw googlemeet doctor <session-id> untuk memastikan ID panggilan Twilio yang didelegasikan, apakah DTMF sudah diantrekan, dan apakah sapaan pembuka diminta.
  • Jalankan openclaw voicecall status --call-id <id> dan pastikan panggilan masih aktif.
  • Jalankan openclaw voicecall tail dan periksa bahwa Webhook Twilio tiba di Gateway.
  • Jalankan openclaw logs --follow dan cari urutan Twilio Meet: Google Meet mendelegasikan join, Voice Call menyimpan dan menyajikan TwiML DTMF pra-koneksi, Voice Call menyajikan TwiML realtime untuk panggilan Twilio, lalu Google Meet meminta ucapan pembuka dengan voicecall.speak.
  • Jalankan ulang openclaw googlemeet setup --transport twilio; pemeriksaan setup hijau diperlukan tetapi tidak membuktikan urutan PIN rapat sudah benar.
  • Pastikan nomor dial-in berasal dari undangan dan wilayah Meet yang sama dengan PIN.
  • Tingkatkan voiceCall.dtmfDelayMs dari default 12 detik jika Meet menjawab lambat atau transkrip panggilan masih menampilkan prompt yang meminta PIN setelah DTMF pra-koneksi dikirim.
  • Jika peserta bergabung tetapi Anda tidak mendengar sapaan, periksa openclaw logs --follow untuk permintaan voicecall.speak pasca-DTMF dan pemutaran TTS media-stream atau fallback Twilio OPENCLAW_DOCS_MARKER:calloutOpen:U2F5. Jika transkrip panggilan masih berisi "enter the meeting PIN", jalur telepon belum bergabung ke ruang Meet, sehingga peserta rapat tidak akan mendengar ucapan.

Jika Webhook tidak tiba, debug Plugin Voice Call terlebih dahulu: penyedia harus dapat menjangkau plugins.entries.voice-call.config.publicUrl atau tunnel yang dikonfigurasi. Lihat Pemecahan masalah panggilan suara.

Catatan

API media resmi Google Meet berorientasi penerimaan, sehingga berbicara ke dalam panggilan Meet tetap memerlukan jalur peserta. Plugin ini menjaga batas tersebut tetap terlihat: Chrome menangani partisipasi browser dan perutean audio lokal; Twilio menangani partisipasi dial-in telepon.

Mode talk-back Chrome memerlukan BlackHole 2ch plus salah satu dari:

  • chrome.audioInputCommand plus chrome.audioOutputCommand: OpenClaw memiliki bridge dan menyalurkan audio dalam chrome.audioFormat antara perintah tersebut dan penyedia yang dipilih. Mode agent menggunakan transkripsi realtime plus TTS biasa; mode bidi menggunakan penyedia suara realtime. Jalur Chrome default adalah PCM16 24 kHz dengan chrome.audioBufferBytes: 4096; G.711 mu-law 8 kHz tetap tersedia untuk pasangan perintah lama.
  • chrome.audioBridgeCommand: perintah bridge eksternal memiliki seluruh jalur audio lokal dan harus keluar setelah memulai atau memvalidasi daemon-nya. Ini hanya valid untuk bidi karena mode agent memerlukan akses pasangan perintah langsung untuk TTS.

Ketika agent memanggil tool google_meet dalam mode agent, sesi konsultan rapat mem-fork transkrip pemanggil saat ini sebelum menjawab ucapan peserta. Sesi Meet tetap terpisah (agent:<agentId>:subagent:google-meet:<sessionId>) sehingga tindak lanjut rapat tidak memutasi transkrip pemanggil secara langsung.

Untuk audio duplex yang bersih, rutekan output Meet dan mikrofon Meet melalui perangkat virtual terpisah atau graf perangkat virtual bergaya Loopback. Satu perangkat BlackHole bersama dapat menggema peserta lain kembali ke panggilan.

Dengan bridge Chrome pasangan perintah, chrome.bargeInInputCommand dapat mendengarkan mikrofon lokal terpisah dan menghapus pemutaran asisten ketika manusia mulai berbicara. Ini menjaga ucapan manusia tetap di depan output asisten bahkan ketika input loopback BlackHole bersama untuk sementara ditekan selama pemutaran asisten. Seperti chrome.audioInputCommand dan chrome.audioOutputCommand, ini adalah perintah lokal yang dikonfigurasi operator. Gunakan path perintah tepercaya eksplisit atau daftar argumen, dan jangan arahkan ke skrip dari lokasi yang tidak tepercaya.

googlemeet speak memicu bridge audio talk-back aktif untuk sesi Chrome. googlemeet leave menghentikan bridge tersebut. Untuk sesi Twilio yang didelegasikan melalui Plugin Voice Call, leave juga menutup panggilan suara yang mendasarinya. Gunakan googlemeet end-active-conference ketika Anda juga ingin menutup konferensi Google Meet aktif untuk ruang yang dikelola API.

Terkait