Plugin de Google Meet

El plugin google-meet se une a URL explícitas de Meet en nombre de un agente de OpenClaw. Su alcance es deliberadamente limitado:

Solo se une a URL de https://meet.google.com/...; nunca llama a una reunión mediante un número de teléfono que haya detectado por sí mismo.
googlemeet create puede generar una nueva URL de Meet mediante la API de Google Meet (o una alternativa basada en el navegador) y unirse a ella de forma predeterminada.
La participación mediante Chrome utiliza un perfil de Chrome con una sesión iniciada, opcionalmente en un Node emparejado. La participación mediante Twilio llama a un número de teléfono más un PIN/DTMF a través del plugin de llamadas de voz; no puede llamar directamente a una URL de Meet.
mode: "agent" (predeterminado) transcribe la voz de los participantes con un proveedor en tiempo real, la envía al agente de OpenClaw configurado y reproduce la respuesta mediante el TTS habitual de OpenClaw. mode: "bidi" permite que un modelo de voz en tiempo real responda directamente. mode: "transcribe" se une solo como observador, sin responder por voz.
No se emite ningún anuncio automático de consentimiento cuando el plugin se une a una llamada.
El comando de la CLI es googlemeet; meet está reservado para flujos de trabajo más amplios de teleconferencia de agentes.

Inicio rápido

Instale el plugin y las dependencias de audio locales y, a continuación, configure una clave de proveedor en tiempo real. OpenAI es el proveedor de transcripción predeterminado para el modo agent; Google Gemini Live está disponible como proveedor de voz del modo bidi:

openclaw plugins install npm:@openclaw/google-meet
brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# solo es necesario cuando realtime.voiceProvider es "google" para el modo bidi
export GEMINI_API_KEY=...

blackhole-2ch instala el dispositivo de audio virtual BlackHole 2ch a través del cual Chrome enruta el audio. El instalador de Homebrew requiere reiniciar antes de que macOS exponga el dispositivo:

sudo reboot

Después de reiniciar, verifique ambos componentes:

system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

El plugin queda habilitado de forma predeterminada después de instalarlo. Añada una entrada solo para personalizarlo:

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

Ejecute openclaw plugins disable google-meet si no desea que el plugin esté activo. Compruebe la configuración y, a continuación, únase:

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

La salida de setup es legible por el agente y tiene en cuenta el modo y el transporte: informa sobre el perfil de Chrome, la fijación del Node y, para las conexiones de Chrome en tiempo real, el puente de audio BlackHole/SoX y la comprobación de la introducción retrasada. Las conexiones solo como observador omiten los requisitos previos de tiempo real:

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

Cuando se configura la delegación de Twilio, setup también informa de si voice-call, las credenciales de Twilio y la exposición pública del Webhook están listos. Considere cualquier comprobación ok: false como un bloqueo para ese transporte o modo antes de que se una un agente. Use --json para obtener una salida legible por máquina y --transport chrome|chrome-node|twilio para comprobar previamente un transporte específico:

openclaw googlemeet setup --transport twilio

También puede permitir que un agente se una mediante la herramienta google_meet:

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

En hosts de Gateway que no utilizan macOS, google_meet permanece visible para las acciones de artefactos, calendario, configuración, transcripción, Twilio y chrome-node, pero la respuesta por voz mediante Chrome local (transport: "chrome" con mode: "agent" o "bidi") se bloquea antes de llegar al puente de audio, ya que esa ruta depende actualmente de BlackHole 2ch de macOS. En su lugar, use mode: "transcribe", la conexión telefónica de Twilio o un host chrome-node con macOS.

Crear una reunión

openclaw googlemeet create --transport chrome-node --mode agent
openclaw googlemeet create --no-join

create dispone de dos rutas, indicadas en el campo source del resultado:

api: se utiliza cuando están configuradas las credenciales de OAuth de Google Meet. Es determinista y no depende del estado de la interfaz del navegador.
browser: se utiliza sin credenciales de OAuth. OpenClaw abre https://meet.google.com/new en el Node de Chrome fijado y espera a que Google redirija a una URL con un código de reunión real; el perfil de Chrome de OpenClaw en ese Node ya debe tener iniciada una sesión de Google. Tanto la unión como la creación reutilizan una pestaña de Meet existente (o una pestaña de .../new o de solicitud de cuenta de Google en curso) antes de abrir una nueva; la coincidencia de pestañas ignora cadenas de consulta inofensivas como authuser.

create se une de forma predeterminada y devuelve joined: true junto con la sesión de unión. Pase --no-join (CLI) o "join": false (herramienta) para generar únicamente la URL. Para las salas creadas mediante la API, establezca una política de acceso explícita en lugar de heredar la predeterminada de la cuenta de Google:

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

`--access-type`	Quién puede unirse sin solicitar acceso
`OPEN`	Cualquier persona con la URL de Meet
`TRUSTED`	Usuarios de confianza de la organización del anfitrión, usuarios externos invitados y usuarios de conexión telefónica
`RESTRICTED`	Solo invitados

Esto solo se aplica a las salas creadas mediante la API, por lo que OAuth debe estar configurado. Si se autenticó antes de que existiera esta opción, vuelva a ejecutar openclaw googlemeet auth login --json después de añadir el ámbito meetings.space.settings a la pantalla de consentimiento de OAuth. Si la alternativa basada en el navegador encuentra un bloqueo de inicio de sesión de Google o de permisos de Meet, la herramienta devuelve manualActionRequired: true con manualActionReason, manualActionMessage y los valores browser.nodeId/browser.targetId/browserUrl. Informe de ese mensaje y deje de abrir nuevas pestañas de Meet hasta que el operador complete el paso en el navegador.

Unión solo como observador

Establezca "mode": "transcribe" para omitir el puente dúplex en tiempo real (sin necesidad de BlackHole/SoX y sin respuesta por voz). Las conexiones de Chrome en modo de transcripción también omiten la concesión de permisos de micrófono y cámara de OpenClaw y la ruta Use microphone de Meet; si Meet muestra la pantalla intermedia de elección de audio, la automatización prueba primero Continue without microphone. Los transportes de Chrome administrados instalan, en la medida de lo posible, un observador de subtítulos de Meet en todos los modos para que haya notas duraderas disponibles sin modificar la ruta de consulta del agente en vivo. googlemeet status --json y googlemeet doctor informan de captioning, captionsEnabledAttempted, transcriptLines, lastCaptionAt, lastCaptionSpeaker, lastCaptionText y una cola recentTranscript. Para consultar la transcripción acotada de la sesión, lea la pestaña exacta de Meet de la que se realiza el seguimiento:

openclaw googlemeet transcript <session-id>
openclaw googlemeet transcript <session-id> --since <next-index> --json

El observador conserva como máximo 2,000 líneas de subtítulos completadas en la página de Meet. El texto progresivo visible permanece en la cola de estado hasta que se completa la fila de subtítulos, de modo que guardar nextIndex no puede omitir una ampliación posterior del texto; al salir, se finalizan las filas visibles antes de generar la instantánea. droppedLines informa de las líneas perdidas al principio cuando se supera el límite. La cola acotada googlemeet transcript sigue conservando únicamente las cuatro sesiones finalizadas más recientemente y se restablece con el Gateway. Por separado, OpenClaw añade las filas de subtítulos completadas a la base de datos de estado compartida durante toda la reunión y escribe un resumen derivado al salir. Use openclaw transcripts para consultar o exportar esas notas duraderas. Las notas automáticas están habilitadas de forma predeterminada. Establezca transcripts.enabled: false para deshabilitar globalmente las notas duraderas; el modo explícito transcribe sigue mostrando únicamente su cola en vivo acotada. Las conexiones de Twilio no disponen del flujo de subtítulos del navegador y esta ruta no las captura. Para realizar una prueba de escucha con respuesta sí/no:

