---
read_when:
    - Bạn muốn một tác nhân OpenClaw tham gia cuộc gọi Google Meet
    - Bạn muốn một tác nhân OpenClaw tạo một cuộc gọi Google Meet mới
    - Bạn đang cấu hình Chrome, nút Chrome hoặc Twilio làm phương thức truyền tải cho Google Meet
summary: 'Google Meet Plugin: tham gia các URL Meet được chỉ định rõ qua Chrome hoặc Twilio với mặc định phản hồi bằng giọng nói của tác tử'
title: Plugin Google Meet
x-i18n:
    generated_at: "2026-05-06T17:58:06Z"
    model: gpt-5.5
    provider: openai
    source_hash: 4b154e9cbce560dbc8327a140b27c17d2614d13d7011032a48b110314772ab0c
    source_path: plugins/google-meet.md
    workflow: 16
---

Hỗ trợ người tham gia Google Meet cho OpenClaw — plugin được thiết kế rõ ràng ngay từ đầu:

- Nó chỉ tham gia một URL `https://meet.google.com/...` rõ ràng.
- Nó có thể tạo một không gian Meet mới thông qua Google Meet API, rồi tham gia
  URL được trả về.
- `agent` là chế độ phản hồi mặc định: phiên âm thời gian thực lắng nghe, tác tử
  OpenClaw đã cấu hình trả lời, và OpenClaw TTS thông thường phát lời nói vào Meet.
- `bidi` vẫn khả dụng làm chế độ dự phòng cho mô hình giọng nói thời gian thực trực tiếp.
- Tác tử chọn hành vi tham gia bằng `mode`: dùng `agent` để nghe/phản hồi trực tiếp,
  `bidi` cho dự phòng giọng nói thời gian thực trực tiếp, hoặc `transcribe`
  để tham gia/điều khiển trình duyệt mà không có cầu nối phản hồi.
- Xác thực bắt đầu bằng Google OAuth cá nhân hoặc một hồ sơ Chrome đã đăng nhập.
- Không có thông báo đồng ý tự động.
- Backend âm thanh Chrome mặc định là `BlackHole 2ch`.
- Chrome có thể chạy cục bộ hoặc trên một máy chủ node đã ghép nối.
- Twilio chấp nhận số quay vào kèm mã PIN hoặc chuỗi DTMF tùy chọn; nó
  không thể quay trực tiếp một URL Meet.
- Lệnh CLI là `googlemeet`; `meet` được dành cho các quy trình hội nghị từ xa
  rộng hơn của tác tử.

## Bắt đầu nhanh

Cài đặt các phụ thuộc âm thanh cục bộ và cấu hình một nhà cung cấp phiên âm
thời gian thực cùng với OpenClaw TTS thông thường. OpenAI là nhà cung cấp
phiên âm mặc định; Google Gemini Live cũng hoạt động như một dự phòng giọng nói
`bidi` riêng biệt với `realtime.voiceProvider: "google"`:

```bash
brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# chỉ cần khi realtime.voiceProvider là "google" cho chế độ bidi
export GEMINI_API_KEY=...
```

`blackhole-2ch` cài đặt thiết bị âm thanh ảo `BlackHole 2ch`. Trình cài đặt của
Homebrew yêu cầu khởi động lại trước khi macOS hiển thị thiết bị:

```bash
sudo reboot
```

Sau khi khởi động lại, xác minh cả hai phần:

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

Bật plugin:

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

Kiểm tra thiết lập:

```bash
openclaw googlemeet setup
```

Đầu ra thiết lập được thiết kế để tác tử có thể đọc và nhận biết chế độ. Nó báo cáo
hồ sơ Chrome, ghim node, và, đối với các lần tham gia Chrome thời gian thực, cầu nối
âm thanh BlackHole/SoX cùng các kiểm tra phần giới thiệu thời gian thực bị trễ.
Đối với các lần tham gia chỉ quan sát, kiểm tra cùng cơ chế truyền tải bằng
`--mode transcribe`; chế độ đó bỏ qua các điều kiện tiên quyết về âm thanh thời gian thực
vì nó không nghe qua hoặc nói qua cầu nối:

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

Khi ủy quyền Twilio được cấu hình, thiết lập cũng báo cáo liệu plugin
`voice-call`, thông tin xác thực Twilio, và việc công khai Webhook đã sẵn sàng hay chưa.
Hãy coi mọi kiểm tra `ok: false` là yếu tố chặn đối với cơ chế truyền tải và chế độ
được kiểm tra trước khi yêu cầu một tác tử tham gia. Dùng `openclaw googlemeet setup --json`
cho tập lệnh hoặc đầu ra máy đọc được. Dùng `--transport chrome`,
`--transport chrome-node`, hoặc `--transport twilio` để kiểm tra trước một
cơ chế truyền tải cụ thể trước khi tác tử thử dùng nó.

Đối với Twilio, luôn kiểm tra trước cơ chế truyền tải một cách rõ ràng khi cơ chế
truyền tải mặc định là Chrome:

```bash
openclaw googlemeet setup --transport twilio
```

Điều đó phát hiện thiếu nối dây `voice-call`, thông tin xác thực Twilio, hoặc
việc công khai Webhook không thể truy cập trước khi tác tử thử quay vào cuộc họp.

Tham gia một cuộc họp:

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

Hoặc để một tác tử tham gia thông qua công cụ `google_meet`:

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

Công cụ `google_meet` dành cho tác tử vẫn khả dụng trên các máy chủ không phải macOS
cho các luồng hiện vật, lịch, thiết lập, phiên âm, Twilio, và `chrome-node`. Các hành động
phản hồi Chrome cục bộ bị chặn ở đó vì đường dẫn âm thanh Chrome được đóng gói hiện
phụ thuộc vào `BlackHole 2ch` của macOS. Trên Linux, dùng `mode: "transcribe"`,
quay vào bằng Twilio, hoặc một máy chủ macOS `chrome-node` để tham gia phản hồi
bằng Chrome.

Tạo một cuộc họp mới và tham gia:

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

Đối với phòng được tạo bằng API, dùng Google Meet `SpaceConfig.accessType` khi bạn muốn
chính sách không cần gõ cửa của phòng được đặt rõ ràng thay vì kế thừa từ mặc định
của tài khoản Google:

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

`OPEN` cho phép bất kỳ ai có URL Meet tham gia mà không cần gõ cửa. `TRUSTED` cho phép
người dùng đáng tin cậy của tổ chức chủ trì, người dùng bên ngoài được mời, và người dùng
quay vào tham gia mà không cần gõ cửa. `RESTRICTED` giới hạn quyền vào không cần gõ cửa
cho người được mời. Các thiết lập này chỉ áp dụng cho đường dẫn tạo chính thức bằng
Google Meet API, vì vậy thông tin xác thực OAuth phải được cấu hình.

Nếu bạn đã xác thực Google Meet trước khi tùy chọn này khả dụng, hãy chạy lại
`openclaw googlemeet auth login --json` sau khi thêm phạm vi
`meetings.space.settings` vào màn hình đồng ý Google OAuth của bạn.

Chỉ tạo URL mà không tham gia:

```bash
openclaw googlemeet create --no-join
```

`googlemeet create` có hai đường dẫn:

- Tạo bằng API: dùng khi thông tin xác thực Google Meet OAuth được cấu hình. Đây là
  đường dẫn xác định nhất và không phụ thuộc vào trạng thái giao diện trình duyệt.
- Dự phòng bằng trình duyệt: dùng khi không có thông tin xác thực OAuth. OpenClaw dùng
  node Chrome đã ghim, mở `https://meet.google.com/new`, chờ Google chuyển hướng đến
  một URL mã cuộc họp thực, rồi trả về URL đó. Đường dẫn này yêu cầu hồ sơ Chrome
  OpenClaw trên node đã đăng nhập vào Google.
  Tự động hóa trình duyệt xử lý lời nhắc micrô chạy lần đầu của chính Meet; lời nhắc đó
  không được coi là lỗi đăng nhập Google.
  Các luồng tham gia và tạo cũng cố gắng tái sử dụng một thẻ Meet hiện có trước khi mở
  thẻ mới. Việc khớp bỏ qua các chuỗi truy vấn URL vô hại như `authuser`, vì vậy một lần
  thử lại của tác tử nên tập trung vào cuộc họp đã mở thay vì tạo một thẻ Chrome thứ hai.

Đầu ra của lệnh/công cụ bao gồm trường `source` (`api` hoặc `browser`) để tác tử
có thể giải thích đường dẫn nào đã được dùng. `create` mặc định tham gia cuộc họp mới và
trả về `joined: true` cùng phiên tham gia. Để chỉ tạo URL, dùng
`create --no-join` trên CLI hoặc truyền `"join": false` cho công cụ.

Hoặc nói với tác tử: "Tạo một Google Meet, tham gia bằng chế độ phản hồi của tác tử,
và gửi cho tôi liên kết." Tác tử nên gọi `google_meet` với
`action: "create"` rồi chia sẻ `meetingUri` được trả về.

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

