---
read_when:
    - Anda ingin agen OpenClaw bergabung ke panggilan Google Meet
    - Anda ingin agen OpenClaw membuat panggilan Google Meet baru
    - Anda sedang mengonfigurasi Chrome, node Chrome, atau Twilio sebagai transport Google Meet
summary: 'Plugin Google Meet: bergabung ke URL Meet eksplisit melalui Chrome atau Twilio dengan setelan bawaan respons bicara agen'
title: Plugin Google Meet
x-i18n:
    generated_at: "2026-05-06T17:58:32Z"
    model: gpt-5.5
    provider: openai
    source_hash: 4b154e9cbce560dbc8327a140b27c17d2614d13d7011032a48b110314772ab0c
    source_path: plugins/google-meet.md
    workflow: 16
---

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"`:

```bash
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:

```bash
sudo reboot
```

Setelah reboot, verifikasi kedua bagian:

```bash
system_profiler SPAudioDataType | grep -i BlackHole
command -v sox
```

Aktifkan Plugin:

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

Periksa penyiapan:

```bash
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:

```bash
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:

```bash
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:

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

Atau biarkan agen bergabung melalui tool `google_meet`:

```json
{
  "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:

```bash
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:

```bash
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:

```bash
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.

```json
{
  "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:

```bash
brew install blackhole-2ch sox
```

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

```bash
sudo reboot
```

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

```bash
system_profiler SPAudioDataType | grep -i BlackHole
command -v sox
```

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

```bash
openclaw plugins enable google-meet
```

Mulai host node di VM:

```bash
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:

```bash
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:

```bash
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:

```bash
openclaw devices list
openclaw devices approve <requestId>
```

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

```bash
openclaw nodes status
```

Rutekan Meet melalui node tersebut pada host Gateway:

```json5
{
  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:

```bash
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:

```bash
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`.

```bash
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:

```json5
{
  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`:

```bash
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:

```bash
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.

```bash
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:

```bash
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:

     ```text
     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:

```bash
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:

```bash
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:

```bash
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:

```json
{
  "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:

```json5
{
  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:

```bash
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:

```bash
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:

```bash
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`:

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

Jalankan preflight sebelum pekerjaan media:

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

Daftar artefak rapat dan kehadiran setelah Meet membuat catatan konferensi:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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`:

```json
{
  "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:

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

Dan mereka dapat mengakhiri konferensi aktif untuk ruang yang diketahui:

```json
{
  "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:

```json
{
  "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:

```bash
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:

```bash
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:

```bash
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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

```bash
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`:

```json5
{
  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:

```json5
{
  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:

```json5
{
  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:

```json5
{
  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`:

```json
{
  "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

```json
{
  "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:

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

Untuk smoke join-and-speak penuh:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```json5
{
  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:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```bash
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:

```json5
{
  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:

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

Lalu mulai ulang atau muat ulang Gateway dan jalankan:

```bash
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:

```bash
openclaw voicecall smoke --to "+15555550123"
```

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

```bash
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:

```bash
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 `<Say>`. 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](/id/plugins/voice-call#troubleshooting).

## 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

- [Plugin panggilan suara](/id/plugins/voice-call)
- [Mode bicara](/id/nodes/talk)
- [Membangun Plugin](/id/plugins/building-plugins)