openclaw googlemeet test-listen <meet-url> --transport chrome-node

Se une en modo de transcripción, espera a que haya actividad nueva en los subtítulos o la transcripción y devuelve listenVerified, listenTimedOut, campos de acción manual y el estado actual de los subtítulos.

Estado de la sesión en tiempo real

Durante las sesiones con respuesta por voz, el estado de google_meet informa del estado de Chrome y del puente de audio: inCall, manualActionRequired, providerConnected, realtimeReady, audioInputActive, audioOutputActive, marcas de tiempo de la última entrada y salida, contadores de bytes y estado de cierre del puente. Las sesiones administradas de Chrome solo reproducen la frase de introducción o prueba después de que el estado indique inCall: true; de lo contrario, speechReady: false y el intento de reproducción de voz se bloquea en lugar de no hacer nada silenciosamente. Las conexiones de Chrome locales se realizan mediante el perfil del navegador de OpenClaw con la sesión iniciada y necesitan BlackHole 2ch para la ruta del micrófono y el altavoz. Un solo dispositivo BlackHole basta para una primera prueba básica, pero puede producir eco; use dispositivos virtuales independientes o un grafo similar a Loopback para obtener audio dúplex limpio.

Gateway local + Chrome en Parallels

No se necesita un Gateway completo ni una clave de API de modelo dentro de una máquina virtual de macOS solo para proporcionarle Chrome. Ejecute el Gateway y el agente localmente; ejecute un host de Node en la máquina virtual.

Dónde se ejecuta	Qué
Host del Gateway	Gateway de OpenClaw, espacio de trabajo del agente, claves de modelo/API, proveedor en tiempo real, configuración del plugin de Google Meet
Máquina virtual de macOS en Parallels	CLI/host de Node de OpenClaw, Chrome, SoX, BlackHole 2ch y un perfil de Chrome con una sesión de Google iniciada
No se necesita en la máquina virtual	Servicio de Gateway, configuración del agente y configuración del proveedor de modelos

Instale las dependencias de la máquina virtual, reinicie y verifique:

brew install blackhole-2ch sox
sudo reboot
system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

Instale el plugin en la máquina virtual, donde queda habilitado de forma predeterminada, e inicie el host de Node:

openclaw plugins install npm:@openclaw/google-meet
openclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos

Si <gateway-host> es una IP de LAN sin TLS, habilite explícitamente esa red privada de confianza:

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

Use la misma opción al instalarlo como LaunchAgent (es una variable de entorno del proceso, almacenada en el entorno de LaunchAgent cuando está presente en el comando de instalación, no una configuración de openclaw.json):

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

Apruebe el Node desde el host del Gateway y, a continuación, confirme que anuncia tanto googlemeet.chrome como la capacidad del navegador/browser.proxy:

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

Enrute Meet a través de ese Node:

{
  gateway: {
    nodes: {
      commands: { allow: ["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",
          },
        },
      },
    },
  },
}

Ahora, únase de la forma habitual desde el host del Gateway:

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

Para realizar una prueba básica con un solo comando que crea o reutiliza una sesión, reproduce una frase conocida y muestra el estado de la sesión:

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

Durante la incorporación en tiempo real, la automatización del navegador rellena el nombre del invitado, hace clic en Join/Ask to join y acepta el aviso inicial “Use microphone” de Meet cuando aparece (o “Continue without microphone” durante la incorporación de solo observación y la creación de reuniones solo mediante navegador). Si se ha cerrado la sesión del perfil, Meet está esperando la admisión del anfitrión, Chrome necesita permiso para el micrófono o la cámara, o Meet está bloqueado en un aviso sin resolver, el resultado informa de manualActionRequired: true con manualActionReason y manualActionMessage. Deje de reintentarlo, informe de ese mensaje junto con browserUrl/browserTitle y vuelva a intentarlo solo después de completar la acción manual. Si se omite chromeNode.node, OpenClaw realiza la selección automática únicamente cuando exactamente un nodo conectado anuncia tanto googlemeet.chrome como el control del navegador; fije chromeNode.node (id. del nodo, nombre para mostrar o IP remota) cuando haya varios nodos aptos conectados.

Comprobaciones de errores comunes

Síntoma	Solución
`Configured Google Meet node ... is not usable: offline`	El nodo fijado es conocido, pero no está disponible. Informe del impedimento de configuración; no recurra de forma silenciosa a otro transporte salvo que se solicite.
`No connected Google Meet-capable node`	Instale `npm:@openclaw/google-meet` en la máquina virtual, ejecute `openclaw plugins enable browser`, inicie `openclaw node run` y apruebe el emparejamiento. Si Google Meet se deshabilitó explícitamente, habilítelo también. Confirme que `gateway.nodes.commands.allow` incluye `googlemeet.chrome` y `browser.proxy`.
`BlackHole 2ch audio device not found`	Instale `blackhole-2ch` en el host que se está comprobando y reinícielo.
`BlackHole 2ch audio device not found on the node`	Instale `blackhole-2ch` en la máquina virtual y reiníciela.
Chrome se abre, pero no puede incorporarse	Inicie sesión en el perfil del navegador de la máquina virtual o mantenga establecido `chrome.guestName`. La incorporación automática como invitado utiliza la automatización del navegador de OpenClaw mediante el proxy del navegador del nodo; dirija el `browser.defaultProfile` del nodo (o un perfil con nombre de sesión existente) al perfil que desee.
Pestañas de Meet duplicadas	Mantenga `chrome.reuseExistingTab: true`. OpenClaw activa una pestaña existente para la misma URL, y la creación reutiliza una pestaña de `.../new` en curso o de aviso de cuenta de Google antes de abrir otra.
Sin audio	Encamine el micrófono y el altavoz de Meet mediante la ruta de audio virtual utilizada por OpenClaw; use dispositivos virtuales separados o un enrutamiento similar a Loopback para obtener audio dúplex limpio.

Notas de instalación

La configuración predeterminada de respuesta mediante Chrome utiliza dos herramientas externas que OpenClaw no incluye ni redistribuye; instálelas como dependencias del host mediante Homebrew:

sox: utilidad de audio para la línea de comandos. El Plugin emite comandos explícitos de dispositivos CoreAudio para el puente de audio PCM16 predeterminado de 24 kHz.
blackhole-2ch: controlador de audio virtual para macOS que proporciona el dispositivo BlackHole 2ch mediante el que se enrutan Chrome/Meet.

SoX tiene licencia LGPL-2.0-only AND GPL-2.0-only; BlackHole tiene licencia GPL-3.0. Si se crea un instalador o dispositivo que incluya BlackHole con OpenClaw, revise la licencia original de BlackHole u obtenga una licencia independiente de Existential Audio.

Transportes

Transporte	Cuándo usarlo
`chrome`	Chrome y el audio se ejecutan en el host del Gateway
`chrome-node`	Chrome y el audio se ejecutan en un nodo emparejado (por ejemplo, una máquina virtual de Parallels con macOS)
`twilio`	Alternativa de acceso telefónico mediante el Plugin Voice Call cuando no está disponible la participación con Chrome

Chrome