Đối với một lần tham gia chỉ quan sát/điều khiển trình duyệt, đặt `"mode": "transcribe"`.
Điều đó không khởi động cầu nối giọng nói thời gian thực song công, không yêu cầu BlackHole
hoặc SoX, và sẽ không phản hồi vào cuộc họp. Các lần tham gia Chrome trong chế độ này cũng
tránh cấp quyền micrô/camera của OpenClaw và tránh đường dẫn **Dùng micrô** của Meet.
Nếu Meet hiển thị một màn hình trung gian chọn âm thanh, tự động hóa thử đường dẫn không dùng
micrô và nếu không được thì báo cáo một hành động thủ công thay vì mở micrô cục bộ.
Trong chế độ transcribe, các cơ chế truyền tải Chrome được quản lý cũng cài đặt một trình
quan sát phụ đề Meet theo nỗ lực tốt nhất. `googlemeet status --json` và
`googlemeet doctor` hiển thị `captioning`, `captionsEnabledAttempted`,
`transcriptLines`, `lastCaptionAt`, `lastCaptionSpeaker`, `lastCaptionText`,
và một phần đuôi `recentTranscript` ngắn để người vận hành biết liệu trình duyệt
đã tham gia cuộc gọi hay chưa và liệu phụ đề Meet có đang tạo văn bản hay không.
Dùng `openclaw googlemeet test-listen <meet-url> --transport chrome-node` khi
bạn cần một phép kiểm tra có/không: nó tham gia trong chế độ transcribe, chờ phụ đề mới hoặc
chuyển động bản phiên âm, và trả về `listenVerified`, `listenTimedOut`, các trường
hành động thủ công, và tình trạng phụ đề mới nhất.

Trong các phiên thời gian thực, trạng thái `google_meet` bao gồm tình trạng trình duyệt
và cầu nối âm thanh như `inCall`, `manualActionRequired`, `providerConnected`,
`realtimeReady`, `audioInputActive`, `audioOutputActive`, dấu thời gian đầu vào/đầu ra
gần nhất, bộ đếm byte, và trạng thái cầu nối đã đóng. Nếu một lời nhắc an toàn trên trang Meet
xuất hiện, tự động hóa trình duyệt xử lý nó khi có thể. Đăng nhập, chấp nhận của chủ trì,
và lời nhắc quyền của trình duyệt/HĐH được báo cáo là hành động thủ công kèm lý do và
thông báo để tác tử chuyển tiếp. Các phiên Chrome được quản lý chỉ phát phần giới thiệu hoặc
cụm kiểm tra sau khi tình trạng trình duyệt báo cáo `inCall: true`; nếu không, trạng thái báo cáo
`speechReady: false` và lần thử nói bị chặn thay vì giả vờ rằng tác tử đã nói vào cuộc họp.

Các lần tham gia Chrome cục bộ thông qua hồ sơ trình duyệt OpenClaw đã đăng nhập. Chế độ thời gian thực
yêu cầu `BlackHole 2ch` cho đường dẫn micrô/loa mà OpenClaw sử dụng. Để có âm thanh song công sạch,
hãy dùng các thiết bị ảo riêng biệt hoặc một đồ thị kiểu Loopback; một thiết bị BlackHole duy nhất
là đủ cho kiểm thử khói đầu tiên nhưng có thể tạo tiếng vọng.

### Gateway cục bộ + Chrome Parallels

Bạn **không** cần một OpenClaw Gateway đầy đủ hoặc khóa API mô hình bên trong VM macOS
chỉ để VM sở hữu Chrome. Chạy Gateway và tác tử cục bộ, rồi chạy một máy chủ node
trong VM. Bật plugin đóng gói trên VM một lần để node quảng bá lệnh Chrome:

Những gì chạy ở đâu:

- Máy chủ Gateway: OpenClaw Gateway, không gian làm việc tác tử, khóa mô hình/API, nhà cung cấp thời gian thực,
  và cấu hình plugin Google Meet.
- VM macOS Parallels: OpenClaw CLI/máy chủ node, Google Chrome, SoX, BlackHole 2ch,
  và một hồ sơ Chrome đã đăng nhập vào Google.
- Không cần trong VM: dịch vụ Gateway, cấu hình tác tử, khóa OpenAI/GPT, hoặc thiết lập
  nhà cung cấp mô hình.

Cài đặt các phụ thuộc VM:

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

Khởi động lại VM sau khi cài đặt BlackHole để macOS hiển thị `BlackHole 2ch`:

```bash
sudo reboot
```

Sau khi khởi động lại, xác minh VM có thể thấy thiết bị âm thanh và lệnh SoX:

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

Cài đặt hoặc cập nhật OpenClaw trong VM, rồi bật plugin đóng gói ở đó:

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

Khởi động máy chủ node trong VM:

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

Nếu `<gateway-host>` là IP LAN và bạn không dùng TLS, node sẽ từ chối WebSocket
plaintext trừ khi bạn chọn tham gia cho mạng riêng đáng tin cậy đó:

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

Dùng cùng biến môi trường khi cài đặt node làm 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` là môi trường tiến trình, không phải thiết lập
`openclaw.json`. `openclaw node install` lưu nó trong môi trường LaunchAgent
khi nó hiện diện trên lệnh cài đặt.

Phê duyệt node từ máy chủ Gateway:

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

Xác nhận Gateway thấy node và node quảng bá cả `googlemeet.chrome`
lẫn năng lực trình duyệt/`browser.proxy`:

```bash
openclaw nodes status
```

Định tuyến Meet qua node đó trên máy chủ 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",
          },
        },
      },
    },
  },
}
```

Bây giờ tham gia bình thường từ máy chủ Gateway:

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

hoặc yêu cầu tác tử dùng công cụ `google_meet` với `transport: "chrome-node"`.

Đối với kiểm thử khói một lệnh tạo hoặc tái sử dụng một phiên, nói một cụm đã biết,
và in tình trạng phiên:

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

Trong quá trình tham gia realtime, tự động hóa trình duyệt OpenClaw điền tên khách, nhấp
Join/Ask to join và chấp nhận lựa chọn "Use microphone" trong lần chạy đầu của Meet khi
lời nhắc đó xuất hiện. Trong quá trình tham gia chỉ quan sát hoặc tạo cuộc họp chỉ bằng trình duyệt, nó
tiếp tục đi qua cùng lời nhắc đó mà không dùng micrô khi lựa chọn đó có sẵn.
Nếu hồ sơ trình duyệt chưa đăng nhập, Meet đang chờ chủ trì chấp nhận,
Chrome cần quyền micrô/camera để tham gia realtime, hoặc Meet bị kẹt
ở một lời nhắc mà tự động hóa không thể xử lý, kết quả join/test-speech báo cáo
`manualActionRequired: true` với `manualActionReason` và
`manualActionMessage`. Agent nên dừng thử lại thao tác tham gia, báo cáo chính xác
thông báo đó cùng `browserUrl`/`browserTitle` hiện tại, và chỉ thử lại sau khi
hành động thủ công trong trình duyệt đã hoàn tất.

Nếu bỏ qua `chromeNode.node`, OpenClaw chỉ tự động chọn khi đúng một
node đã kết nối quảng bá cả `googlemeet.chrome` và quyền điều khiển trình duyệt. Nếu
nhiều node có khả năng đang kết nối, hãy đặt `chromeNode.node` thành ID node,
tên hiển thị hoặc IP từ xa.

Các kiểm tra lỗi thường gặp:

- `Configured Google Meet node ... is not usable: offline`: node đã ghim
  được Gateway biết đến nhưng không khả dụng. Agent nên xem node đó là
  trạng thái chẩn đoán, không phải máy chủ Chrome có thể dùng, và báo cáo trở ngại thiết lập
  thay vì chuyển sang transport khác trừ khi người dùng yêu cầu như vậy.
- `No connected Google Meet-capable node`: khởi động `openclaw node run` trong VM,
  phê duyệt ghép nối, và bảo đảm `openclaw plugins enable google-meet` và
  `openclaw plugins enable browser` đã được chạy trong VM. Đồng thời xác nhận
  máy chủ Gateway cho phép cả hai lệnh node với
  `gateway.nodes.allowCommands: ["googlemeet.chrome", "browser.proxy"]`.
- `BlackHole 2ch audio device not found`: cài đặt `blackhole-2ch` trên máy chủ
  đang được kiểm tra và khởi động lại trước khi dùng âm thanh Chrome cục bộ.
- `BlackHole 2ch audio device not found on the node`: cài đặt `blackhole-2ch`
  trong VM và khởi động lại VM.
- Chrome mở nhưng không thể tham gia: đăng nhập vào hồ sơ trình duyệt bên trong VM, hoặc
  giữ `chrome.guestName` được đặt để tham gia với tư cách khách. Tự động tham gia với tư cách khách dùng tự động hóa trình duyệt
  OpenClaw thông qua proxy trình duyệt của node; hãy bảo đảm cấu hình trình duyệt của node
  trỏ đến hồ sơ bạn muốn, ví dụ
  `browser.defaultProfile: "user"` hoặc một hồ sơ phiên hiện có có tên.
