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

Plugins

Plugin Google Meet

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

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ị:

sudo reboot

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

system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

Bật plugin:

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

Kiểm tra thiết lập:

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:

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:

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:

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:

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

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:

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:

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ề.

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

brew install blackhole-2ch sox

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

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:

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 ở đó:

openclaw plugins enable google-meet

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

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 đó:

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:

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:

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:

openclaw nodes status

Định tuyến Meet qua node đó trên máy chủ Gateway:

{
  gateway: {
    nodes: {
      allowCommands: ["googlemeet.chrome", "browser.proxy"],
    },
  },
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          chrome: {
            guestName: "OpenClaw Agent",
            autoJoin: true,
            reuseExistingTab: true,
          },
          chromeNode: {
            node: "parallels-macos",
          },
        },
      },
    },
  },
}

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

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:

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.

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:

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

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:

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.

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:

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:

      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:

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ụ:

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ộ:

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:

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

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

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ụ:

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ó:

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:

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:

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ị:

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:

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:

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:

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:

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:

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

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

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

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

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:

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:

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:

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

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

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

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:

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

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

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

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

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

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

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

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:

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:

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:

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:

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:

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:

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 đó:

{
  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à:

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:

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:

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:

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:

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:

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

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

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ể:

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:

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:

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 OPENCLAW_DOCS_MARKER:calloutOpen:U2F5. 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.

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