메인 콘텐츠로 건너뛰기

​
Google Meet (Plugin)

OpenClaw용 Google Meet 참가자 지원입니다. 이 Plugin은 의도적으로 명시적입니다.
  • 명시적인 https://meet.google.com/... URL에만 참여합니다.
  • realtime 음성이 기본 모드입니다.
  • 더 깊은 추론이나 도구가 필요할 때 realtime 음성은 전체 OpenClaw 에이전트를 다시 호출할 수 있습니다.
  • 인증은 개인 Google OAuth 또는 이미 로그인된 Chrome 프로필로 시작합니다.
  • 자동 동의 안내는 없습니다.
  • 기본 Chrome 오디오 백엔드는 BlackHole 2ch입니다.
  • Chrome은 로컬 또는 페어링된 Node 호스트에서 실행할 수 있습니다.
  • Twilio는 전화 접속 번호와 선택적 PIN 또는 DTMF 시퀀스를 허용합니다.
  • CLI 명령은 googlemeet이며, meet는 더 넓은 에이전트 텔레컨퍼런스 워크플로를 위해 예약되어 있습니다.

​
빠른 시작

로컬 오디오 종속성을 설치하고 백엔드 realtime 음성 제공자를 구성합니다. OpenAI가 기본값이며, realtime.provider: "google"과 함께 Google Gemini Live도 동작합니다. 
brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# or
export GEMINI_API_KEY=...
blackhole-2ch는 BlackHole 2ch 가상 오디오 장치를 설치합니다. Homebrew 설치 프로그램은 macOS가 이 장치를 노출하기 전에 재부팅을 요구합니다. 
sudo reboot
재부팅 후 두 가지를 모두 확인합니다. 
system_profiler SPAudioDataType | grep -i BlackHole
command -v rec play
Plugin을 활성화합니다. 
{
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {},
      },
    },
  },
}
설정을 확인합니다. 
openclaw googlemeet setup
회의에 참여합니다. 
openclaw googlemeet join https://meet.google.com/abc-defg-hij
또는 에이전트가 google_meet 도구를 통해 참여하도록 합니다. 
{
  "action": "join",
  "url": "https://meet.google.com/abc-defg-hij"
}
Chrome은 로그인된 Chrome 프로필로 참여합니다. Meet에서 OpenClaw가 사용하는 마이크/스피커 경로로 BlackHole 2ch를 선택합니다. 깨끗한 양방향 오디오를 위해 별도의 가상 장치 또는 Loopback 스타일 그래프를 사용하세요. 첫 번째 스모크 테스트에는 단일 BlackHole 장치로도 충분하지만 에코가 발생할 수 있습니다.

​
로컬 Gateway + Parallels Chrome

VM이 Chrome을 소유하도록 하기 위해 macOS VM 내부에 전체 OpenClaw Gateway 또는 모델 API 키가 필요한 것은 아닙니다. Gateway와 에이전트는 로컬에서 실행하고, VM에서는 Node 호스트를 실행합니다. Node가 Chrome 명령을 광고하도록 하려면 VM에서 번들 Plugin을 한 번 활성화하세요. 무엇이 어디서 실행되는지:
  • Gateway 호스트: OpenClaw Gateway, 에이전트 워크스페이스, 모델/API 키, realtime 제공자, 그리고 Google Meet Plugin 구성
  • Parallels macOS VM: OpenClaw CLI/Node 호스트, Google Chrome, SoX, BlackHole 2ch, 그리고 Google에 로그인된 Chrome 프로필
  • VM에 필요하지 않은 것: Gateway 서비스, 에이전트 구성, OpenAI/GPT 키, 또는 모델 제공자 설정
VM 종속성을 설치합니다. 
brew install blackhole-2ch sox
macOS가 BlackHole 2ch를 노출하도록 BlackHole 설치 후 VM을 재부팅합니다. 
sudo reboot
재부팅 후 VM이 오디오 장치와 SoX 명령을 볼 수 있는지 확인합니다. 
system_profiler SPAudioDataType | grep -i BlackHole
command -v rec play
VM에서 OpenClaw를 설치하거나 업데이트한 다음, সেখানে 번들 Plugin을 활성화합니다. 
openclaw plugins enable google-meet
VM에서 Node 호스트를 시작합니다. 
openclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos
<gateway-host>가 LAN IP이고 TLS를 사용하지 않는 경우, 신뢰된 사설 네트워크에 대해 명시적으로 허용하지 않으면 Node는 평문 WebSocket을 거부합니다. 
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \
  openclaw node run --host <gateway-lan-ip> --port 18789 --display-name parallels-macos