- Các tab Meet trùng lặp: giữ `chrome.reuseExistingTab: true` được bật. OpenClaw
  kích hoạt tab hiện có cho cùng URL Meet trước khi mở tab mới, và
  việc tạo cuộc họp bằng trình duyệt tái sử dụng một tab `https://meet.google.com/new`
  đang diễn ra hoặc tab lời nhắc tài khoản Google trước khi mở tab khác.
- Không có âm thanh: trong Meet, định tuyến âm thanh micrô/loa qua đường dẫn thiết bị âm thanh ảo
  mà OpenClaw dùng; dùng các thiết bị ảo riêng biệt hoặc định tuyến kiểu Loopback
  để có âm thanh song công sạch.

## Ghi chú cài đặt

Mặc định phản hồi bằng giọng nói của Chrome dùng hai công cụ bên ngoài:

- `sox`: tiện ích âm thanh dòng lệnh. Plugin dùng các lệnh thiết bị CoreAudio
  rõ ràng cho cầu nối âm thanh PCM16 24 kHz mặc định.
- `blackhole-2ch`: trình điều khiển âm thanh ảo macOS. Nó tạo thiết bị âm thanh
  `BlackHole 2ch` để Chrome/Meet có thể định tuyến qua.

OpenClaw không đóng gói hoặc phân phối lại bất kỳ gói nào trong hai gói này. Tài liệu yêu cầu người dùng
cài đặt chúng làm phụ thuộc máy chủ thông qua Homebrew. SoX được cấp phép theo
`LGPL-2.0-only AND GPL-2.0-only`; BlackHole là GPL-3.0. Nếu bạn xây dựng một
trình cài đặt hoặc appliance đóng gói BlackHole cùng OpenClaw, hãy xem lại các
điều khoản cấp phép upstream của BlackHole hoặc lấy giấy phép riêng từ Existential Audio.

## Transport

### Chrome

Transport Chrome mở URL Meet thông qua điều khiển trình duyệt OpenClaw và tham gia
bằng hồ sơ trình duyệt OpenClaw đã đăng nhập. Trên macOS, Plugin kiểm tra
`BlackHole 2ch` trước khi khởi chạy. Nếu được cấu hình, nó cũng chạy lệnh
kiểm tra sức khỏe cầu nối âm thanh và lệnh khởi động trước khi mở Chrome. Dùng `chrome` khi
Chrome/âm thanh chạy trên máy chủ Gateway; dùng `chrome-node` khi Chrome/âm thanh chạy
trên một node đã ghép nối như VM macOS Parallels. Với Chrome cục bộ, chọn
hồ sơ bằng `browser.defaultProfile`; `chrome.browserProfile` được truyền đến
máy chủ `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
```

Định tuyến âm thanh micrô và loa của Chrome qua cầu nối âm thanh OpenClaw cục bộ.
Nếu `BlackHole 2ch` chưa được cài đặt, thao tác tham gia thất bại với lỗi thiết lập
thay vì âm thầm tham gia mà không có đường dẫn âm thanh.

### Twilio

Transport Twilio là một kế hoạch quay số nghiêm ngặt được ủy quyền cho Plugin Voice Call. Nó
không phân tích trang Meet để tìm số điện thoại.

Dùng tùy chọn này khi không thể tham gia bằng Chrome hoặc bạn muốn dự phòng quay số
điện thoại. Google Meet phải hiển thị số quay vào và PIN cho
cuộc họp; OpenClaw không khám phá các thông tin đó từ trang Meet.

Bật Plugin Voice Call trên máy chủ Gateway, không phải trên 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,
      },
    },
  },
}
```

Cung cấp thông tin xác thực Twilio qua môi trường hoặc cấu hình. Môi trường giữ
bí mật bên ngoài `openclaw.json`:

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

Thay vào đó, dùng `realtime.provider: "openai"` với Plugin nhà cung cấp OpenAI và
`OPENAI_API_KEY` nếu đó là nhà cung cấp giọng nói realtime của bạn.

Khởi động lại hoặc tải lại Gateway sau khi bật `voice-call`; các thay đổi cấu hình Plugin
không xuất hiện trong tiến trình Gateway đang chạy cho đến khi tiến trình đó tải lại.

Sau đó xác minh:

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

Khi ủy quyền Twilio đã được nối dây, `googlemeet setup` bao gồm các kiểm tra
`twilio-voice-call-plugin`, `twilio-voice-call-credentials` và
`twilio-voice-call-webhook` thành công.

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

Dùng `--dtmf-sequence` khi cuộc họp cần một chuỗi tùy chỉnh:

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

## OAuth và preflight

OAuth là tùy chọn để tạo liên kết Meet vì `googlemeet create` có thể dự phòng
bằng tự động hóa trình duyệt. Cấu hình OAuth khi bạn muốn tạo bằng API chính thức,
phân giải space hoặc kiểm tra preflight Meet Media API.

Quyền truy cập Google Meet API dùng OAuth người dùng: tạo một ứng dụng khách OAuth Google Cloud,
yêu cầu các scope cần thiết, ủy quyền một tài khoản Google, rồi lưu
refresh token kết quả trong cấu hình Plugin Google Meet hoặc cung cấp các
biến môi trường `OPENCLAW_GOOGLE_MEET_*`.

OAuth không thay thế đường dẫn tham gia bằng Chrome. Các transport Chrome và Chrome-node
vẫn tham gia thông qua hồ sơ Chrome đã đăng nhập, BlackHole/SoX và một node đã kết nối
khi bạn dùng tham gia bằng trình duyệt. OAuth chỉ dành cho đường dẫn Google
Meet API chính thức: tạo meeting spaces, phân giải spaces và chạy kiểm tra preflight
Meet Media API.

### Tạo thông tin xác thực Google

Trong Google Cloud Console:

1. Tạo hoặc chọn một dự án Google Cloud.
2. Bật **Google Meet REST API** cho dự án đó.
3. Cấu hình màn hình đồng ý OAuth.
   - **Internal** là đơn giản nhất cho một tổ chức Google Workspace.
   - **External** hoạt động cho các thiết lập cá nhân/thử nghiệm; khi ứng dụng đang ở Testing,
     hãy thêm từng tài khoản Google sẽ ủy quyền ứng dụng làm người dùng thử nghiệm.
4. Thêm các scope OpenClaw yêu cầu:
   - `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. Tạo ID ứng dụng khách OAuth.
   - Loại ứng dụng: **Web application**.
   - URI chuyển hướng được ủy quyền:

     ```text
     http://localhost:8085/oauth2callback
     ```

6. Sao chép ID ứng dụng khách và bí mật ứng dụng khách.

`meetings.space.created` được Google Meet `spaces.create` yêu cầu.
`meetings.space.readonly` cho phép OpenClaw phân giải URL/mã Meet thành spaces.
`meetings.space.settings` cho phép OpenClaw truyền các thiết lập `SpaceConfig` như
`accessType` trong quá trình tạo phòng bằng API.
`meetings.conference.media.readonly` dành cho preflight Meet Media API và công việc
media; Google có thể yêu cầu đăng ký Developer Preview để dùng Media API thực tế.
Nếu bạn chỉ cần các lượt tham gia Chrome dựa trên trình duyệt, hãy bỏ qua OAuth hoàn toàn.

### Tạo refresh token

Cấu hình `oauth.clientId` và tùy chọn `oauth.clientSecret`, hoặc truyền chúng làm
biến môi trường, rồi chạy:

```bash
openclaw googlemeet auth login --json
```

Lệnh in ra một khối cấu hình `oauth` có refresh token. Nó dùng PKCE,
callback localhost tại `http://localhost:8085/oauth2callback` và một luồng
sao chép/dán thủ công với `--manual`.

Ví dụ:

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

Dùng chế độ thủ công khi trình duyệt không thể truy cập callback cục bộ:

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

Đầu ra JSON bao gồm:

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

Lưu đối tượng `oauth` dưới cấu hình Plugin Google Meet:

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

Ưu tiên biến môi trường khi bạn không muốn refresh token nằm trong cấu hình.
Nếu cả giá trị cấu hình và môi trường đều hiện diện, Plugin phân giải cấu hình
trước rồi mới dự phòng sang môi trường.

Màn hình đồng ý OAuth bao gồm quyền tạo Meet space, quyền đọc Meet space và quyền đọc
media hội nghị Meet. Nếu bạn đã xác thực trước khi hỗ trợ tạo cuộc họp
tồn tại, hãy chạy lại `openclaw googlemeet auth login --json` để refresh
token có scope `meetings.space.created`.

### Xác minh OAuth bằng doctor

Chạy OAuth doctor khi bạn muốn kiểm tra sức khỏe nhanh, không tiết lộ bí mật:

```bash
openclaw googlemeet doctor --oauth --json
```

Thao tác này không tải runtime Chrome hoặc yêu cầu node Chrome đã kết nối. Nó
kiểm tra rằng cấu hình OAuth tồn tại và refresh token có thể tạo access
token. Báo cáo JSON chỉ bao gồm các trường trạng thái như `ok`, `configured`,
`tokenSource`, `expiresAt` và thông báo kiểm tra; nó không in access
token, refresh token hoặc bí mật ứng dụng khách.