Abre la URL de Meet mediante el control del navegador de OpenClaw y se incorpora con el perfil del navegador de OpenClaw que tiene la sesión iniciada. En macOS, el Plugin comprueba BlackHole 2ch antes del inicio y, si está configurado, ejecuta un comando de estado/inicio del puente de audio antes de abrir Chrome. Para Chrome local, seleccione el perfil con browser.defaultProfile; en su lugar, chrome.browserProfile se pasa a los hosts 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

El audio del micrófono y el altavoz de Chrome se enruta mediante el puente de audio local de OpenClaw. Si BlackHole 2ch no está instalado, la incorporación falla con un error de configuración en lugar de incorporarse sin una ruta de audio.

Twilio

Un plan de marcación estricto delegado al Plugin Voice Call. No analiza las páginas de Meet para encontrar números de teléfono; Google Meet debe proporcionar un número de acceso telefónico y un PIN para la reunión. Habilite Voice Call en el host del Gateway, no en el nodo de Chrome:

{
  plugins: {
    allow: ["google-meet", "voice-call", "google"],
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          // o establezca "twilio" si Twilio debe ser el valor predeterminado
        },
      },
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio",
          inboundPolicy: "allowlist",
          realtime: {
            enabled: true,
            provider: "google",
            instructions: "Incorpórate a esta reunión de Google Meet como agente de OpenClaw. Sé breve.",
            toolPolicy: "safe-read-only",
            providers: {
              google: {
                silenceDurationMs: 500,
                startSensitivity: "high",
              },
            },
          },
        },
      },
      google: {
        enabled: true,
      },
    },
  },
}

Proporcione las credenciales de Twilio mediante el entorno para mantener los secretos fuera de openclaw.json:

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

Use en su lugar realtime.provider: "openai" con OPENAI_API_KEY si OpenAI es el proveedor de voz en tiempo real. Reinicie o vuelva a cargar el Gateway después de habilitar voice-call; los cambios de configuración del Plugin no se aplican hasta que se vuelve a cargar. Verifique:

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

Cuando la delegación de Twilio está conectada, googlemeet setup incluye las comprobaciones twilio-voice-call-plugin, twilio-voice-call-credentials y twilio-voice-call-webhook.

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

Use --dtmf-sequence para una secuencia personalizada, con w iniciales o comas para introducir una pausa antes del PIN:

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

OAuth y comprobación previa

OAuth es opcional para crear un enlace de Meet, porque googlemeet create puede recurrir a la automatización del navegador. Configure OAuth para la creación mediante la API oficial, la resolución de espacios o la comprobación previa de Meet Media API. Las incorporaciones mediante Chrome/Chrome-node nunca dependen de OAuth; utilizan un perfil de Chrome con la sesión iniciada, BlackHole/SoX y, para chrome-node, un nodo conectado en cualquier caso.

Crear credenciales de Google

En Google Cloud Console:

Crear o seleccionar un proyecto

Habilitar la API REST de Google Meet

Configurar la pantalla de consentimiento de OAuth

Internal es la opción más sencilla para una organización de Google Workspace. External funciona para configuraciones personales o de prueba; mientras la aplicación esté en Testing, añada como usuario de prueba cada cuenta de Google que vaya a autorizarla.

Añadir los ámbitos solicitados

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
https://www.googleapis.com/auth/calendar.events.readonly (consulta de Calendar)
https://www.googleapis.com/auth/drive.meet.readonly (exportación del cuerpo del documento de transcripción/notas inteligentes)

Crear un ID de cliente de OAuth

Tipo de aplicación Web application. URI de redirección autorizado:

http://localhost:8085/oauth2callback

Copiar el ID y el secreto del cliente

meetings.space.created es obligatorio para spaces.create. meetings.space.readonly resuelve las URL o los códigos de Meet en espacios. meetings.space.settings permite que OpenClaw pase ajustes de SpaceConfig, como accessType, durante la creación de salas mediante la API. meetings.conference.media.readonly se utiliza para la comprobación previa y el trabajo multimedia de Meet Media API; Google puede exigir la inscripción en Developer Preview para utilizar realmente Media API. calendar.events.readonly solo es necesario para la consulta de Calendar --today/--event. drive.meet.readonly solo es necesario para la exportación --include-doc-bodies. Si únicamente se necesitan incorporaciones mediante Chrome basadas en el navegador, omita OAuth por completo.

Generar el token de actualización

Configure oauth.clientId y, opcionalmente, oauth.clientSecret (o páselos como variables de entorno) y, a continuación, ejecute:

openclaw googlemeet auth login --json

Esto ejecuta un flujo PKCE con una devolución de llamada de localhost en http://localhost:8085/oauth2callback e imprime un bloque de configuración oauth con un token de actualización. Añada --manual para usar un flujo de copiar y pegar cuando el navegador no pueda acceder a la devolución de llamada local:

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

Salida JSON:

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

Almacene el objeto oauth en la configuración del Plugin:

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

Utilice preferentemente variables de entorno si no desea guardar el token de actualización en la configuración; primero se resuelve la configuración y, después, se usa el entorno como alternativa. Si la autenticación se realizó antes de que existiera la compatibilidad con la creación de reuniones, la consulta de Calendar o la exportación del cuerpo de los documentos, vuelva a ejecutar openclaw googlemeet auth login --json para que el token de actualización abarque el conjunto actual de ámbitos.

Verificar OAuth con doctor

openclaw googlemeet doctor --oauth --json

Esto comprueba que exista la configuración de OAuth y que el token de actualización pueda generar un token de acceso, sin cargar el entorno de ejecución de Chrome ni requerir un nodo conectado. El informe incluye únicamente campos de estado (ok, configured, tokenSource, expiresAt, mensajes de comprobación) y nunca muestra el token de acceso, el token de actualización ni el secreto del cliente.

Comprobación	Significado
`oauth-config`	Están presentes `oauth.clientId` junto con `oauth.refreshToken`, o un token de acceso almacenado en caché
`oauth-token`	El token de acceso almacenado en caché sigue siendo válido o el token de actualización generó uno nuevo
`meet-spaces-get`	La comprobación opcional `--meeting` resolvió un espacio de Meet existente
`meet-spaces-create`	La comprobación opcional `--create-space` creó un nuevo espacio de Meet

Para demostrar que la API de Meet está habilitada y que se dispone del ámbito spaces.create, utilice la comprobación de creación con efectos secundarios:

openclaw googlemeet doctor --oauth --create-space --json

Para demostrar el acceso de lectura a un espacio existente:

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

Un 403 en estas comprobaciones suele significar que la API REST de Meet está deshabilitada, que al token de actualización le falta el ámbito requerido o que la cuenta de Google no puede acceder a ese espacio. Un error del token de actualización significa que se debe volver a ejecutar openclaw googlemeet auth login --json y almacenar el nuevo bloque oauth. No se necesita OAuth para el mecanismo alternativo del navegador; en este caso, la autenticación de Google procede del perfil de Chrome con la sesión iniciada en el nodo seleccionado, no de la configuración de OpenClaw. Se aceptan estas variables de entorno como alternativas:

OPENCLAW_GOOGLE_MEET_CLIENT_ID o GOOGLE_MEET_CLIENT_ID
OPENCLAW_GOOGLE_MEET_CLIENT_SECRET o GOOGLE_MEET_CLIENT_SECRET
OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN o GOOGLE_MEET_REFRESH_TOKEN
OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN o GOOGLE_MEET_ACCESS_TOKEN
OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT o GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT
OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING o GOOGLE_MEET_DEFAULT_MEETING
OPENCLAW_GOOGLE_MEET_PREVIEW_ACK o GOOGLE_MEET_PREVIEW_ACK