Node를 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는 openclaw.json 설정이 아니라 프로세스 환경 변수입니다. openclaw node install은 설치 명령에 해당 변수가 있을 때 이를 LaunchAgent 환경에 저장합니다. Gateway 호스트에서 Node를 승인합니다. 
openclaw devices list
openclaw devices approve <requestId>
Gateway가 Node를 인식하고 googlemeet.chrome를 광고하는지 확인합니다. 
openclaw nodes status
Gateway 호스트에서 해당 Node를 통해 Meet를 라우팅합니다. 
{
  gateway: {
    nodes: {
      allowCommands: ["googlemeet.chrome"],
    },
  },
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          chromeNode: {
            node: "parallels-macos",
          },
        },
      },
    },
  },
}
이제 Gateway 호스트에서 평소처럼 참여합니다. 
openclaw googlemeet join https://meet.google.com/abc-defg-hij
또는 에이전트에게 transport: "chrome-node"와 함께 google_meet 도구를 사용하도록 요청합니다. chromeNode.node가 생략되면, 연결된 Node 중 정확히 하나만 googlemeet.chrome를 광고할 때에만 OpenClaw가 자동 선택합니다. 여러 개의 가능한 Node가 연결되어 있으면 chromeNode.node를 Node id, 표시 이름, 또는 원격 IP로 설정하세요. 일반적인 실패 확인 사항:
  • No connected Google Meet-capable node: VM에서 openclaw node run을 시작하고, 페어링을 승인했는지 확인하고, VM에서 openclaw plugins enable google-meet를 실행했는지 확인하세요. 또한 Gateway 호스트가 gateway.nodes.allowCommands: ["googlemeet.chrome"]로 해당 Node 명령을 허용하는지도 확인하세요.
  • BlackHole 2ch audio device not found on the node: VM에 blackhole-2ch를 설치하고 VM을 재부팅하세요.
  • Chrome은 열리지만 참여할 수 없음: VM 내부의 Chrome에 로그인하고 해당 프로필로 Meet URL에 수동으로 참여할 수 있는지 확인하세요.
  • 오디오 없음: Meet에서 OpenClaw가 사용하는 가상 오디오 장치 경로로 마이크/스피커를 라우팅하세요. 깨끗한 양방향 오디오를 위해 별도의 가상 장치 또는 Loopback 스타일 라우팅을 사용하세요.

​
설치 참고 사항

Chrome realtime 기본값은 두 개의 외부 도구를 사용합니다.
  • sox: 명령줄 오디오 유틸리티입니다. Plugin은 기본 8 kHz G.711 mu-law 오디오 브리지를 위해 rec 및 play 명령을 사용합니다.
  • blackhole-2ch: macOS 가상 오디오 드라이버입니다. Chrome/Meet가 라우팅할 수 있는 BlackHole 2ch 오디오 장치를 생성합니다.
OpenClaw는 어느 패키지도 번들로 제공하거나 재배포하지 않습니다. 문서에서는 사용자가 Homebrew를 통해 이를 호스트 종속성으로 설치하도록 안내합니다. SoX의 라이선스는 LGPL-2.0-only AND GPL-2.0-only이며, BlackHole은 GPL-3.0입니다. OpenClaw와 함께 BlackHole을 번들하는 설치 프로그램이나 어플라이언스를 빌드하는 경우, BlackHole의 업스트림 라이선스 조건을 검토하거나 Existential Audio에서 별도 라이선스를 받으세요.

​
전송 수단

​
Chrome

Chrome 전송은 Google Chrome에서 Meet URL을 열고 로그인된 Chrome 프로필로 참여합니다. macOS에서는 Plugin이 실행 전에 BlackHole 2ch를 확인합니다. 구성된 경우, Chrome을 열기 전에 오디오 브리지 상태 확인 명령과 시작 명령도 실행합니다. Chrome/오디오가 Gateway 호스트에 있으면 chrome을 사용하고, Parallels macOS VM 같은 페어링된 Node에 있으면 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
Chrome 마이크와 스피커 오디오를 로컬 OpenClaw 오디오 브리지를 통해 라우팅합니다. BlackHole 2ch가 설치되어 있지 않으면, 오디오 경로 없이 조용히 참여하는 대신 설정 오류로 참여가 실패합니다.