Kết quả thường gặp:

| Kiểm tra             | Ý nghĩa                                                                                 |
| -------------------- | --------------------------------------------------------------------------------------- |
| `oauth-config`       | Có `oauth.clientId` cùng với `oauth.refreshToken`, hoặc một mã truy cập đã lưu cache.   |
| `oauth-token`        | Mã truy cập đã lưu cache vẫn còn hợp lệ, hoặc mã làm mới đã tạo một mã truy cập mới.    |
| `meet-spaces-get`    | Kiểm tra `--meeting` tùy chọn đã phân giải một không gian Meet hiện có.                 |
| `meet-spaces-create` | Kiểm tra `--create-space` tùy chọn đã tạo một không gian Meet mới.                      |

Để chứng minh việc bật Google Meet API và phạm vi `spaces.create`, hãy chạy
kiểm tra tạo có tác dụng phụ:

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

`--create-space` tạo một URL Meet dùng tạm. Dùng tùy chọn này khi bạn cần xác nhận
rằng dự án Google Cloud đã bật Meet API và tài khoản được ủy quyền có phạm vi
`meetings.space.created`.

Để chứng minh quyền đọc cho một không gian cuộc họp hiện có:

```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` và `resolve-space` chứng minh quyền đọc đối với một
không gian hiện có mà tài khoản Google được ủy quyền có thể truy cập. Mã `403`
từ các kiểm tra này thường có nghĩa là Google Meet REST API bị tắt, mã làm mới
đã đồng ý thiếu phạm vi bắt buộc, hoặc tài khoản Google không thể truy cập
không gian Meet đó. Lỗi mã làm mới có nghĩa là chạy lại `openclaw googlemeet auth login
--json` và lưu khối `oauth` mới.

Không cần thông tin xác thực OAuth cho phương án dự phòng bằng trình duyệt. Trong
chế độ đó, xác thực Google đến từ hồ sơ Chrome đã đăng nhập trên Node đã chọn,
không đến từ cấu hình OpenClaw.

Các biến môi trường này được chấp nhận làm phương án dự phòng:

- `OPENCLAW_GOOGLE_MEET_CLIENT_ID` hoặc `GOOGLE_MEET_CLIENT_ID`
- `OPENCLAW_GOOGLE_MEET_CLIENT_SECRET` hoặc `GOOGLE_MEET_CLIENT_SECRET`
- `OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN` hoặc `GOOGLE_MEET_REFRESH_TOKEN`
- `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN` hoặc `GOOGLE_MEET_ACCESS_TOKEN`
- `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT` hoặc
  `GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT`
- `OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING` hoặc `GOOGLE_MEET_DEFAULT_MEETING`
- `OPENCLAW_GOOGLE_MEET_PREVIEW_ACK` hoặc `GOOGLE_MEET_PREVIEW_ACK`

Phân giải một URL Meet, mã hoặc `spaces/{id}` thông qua `spaces.get`:

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

Chạy kiểm tra trước khi làm việc với phương tiện:

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

Liệt kê hiện vật cuộc họp và điểm danh sau khi Meet đã tạo bản ghi hội nghị:

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

Với `--meeting`, `artifacts` và `attendance` mặc định dùng bản ghi hội nghị mới
nhất. Truyền `--all-conference-records` khi bạn muốn mọi bản ghi được giữ lại
cho cuộc họp đó.

Tra cứu Calendar có thể phân giải URL cuộc họp từ Google Calendar trước khi đọc
hiện vật 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` tìm kiếm lịch `primary` của hôm nay để tìm một sự kiện Calendar có
liên kết Google Meet. Dùng `--event <query>` để tìm văn bản sự kiện khớp, và
`--calendar <id>` cho lịch không phải lịch chính. Tra cứu Calendar yêu cầu đăng
nhập OAuth mới có bao gồm phạm vi chỉ đọc sự kiện Calendar.
`calendar-events` xem trước các sự kiện Meet khớp và đánh dấu sự kiện mà
`latest`, `artifacts`, `attendance` hoặc `export` sẽ chọn.

Nếu bạn đã biết id bản ghi hội nghị, hãy gọi trực tiếp:

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

Kết thúc một hội nghị đang hoạt động cho một không gian được tạo bằng API khi
bạn muốn đóng phòng sau cuộc gọi:

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

Lệnh này gọi Google Meet `spaces.endActiveConference` và yêu cầu OAuth với phạm
vi `meetings.space.created` cho một không gian mà tài khoản được ủy quyền có thể
quản lý. OpenClaw chấp nhận đầu vào là URL Meet, mã cuộc họp hoặc `spaces/{id}`
và phân giải đầu vào đó thành tài nguyên không gian API trước khi kết thúc hội
nghị đang hoạt động.
Lệnh này tách biệt với `googlemeet leave`: `leave` dừng sự tham gia cục bộ/phiên
của OpenClaw, còn `end-active-conference` yêu cầu Google Meet kết thúc hội nghị
đang hoạt động cho không gian.

Ghi một báo cáo dễ đọc:

```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` trả về siêu dữ liệu bản ghi hội nghị cùng với siêu dữ liệu tài
nguyên về người tham gia, bản ghi âm, bản chép lời, mục bản chép lời có cấu trúc
và ghi chú thông minh khi Google cung cấp cho cuộc họp. Dùng
`--no-transcript-entries` để bỏ qua tra cứu mục cho các cuộc họp lớn.
`attendance` mở rộng người tham gia thành các hàng phiên người tham gia với thời
điểm được thấy lần đầu/lần cuối, tổng thời lượng phiên, cờ đến muộn/rời sớm, và
các tài nguyên người tham gia trùng lặp được hợp nhất theo người dùng đã đăng
nhập hoặc tên hiển thị. Truyền `--no-merge-duplicates` để giữ riêng các tài
nguyên người tham gia thô, `--late-after-minutes` để tinh chỉnh phát hiện đến
muộn, và `--early-before-minutes` để tinh chỉnh phát hiện rời sớm.

`export` ghi một thư mục chứa `summary.md`, `attendance.csv`,
`transcript.md`, `artifacts.json`, `attendance.json` và `manifest.json`.
`manifest.json` ghi lại đầu vào đã chọn, tùy chọn xuất, bản ghi hội nghị,
tệp đầu ra, số lượng, nguồn mã, sự kiện Calendar khi có dùng, và mọi cảnh báo
truy xuất một phần. Truyền `--zip` để cũng ghi một kho lưu trữ di động bên cạnh
thư mục. Truyền `--include-doc-bodies` để xuất văn bản Google Docs của bản chép
lời và ghi chú thông minh được liên kết thông qua Google Drive `files.export`;
việc này yêu cầu đăng nhập OAuth mới có bao gồm phạm vi chỉ đọc Drive Meet. Nếu
không có `--include-doc-bodies`, bản xuất chỉ bao gồm siêu dữ liệu Meet và các
mục bản chép lời có cấu trúc. Nếu Google trả về lỗi hiện vật một phần, chẳng hạn
như lỗi liệt kê ghi chú thông minh, mục bản chép lời, hoặc nội dung tài liệu
Drive, phần tóm tắt và manifest giữ lại cảnh báo thay vì làm hỏng toàn bộ bản
xuất.
Dùng `--dry-run` để lấy cùng dữ liệu hiện vật/điểm danh và in JSON manifest mà
không tạo thư mục hoặc ZIP. Điều này hữu ích trước khi ghi một bản xuất lớn hoặc
khi một tác tử chỉ cần số lượng, bản ghi đã chọn và cảnh báo.

Tác tử cũng có thể tạo cùng gói thông qua công cụ `google_meet`:

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

Đặt `"dryRun": true` để chỉ trả về manifest xuất và bỏ qua ghi tệp.

Tác tử cũng có thể tạo phòng được hỗ trợ bằng API với chính sách truy cập rõ
ràng:

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

Và chúng có thể kết thúc hội nghị đang hoạt động cho một phòng đã biết:

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

Để xác thực nghe trước, tác tử nên dùng `test_listen` trước khi khẳng định cuộc
họp hữu ích:

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

Chạy kiểm tra live smoke được bảo vệ với một cuộc họp thực được giữ lại:

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

Chạy phép dò trình duyệt nghe trước trực tiếp với một cuộc họp nơi có người sẽ
nói và phụ đề Meet khả dụng:

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

Môi trường live smoke:

- `OPENCLAW_LIVE_TEST=1` bật các kiểm thử trực tiếp được bảo vệ.
- `OPENCLAW_GOOGLE_MEET_LIVE_MEETING` trỏ đến một URL Meet, mã hoặc
  `spaces/{id}` được giữ lại.
- `OPENCLAW_GOOGLE_MEET_CLIENT_ID` hoặc `GOOGLE_MEET_CLIENT_ID` cung cấp id ứng
  dụng OAuth.
- `OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN` hoặc `GOOGLE_MEET_REFRESH_TOKEN` cung cấp
  mã làm mới.
- Tùy chọn: `OPENCLAW_GOOGLE_MEET_CLIENT_SECRET`,
  `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN`, và
  `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT` dùng cùng tên dự phòng
  không có tiền tố `OPENCLAW_`.

Live smoke hiện vật/điểm danh cơ sở cần
`https://www.googleapis.com/auth/meetings.space.readonly` và
`https://www.googleapis.com/auth/meetings.conference.media.readonly`. Tra cứu
Calendar cần `https://www.googleapis.com/auth/calendar.events.readonly`. Xuất
nội dung tài liệu Drive cần
`https://www.googleapis.com/auth/drive.meet.readonly`.