Resolver, realizar la comprobación previa y leer artefactos

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

Después de que Meet haya creado registros de conferencia:

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

Con --meeting, artifacts y attendance, se utiliza de forma predeterminada el registro de conferencia más reciente; pase --all-conference-records para incluir todos los registros conservados. La búsqueda en Calendar resuelve la URL de la reunión desde Google Calendar antes de leer los artefactos (requiere un token de actualización que incluya el ámbito de solo lectura de eventos de Calendar):

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 busca en el calendario primary de hoy un evento con un enlace de Meet; --event <query> busca texto coincidente en los eventos; --calendar <id> especifica un calendario no principal. calendar-events muestra una vista previa de los eventos coincidentes e indica cuál elegirán latest/artifacts/attendance/export. Si ya se conoce el identificador del registro de conferencia, se puede especificar directamente:

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

Para cerrar la sala de un espacio creado mediante la API:

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

Llama a spaces.endActiveConference y requiere OAuth con el ámbito meetings.space.created para un espacio que la cuenta autorizada pueda administrar. Acepta una URL de Meet, un código de reunión o spaces/{id}, y primero lo resuelve como el recurso de espacio de la API. Esto es independiente de googlemeet leave: leave detiene la participación local o de sesión de OpenClaw; end-active-conference solicita a Google Meet que finalice la conferencia activa del espacio. Para escribir un informe legible:

openclaw googlemeet artifacts --conference-record conferenceRecords/abc123 \
  --format markdown --output meet-artifacts.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 devuelve los metadatos del registro de conferencia, además de los metadatos de los recursos de participantes, grabaciones, transcripciones, entradas de transcripción estructuradas y notas inteligentes cuando Google los proporciona. --no-transcript-entries omite la búsqueda de entradas para reuniones grandes. attendance expande los participantes en filas de sesiones de participante con las horas de primera y última aparición, la duración total de la sesión, indicadores de llegada tardía y salida anticipada, y combina los recursos de participantes duplicados por usuario con la sesión iniciada o nombre para mostrar; --no-merge-duplicates mantiene separados los recursos sin procesar, y --late-after-minutes/--early-before-minutes ajustan los umbrales. export escribe una carpeta con summary.md, attendance.csv, transcript.md, artifacts.json, attendance.json y manifest.json. manifest.json registra la entrada elegida, las opciones de exportación, los registros de conferencia, los archivos de salida, los recuentos, el origen del token, cualquier evento de Calendar utilizado y las advertencias de recuperación parcial. --zip también escribe un archivo comprimido portátil junto a la carpeta. --include-doc-bodies exporta mediante Drive files.export el texto de los documentos de Google vinculados de transcripciones y notas inteligentes (requiere el ámbito de solo lectura de Meet de Drive); sin este, las exportaciones solo incluyen los metadatos de Meet y las entradas de transcripción estructuradas. Un fallo parcial de un artefacto (error al enumerar notas inteligentes, obtener entradas de transcripción o recuperar el cuerpo de un documento) conserva la advertencia en el resumen o manifiesto en lugar de hacer fallar toda la exportación. --dry-run obtiene los mismos datos y muestra el JSON del manifiesto sin crear la carpeta ni el archivo ZIP. Los agentes utilizan las mismas acciones mediante la herramienta google_meet (export, create con accessType, end_active_conference, test_listen); consulte Herramienta.

Prueba rápida en vivo

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

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

Variable	Finalidad
`OPENCLAW_LIVE_TEST=1`	Habilita las pruebas en vivo protegidas
`OPENCLAW_GOOGLE_MEET_LIVE_MEETING`	URL de Meet, código o `spaces/{id}` conservado
`OPENCLAW_GOOGLE_MEET_CLIENT_ID` / `GOOGLE_MEET_CLIENT_ID`	Identificador del cliente de OAuth
`OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN` / `GOOGLE_MEET_REFRESH_TOKEN`	Token de actualización
`OPENCLAW_GOOGLE_MEET_CLIENT_SECRET`, `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN`, `OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT`	Opcional; también funcionan los mismos nombres alternativos sin el prefijo `OPENCLAW_`

La prueba rápida básica de artefactos y asistencia necesita meetings.space.readonly y meetings.conference.media.readonly. La búsqueda en Calendar necesita calendar.events.readonly. La exportación del cuerpo de documentos de Drive necesita drive.meet.readonly.

Ejemplos de creación

openclaw googlemeet create

Muestra el URI de la nueva reunión, el origen y la sesión de incorporación. Con OAuth utiliza la API de Meet; sin OAuth, utiliza el perfil con la sesión iniciada del nodo de Chrome fijado. JSON del mecanismo alternativo del navegador:

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

Si el mecanismo alternativo del navegador encuentra primero el inicio de sesión de Google o un bloqueo de permisos de Meet, google_meet devuelve detalles estructurados en lugar de una cadena de texto simple:

{
  "source": "browser",
  "error": "google-login-required: Inicie sesión en Google en el perfil del navegador de OpenClaw y, después, vuelva a intentar crear la reunión.",
  "manualActionRequired": true,
  "manualActionReason": "google-login-required",
  "manualActionMessage": "Inicie sesión en Google en el perfil del navegador de OpenClaw y, después, vuelva a intentar crear la reunión.",
  "browser": {
    "nodeId": "ba0f4e4bc...",
    "targetId": "tab-1",
    "browserUrl": "https://accounts.google.com/signin",
    "browserTitle": "Sign in - Google Accounts"
  }
}

JSON de creación mediante la 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"
    }
  }
}

Al crear, se incorpora de forma predeterminada, pero Chrome/Chrome-node sigue necesitando un perfil de Google con la sesión iniciada para incorporarse mediante el navegador; si la sesión está cerrada, OpenClaw informa de manualActionRequired: true o de un error del mecanismo alternativo del navegador y solicita al operador que complete el inicio de sesión de Google antes de volver a intentarlo. Establezca preview.enrollmentAcknowledged: true únicamente después de confirmar que el proyecto de Cloud, la entidad principal de OAuth y los participantes de la reunión están inscritos en el Google Workspace Developer Preview Program para las API multimedia de Meet.

Configuración

La ruta común del agente de Chrome solo necesita que el plugin esté habilitado, BlackHole, SoX, una clave de proveedor en tiempo real y un proveedor de TTS de OpenClaw configurado:

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

Valores predeterminados