​
Twilio

Twilio 전송은 Voice Call Plugin에 위임된 엄격한 다이얼 플랜입니다. Meet 페이지에서 전화번호를 파싱하지 않습니다. 
openclaw googlemeet join https://meet.google.com/abc-defg-hij \
  --transport twilio \
  --dial-in-number +15551234567 \
  --pin 123456
회의에 사용자 지정 시퀀스가 필요하면 --dtmf-sequence를 사용합니다. 
openclaw googlemeet join https://meet.google.com/abc-defg-hij \
  --transport twilio \
  --dial-in-number +15551234567 \
  --dtmf-sequence ww123456#

​
OAuth 및 사전 점검

Google Meet Media API 액세스는 먼저 개인 OAuth 클라이언트를 사용합니다. oauth.clientId와 선택적으로 oauth.clientSecret를 구성한 다음 다음을 실행합니다. 
openclaw googlemeet auth login --json
이 명령은 새로 고침 토큰이 포함된 oauth 구성 블록을 출력합니다. PKCE, http://localhost:8085/oauth2callback의 localhost 콜백, 그리고 --manual을 사용하는 수동 복사/붙여넣기 흐름을 사용합니다. 다음 환경 변수를 대체값으로 허용합니다.
  • OPENCLAW_GOOGLE_MEET_CLIENT_ID 또는 GOOGLE_MEET_CLIENT_ID
  • OPENCLAW_GOOGLE_MEET_CLIENT_SECRET 또는 GOOGLE_MEET_CLIENT_SECRET
  • OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN 또는 GOOGLE_MEET_REFRESH_TOKEN
  • OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN 또는 GOOGLE_MEET_ACCESS_TOKEN
  • OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT 또는 GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT
  • OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING 또는 GOOGLE_MEET_DEFAULT_MEETING
  • OPENCLAW_GOOGLE_MEET_PREVIEW_ACK 또는 GOOGLE_MEET_PREVIEW_ACK
Meet URL, 코드 또는 spaces/{id}를 spaces.get을 통해 확인합니다. 
openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij
미디어 작업 전에 사전 점검을 실행합니다. 
openclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij
Cloud 프로젝트, OAuth 주체, 회의 참가자가 Meet media API용 Google Workspace Developer Preview Program에 등록되어 있음을 확인한 후에만 preview.enrollmentAcknowledged: true를 설정하세요.

​
구성

일반적인 Chrome realtime 경로에는 Plugin 활성화, BlackHole, SoX, 그리고 백엔드 realtime 음성 제공자 키만 필요합니다. OpenAI가 기본값이며, Google Gemini Live를 사용하려면 realtime.provider: "google"를 설정하세요. 
brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# or
export GEMINI_API_KEY=...
Plugin 구성을 plugins.entries.google-meet.config 아래에 설정합니다. 
{
  plugins: {
    entries: {
      "google-meet": {
        enabled: true,
        config: {},
      },
    },
  },
}
기본값:
  • defaultTransport: "chrome"
  • defaultMode: "realtime"
  • chromeNode.node: chrome-node용 선택적 Node id/이름/IP
  • chrome.audioBackend: "blackhole-2ch"
  • chrome.audioInputCommand: stdout으로 8 kHz G.711 mu-law 오디오를 쓰는 SoX rec 명령
  • chrome.audioOutputCommand: stdin에서 8 kHz G.711 mu-law 오디오를 읽는 SoX play 명령
  • realtime.provider: "openai"
  • realtime.toolPolicy: "safe-read-only"
  • realtime.instructions: 더 깊은 답변을 위해 openclaw_agent_consult를 사용하는 짧은 음성 응답
  • realtime.introMessage: realtime 브리지가 연결될 때의 짧은 음성 준비 확인 메시지이며, 조용히 참여하려면 ""로 설정
선택적 재정의: 
{
  defaults: {
    meeting: "https://meet.google.com/abc-defg-hij",
  },
  chrome: {
    browserProfile: "Default",
  },
  chromeNode: {
    node: "parallels-macos",
  },
  realtime: {
    provider: "google",
    toolPolicy: "owner",
    introMessage: "Say exactly: I'm here.",
    providers: {
      google: {
        model: "gemini-2.5-flash-native-audio-preview-12-2025",
        voice: "Kore",
      },
    },
  },
}
Twilio 전용 구성: 
{
  defaultTransport: "twilio",
  twilio: {
    defaultDialInNumber: "+15551234567",
    defaultPin: "123456",
  },
  voiceCall: {
    gatewayUrl: "ws://127.0.0.1:18789",
  },
}