Tạo một không gian Meet mới:

```bash
openclaw googlemeet create
```

Lệnh này in `meeting uri`, nguồn và phiên tham gia mới. Với thông tin xác thực
OAuth, lệnh dùng Google Meet API chính thức. Không có thông tin xác thực OAuth,
lệnh dùng hồ sơ trình duyệt đã đăng nhập của Node Chrome đã ghim làm phương án
dự phòng. Tác tử có thể dùng công cụ `google_meet` với `action: "create"` để tạo
và tham gia trong một bước. Để chỉ tạo URL, truyền `"join": false`.

Ví dụ đầu ra JSON từ phương án dự phòng bằng trình duyệt:

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

Nếu phương án dự phòng bằng trình duyệt gặp đăng nhập Google hoặc bộ chặn quyền
Meet trước khi có thể tạo URL, phương thức Gateway trả về phản hồi thất bại và
công cụ `google_meet` trả về chi tiết có cấu trúc thay vì một chuỗi thuần:

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

Khi một tác tử thấy `manualActionRequired: true`, tác tử nên báo cáo
`manualActionMessage` cùng với ngữ cảnh Node/tab trình duyệt và dừng mở các tab
Meet mới cho đến khi người vận hành hoàn tất bước trên trình duyệt.

Ví dụ đầu ra JSON từ tạo bằng 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"
    }
  }
}
```

Việc tạo một Meet sẽ tham gia theo mặc định. Transport Chrome hoặc Chrome-node vẫn
cần một hồ sơ Google Chrome đã đăng nhập để tham gia qua trình duyệt. Nếu hồ sơ
đã đăng xuất, OpenClaw sẽ báo cáo `manualActionRequired: true` hoặc một lỗi dự
phòng của trình duyệt và yêu cầu người vận hành hoàn tất đăng nhập Google trước
khi thử lại.

Chỉ đặt `preview.enrollmentAcknowledged: true` sau khi xác nhận dự án Cloud,
OAuth principal và người tham gia cuộc họp của bạn đã được ghi danh vào Google
Workspace Developer Preview Program cho Meet media APIs.

## Cấu hình

Đường dẫn Chrome agent chung chỉ cần bật Plugin, BlackHole, SoX, khóa nhà cung
cấp phiên âm thời gian thực, và nhà cung cấp OpenClaw TTS đã cấu hình. OpenAI là
nhà cung cấp phiên âm mặc định; đặt `realtime.voiceProvider` thành `"google"` và
`realtime.model` để dùng Google Gemini Live cho chế độ `bidi` mà không thay đổi
nhà cung cấp phiên âm mặc định của chế độ agent:

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

Đặt cấu hình Plugin dưới `plugins.entries.google-meet.config`:

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

Mặc định:

- `defaultTransport: "chrome"`
- `defaultMode: "agent"` (`"realtime"` chỉ được chấp nhận như bí danh tương thích
  cũ cho `"agent"`; các lệnh gọi công cụ mới nên dùng `"agent"`)
- `chromeNode.node`: id/tên/IP Node tùy chọn cho `chrome-node`
- `chrome.audioBackend: "blackhole-2ch"`
- `chrome.guestName: "OpenClaw Agent"`: tên dùng trên màn hình khách Meet đã
  đăng xuất
- `chrome.autoJoin: true`: nỗ lực tốt nhất để điền tên khách và bấm Join Now
  thông qua tự động hóa trình duyệt OpenClaw trên `chrome-node`
- `chrome.reuseExistingTab: true`: kích hoạt một tab Meet hiện có thay vì mở
  các tab trùng lặp
- `chrome.waitForInCallMs: 20000`: chờ tab Meet báo cáo đang trong cuộc gọi
  trước khi kích hoạt lời giới thiệu phản hồi bằng giọng nói
- `chrome.audioFormat: "pcm16-24khz"`: định dạng âm thanh cặp lệnh. Chỉ dùng
  `"g711-ulaw-8khz"` cho các cặp lệnh cũ/tùy chỉnh vẫn phát ra âm thanh điện
  thoại.
- `chrome.audioBufferBytes: 4096`: bộ đệm xử lý SoX cho các lệnh âm thanh cặp
  lệnh Chrome được tạo. Đây là một nửa bộ đệm mặc định 8192 byte của SoX, giảm
  độ trễ pipe mặc định trong khi vẫn chừa chỗ để tăng trên các máy chủ bận.
  Các giá trị thấp hơn mức tối thiểu của SoX được giới hạn thành 17 byte.
- `chrome.audioInputCommand`: lệnh SoX đọc từ CoreAudio `BlackHole 2ch` và ghi
  âm thanh theo `chrome.audioFormat`
- `chrome.audioOutputCommand`: lệnh SoX đọc âm thanh theo `chrome.audioFormat`
  và ghi vào CoreAudio `BlackHole 2ch`
- `chrome.bargeInInputCommand`: lệnh micro cục bộ tùy chọn ghi PCM mono
  little-endian 16-bit có dấu để phát hiện người dùng chen ngang khi phát lại
  trợ lý đang hoạt động. Hiện tại mục này áp dụng cho cầu nối cặp lệnh `chrome`
  do Gateway lưu trữ.
- `chrome.bargeInRmsThreshold: 650`: mức RMS được tính là một lần chen ngang của
  người dùng trên `chrome.bargeInInputCommand`
- `chrome.bargeInPeakThreshold: 2500`: mức đỉnh được tính là một lần chen ngang
  của người dùng trên `chrome.bargeInInputCommand`
- `chrome.bargeInCooldownMs: 900`: độ trễ tối thiểu giữa các lần xóa chen ngang
  lặp lại của người dùng
- `mode: "agent"`: chế độ phản hồi bằng giọng nói mặc định. Lời nói của người
  tham gia được phiên âm bởi nhà cung cấp phiên âm thời gian thực đã cấu hình,
  gửi đến OpenClaw agent đã cấu hình trong một phiên sub-agent theo từng cuộc
  họp, rồi được đọc lại qua runtime OpenClaw TTS bình thường.
- `mode: "bidi"`: chế độ dự phòng mô hình thời gian thực hai chiều trực tiếp.
  Nhà cung cấp giọng nói thời gian thực trả lời trực tiếp lời nói của người tham
  gia và có thể gọi `openclaw_agent_consult` để có câu trả lời sâu hơn/dựa trên
  công cụ.
- `mode: "transcribe"`: chế độ chỉ quan sát, không có cầu nối phản hồi bằng giọng
  nói.
- `realtime.provider: "openai"`: dự phòng tương thích dùng khi các trường nhà
  cung cấp theo phạm vi bên dưới chưa được đặt.
- `realtime.transcriptionProvider: "openai"`: id nhà cung cấp được chế độ
  `agent` dùng cho phiên âm thời gian thực.
- `realtime.voiceProvider`: id nhà cung cấp được chế độ `bidi` dùng cho giọng nói
  thời gian thực trực tiếp. Đặt mục này thành `"google"` để dùng Gemini Live
  trong khi vẫn giữ phiên âm chế độ agent trên OpenAI.
- `realtime.toolPolicy: "safe-read-only"`
- `realtime.instructions`: câu trả lời nói ngắn gọn, kèm
  `openclaw_agent_consult` cho các câu trả lời sâu hơn
- `realtime.introMessage`: kiểm tra trạng thái sẵn sàng ngắn bằng giọng nói khi
  cầu nối thời gian thực kết nối; đặt thành `""` để tham gia im lặng
- `realtime.agentId`: id OpenClaw agent tùy chọn cho
  `openclaw_agent_consult`; mặc định là `main`

Ghi đè tùy chọn:

```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 cho cả nghe và nói ở chế độ agent:

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

Giọng nói Meet bền vững đến từ
`messages.tts.providers.elevenlabs.voiceId`. Câu trả lời của agent cũng có thể
dùng chỉ thị theo từng câu trả lời `[[tts:voiceId=... model=eleven_v3]]` khi bật
ghi đè mô hình TTS, nhưng cấu hình là mặc định xác định cho cuộc họp. Khi tham
gia, nhật ký nên hiển thị `transcriptionProvider=elevenlabs` và mỗi câu trả lời
được nói nên ghi `provider=elevenlabs model=eleven_v3 voice=<voiceId>`.

Cấu hình chỉ Twilio:

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