Clave	Valor predeterminado	Notas
`defaultTransport`	`"chrome"`
`defaultMode`	`"agent"`	`"realtime"` se acepta como alias heredado de `"agent"`; los nuevos invocadores deben usar `"agent"`
`chromeNode.node`	sin definir	Id./nombre/IP del Node para `chrome-node`; obligatorio cuando pueda haber más de un Node compatible conectado
`chrome.launch`	`true`	Inicia Chrome para unirse; establezca `false` únicamente al reutilizar una sesión ya abierta
`chrome.audioBackend`	`"blackhole-2ch"`
`chrome.guestName`	`"OpenClaw Agent"`	Se muestra en la pantalla de invitado de Meet con la sesión cerrada
`chrome.autoJoin`	`true`	Intenta rellenar el nombre del invitado y hacer clic en Join Now en `chrome-node`
`chrome.reuseExistingTab`	`true`	Activa una pestaña de Meet existente en lugar de abrir duplicados
`chrome.waitForInCallMs`	`20000`	Espera a que la pestaña de Meet indique que la llamada está en curso antes de reproducir la introducción de respuesta por voz
`chrome.audioFormat`	`"pcm16-24khz"`	Formato de audio del par de comandos; `"g711-ulaw-8khz"` solo se usa para pares de comandos heredados o personalizados que emiten audio de telefonía
`chrome.audioBufferBytes`	`4096`	Búfer de procesamiento de SoX para los comandos de audio generados del par de comandos (la mitad del búfer predeterminado de 8192 bytes de SoX, lo que reduce la latencia de la canalización); los valores se limitan a un mínimo de 17 bytes
`chrome.audioInputCommand`	comando de SoX generado	Lee desde CoreAudio `BlackHole 2ch` y escribe audio en `chrome.audioFormat`
`chrome.audioOutputCommand`	comando de SoX generado	Lee audio en `chrome.audioFormat` y lo escribe en CoreAudio `BlackHole 2ch`
`chrome.bargeInInputCommand`	sin definir	Comando opcional del micrófono local que escribe PCM mono de 16 bits con signo y orden little-endian para detectar la interrupción humana durante la reproducción del asistente; se aplica al puente del par de comandos alojado en el Gateway
`chrome.bargeInRmsThreshold`	`650`	Nivel RMS que se considera una interrupción humana
`chrome.bargeInPeakThreshold`	`2500`	Nivel máximo que se considera una interrupción humana
`chrome.bargeInCooldownMs`	`900`	Demora mínima entre cancelaciones repetidas por interrupción
`mode` (por solicitud)	`"agent"`	Modo de respuesta por voz; consulte la tabla Modos de agente y bidireccional
`realtime.provider`	`"openai"`	Alternativa de compatibilidad utilizada cuando no están definidos los campos con ámbito que aparecen a continuación
`realtime.transcriptionProvider`	`"openai"`	Id. del proveedor utilizado por el modo `agent` para la transcripción en tiempo real
`realtime.voiceProvider`	sin definir	Id. del proveedor utilizado por el modo `bidi` para la voz directa en tiempo real; establézcalo en `"google"` para Gemini Live y mantenga la transcripción del modo de agente en OpenAI. Combínelo con `realtime.model` para elegir el modelo específico de Gemini Live.
`realtime.toolPolicy`	`"safe-read-only"`	Consulte Modos de agente y bidireccional
`realtime.instructions`	instrucciones para una respuesta oral breve	Indica al modelo que hable brevemente y utilice `openclaw_agent_consult` para respuestas más detalladas
`realtime.introMessage`	`"Say exactly: I'm here and listening."`	Se pronuncia una vez cuando se conecta el puente en tiempo real; establézcalo en `""` para unirse en silencio
`realtime.agentId`	`"main"`	Id. del agente de OpenClaw utilizado para `openclaw_agent_consult`
`voiceCall.enabled`	`true`	Delega la llamada PSTN de Twilio, el DTMF y el saludo de introducción al Plugin Voice Call
`voiceCall.dtmfDelayMs`	`12000`	Espera inicial antes de reproducir una secuencia DTMF derivada del PIN mediante Twilio
`voiceCall.postDtmfSpeechDelayMs`	`5000`	Demora antes de solicitar el saludo de introducción en tiempo real después de que Voice Call inicia el tramo de Twilio

chrome.audioBridgeCommand y chrome.audioBridgeHealthCommand permiten que un puente externo controle toda la ruta de audio local en lugar de chrome.audioInputCommand/chrome.audioOutputCommand; consulte Notas para conocer la restricción sobre qué modo puede utilizarlos. Existe una migración openclaw doctor --fix para la estructura heredada realtime.provider: "google": traslada esa intención a realtime.voiceProvider: "google" junto con realtime.transcriptionProvider: "openai" cuando esos campos aún no están definidos.

Anulaciones opcionales

{
  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-3.1-flash-live-preview",
    agentId: "jay",
    toolPolicy: "owner",
    introMessage: "Di exactamente: Estoy aquí.",
    providers: {
      google: {
        speakerVoice: "Kore",
      },
    },
  },
}

ElevenLabs para la escucha y el habla en modo de agente:

{
  tts: {
    provider: "elevenlabs",
    providers: {
      elevenlabs: {
        modelId: "eleven_v3",
        speakerVoiceId: "pMsXgVXv3BLzUgSXRplE",
      },
    },
  },
  plugins: {
    entries: {
      "google-meet": {
        config: {
          realtime: {
            transcriptionProvider: "elevenlabs",
            providers: {
              elevenlabs: {
                modelId: "scribe_v2_realtime",
                audioFormat: "ulaw_8000",
                sampleRate: 8000,
                commitStrategy: "vad",
              },
            },
          },
        },
      },
    },
  },
}

La voz persistente de Meet procede de tts.providers.elevenlabs.speakerVoiceId. Las respuestas del agente también pueden utilizar directivas [[tts:speakerVoiceId=... model=eleven_v3]] por respuesta cuando están habilitadas las anulaciones del modelo TTS, pero la configuración es el valor predeterminado determinista para las reuniones. Al unirse, los registros muestran transcriptionProvider=elevenlabs, y cada respuesta oral registra provider=elevenlabs model=eleven_v3 speakerVoiceId=<voiceId>. Configuración exclusiva para Twilio:

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

Con voiceCall.enabled: true (el valor predeterminado) y el transporte de Twilio, Voice Call envía la secuencia DTMF antes de abrir el flujo multimedia en tiempo real y, a continuación, utiliza el texto de introducción guardado como saludo inicial en tiempo real. Si voice-call no está habilitado, Google Meet aún puede validar y registrar el plan de marcación, pero no puede realizar la llamada de Twilio. Deje voiceCall.gatewayUrl sin configurar para usar el runtime local de confianza del Gateway, que conserva el agente que realiza la invocación durante toda la llamada. Una URL del Gateway configurada sigue siendo un destino WebSocket explícito y no puede autenticar la procedencia del plugin; las incorporaciones de agentes no predeterminados fallan de forma segura en lugar de usar silenciosamente otro agente. Ejecute Google Meet y Voice Call en el mismo proceso del Gateway cuando se requiera enrutamiento por agente.

Herramienta

Los agentes usan la herramienta google_meet:

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

`action`	Propósito
`join`	Unirse a una URL explícita de Meet
`create`	Crear un espacio (y unirse de forma predeterminada); admite `accessType`/`entryPointAccess`
`status`	Enumerar las sesiones activas o inspeccionar una mediante `sessionId`
`setup_status`	Ejecutar las mismas comprobaciones que `googlemeet setup`
`resolve_space`	Resolver una URL, un código o `spaces/{id}` mediante `spaces.get`
`preflight`	Validar los requisitos previos de OAuth y resolución de reuniones
`latest`	Buscar el registro de conferencia más reciente de una reunión
`calendar_events`	Previsualizar eventos de Calendar con enlaces de Meet
`artifacts`	Enumerar registros de conferencias y metadatos de participantes, grabaciones, transcripciones y notas inteligentes
`attendance`	Enumerar participantes y sesiones de participantes
`export`	Escribir el paquete de artefactos, asistencia, transcripción y manifiesto; establecer `"dryRun": true` para generar solo el manifiesto
`recover_current_tab`	Enfocar o inspeccionar una pestaña existente de Meet sin abrir una nueva
`transcript`	Leer la transcripción acotada de subtítulos; `sinceIndex` reanuda desde el `nextIndex` anterior
`leave`	Finalizar una sesión (Chrome hace clic en Leave; cierra solo las pestañas que abrió; Twilio cuelga)
`end_active_conference`	Finalizar la conferencia activa de Google Meet de un espacio gestionado mediante la API
`speak`	Hacer que el agente en tiempo real hable inmediatamente, dados `sessionId` y `message`
`test_speech`	Crear o reutilizar una sesión, activar una frase conocida y devolver el estado de Chrome
`test_listen`	Crear o reutilizar una sesión solo de observación y esperar cambios en los subtítulos o la transcripción