​
도구

에이전트는 google_meet 도구를 사용할 수 있습니다. 
{
  "action": "join",
  "url": "https://meet.google.com/abc-defg-hij",
  "transport": "chrome-node",
  "mode": "realtime"
}
Chrome이 Gateway 호스트에서 실행되면 transport: "chrome"를 사용하세요. Chrome이 Parallels VM 같은 페어링된 Node에서 실행되면 transport: "chrome-node"를 사용하세요. 두 경우 모두 realtime 모델과 openclaw_agent_consult는 Gateway 호스트에서 실행되므로 모델 자격 증명은 그곳에 유지됩니다. 활성 세션을 나열하거나 세션 ID를 확인하려면 action: "status"를 사용하세요. realtime 에이전트가 즉시 말하도록 하려면 sessionId와 message와 함께 action: "speak"를 사용하세요. 세션을 종료된 것으로 표시하려면 action: "leave"를 사용하세요. 
{
  "action": "speak",
  "sessionId": "meet_...",
  "message": "Say exactly: I'm here and listening."
}

​
Realtime 에이전트 상담

Chrome realtime 모드는 라이브 음성 루프에 최적화되어 있습니다. realtime 음성 제공자는 회의 오디오를 듣고 구성된 오디오 브리지를 통해 말합니다. realtime 모델에 더 깊은 추론, 최신 정보 또는 일반 OpenClaw 도구가 필요할 때 openclaw_agent_consult를 호출할 수 있습니다. consult 도구는 최근 회의 전사 컨텍스트를 바탕으로 일반 OpenClaw 에이전트를 백그라운드에서 실행하고, realtime 음성 세션에 간결한 음성 응답을 반환합니다. 그러면 음성 모델이 그 응답을 다시 회의에서 말할 수 있습니다. realtime.toolPolicy는 consult 실행 방식을 제어합니다.
  • safe-read-only: consult 도구를 노출하고 일반 에이전트를 read, web_search, web_fetch, x_search, memory_search, memory_get으로 제한합니다.
  • owner: consult 도구를 노출하고 일반 에이전트가 일반 에이전트 도구 정책을 사용하도록 합니다.
  • none: realtime 음성 모델에 consult 도구를 노출하지 않습니다.
consult 세션 키는 Meet 세션별로 범위가 지정되므로, 같은 회의 중 후속 consult 호출에서 이전 consult 컨텍스트를 재사용할 수 있습니다. Chrome이 통화에 완전히 참여한 뒤 음성 준비 확인을 강제로 실행하려면 다음을 사용합니다. 
openclaw googlemeet speak meet_... "Say exactly: I'm here and listening."

​
참고 사항

Google Meet의 공식 media API는 수신 중심이므로, Meet 통화에서 실제로 말하려면 여전히 참가자 경로가 필요합니다. 이 Plugin은 그 경계를 명확하게 드러냅니다. Chrome은 브라우저 참가와 로컬 오디오 라우팅을 처리하고, Twilio는 전화 접속 기반 참가를 처리합니다. Chrome realtime 모드에는 다음 중 하나가 필요합니다.
  • chrome.audioInputCommand와 chrome.audioOutputCommand: OpenClaw가 realtime 모델 브리지를 소유하며, 해당 명령과 선택된 realtime 음성 제공자 사이에서 8 kHz G.711 mu-law 오디오를 파이프합니다.
  • chrome.audioBridgeCommand: 외부 브리지 명령이 전체 로컬 오디오 경로를 소유하며, 데몬을 시작하거나 검증한 뒤 종료되어야 합니다.
깨끗한 양방향 오디오를 위해 Meet 출력과 Meet 마이크를 별도의 가상 장치 또는 Loopback 스타일 가상 장치 그래프로 라우팅하세요. 단일 공유 BlackHole 장치는 다른 참가자의 음성을 다시 통화로 에코할 수 있습니다. googlemeet speak는 Chrome 세션의 활성 realtime 오디오 브리지를 트리거합니다. googlemeet leave는 해당 브리지를 중지합니다. Voice Call Plugin을 통해 위임된 Twilio 세션의 경우 leave는 기본 음성 통화도 종료합니다.

​
관련 항목