`voiceCall.enabled` mặc định là `true`; với transport Twilio, nó ủy quyền cuộc
gọi PSTN thực tế, DTMF và lời chào mở đầu cho Plugin Voice Call. Voice Call phát
chuỗi DTMF trước khi mở luồng phương tiện thời gian thực, rồi dùng văn bản mở
đầu đã lưu làm lời chào thời gian thực ban đầu. Nếu `voice-call` chưa được bật,
Google Meet vẫn có thể xác thực và ghi lại kế hoạch quay số, nhưng không thể
thực hiện cuộc gọi Twilio.

## Công cụ

Agent có thể dùng công cụ `google_meet`:

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

Dùng `transport: "chrome"` khi Chrome chạy trên máy chủ Gateway. Dùng
`transport: "chrome-node"` khi Chrome chạy trên một Node đã ghép đôi như máy ảo
Parallels. Trong cả hai trường hợp, các nhà cung cấp mô hình và
`openclaw_agent_consult` chạy trên máy chủ Gateway, nên thông tin xác thực mô
hình vẫn ở đó. Với `mode: "agent"` mặc định, nhà cung cấp phiên âm thời gian
thực xử lý việc lắng nghe, OpenClaw agent đã cấu hình tạo câu trả lời, và
OpenClaw TTS thông thường nói câu đó vào Meet. Dùng `mode: "bidi"` khi bạn muốn
mô hình giọng nói thời gian thực trả lời trực tiếp. `mode: "realtime"` thô vẫn
được chấp nhận như bí danh tương thích cũ cho `mode: "agent"`, nhưng không còn
được quảng bá trong schema công cụ agent. Nhật ký chế độ agent bao gồm nhà cung
cấp/mô hình phiên âm đã phân giải khi khởi động cầu nối và nhà cung cấp TTS, mô
hình, giọng nói, định dạng đầu ra và tốc độ lấy mẫu sau mỗi câu trả lời được
tổng hợp.

Dùng `action: "status"` để liệt kê các phiên đang hoạt động hoặc kiểm tra một
session ID. Dùng `action: "speak"` với `sessionId` và `message` để yêu cầu agent
thời gian thực nói ngay lập tức. Dùng `action: "test_speech"` để tạo hoặc tái sử
dụng phiên, kích hoạt một cụm từ đã biết, và trả về tình trạng `inCall` khi máy
chủ Chrome có thể báo cáo. `test_speech` luôn buộc `mode: "agent"` và thất bại
nếu được yêu cầu chạy ở `mode: "transcribe"` vì các phiên chỉ quan sát cố ý
không thể phát ra lời nói. Kết quả `speechOutputVerified` của nó dựa trên số
byte đầu ra âm thanh thời gian thực tăng trong lệnh gọi kiểm thử này, nên một
phiên được tái sử dụng có âm thanh cũ hơn không được tính là kiểm tra lời nói
thành công mới. Dùng `action: "leave"` để đánh dấu một phiên đã kết thúc.

`status` bao gồm tình trạng Chrome khi có sẵn:

- `inCall`: Chrome có vẻ đang ở trong cuộc gọi Meet
- `micMuted`: trạng thái micro Meet theo nỗ lực tốt nhất
- `manualActionRequired` / `manualActionReason` / `manualActionMessage`: hồ sơ
  trình duyệt cần đăng nhập thủ công, được chủ phòng Meet chấp nhận, quyền, hoặc
  sửa chữa điều khiển trình duyệt trước khi lời nói có thể hoạt động
- `speechReady` / `speechBlockedReason` / `speechBlockedMessage`: liệu giọng nói
  Chrome được quản lý hiện có được phép hay không. `speechReady: false` nghĩa là
  OpenClaw không gửi cụm từ mở đầu/kiểm thử vào cầu nối âm thanh.
- `providerConnected` / `realtimeReady`: trạng thái cầu nối giọng nói thời gian
  thực
- `lastInputAt` / `lastOutputAt`: âm thanh cuối cùng được thấy từ cầu nối hoặc
  gửi đến cầu nối
- `audioOutputRouted` / `audioOutputDeviceLabel`: liệu đầu ra phương tiện của tab
  Meet có được định tuyến chủ động đến thiết bị BlackHole dùng bởi cầu nối hay
  không
- `lastSuppressedInputAt` / `suppressedInputBytes`: đầu vào loopback bị bỏ qua
  khi phát lại trợ lý đang hoạt động

```json
{
  "action": "speak",
  "sessionId": "meet_...",
  "message": "Say exactly: I'm here and listening."
}
```

## Chế độ agent và bidi

Chế độ Chrome `agent` được tối ưu cho hành vi "agent của tôi đang ở trong cuộc
họp". Nhà cung cấp phiên âm thời gian thực nghe âm thanh cuộc họp, bản phiên âm
cuối cùng của người tham gia được định tuyến qua OpenClaw agent đã cấu hình, và
câu trả lời được nói qua runtime OpenClaw TTS bình thường. Đặt `mode: "bidi"`
khi bạn muốn mô hình giọng nói thời gian thực trả lời trực tiếp.
Các mảnh bản phiên âm cuối gần nhau được gộp lại trước khi tham vấn để một lượt
nói không tạo ra nhiều câu trả lời từng phần đã cũ. Đầu vào thời gian thực cũng
bị chặn khi âm thanh trợ lý đã xếp hàng vẫn đang phát,
và các tiếng vọng bản phiên âm gần đây giống trợ lý sẽ bị bỏ qua trước khi tham
vấn agent để loopback BlackHole không khiến agent trả lời chính lời nói của nó.

| Chế độ  | Ai quyết định câu trả lời     | Đường dẫn đầu ra lời nói               | Dùng khi                                               |
| ------- | ----------------------------- | -------------------------------------- | ----------------------------------------------------- |
| `agent` | OpenClaw agent đã cấu hình    | Runtime OpenClaw TTS bình thường       | Bạn muốn hành vi "agent của tôi đang ở trong cuộc họp" |
| `bidi`  | Mô hình giọng nói thời gian thực | Phản hồi âm thanh của nhà cung cấp giọng nói thời gian thực | Bạn muốn vòng lặp giọng nói hội thoại có độ trễ thấp nhất |

Ở chế độ `bidi`, khi mô hình thời gian thực cần suy luận sâu hơn, thông tin hiện
tại, hoặc các công cụ OpenClaw bình thường, nó có thể gọi
`openclaw_agent_consult`.

Công cụ tham vấn chạy agent OpenClaw thông thường ở hậu trường với ngữ cảnh bản chép lời cuộc họp gần đây và trả về một câu trả lời nói ngắn gọn. Ở chế độ `agent`, OpenClaw gửi câu trả lời đó trực tiếp đến runtime TTS; ở chế độ `bidi`, mô hình giọng nói realtime có thể nói kết quả tham vấn lại vào cuộc họp. Công cụ này dùng cùng cơ chế tham vấn dùng chung như Voice Call.

Theo mặc định, các lượt tham vấn chạy với agent `main`. Đặt `realtime.agentId` khi một làn Meet cần tham vấn một không gian làm việc agent OpenClaw chuyên dụng, các mặc định mô hình, chính sách công cụ, bộ nhớ và lịch sử phiên riêng.

Các lượt tham vấn ở chế độ agent dùng khóa phiên theo từng cuộc họp `agent:<id>:subagent:google-meet:<session>` để các câu hỏi tiếp theo giữ ngữ cảnh cuộc họp trong khi kế thừa chính sách agent thông thường từ agent đã cấu hình.

`realtime.toolPolicy` kiểm soát lượt chạy tham vấn:

- `safe-read-only`: hiển thị công cụ tham vấn và giới hạn agent thông thường ở `read`, `web_search`, `web_fetch`, `x_search`, `memory_search` và `memory_get`.
- `owner`: hiển thị công cụ tham vấn và cho phép agent thông thường dùng chính sách công cụ agent thông thường.
- `none`: không hiển thị công cụ tham vấn cho mô hình giọng nói realtime.

Khóa phiên tham vấn được giới hạn theo từng phiên Meet, nên các lệnh gọi tham vấn tiếp theo có thể tái sử dụng ngữ cảnh tham vấn trước đó trong cùng cuộc họp.

Để buộc kiểm tra trạng thái sẵn sàng bằng giọng nói sau khi Chrome đã tham gia hoàn toàn cuộc gọi:

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

Đối với kiểm tra smoke tham gia-và-nói đầy đủ:

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

## Danh sách kiểm tra thử nghiệm live

Dùng trình tự này trước khi giao cuộc họp cho một agent không có người giám sát:

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

Trạng thái Chrome-node kỳ vọng:

- `googlemeet setup` đều màu xanh.
- `googlemeet setup` bao gồm `chrome-node-connected` khi Chrome-node là transport mặc định hoặc một node được ghim.
- `nodes status` hiển thị node đã chọn đang kết nối.
- Node đã chọn quảng bá cả `googlemeet.chrome` và `browser.proxy`.
- Thẻ Meet tham gia cuộc gọi và `test-speech` trả về tình trạng Chrome với `inCall: true`.