test_speech siempre fuerza mode: "agent" o "bidi" y falla si se le solicita ejecutarse en mode: "transcribe", porque las sesiones solo de observación no pueden emitir voz. speechOutputVerified requiere tanto bytes nuevos de salida en tiempo real como audio nuevo no silencioso que regrese por la ruta de captura del micrófono del puente durante esa salida. La salida anterior o la señal de bucle invertido de una sesión reutilizada no cuentan, y el crecimiento de los bytes del sumidero por sí solo ya no indica voz verificada. Para los transportes de Chrome, leave mantiene abierta una pestaña reutilizada propiedad del usuario después de hacer clic en el botón Leave call de Meet. Las pestañas abiertas por OpenClaw se cierran después de salir. Use transport: "chrome" cuando Chrome se ejecute en el host del Gateway y transport: "chrome-node" cuando se ejecute en un Node emparejado. En ambos casos, los proveedores de modelos y openclaw_agent_consult se ejecutan en el host del Gateway, por lo que las credenciales del modelo permanecen allí. Los registros del modo agente incluyen el proveedor y el modelo de transcripción resueltos al iniciar el puente, y el proveedor, modelo, voz, formato de salida y frecuencia de muestreo de TTS después de cada respuesta sintetizada. El valor sin procesar mode: "realtime" todavía se acepta como alias de compatibilidad heredado de mode: "agent", pero ya no se anuncia en la enumeración mode de la herramienta. create con una sala respaldada por API y una política de acceso explícita:

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

Finalización de la conferencia activa de una sala conocida:

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

Validación centrada primero en la escucha antes de afirmar que una reunión es útil:

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

Hablar bajo demanda:

{
  "action": "speak",
  "sessionId": "meet_...",
  "message": "Di exactamente: Estoy aquí y escuchando."
}

status incluye el estado de Chrome cuando está disponible:

Campo	Significado
`inCall`	Chrome parece estar dentro de la llamada de Meet
`micMuted`	Estado aproximado del micrófono de Meet
`manualActionRequired` / `manualActionReason` / `manualActionMessage`	El perfil del navegador necesita inicio de sesión manual, admisión del anfitrión de Meet, permisos o reparación del control del navegador para que la voz pueda funcionar
`speechReady` / `speechBlockedReason` / `speechBlockedMessage`	Indica si la voz gestionada de Chrome está permitida actualmente; `speechReady: false` significa que OpenClaw no envió la frase de introducción o prueba
`providerConnected` / `realtimeReady`	Estado del puente de voz en tiempo real
`lastInputAt` / `lastOutputAt`	Último audio recibido del puente o enviado a este
`audioOutputRouted` / `audioOutputDeviceLabel`	Indica si la salida multimedia de la pestaña de Meet se enrutó activamente al dispositivo BlackHole del puente
`lastOutputLoopbackAt` / `outputLoopbackSignalBytes`	Salida nueva cuya huella de forma de onda se correlacionó en la ruta de captura del micrófono BlackHole
`lastOutputLoopbackCorrelation`	Puntuación de correlación que vincula la señal capturada con la generación de salida actual del asistente
`outputGeneration` / `verifiedOutputGeneration`	Identificadores monotónicos; la igualdad significa que la salida actual, en lugar de una intervención anterior, superó la prueba de bucle invertido
`lastOutputLoopbackRms` / `lastOutputLoopbackPeak`	Diagnósticos de energía de audio del último fragmento verificado de captura de bucle invertido
`lastSuppressedInputAt` / `suppressedInputBytes`	Entrada de bucle invertido ignorada mientras la reproducción del asistente está activa

Modos agente y bidireccional

Modo	Quién decide la respuesta	Ruta de salida de voz	Cuándo usarlo
`agent`	El agente de OpenClaw configurado	Runtime normal de TTS de OpenClaw	Cuando se desea el comportamiento «mi agente está en la reunión»
`bidi`	El modelo de voz en tiempo real	Respuesta de audio del proveedor de voz en tiempo real	Cuando se desea el bucle de voz conversacional con la menor latencia

Modo agent: el proveedor de transcripción en tiempo real escucha el audio de la reunión, las transcripciones finales de los participantes se enrutan mediante el agente de OpenClaw configurado y la respuesta se reproduce mediante el TTS habitual de OpenClaw. Los fragmentos cercanos de la transcripción final se agrupan antes de la consulta para que un turno hablado no produzca varias respuestas parciales obsoletas; la entrada en tiempo real se suprime mientras el audio en cola del asistente sigue reproduciéndose, y los ecos recientes de transcripciones similares a las del asistente se ignoran antes de la consulta para que el bucle invertido de BlackHole no haga que el agente responda a su propia voz. Modo bidi: el modelo de voz en tiempo real responde directamente y puede llamar a openclaw_agent_consult para realizar un razonamiento más profundo, obtener información actual o usar las herramientas normales de OpenClaw. La herramienta de consulta ejecuta en segundo plano el agente normal de OpenClaw con el contexto reciente de la transcripción de la reunión y devuelve una respuesta oral concisa; en el modo agent, OpenClaw envía esa respuesta directamente a TTS, mientras que en el modo bidi el modelo de voz en tiempo real puede reproducirla. Usa el mismo mecanismo compartido de consulta que Voice Call. De forma predeterminada, las consultas se ejecutan con el agente main; establezca realtime.agentId para dirigir una vía de Meet a un espacio de trabajo de agente dedicado, valores predeterminados del modelo, política de herramientas, memoria e historial de sesiones. Las consultas del modo agente usan una clave de sesión agent:<id>:subagent:google-meet:<session> por reunión, de modo que las preguntas de seguimiento conservan el contexto de la reunión mientras heredan la política normal del agente. Cuando un agente llama a google_meet en modo agente, la sesión del consultor bifurca la transcripción actual del agente que realiza la llamada antes de responder a la voz del participante; la sesión de Meet permanece separada para que los seguimientos de la reunión no modifiquen directamente la transcripción del agente que realiza la llamada. realtime.toolPolicy controla la ejecución de la consulta:

Política	Comportamiento
`safe-read-only`	Exponer la herramienta de consulta; limitar el agente normal a `read`, `web_search`, `web_fetch`, `x_search`, `memory_search`, `memory_get`
`owner`	Exponer la herramienta de consulta; permitir que el agente normal use su política habitual de herramientas
`none`	No exponer la herramienta de consulta al modelo de voz en tiempo real

La clave de sesión de consulta tiene un ámbito por sesión de Meet, por lo que las llamadas de consulta de seguimiento reutilizan el contexto de consultas anterior durante la misma reunión. Fuerce una comprobación oral de disponibilidad después de que Chrome se haya unido por completo:

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

Prueba de humo completa de unión y voz:

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

Lista de comprobación para pruebas en directo

Antes de dejar una reunión a cargo de un agente sin supervisión:

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

Estado esperado de Chrome-node:

