From 467f8391988ebc850021e35672a88dd60248c07b Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Fri, 24 Apr 2026 03:14:19 +0100
Subject: [PATCH] docs(plugins): explain google meet audio install

---
 docs/plugins/google-meet.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/docs/plugins/google-meet.md b/docs/plugins/google-meet.md
index cb622e1a283..a529ce1ba5e 100644
--- a/docs/plugins/google-meet.md
+++ b/docs/plugins/google-meet.md
@@ -33,6 +33,20 @@ brew install blackhole-2ch sox
 export OPENAI_API_KEY=sk-...
 ```
 
+`blackhole-2ch` installs the `BlackHole 2ch` virtual audio device. Homebrew's
+installer requires a reboot before macOS exposes the device:
+
+```bash
+sudo reboot
+```
+
+After reboot, verify both pieces:
+
+```bash
+system_profiler SPAudioDataType | grep -i BlackHole
+command -v rec play
+```
+
 Enable the plugin:
 
 ```json5
@@ -74,6 +88,21 @@ the microphone/speaker path used by OpenClaw. For clean duplex audio, use
 separate virtual devices or a Loopback-style graph; a single BlackHole device is
 enough for a first smoke test but can echo.
 
+## Install notes
+
+The Chrome realtime default uses two external tools:
+
+- `sox`: command-line audio utility. The plugin uses its `rec` and `play`
+  commands for the default 8 kHz G.711 mu-law audio bridge.
+- `blackhole-2ch`: macOS virtual audio driver. It creates the `BlackHole 2ch`
+  audio device that Chrome/Meet can route through.
+
+OpenClaw does not bundle or redistribute either package. The docs ask users to
+install them as host dependencies through Homebrew. SoX is licensed as
+`LGPL-2.0-only AND GPL-2.0-only`; BlackHole is GPL-3.0. If you build an
+installer or appliance that bundles BlackHole with OpenClaw, review BlackHole's
+upstream licensing terms or get a separate license from Existential Audio.
+
 ## Transports
 
 ### Chrome