mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-17 08:02:12 -06:00
Peter Steinberger
7d4066639e
* feat(meetings): add Linux audio routing * chore(plugin-sdk): refresh meeting audio API baseline
90 lines
4.2 KiB
Markdown
90 lines
4.2 KiB
Markdown
---
|
|
summary: "Zoom meetings plugin: join meetings as a Chrome browser guest"
|
|
read_when:
|
|
- You want an OpenClaw agent to join a Zoom meeting
|
|
- You are configuring Chrome or virtual audio for Zoom meeting talk-back
|
|
title: "Zoom meetings plugin"
|
|
---
|
|
|
|
The `zoom-meetings` plugin joins Zoom meeting links as a guest through the Zoom Web App in the OpenClaw Chrome profile. It accepts meeting links under `zoom.us/j/...` and account subdomains such as `example.zoom.us/j/...`. It does not create meetings, dial in, use the Zoom Meeting SDK, or capture audio/video recordings.
|
|
|
|
## Setup
|
|
|
|
Talk-back uses the shared [meeting-plugin audio setup](/plugins/meeting-plugins#prepare-chrome-and-audio): `BlackHole 2ch` plus SoX on macOS, or PipeWire-Pulse plus `pactl`/`pacat`/`parec` on Linux.
|
|
|
|
```bash
|
|
openclaw plugins install @openclaw/zoom-meetings
|
|
openclaw gateway restart
|
|
brew install blackhole-2ch sox
|
|
sudo reboot
|
|
system_profiler SPAudioDataType | grep -i BlackHole
|
|
command -v sox
|
|
```
|
|
|
|
On Linux, verify the desktop user's PipeWire-Pulse session instead:
|
|
|
|
```bash
|
|
pactl info
|
|
command -v pactl pacat parec
|
|
```
|
|
|
|
The plugin is enabled by default after installation. Add an entry only to customize it, then check setup:
|
|
|
|
```json5
|
|
{
|
|
plugins: {
|
|
entries: {
|
|
"zoom-meetings": {
|
|
config: {
|
|
defaultMode: "agent",
|
|
chrome: { guestName: "OpenClaw Agent" },
|
|
},
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Run `openclaw plugins disable zoom-meetings` if you do not want the plugin active.
|
|
|
|
```bash
|
|
openclaw zoommeetings setup
|
|
openclaw zoommeetings join 'https://zoom.us/j/1234567890'
|
|
```
|
|
|
|
Use `chromeNode.node` to run Chrome and its native virtual-audio backend on a paired macOS or Linux node. The node must allow `zoommeetings.chrome` and `browser.proxy`; backend setup and generated commands resolve on that node, not on the Gateway host.
|
|
|
|
## Modes
|
|
|
|
| Mode | Behavior |
|
|
| ------------ | --------------------------------------------------------------------------- |
|
|
| `agent` | Realtime transcription consults the configured OpenClaw agent; TTS replies. |
|
|
| `bidi` | A realtime voice model listens and replies directly. |
|
|
| `transcribe` | Observe-only join with live-caption transcript snapshots. |
|
|
|
|
Zoom live captions are enabled after admission in every mode so OpenClaw can
|
|
persist meeting notes. The `transcript` action still returns the bounded live
|
|
buffer only for `transcribe` sessions. On leave, OpenClaw stores the durable
|
|
transcript and derived summary in the shared state database; list or export
|
|
them with [`openclaw transcripts`](/cli/transcripts).
|
|
|
|
Automatic notes are enabled by default. Set `transcripts.enabled: false` to
|
|
disable durable notes globally; explicit `transcribe` mode still exposes only
|
|
its bounded live tail.
|
|
|
|
## Guest join limits
|
|
|
|
The browser adapter chooses **Join from browser**, fills the guest name, turns the camera off, configures the microphone for the selected mode, and clicks **Join**. Zoom Web App runs under `app.zoom.us`; the plugin grants that origin microphone and speaker-selection permissions before navigation. In-call state uses Zoom's Leave control. Lobby, sign-in, passcode, CAPTCHA, and device-permission states return explicit manual-action reasons.
|
|
|
|
Zoom host and account policy can disable browser join, require authentication or email verification, show a CAPTCHA, or require host admission. Complete that step in the OpenClaw Chrome profile, then retry status or speech. The plugin does not bypass Zoom policy.
|
|
|
|
The Zoom Web App has been live-validated with an official Zoom test meeting for the app interstitial, iframe guest-name entry, prejoin microphone and camera controls, join, browser and macOS media permissions, in-call detection, live-caption enablement, and host-ended detection. Lobby and authentication states depend on host policy and retain text fallbacks when no stable DOM identifier is available.
|
|
|
|
## Tool and gateway surface
|
|
|
|
The `zoom_meetings` agent tool supports `join`, `leave`, `status`, `transcript`, and `speak`. Gateway methods use the `zoommeetings.*` prefix. The node command is `zoommeetings.chrome`.
|
|
|
|
## Related
|
|
|
|
- [Meeting plugins overview](/plugins/meeting-plugins)
|