googlemeet setup está completamente en verde e incluye chrome-node-connected cuando Chrome-node es el transporte predeterminado o hay un nodo fijado.
nodes status muestra el nodo seleccionado conectado, anunciando tanto googlemeet.chrome como browser.proxy.
La pestaña de Meet se une y test-speech devuelve el estado de Chrome con inCall: true.

Para un host de Chrome remoto, como una máquina virtual macOS de Parallels, la comprobación segura más breve después de actualizar el Gateway o la máquina virtual es:

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

Esto demuestra que el plugin del Gateway está cargado, que el Node de la máquina virtual está conectado con el token actual y que el puente de audio de Meet está disponible antes de que un agente abra una pestaña de reunión real. Para una prueba rápida de Twilio, utilice una reunión que proporcione datos de acceso telefónico:

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

Estado esperado de Twilio:

googlemeet setup incluye comprobaciones en verde de twilio-voice-call-plugin, twilio-voice-call-credentials y twilio-voice-call-webhook.
voicecall está disponible en la CLI después de recargar el Gateway.
La sesión devuelta tiene transport: "twilio" y un twilio.voiceCallId.
openclaw logs --follow muestra que se proporcionó el TwiML de DTMF antes del TwiML en tiempo real y, después, un puente en tiempo real con el saludo inicial en cola.
googlemeet leave <sessionId> finaliza la llamada de voz delegada.

Solución de problemas

El agente no puede ver la herramienta de Google Meet

Confirme que el plugin esté habilitado y vuelva a cargar el Gateway; el agente en ejecución solo ve las herramientas de plugins registradas por el proceso actual del Gateway:

openclaw plugins list | grep google-meet
openclaw googlemeet setup

En hosts del Gateway que no sean macOS, google_meet permanece visible, pero las acciones locales de respuesta de Chrome se bloquean antes de llegar al puente de audio. Utilice mode: "transcribe", el acceso telefónico de Twilio o un host chrome-node de macOS en lugar de la ruta predeterminada del agente de Chrome local.

No hay ningún Node conectado compatible con Google Meet

En el host del Node:

openclaw plugins install npm:@openclaw/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

En el host del Gateway:

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

El Node debe estar conectado y enumerar googlemeet.chrome además de browser.proxy; la configuración del Gateway debe permitir ambos:

{
  gateway: {
    nodes: {
      commands: { allow: ["browser.proxy", "googlemeet.chrome"] },
    },
  },
}

Si googlemeet setup no supera chrome-node-connected o el registro del Gateway informa de gateway token mismatch, reinstale o reinicie el Node con el token actual del Gateway:

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

Después, vuelva a cargar el servicio del Node y ejecute de nuevo:

openclaw googlemeet setup
openclaw nodes status --connected

El navegador se abre, pero el agente no puede unirse

Ejecute googlemeet test-listen para incorporaciones de solo observación o googlemeet test-speech para incorporaciones en tiempo real y, después, inspeccione el estado de Chrome devuelto. Si cualquiera de ellos informa de manualActionRequired: true, muestre manualActionMessage al operador y deje de reintentar hasta que finalice la acción en el navegador. Acciones manuales habituales: iniciar sesión en el perfil de Chrome; admitir al invitado desde la cuenta anfitriona de Meet; conceder a Chrome permisos de micrófono y cámara cuando aparezca la solicitud nativa; cerrar o corregir un diálogo de permisos de Meet bloqueado. No informe de que «no se ha iniciado sesión» solo porque Meet pregunte «Do you want people to hear you in the meeting?»; esa es la pantalla intermedia de selección de audio de Meet. OpenClaw hace clic en Use microphone mediante la automatización del navegador cuando está disponible y sigue esperando el estado real de la reunión; para el mecanismo alternativo del navegador destinado únicamente a la creación, puede hacer clic en Continue without microphone, ya que generar la URL no necesita la ruta de audio en tiempo real.

No se puede crear la reunión

googlemeet create utiliza spaces.create de la API de Meet cuando OAuth está configurado; de lo contrario, utiliza el navegador del Node de Chrome fijado. Confirme lo siguiente:

Creación mediante la API: oauth.clientId y oauth.refreshToken (o las variables de entorno OPENCLAW_GOOGLE_MEET_* correspondientes) están presentes, y el token de actualización se generó después de añadir la compatibilidad con la creación; es posible que los tokens anteriores no incluyan meetings.space.created, por lo que debe volver a ejecutar openclaw googlemeet auth login --json.
Mecanismo alternativo del navegador: defaultTransport: "chrome-node" y chromeNode.node apuntan a un Node conectado con browser.proxy y googlemeet.chrome; se ha iniciado sesión en el perfil de Chrome de OpenClaw de ese Node y este puede abrir https://meet.google.com/new.
Reintentos del mecanismo alternativo del navegador: reutilice una pestaña existente de .../new o de solicitud de cuenta de Google antes de abrir una nueva; vuelva a intentar la llamada a la herramienta en lugar de abrir manualmente otra pestaña.
Acción manual: si la herramienta devuelve manualActionRequired: true, utilice browser.nodeId, browser.targetId, browserUrl y manualActionMessage para orientar al operador; no reintente en bucle.
Pantalla intermedia de selección de audio: si Meet muestra «Do you want people to hear you in the meeting?», deje abierta la pestaña. OpenClaw debería hacer clic en Use microphone o, únicamente para la creación, en Continue without microphone, y seguir esperando la URL generada; si no puede hacerlo, el error debería mencionar meet-audio-choice-required, no google-login-required.

El agente se une, pero no habla

openclaw googlemeet setup
openclaw googlemeet doctor

Utilice mode: "agent" para la ruta STT -> agente de OpenClaw -> TTS y mode: "bidi" para el mecanismo alternativo directo de voz en tiempo real. mode: "transcribe" no inicia intencionadamente ningún puente de respuesta. Para depurar en modo de solo observación, ejecute openclaw googlemeet status --json <session-id> después de que hablen los participantes y compruebe captioning, transcriptLines y lastCaptionText. Si inCall es verdadero, pero transcriptLines permanece en 0, es posible que los subtítulos de Meet estén deshabilitados, que nadie haya hablado desde que se instaló el observador, que la interfaz de Meet haya cambiado o que los subtítulos en directo no estén disponibles para el idioma o la cuenta de la reunión. googlemeet test-speech siempre comprueba la ruta en tiempo real e informa de si se observaron bytes de salida del puente para esa invocación. Si speechOutputVerified es falso y speechOutputTimedOut es verdadero, es posible que el proveedor en tiempo real haya aceptado la intervención, pero OpenClaw no haya detectado nuevos bytes de salida que llegaran al puente de audio de Chrome. Compruebe también lo siguiente: hay una clave del proveedor en tiempo real (OPENAI_API_KEY o GEMINI_API_KEY) disponible en el host del Gateway; BlackHole 2ch está visible en el host de Chrome; sox existe allí; el micrófono y el altavoz de Meet se enrutan a través de la ruta de audio virtual (doctor debería mostrar meet output routed: yes para incorporaciones en tiempo real con Chrome local). googlemeet doctor [session-id] muestra la sesión, el Node, el estado de la llamada, el motivo de la acción manual, la conexión con el proveedor en tiempo real, realtimeReady, la actividad de entrada y salida de audio, las marcas de tiempo del último audio, los contadores de bytes y la URL del navegador. Utilice googlemeet status [session-id] --json para obtener JSON sin procesar y googlemeet doctor --oauth (añada --meeting o --create-space) para verificar la actualización de OAuth sin exponer tokens. Si se agotó el tiempo de espera de un agente y ya hay una pestaña de Meet abierta, inspecciónela sin abrir otra:

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