Đối với máy chủ Chrome từ xa như máy ảo Parallels macOS, đây là kiểm tra an toàn ngắn nhất sau khi cập nhật Gateway hoặc máy ảo:

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

Điều đó chứng minh Plugin Gateway đã được tải, node máy ảo được kết nối với token hiện tại, và cầu âm thanh Meet khả dụng trước khi agent mở một thẻ cuộc họp thật.

Đối với kiểm tra smoke Twilio, hãy dùng một cuộc họp có chi tiết quay số điện thoại:

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

Trạng thái Twilio kỳ vọng:

- `googlemeet setup` bao gồm các kiểm tra màu xanh `twilio-voice-call-plugin`, `twilio-voice-call-credentials` và `twilio-voice-call-webhook`.
- `voicecall` khả dụng trong CLI sau khi Gateway tải lại.
- Phiên được trả về có `transport: "twilio"` và một `twilio.voiceCallId`.
- `openclaw logs --follow` hiển thị DTMF TwiML được phục vụ trước realtime TwiML, sau đó là một cầu realtime với lời chào ban đầu đã được xếp hàng.
- `googlemeet leave <sessionId>` gác cuộc gọi thoại đã ủy quyền.

## Khắc phục sự cố

### Agent không thấy công cụ Google Meet

Xác nhận Plugin được bật trong cấu hình Gateway và tải lại Gateway:

```bash
openclaw plugins list | grep google-meet
openclaw googlemeet setup
```

Nếu bạn vừa chỉnh sửa `plugins.entries.google-meet`, hãy khởi động lại hoặc tải lại Gateway. Agent đang chạy chỉ thấy các công cụ Plugin do tiến trình Gateway hiện tại đăng ký.

Trên các máy chủ Gateway không phải macOS, công cụ dành cho agent `google_meet` vẫn hiển thị, nhưng các hành động nói ngược lại bằng Chrome cục bộ bị chặn trước khi chạm tới cầu âm thanh. Âm thanh nói ngược lại bằng Chrome cục bộ hiện phụ thuộc vào `BlackHole 2ch` của macOS, nên agent Linux nên dùng `mode: "transcribe"`, quay số Twilio, hoặc máy chủ `chrome-node` macOS thay vì đường dẫn agent Chrome cục bộ mặc định.

### Không có node hỗ trợ Google Meet đang kết nối

Trên máy chủ node, chạy:

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

Trên máy chủ Gateway, phê duyệt node và xác minh các lệnh:

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

Node phải được kết nối và liệt kê `googlemeet.chrome` cùng với `browser.proxy`. Cấu hình Gateway phải cho phép các lệnh node đó:

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

Nếu `googlemeet setup` thất bại ở `chrome-node-connected` hoặc nhật ký Gateway báo cáo `gateway token mismatch`, hãy cài đặt lại hoặc khởi động lại node với token Gateway hiện tại. Đối với Gateway trong LAN, điều này thường có nghĩa là:

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

Sau đó tải lại dịch vụ node và chạy lại:

```bash
openclaw googlemeet setup
openclaw nodes status --connected
```

### Trình duyệt mở nhưng agent không thể tham gia

Chạy `googlemeet test-listen` cho các lượt tham gia chỉ quan sát hoặc `googlemeet test-speech` cho các lượt tham gia realtime, rồi kiểm tra tình trạng Chrome được trả về. Nếu một trong hai phép thăm dò báo cáo `manualActionRequired: true`, hãy hiển thị `manualActionMessage` cho người vận hành và dừng thử lại cho đến khi hành động trong trình duyệt hoàn tất.

Các hành động thủ công phổ biến:

- Đăng nhập vào hồ sơ Chrome.
- Cho phép khách vào từ tài khoản máy chủ Meet.
- Cấp quyền microphone/camera cho Chrome khi lời nhắc quyền gốc của Chrome xuất hiện.
- Đóng hoặc sửa hộp thoại quyền Meet bị kẹt.

Đừng báo cáo "chưa đăng nhập" chỉ vì Meet hiển thị "Do you want people to hear you in the meeting?" Đó là màn hình xen kẽ lựa chọn âm thanh của Meet; OpenClaw nhấp **Use microphone** qua tự động hóa trình duyệt khi có sẵn và tiếp tục chờ trạng thái cuộc họp thật. Đối với fallback trình duyệt chỉ tạo, OpenClaw có thể nhấp **Continue without microphone** vì việc tạo URL không cần đường dẫn âm thanh realtime.

### Tạo cuộc họp thất bại

`googlemeet create` trước tiên dùng endpoint Google Meet API `spaces.create` khi thông tin xác thực OAuth đã được cấu hình. Không có thông tin xác thực OAuth, nó fallback sang trình duyệt node Chrome đã ghim. Xác nhận:

- Đối với tạo qua API: `oauth.clientId` và `oauth.refreshToken` đã được cấu hình, hoặc các biến môi trường `OPENCLAW_GOOGLE_MEET_*` tương ứng có mặt.
- Đối với tạo qua API: token làm mới được phát hành sau khi hỗ trợ tạo được thêm vào. Các token cũ hơn có thể thiếu phạm vi `meetings.space.created`; chạy lại `openclaw googlemeet auth login --json` và cập nhật cấu hình Plugin.
- Đối với fallback trình duyệt: `defaultTransport: "chrome-node"` và `chromeNode.node` trỏ đến một node đang kết nối có `browser.proxy` và `googlemeet.chrome`.
- Đối với fallback trình duyệt: hồ sơ OpenClaw Chrome trên node đó đã đăng nhập vào Google và có thể mở `https://meet.google.com/new`.
- Đối với fallback trình duyệt: các lần thử lại tái sử dụng thẻ `https://meet.google.com/new` hiện có hoặc thẻ lời nhắc tài khoản Google trước khi mở thẻ mới. Nếu một agent hết thời gian chờ, hãy thử lại lệnh gọi công cụ thay vì tự mở thêm một thẻ Meet khác.
- Đối với fallback trình duyệt: nếu công cụ trả về `manualActionRequired: true`, hãy dùng `browser.nodeId`, `browser.targetId`, `browserUrl` và `manualActionMessage` được trả về để hướng dẫn người vận hành. Đừng thử lại trong vòng lặp cho đến khi hành động đó hoàn tất.
- Đối với fallback trình duyệt: nếu Meet hiển thị "Do you want people to hear you in the meeting?", hãy để thẻ mở. OpenClaw nên nhấp **Use microphone** hoặc, đối với fallback chỉ tạo, **Continue without microphone** qua tự động hóa trình duyệt và tiếp tục chờ URL Meet được tạo. Nếu không thể, lỗi nên đề cập `meet-audio-choice-required`, không phải `google-login-required`.

### Agent tham gia nhưng không nói

Kiểm tra đường dẫn realtime:

```bash
openclaw googlemeet setup
openclaw googlemeet doctor
```

Dùng `mode: "agent"` cho đường dẫn nói ngược lại STT -> agent OpenClaw -> TTS thông thường, hoặc `mode: "bidi"` cho fallback giọng nói realtime trực tiếp. `mode: "transcribe"` cố ý không khởi động cầu nói ngược lại. Để gỡ lỗi chỉ quan sát, chạy `openclaw googlemeet status --json <session-id>` sau khi người tham gia nói và kiểm tra `captioning`, `transcriptLines` và `lastCaptionText`. Nếu `inCall` là true nhưng `transcriptLines` vẫn ở `0`, phụ đề Meet có thể đã bị tắt, chưa ai nói kể từ khi trình quan sát được cài đặt, UI Meet đã thay đổi, hoặc phụ đề live không khả dụng cho ngôn ngữ/tài khoản cuộc họp.

`googlemeet test-speech` luôn kiểm tra đường dẫn realtime và báo cáo liệu các byte đầu ra của cầu có được quan sát cho lần gọi đó hay không. Nếu `speechOutputVerified` là false và `speechOutputTimedOut` là true, nhà cung cấp realtime có thể đã chấp nhận phát ngôn nhưng OpenClaw không thấy byte đầu ra mới tới cầu âm thanh Chrome.

Cũng xác minh:

- Khóa nhà cung cấp realtime khả dụng trên máy chủ Gateway, chẳng hạn như `OPENAI_API_KEY` hoặc `GEMINI_API_KEY`.
- `BlackHole 2ch` hiển thị trên máy chủ Chrome.
- `sox` tồn tại trên máy chủ Chrome.
- Microphone và loa Meet được định tuyến qua đường dẫn âm thanh ảo mà OpenClaw dùng. `doctor` nên hiển thị `meet output routed: yes` cho các lượt tham gia realtime bằng Chrome cục bộ.

`googlemeet doctor [session-id]` in ra phiên, node, trạng thái trong cuộc gọi, lý do hành động thủ công, kết nối nhà cung cấp realtime, `realtimeReady`, hoạt động đầu vào/đầu ra âm thanh, dấu thời gian âm thanh cuối cùng, bộ đếm byte và URL trình duyệt. Dùng `googlemeet status [session-id] --json` khi bạn cần JSON thô. Dùng `googlemeet doctor --oauth` khi bạn cần xác minh làm mới OAuth Google Meet mà không lộ token; thêm `--meeting` hoặc `--create-space` khi bạn cũng cần bằng chứng Google Meet API.