La acción de herramienta equivalente es recover_current_tab: enfoca e inspecciona una pestaña de Meet existente para el transporte seleccionado (control del navegador local para chrome y el Node configurado para chrome-node) sin abrir una pestaña ni una sesión nuevas, e informa del bloqueo actual (inicio de sesión, admisión, permisos o estado de selección de audio). El comando de la CLI se comunica con el Gateway configurado, que debe estar en ejecución; chrome-node también requiere que el Node esté conectado.

Fallan las comprobaciones de configuración de Twilio

twilio-voice-call-plugin falla cuando voice-call no está permitido o habilitado: añádalo a plugins.allow, habilite plugins.entries.voice-call y vuelva a cargar el Gateway. twilio-voice-call-credentials falla cuando al backend de Twilio le falta el SID de la cuenta, el token de autenticación o el número de origen:

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

twilio-voice-call-webhook falla cuando voice-call no tiene exposición pública del Webhook o publicUrl apunta a un espacio de red de bucle invertido o privado. No utilice 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 ni fd00::/8 como publicUrl; las devoluciones de llamada del operador no pueden acceder a ellos. Establezca plugins.entries.voice-call.config.publicUrl en una URL pública o configure una exposición mediante un túnel o Tailscale:

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

Para el desarrollo local, utilice una exposición mediante un túnel o Tailscale en lugar de una URL de host privado:

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

Reinicie o vuelva a cargar el Gateway y, después, ejecute:

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

De forma predeterminada, voicecall smoke solo comprueba la disponibilidad. Realice una ejecución de prueba con un número concreto:

openclaw voicecall smoke --to "+15555550123"

Añada --yes únicamente para realizar intencionadamente una llamada saliente real:

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

La llamada de Twilio se inicia, pero nunca entra en la reunión

Confirme que el evento de Meet proporcione datos de acceso telefónico e indique el número de acceso telefónico exacto junto con el PIN o una secuencia DTMF personalizada:

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

Utilice w iniciales o comas en --dtmf-sequence para introducir una pausa antes del PIN. Si se crea la llamada, pero la lista de participantes de Meet nunca muestra al participante conectado por teléfono:

openclaw googlemeet doctor <session-id>: confirme el identificador de la llamada delegada de Twilio, si se puso DTMF en cola y si se solicitó el saludo de introducción.
openclaw voicecall status --call-id <id>: confirme que la llamada siga activa.
openclaw voicecall tail: confirme que los Webhooks de Twilio estén llegando al Gateway.
openclaw logs --follow: busque la secuencia de Twilio para Meet: Google Meet delega la incorporación, Voice Call almacena y proporciona el TwiML de DTMF previo a la conexión, Voice Call proporciona el TwiML en tiempo real para la llamada de Twilio y, después, Google Meet solicita la locución introductoria con voicecall.speak.
Vuelva a ejecutar openclaw googlemeet setup --transport twilio; se requiere una comprobación de configuración en verde, pero esta no demuestra que la secuencia del PIN de la reunión sea correcta.
Confirme que el número de acceso telefónico pertenezca a la misma invitación y región de Meet que el PIN.
Aumente voiceCall.dtmfDelayMs respecto al valor predeterminado de 12 segundos si Meet tarda en responder o la transcripción de la llamada sigue mostrando la solicitud del PIN después de enviar el DTMF previo a la conexión.
Si el participante se une, pero no se oye el saludo, compruebe en openclaw logs --follow la solicitud voicecall.speak posterior al DTMF y la reproducción de TTS mediante flujo multimedia o el mecanismo alternativo <Say> de Twilio. Si la transcripción sigue mostrando «enter the meeting PIN», el tramo telefónico aún no se ha unido a la sala de Meet, por lo que los participantes no oirán la locución.

Si los webhooks no llegan, depure primero el Plugin de llamadas de voz: el proveedor debe poder acceder a plugins.entries.voice-call.config.publicUrl o al túnel configurado. Consulte Solución de problemas de llamadas de voz.

Notas

La API oficial de medios de Google Meet está orientada a la recepción, por lo que para hablar en una llamada sigue siendo necesaria una ruta de participante. Este Plugin mantiene visible ese límite: Chrome gestiona la participación mediante el navegador y el enrutamiento del audio local; Twilio gestiona la participación mediante acceso telefónico. Los modos de respuesta de Chrome necesitan BlackHole 2ch más una de estas opciones:

chrome.audioInputCommand más chrome.audioOutputCommand: OpenClaw controla el puente y canaliza el audio en chrome.audioFormat entre esos comandos y el proveedor seleccionado. El modo agent utiliza transcripción en tiempo real más TTS normal; el modo bidi utiliza el proveedor de voz en tiempo real. La ruta predeterminada es PCM16 a 24 kHz con chrome.audioBufferBytes: 4096; G.711 mu-law a 8 kHz sigue disponible para pares de comandos heredados.
chrome.audioBridgeCommand: un comando de puente externo controla toda la ruta de audio local y debe finalizar después de iniciar o validar su daemon. Solo es válido para bidi, porque el modo agent necesita acceso directo al par de comandos para TTS.

Con el puente de Chrome basado en pares de comandos, chrome.bargeInInputCommand puede escuchar un micrófono local independiente e interrumpir la reproducción del asistente cuando una persona empieza a hablar, dando prioridad a la voz humana frente a la salida del asistente incluso mientras la entrada de bucle invertido compartida de BlackHole se suprime temporalmente durante la reproducción del asistente. Al igual que chrome.audioInputCommand/chrome.audioOutputCommand, es un comando local configurado por el operador: utilice una ruta de comando explícita y de confianza o una lista de argumentos, nunca un script procedente de una ubicación que no sea de confianza. Para obtener un audio dúplex limpio, enrute la salida de Meet y el micrófono de Meet mediante dispositivos virtuales separados o un gráfico de dispositivos virtuales similar a Loopback; un único dispositivo BlackHole compartido puede devolver a la llamada el audio de los demás participantes como eco. googlemeet speak activa el puente de audio de respuesta para una sesión de Chrome; googlemeet leave lo detiene (y, en las sesiones de Twilio delegadas mediante Llamadas de voz, finaliza la llamada subyacente). Utilice googlemeet end-active-conference para cerrar también la conferencia activa de Google Meet de un espacio gestionado mediante la API.

​Inicio rápido

​Crear una reunión

​Unión solo como observador

​Estado de la sesión en tiempo real

​Gateway local + Chrome en Parallels

​Comprobaciones de errores comunes

​Notas de instalación

​Transportes

​Chrome

​Twilio

​OAuth y comprobación previa

​Crear credenciales de Google

​Generar el token de actualización

​Verificar OAuth con doctor

​Resolver, realizar la comprobación previa y leer artefactos

​Prueba rápida en vivo

​Ejemplos de creación

​Configuración

​Valores predeterminados

​Anulaciones opcionales

​Herramienta

​Modos agente y bidireccional

​Lista de comprobación para pruebas en directo

​Solución de problemas

​El agente no puede ver la herramienta de Google Meet

​No hay ningún Node conectado compatible con Google Meet

​El navegador se abre, pero el agente no puede unirse

​No se puede crear la reunión

​El agente se une, pero no habla

​Fallan las comprobaciones de configuración de Twilio

​La llamada de Twilio se inicia, pero nunca entra en la reunión

​Notas

​Contenido relacionado