Nếu một agent hết thời gian chờ và bạn có thể thấy một thẻ Meet đã mở, hãy kiểm tra thẻ đó mà không mở thẻ khác:

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

Hành động công cụ tương đương là `recover_current_tab`. Nó đưa tiêu điểm và kiểm tra một thẻ Meet hiện có cho transport đã chọn. Với `chrome`, nó dùng điều khiển trình duyệt cục bộ qua Gateway; với `chrome-node`, nó dùng node Chrome đã cấu hình. Nó không mở thẻ mới hoặc tạo phiên mới; nó báo cáo vật cản hiện tại, chẳng hạn như trạng thái đăng nhập, cho phép vào, quyền hoặc lựa chọn âm thanh. Lệnh CLI nói chuyện với Gateway đã cấu hình, nên Gateway phải đang chạy; `chrome-node` cũng yêu cầu node Chrome phải được kết nối.

### Kiểm tra thiết lập Twilio thất bại

`twilio-voice-call-plugin` thất bại khi `voice-call` không được cho phép hoặc không được bật. Thêm nó vào `plugins.allow`, bật `plugins.entries.voice-call` và tải lại Gateway.

`twilio-voice-call-credentials` thất bại khi backend Twilio thiếu account SID, auth token hoặc số gọi đi. Đặt các giá trị này trên máy chủ Gateway:

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

`twilio-voice-call-webhook` thất bại khi `voice-call` không có Webhook công khai, hoặc khi `publicUrl` trỏ tới local loopback hoặc không gian mạng riêng. Đặt `plugins.entries.voice-call.config.publicUrl` thành URL nhà cung cấp công khai hoặc cấu hình một tunnel/Tailscale cho `voice-call`.

Các URL loopback và riêng tư không hợp lệ cho callback của nhà mạng. Không dùng `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` hoặc `fd00::/8` làm `publicUrl`.

Đối với một URL công khai ổn định:

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

Để phát triển cục bộ, hãy dùng tunnel hoặc phơi bày qua Tailscale thay vì URL
máy chủ riêng:

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

Sau đó khởi động lại hoặc tải lại Gateway và chạy:

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

`voicecall smoke` mặc định chỉ kiểm tra mức sẵn sàng. Để chạy thử khô với một số cụ thể:

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

Chỉ thêm `--yes` khi bạn chủ ý muốn thực hiện một cuộc gọi thông báo đi trực tiếp:

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

### Cuộc gọi Twilio bắt đầu nhưng không bao giờ vào cuộc họp

Xác nhận sự kiện Meet hiển thị thông tin quay số điện thoại vào cuộc họp. Truyền đúng số quay vào
và PIN hoặc một chuỗi DTMF tùy chỉnh:

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

Dùng `w` ở đầu hoặc dấu phẩy trong `--dtmf-sequence` nếu nhà cung cấp cần tạm dừng
trước khi nhập PIN.

Nếu cuộc gọi điện thoại được tạo nhưng danh sách tham dự Meet không bao giờ hiển thị
người tham gia qua quay số:

- Chạy `openclaw googlemeet doctor <session-id>` để xác nhận ID cuộc gọi Twilio được ủy quyền, DTMF có được đưa vào hàng đợi hay không, và lời chào mở đầu có được yêu cầu hay không.
- Chạy `openclaw voicecall status --call-id <id>` và xác nhận cuộc gọi vẫn đang hoạt động.
- Chạy `openclaw voicecall tail` và kiểm tra rằng Webhook Twilio đang đến Gateway.
- Chạy `openclaw logs --follow` và tìm chuỗi Twilio Meet: Google Meet ủy quyền thao tác tham gia, Voice Call lưu và phục vụ DTMF TwiML trước kết nối, Voice Call phục vụ TwiML thời gian thực cho cuộc gọi Twilio, rồi Google Meet yêu cầu lời nói mở đầu bằng `voicecall.speak`.
- Chạy lại `openclaw googlemeet setup --transport twilio`; kiểm tra thiết lập xanh là bắt buộc nhưng không chứng minh chuỗi PIN cuộc họp là đúng.
- Xác nhận số quay vào thuộc cùng lời mời Meet và khu vực với PIN.
- Tăng `voiceCall.dtmfDelayMs` từ mặc định 12 giây nếu Meet trả lời chậm hoặc bản ghi cuộc gọi vẫn hiển thị lời nhắc yêu cầu PIN sau khi DTMF trước kết nối đã được gửi.
- Nếu người tham gia đã vào nhưng bạn không nghe thấy lời chào, hãy kiểm tra `openclaw logs --follow` để tìm yêu cầu `voicecall.speak` sau DTMF và phần phát TTS qua media-stream hoặc cơ chế dự phòng Twilio `<Say>`. Nếu bản ghi cuộc gọi vẫn chứa "enter the meeting PIN", nhánh điện thoại chưa vào phòng Meet, vì vậy người tham gia cuộc họp sẽ không nghe thấy lời nói.

Nếu Webhook không đến, hãy gỡ lỗi Plugin Voice Call trước: nhà cung cấp phải
truy cập được `plugins.entries.voice-call.config.publicUrl` hoặc tunnel đã cấu hình.
Xem [Khắc phục sự cố cuộc gọi thoại](/vi/plugins/voice-call#troubleshooting).

## Ghi chú

API phương tiện chính thức của Google Meet theo hướng nhận, vì vậy nói vào một cuộc gọi Meet
vẫn cần một đường tham gia. Plugin này giữ ranh giới đó rõ ràng:
Chrome xử lý việc tham gia bằng trình duyệt và định tuyến âm thanh cục bộ; Twilio xử lý
việc tham gia qua quay số điện thoại.

Các chế độ talk-back của Chrome cần `BlackHole 2ch` cộng với một trong hai:

- `chrome.audioInputCommand` cộng với `chrome.audioOutputCommand`: OpenClaw sở hữu
  cầu nối và truyền âm thanh trong `chrome.audioFormat` giữa các lệnh đó và
  nhà cung cấp đã chọn. Chế độ agent dùng phiên âm thời gian thực cộng với TTS thông thường;
  chế độ bidi dùng nhà cung cấp giọng nói thời gian thực. Đường Chrome mặc định là PCM16 24 kHz
  với `chrome.audioBufferBytes: 4096`; G.711 mu-law 8 kHz vẫn
  khả dụng cho các cặp lệnh cũ.
- `chrome.audioBridgeCommand`: một lệnh cầu nối bên ngoài sở hữu toàn bộ đường
  âm thanh cục bộ và phải thoát sau khi khởi động hoặc xác thực daemon của nó. Điều này chỉ
  hợp lệ cho `bidi` vì chế độ `agent` cần quyền truy cập trực tiếp vào cặp lệnh cho TTS.

Khi một agent gọi công cụ `google_meet` ở chế độ agent, phiên tư vấn cuộc họp
fork bản ghi hiện tại của người gọi trước khi trả lời lời nói của người tham gia.
Phiên Meet vẫn tách biệt (`agent:<agentId>:subagent:google-meet:<sessionId>`)
để các lượt theo dõi cuộc họp không trực tiếp thay đổi bản ghi của người gọi.

Để có âm thanh duplex sạch, hãy định tuyến đầu ra Meet và micro Meet qua các
thiết bị ảo riêng biệt hoặc đồ thị thiết bị ảo kiểu Loopback. Một thiết bị
BlackHole dùng chung duy nhất có thể dội lại âm thanh của người tham gia khác vào cuộc gọi.

Với cầu nối Chrome dạng cặp lệnh, `chrome.bargeInInputCommand` có thể lắng nghe một
micro cục bộ riêng và xóa phần phát của trợ lý khi con người bắt đầu
nói. Điều này giữ lời nói của con người đi trước đầu ra của trợ lý ngay cả khi đầu vào local loopback
BlackHole dùng chung tạm thời bị chặn trong lúc phát lời trợ lý.
Giống như `chrome.audioInputCommand` và `chrome.audioOutputCommand`, đây là một
lệnh cục bộ do operator cấu hình. Hãy dùng đường dẫn lệnh hoặc
danh sách đối số tin cậy rõ ràng, và không trỏ nó tới script từ các vị trí không đáng tin cậy.

`googlemeet speak` kích hoạt cầu nối âm thanh talk-back đang hoạt động cho một phiên
Chrome. `googlemeet leave` dừng cầu nối đó. Với các phiên Twilio được ủy quyền
thông qua Plugin Voice Call, `leave` cũng gác cuộc gọi thoại bên dưới.
Dùng `googlemeet end-active-conference` khi bạn cũng muốn đóng hội nghị
Google Meet đang hoạt động cho một không gian do API quản lý.

## Liên quan

- [Plugin cuộc gọi thoại](/vi/plugins/voice-call)
- [Chế độ nói chuyện](/vi/nodes/talk)
- [Xây dựng Plugin](/vi/plugins/building-plugins)