Plugin گوگل میت

Plugin ‏google-meet به‌نمایندگی از یک عامل OpenClaw به نشانی‌های صریح Meet می‌پیوندد. دامنهٔ آن عمداً محدود است:

• این Plugin فقط به نشانی‌های https://meet.google.com/... می‌پیوندد؛ هرگز با استفاده از شماره تلفنی که خودش پیدا کرده است وارد جلسه نمی‌شود.
• googlemeet create می‌تواند از طریق Google Meet API (یا راهکار جایگزین مرورگر) یک نشانی Meet جدید ایجاد کند و به‌طور پیش‌فرض به آن بپیوندد.
• مشارکت از طریق Chrome از یک نمایهٔ واردشدهٔ Chrome استفاده می‌کند که می‌تواند روی یک Node جفت‌شده باشد. مشارکت از طریق Twilio با استفاده از شماره تلفن به‌همراه PIN/DTMF و از طریق Plugin تماس صوتی شماره‌گیری می‌کند؛ این روش نمی‌تواند مستقیماً یک نشانی Meet را شماره‌گیری کند.
• mode: "agent" (پیش‌فرض) گفتار شرکت‌کنندگان را با یک ارائه‌دهندهٔ بلادرنگ رونویسی می‌کند، آن را به عامل پیکربندی‌شدهٔ OpenClaw می‌فرستد و پاسخ را با TTS معمول OpenClaw می‌خواند. mode: "bidi" به یک مدل صوتی بلادرنگ اجازه می‌دهد مستقیماً پاسخ دهد. mode: "transcribe" به‌صورت فقط‌ناظر و بدون پاسخ صوتی به جلسه می‌پیوندد.
• هنگام پیوستن Plugin به تماس، هیچ اعلام خودکار رضایتی پخش نمی‌شود.
• فرمان CLI برابر با googlemeet است؛ meet برای گردش‌کارهای گسترده‌تر کنفرانس تلفنی عامل رزرو شده است.

شروع سریع

وابستگی‌های صوتی محلی را نصب کنید، سپس کلید یک ارائه‌دهندهٔ بلادرنگ را تنظیم کنید. OpenAI ارائه‌دهندهٔ پیش‌فرض رونویسی برای حالت agent است؛ Google Gemini Live نیز به‌عنوان ارائه‌دهندهٔ صوتی حالت bidi در دسترس است:

brew install blackhole-2ch soxexport OPENAI_API_KEY=sk-...# فقط وقتی لازم است که realtime.voiceProvider برای حالت bidi برابر با "google" باشدexport GEMINI_API_KEY=...

blackhole-2ch دستگاه صوتی مجازی BlackHole 2ch را نصب می‌کند که Chrome صدا را از طریق آن مسیریابی می‌کند. نصب‌کنندهٔ Homebrew برای اینکه macOS دستگاه را در دسترس قرار دهد، به راه‌اندازی مجدد نیاز دارد:

sudo reboot

پس از راه‌اندازی مجدد، هر دو مؤلفه را بررسی کنید:

system_profiler SPAudioDataType | grep -i BlackHolecommand -v sox

Plugin را فعال کنید:

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

راه‌اندازی را بررسی کنید، سپس به جلسه بپیوندید:

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

خروجی setup برای عامل قابل‌خواندن و از حالت و انتقال آگاه است: نمایهٔ Chrome، تثبیت Node و برای پیوستن‌های بلادرنگ Chrome، پل صوتی BlackHole/SoX و بررسی معرفی با تأخیر را گزارش می‌کند. پیوستن‌های فقط‌ناظر پیش‌نیازهای بلادرنگ را نادیده می‌گیرند:

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

وقتی واگذاری به Twilio پیکربندی شده باشد، setup همچنین آماده‌بودن voice-call، اعتبارنامه‌های Twilio و دسترسی عمومی Webhook را گزارش می‌کند. پیش از پیوستن عامل، هر بررسی ok: false را برای آن انتقال/حالت یک عامل مسدودکننده در نظر بگیرید. برای خروجی قابل‌خواندن توسط ماشین از --json و برای بررسی پیشاپیش یک انتقال مشخص از --transport chrome|chrome-node|twilio استفاده کنید:

openclaw googlemeet setup --transport twilio

یا اجازه دهید عامل از طریق ابزار google_meet بپیوندد:

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

در میزبان‌های Gateway غیر macOS، ‏google_meet برای کنش‌های مصنوع، تقویم، راه‌اندازی، رونویسی، Twilio و chrome-node همچنان قابل‌مشاهده است، اما پاسخ صوتی Chrome محلی (transport: "chrome" با mode: "agent" یا "bidi") پیش از رسیدن به پل صوتی مسدود می‌شود، زیرا این مسیر درحال‌حاضر به BlackHole 2ch در macOS وابسته است. در عوض از mode: "transcribe"، ورود تلفنی Twilio یا یک میزبان chrome-node مبتنی بر macOS استفاده کنید.

ایجاد جلسه

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

create دو مسیر دارد که در فیلد source نتیجه گزارش می‌شوند:

• api: وقتی اعتبارنامه‌های OAuth مربوط به Google Meet پیکربندی شده باشند استفاده می‌شود. قطعی است و به وضعیت رابط کاربری مرورگر وابسته نیست.
• browser: بدون اعتبارنامه‌های OAuth استفاده می‌شود. OpenClaw ‏https://meet.google.com/new را روی Node تثبیت‌شدهٔ Chrome باز می‌کند و منتظر می‌ماند تا Google به یک نشانی واقعی دارای کد جلسه هدایت کند؛ نمایهٔ Chrome متعلق به OpenClaw روی آن Node باید از قبل به Google وارد شده باشد. هم پیوستن و هم ایجاد، پیش از بازکردن برگه‌ای جدید، از برگهٔ موجود Meet (یا برگهٔ درحال‌انجام .../new / درخواست حساب Google) دوباره استفاده می‌کنند؛ تطبیق برگه رشته‌های پرس‌وجوی بی‌ضرری مانند authuser را نادیده می‌گیرد.

create به‌طور پیش‌فرض می‌پیوندد و joined: true را به‌همراه نشست پیوستن برمی‌گرداند. برای اینکه فقط نشانی ایجاد شود، --no-join (CLI) یا "join": false (ابزار) را ارسال کنید.

برای اتاق‌های ایجادشده از طریق API، به‌جای به‌ارث‌بردن پیش‌فرض حساب Google، یک سیاست دسترسی صریح تنظیم کنید:

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

این مورد فقط برای اتاق‌های ایجادشده از طریق API اعمال می‌شود، بنابراین OAuth باید پیکربندی شده باشد. اگر پیش از وجود این گزینه احراز هویت کرده‌اید، پس از افزودن محدودهٔ meetings.space.settings به صفحهٔ رضایت OAuth خود، openclaw googlemeet auth login --json را دوباره اجرا کنید.

اگر راهکار جایگزین مرورگر با مانع ورود به Google یا مجوز Meet روبه‌رو شود، ابزار manualActionRequired: true را به‌همراه manualActionReason، ‏manualActionMessage و browser.nodeId/browser.targetId/browserUrl برمی‌گرداند. آن پیام را گزارش کنید و تا زمانی که اپراتور مرحلهٔ مرورگر را تکمیل نکرده است، از بازکردن برگه‌های جدید Meet خودداری کنید.

پیوستن فقط‌ناظر

برای نادیده‌گرفتن پل بلادرنگ دوطرفه (بدون نیاز به BlackHole/SoX و بدون پاسخ صوتی)، "mode": "transcribe" را تنظیم کنید. پیوستن‌های Chrome در حالت رونویسی نیز اعطای مجوز میکروفون/دوربین OpenClaw و مسیر Use microphone در Meet را نادیده می‌گیرند؛ اگر Meet صفحهٔ میانی انتخاب صدا را نمایش دهد، خودکارسازی ابتدا Continue without microphone را امتحان می‌کند. انتقال‌های مدیریت‌شدهٔ Chrome در این حالت یک ناظر زیرنویس Meet را به‌صورت بهترین تلاش نصب می‌کنند. googlemeet status --json و googlemeet doctor مقادیر captioning، ‏captionsEnabledAttempted، ‏transcriptLines، ‏lastCaptionAt، ‏lastCaptionSpeaker، ‏lastCaptionText و یک دنبالهٔ recentTranscript را گزارش می‌کنند.

برای خواندن رونوشت محدود نشست، برگهٔ دقیق و ردیابی‌شدهٔ Meet را بخوانید:

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

ناظر حداکثر 2,000 خط زیرنویس تکمیل‌شده را در صفحهٔ Meet نگه می‌دارد. متن تدریجی قابل‌مشاهده تا زمان تکمیل ردیف زیرنویس در دنبالهٔ سلامت وضعیت باقی می‌ماند؛ بنابراین ذخیرهٔ nextIndex نمی‌تواند گسترش بعدی متن را از قلم بیندازد؛ ترک جلسه ردیف‌های قابل‌مشاهده را پیش از ثبت تصویر نهایی می‌کند. droppedLines خطوط ازدست‌رفته از ابتدای رونوشت را هنگام عبور از سقف گزارش می‌کند. رونوشت چهار نشست پایان‌یافتهٔ اخیر تا زمان راه‌اندازی مجدد Gateway قابل‌خواندن باقی می‌مانند. رونوشت نشست‌های پایان‌یافتهٔ قدیمی‌تر evicted: true را برمی‌گردانند. این قابلیت عمداً حافظهٔ زمان اجرا است، نه ذخیره‌سازی ماندگار تاریخچهٔ جلسه: راه‌اندازی مجدد Gateway، بستن برگه پیش از ثبت تصویر یا عبور از سقف‌های مستندشده می‌تواند باعث ازدست‌رفتن زیرنویس‌ها شود.

برای یک کاوش شنیداری بله/خیر:

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

این فرمان در حالت رونویسی می‌پیوندد، منتظر حرکت تازهٔ زیرنویس/رونوشت می‌ماند و listenVerified، ‏listenTimedOut، فیلدهای اقدام دستی و سلامت فعلی زیرنویس را برمی‌گرداند.

سلامت نشست بلادرنگ

در طول نشست‌های دارای پاسخ صوتی، وضعیت google_meet سلامت Chrome/پل صوتی را گزارش می‌کند: inCall، ‏manualActionRequired، ‏providerConnected، ‏realtimeReady، ‏audioInputActive، ‏audioOutputActive، آخرین برچسب‌های زمانی ورودی/خروجی، شمارنده‌های بایت و وضعیت بسته‌بودن پل. نشست‌های مدیریت‌شدهٔ Chrome تنها پس از آن عبارت معرفی/آزمایش را می‌خوانند که سلامت، inCall: true را گزارش کند؛ در غیر این صورت speechReady: false و تلاش برای گفتار مسدود می‌شود، نه اینکه بی‌سروصدا هیچ کاری انجام ندهد.

پیوستن‌های محلی Chrome از نمایهٔ مرورگر واردشدهٔ OpenClaw استفاده می‌کنند و برای مسیر میکروفون/بلندگو به BlackHole 2ch نیاز دارند. یک دستگاه BlackHole برای نخستین آزمایش دود کافی است، اما ممکن است پژواک ایجاد کند؛ برای صدای دوطرفهٔ پاک از دستگاه‌های مجازی جداگانه یا یک گراف مشابه Loopback استفاده کنید.

Gateway محلی + Chrome در Parallels

برای اینکه صرفاً Chrome در اختیار یک ماشین مجازی macOS قرار گیرد، وجود Gateway کامل یا کلید API مدل داخل ماشین مجازی لازم نیست. Gateway و عامل را به‌صورت محلی اجرا کنید؛ میزبان Node را در ماشین مجازی اجرا کنید.

وابستگی‌های ماشین مجازی را نصب کنید، راه‌اندازی مجدد انجام دهید و بررسی کنید:

brew install blackhole-2ch soxsudo rebootsystem_profiler SPAudioDataType | grep -i BlackHolecommand -v sox

Plugin را در ماشین مجازی فعال کنید و میزبان Node را راه‌اندازی کنید:

openclaw plugins enable google-meetopenclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos

اگر <gateway-host> یک IP شبکهٔ محلی بدون TLS است، استفاده از آن شبکهٔ خصوصی مورداعتماد را صریحاً بپذیرید:

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

هنگام نصب به‌عنوان LaunchAgent نیز از همین پرچم استفاده کنید (این یک متغیر محیطی فرایند است که اگر در فرمان نصب وجود داشته باشد در محیط LaunchAgent ذخیره می‌شود، نه یک تنظیم openclaw.json):

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

Node را از میزبان Gateway تأیید کنید، سپس مطمئن شوید که هم googlemeet.chrome و هم قابلیت مرورگر/browser.proxy را اعلام می‌کند:

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

Meet را از طریق آن Node مسیریابی کنید:

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

اکنون به‌طور معمول از میزبان Gateway به جلسه بپیوندید:

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

برای یک آزمایش دود تک‌فرمانی که نشستی را ایجاد می‌کند یا دوباره به‌کار می‌گیرد، عبارتی شناخته‌شده را می‌خواند و سلامت نشست را چاپ می‌کند:

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

هنگام پیوستن بلادرنگ، خودکارسازی مرورگر نام مهمان را وارد می‌کند، روی Join/Ask to join کلیک می‌کند و در صورت نمایش، درخواست بار نخست Use microphone در Meet را می‌پذیرد (یا هنگام پیوستن فقط‌ناظر و ایجاد جلسه فقط از طریق مرورگر، Continue without microphone را انتخاب می‌کند). اگر نمایه از حساب خارج شده باشد، Meet منتظر پذیرش میزبان باشد، Chrome به مجوز میکروفون/دوربین نیاز داشته باشد یا Meet روی یک درخواست حل‌نشده گیر کرده باشد، نتیجه manualActionRequired: true را به‌همراه manualActionReason و manualActionMessage گزارش می‌کند. تلاش مجدد را متوقف کنید، آن پیام را به‌همراه browserUrl/browserTitle گزارش کنید و فقط پس از تکمیل اقدام دستی دوباره تلاش کنید.

اگر chromeNode.node حذف شود، OpenClaw تنها زمانی به‌طور خودکار انتخاب می‌کند که دقیقاً یک Node متصل، هم googlemeet.chrome و هم کنترل مرورگر را اعلام کند؛ هنگامی که چند Node توانمند متصل‌اند، chromeNode.node (شناسه Node، نام نمایشی یا IP راه‌دور) را ثابت کنید.

بررسی خطاهای رایج

نکات نصب

حالت پیش‌فرض پاسخ صوتی Chrome از دو ابزار خارجی استفاده می‌کند که OpenClaw آن‌ها را همراه خود ارائه یا بازتوزیع نمی‌کند؛ آن‌ها را از طریق Homebrew به‌عنوان وابستگی‌های میزبان نصب کنید:

• sox: ابزار صوتی خط فرمان. Plugin برای پل صوتی پیش‌فرض PCM16 با نرخ 24 kHz، فرمان‌های صریح دستگاه CoreAudio را صادر می‌کند.
• blackhole-2ch: درایور صوتی مجازی macOS که دستگاه BlackHole 2ch را فراهم می‌کند و Chrome/Meet از طریق آن مسیریابی می‌شود.

مجوز SoX از نوع LGPL-2.0-only AND GPL-2.0-only است؛ BlackHole تحت GPL-3.0 است. اگر نصب‌کننده یا دستگاهی می‌سازید که BlackHole را همراه OpenClaw ارائه می‌کند، مجوز بالادستی BlackHole را بررسی کنید یا مجوزی جداگانه از Existential Audio بگیرید.

انتقال‌ها

Chrome

URL مربوط به Meet را از طریق کنترل مرورگر OpenClaw باز می‌کند و با نمایه واردشده مرورگر OpenClaw می‌پیوندد. در macOS، Plugin پیش از اجرا وجود BlackHole 2ch را بررسی می‌کند و در صورت پیکربندی، پیش از باز کردن Chrome فرمان سلامت/راه‌اندازی پل صوتی را اجرا می‌کند. برای Chrome محلی، نمایه را با browser.defaultProfile انتخاب کنید؛ در عوض، chrome.browserProfile به میزبان‌های chrome-node ارسال می‌شود.

openclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chromeopenclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome-node

صدای میکروفون/بلندگوی Chrome از پل صوتی محلی OpenClaw عبور می‌کند. اگر BlackHole 2ch نصب نشده باشد، پیوستن به‌جای ورود بدون مسیر صوتی، با خطای راه‌اندازی ناموفق می‌شود.

Twilio

یک طرح شماره‌گیری سخت‌گیرانه که به Plugin تماس صوتی واگذار می‌شود. این طرح صفحات Meet را برای یافتن شماره تلفن تجزیه نمی‌کند؛ Google Meet باید شماره تماس ورودی تلفنی و PIN جلسه را نمایش دهد.

تماس صوتی را روی میزبان Gateway فعال کنید، نه روی Node مربوط به Chrome:

{  plugins: {    allow: ["google-meet", "voice-call", "google"],    entries: {      "google-meet": {        enabled: true,        config: {          defaultTransport: "chrome-node",          // یا اگر Twilio باید پیش‌فرض باشد، "twilio" را تنظیم کنید        },      },      "voice-call": {        enabled: true,        config: {          provider: "twilio",          inboundPolicy: "allowlist",          realtime: {            enabled: true,            provider: "google",            instructions: "به‌عنوان یک عامل OpenClaw به این Google Meet بپیوند. مختصر صحبت کن.",            toolPolicy: "safe-read-only",            providers: {              google: {                silenceDurationMs: 500,                startSensitivity: "high",              },            },          },        },      },      google: {        enabled: true,      },    },  },}

برای خارج نگه‌داشتن اطلاعات اعتبارسنجی Twilio از openclaw.json، آن‌ها را از طریق محیط ارائه کنید:

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

اگر OpenAI ارائه‌دهنده صدای بلادرنگ است، در عوض از realtime.provider: "openai" همراه با OPENAI_API_KEY استفاده کنید.

پس از فعال‌سازی voice-call، Gateway را راه‌اندازی مجدد یا بازبارگذاری کنید؛ تغییرات پیکربندی Plugin تا زمان بازبارگذاری اعمال نمی‌شوند. بررسی کنید:

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

هنگامی که واگذاری Twilio متصل شده باشد، googlemeet setup شامل بررسی‌های twilio-voice-call-plugin، twilio-voice-call-credentials و twilio-voice-call-webhook است.

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

برای یک توالی سفارشی از --dtmf-sequence استفاده کنید و برای مکث پیش از PIN، w ابتدایی یا ویرگول‌ها را به‌کار ببرید:

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

OAuth و پیش‌بررسی

OAuth برای ایجاد پیوند Meet اختیاری است، زیرا googlemeet create می‌تواند به خودکارسازی مرورگر بازگردد. OAuth را برای ایجاد از طریق API رسمی، تفکیک فضا یا پیش‌بررسی Meet Media API پیکربندی کنید. پیوستن‌های Chrome/Chrome-node هرگز به OAuth وابسته نیستند؛ آن‌ها در هر صورت از یک نمایه واردشده Chrome، ‏BlackHole/SoX و (برای chrome-node) یک Node متصل استفاده می‌کنند.

ایجاد اطلاعات اعتبارسنجی Google

در Google Cloud Console:

http://localhost:8085/oauth2callback

meetings.space.created برای spaces.create الزامی است. meetings.space.readonly نشانی‌ها/کدهای Meet را به فضاها تفکیک می‌کند. meetings.space.settings به OpenClaw اجازه می‌دهد تنظیمات SpaceConfig مانند accessType را هنگام ایجاد اتاق با API ارسال کند. meetings.conference.media.readonly برای پیش‌بررسی Meet Media API و کار با رسانه است؛ ممکن است Google برای استفاده واقعی از Media API ثبت‌نام در Developer Preview را الزامی کند. calendar.events.readonly فقط برای جست‌وجوی تقویم --today/--event لازم است. drive.meet.readonly فقط برای برون‌بری --include-doc-bodies لازم است. اگر فقط به پیوستن با Chrome مبتنی بر مرورگر نیاز دارید، OAuth را به‌طور کامل نادیده بگیرید.

ایجاد توکن تازه‌سازی

oauth.clientId و در صورت تمایل oauth.clientSecret را پیکربندی کنید (یا آن‌ها را به‌عنوان متغیرهای محیطی ارسال کنید)، سپس اجرا کنید:

openclaw googlemeet auth login --json

این فرمان یک جریان PKCE را با فراخوان محلی روی http://localhost:8085/oauth2callback اجرا می‌کند و یک بلوک پیکربندی oauth حاوی توکن تازه‌سازی را چاپ می‌کند. هنگامی که مرورگر نمی‌تواند به فراخوان محلی دسترسی پیدا کند، برای جریان کپی/جای‌گذاری --manual را اضافه کنید:

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

خروجی JSON:

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

شیء oauth را زیر پیکربندی Plugin ذخیره کنید:

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

اگر نمی‌خواهید توکن تازه‌سازی در پیکربندی باشد، متغیرهای محیطی را ترجیح دهید؛ ابتدا پیکربندی تفکیک می‌شود و سپس محیط به‌عنوان مسیر جایگزین استفاده می‌شود. اگر پیش از افزوده‌شدن پشتیبانی از ایجاد جلسه، جست‌وجوی تقویم یا برون‌بری متن سند احراز هویت کرده‌اید، openclaw googlemeet auth login --json را دوباره اجرا کنید تا توکن تازه‌سازی مجموعه دامنه‌های فعلی را پوشش دهد.

بررسی OAuth با doctor

openclaw googlemeet doctor --oauth --json

این فرمان بدون بارگذاری زمان‌اجرای Chrome یا نیاز به Node متصل، وجود پیکربندی OAuth و توانایی توکن تازه‌سازی برای ایجاد توکن دسترسی را بررسی می‌کند. گزارش فقط شامل فیلدهای وضعیت (ok، configured، tokenSource، expiresAt، پیام‌های بررسی) است و هرگز توکن دسترسی، توکن تازه‌سازی یا راز کارخواه را چاپ نمی‌کند.

فعال‌سازی Meet API و دامنهٔ spaces.create را با بررسی ایجادِ دارای اثر جانبی اثبات کنید:

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

دسترسی خواندن به یک فضا‌ی موجود را اثبات کنید:

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

یک 403 از این بررسی‌ها معمولاً به این معناست که Meet REST API غیرفعال است، توکن نوسازی دامنهٔ لازم را ندارد، یا حساب Google نمی‌تواند به آن فضا دسترسی پیدا کند. خطای توکن نوسازی یعنی openclaw googlemeet auth login --json را دوباره اجرا کنید و بلوک جدید oauth را ذخیره کنید.

برای روش جایگزین مرورگر نیازی به OAuth نیست؛ احراز هویت Google در آنجا از نمایهٔ واردشدهٔ Chrome روی Node انتخاب‌شده تأمین می‌شود، نه از پیکربندی OpenClaw.

این متغیرهای محیطی به‌عنوان مقادیر جایگزین پذیرفته می‌شوند:

• 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

رفع شناسه، بررسی پیش‌نیازها و خواندن مصنوعات

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

پس از اینکه Meet رکوردهای کنفرانس را ایجاد کرد:

openclaw googlemeet artifacts --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet attendance --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet export --meeting https://meet.google.com/abc-defg-hij --output ./meet-export

با --meeting، artifacts و attendance به‌طور پیش‌فرض از جدیدترین رکورد کنفرانس استفاده می‌شود؛ برای همهٔ رکوردهای نگه‌داری‌شده --all-conference-records را ارسال کنید.

جست‌وجوی تقویم پیش از خواندن مصنوعات، نشانی جلسه را از Google Calendar رفع می‌کند (به توکن نوسازی‌ای نیاز دارد که دامنهٔ فقط‌خواندنی رویدادهای Calendar را شامل شود):

openclaw googlemeet latest --todayopenclaw googlemeet calendar-events --today --jsonopenclaw googlemeet artifacts --event "Weekly sync"openclaw googlemeet attendance --today --format csv --output attendance.csv

--today تقویم primary امروز را برای رویدادی دارای پیوند Meet جست‌وجو می‌کند؛ --event <query> متن رویداد منطبق را جست‌وجو می‌کند؛ --calendar <id> یک تقویم غیراصلی را هدف می‌گیرد. calendar-events پیش‌نمایش رویدادهای منطبق را نمایش می‌دهد و مشخص می‌کند latest/artifacts/attendance/export کدام‌یک را انتخاب خواهد کرد.

اگر شناسهٔ رکورد کنفرانس را از قبل می‌دانید، مستقیماً به آن ارجاع دهید:

openclaw googlemeet latest --meeting https://meet.google.com/abc-defg-hijopenclaw googlemeet artifacts --conference-record conferenceRecords/abc123 --jsonopenclaw googlemeet attendance --conference-record conferenceRecords/abc123 --json

اتاق یک فضای ایجادشده با API را ببندید:

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

spaces.endActiveConference را فراخوانی می‌کند و برای فضایی که حساب مجاز می‌تواند مدیریت کند، به OAuth با دامنهٔ meetings.space.created نیاز دارد. یک نشانی Meet، کد جلسه یا spaces/{id} را می‌پذیرد و ابتدا آن را به منبع فضای API رفع می‌کند. این کار از googlemeet leave جداست: leave مشارکت محلی/نشست OpenClaw را متوقف می‌کند؛ end-active-conference از Google Meet می‌خواهد کنفرانس فعال آن فضا را پایان دهد.

یک گزارش خوانا بنویسید:

openclaw googlemeet artifacts --conference-record conferenceRecords/abc123 \  --format markdown --output meet-artifacts.mdopenclaw googlemeet attendance --conference-record conferenceRecords/abc123 \  --format csv --output meet-attendance.csvopenclaw googlemeet export --conference-record conferenceRecords/abc123 \  --include-doc-bodies --zip --output meet-exportopenclaw googlemeet export --conference-record conferenceRecords/abc123 \  --include-doc-bodies --dry-run

artifacts فرادادهٔ رکورد کنفرانس را به‌همراه فرادادهٔ منابع شرکت‌کننده، ضبط، رونوشت، ورودی‌های ساخت‌یافتهٔ رونوشت و یادداشت هوشمند، در صورت ارائه‌شدن آن‌ها توسط Google، برمی‌گرداند. --no-transcript-entries برای جلسه‌های بزرگ از جست‌وجوی ورودی‌ها صرف‌نظر می‌کند. attendance شرکت‌کنندگان را به ردیف‌های نشست شرکت‌کننده گسترش می‌دهد که شامل زمان اولین/آخرین مشاهده، مدت کل نشست، پرچم‌های تأخیر/ترک زودهنگام و ادغام منابع تکراری شرکت‌کننده بر اساس کاربر واردشده یا نام نمایشی است؛ --no-merge-duplicates منابع خام را جدا نگه می‌دارد و --late-after-minutes/--early-before-minutes آستانه‌ها را تنظیم می‌کنند.

export پوشه‌ای شامل summary.md، attendance.csv، transcript.md، artifacts.json، attendance.json و manifest.json می‌نویسد. manifest.json ورودی انتخاب‌شده، گزینه‌های برون‌بری، رکوردهای کنفرانس، فایل‌های خروجی، تعدادها، منبع توکن، هر رویداد Calendar استفاده‌شده و هشدارهای بازیابی جزئی را ثبت می‌کند. --zip همچنین یک بایگانی قابل‌حمل در کنار پوشه می‌نویسد. --include-doc-bodies متن Google Docs پیوندشدهٔ رونوشت/یادداشت هوشمند را از طریق Drive files.export برون‌بری می‌کند (به دامنهٔ فقط‌خواندنی Drive Meet نیاز دارد)؛ بدون آن، برون‌بری‌ها فقط شامل فرادادهٔ Meet و ورودی‌های ساخت‌یافتهٔ رونوشت خواهند بود. خرابی جزئی مصنوعات (خطای فهرست‌کردن یادداشت هوشمند، ورودی رونوشت یا بدنهٔ سند) به‌جای شکست کل برون‌بری، هشدار را در خلاصه/مانیفست نگه می‌دارد. --dry-run همان داده‌ها را دریافت می‌کند و بدون ایجاد پوشه یا ZIP، JSON مانیفست را چاپ می‌کند.

عامل‌ها از همان کنش‌ها از طریق ابزار google_meet استفاده می‌کنند (export، create با accessType، end_active_conference، test_listen)؛ ابزار را ببینید.

آزمون دود زنده

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 transcribeopenclaw googlemeet test-listen https://meet.google.com/abc-defg-hij --transport chrome-node --timeout-ms 30000

آزمون دود پایهٔ مصنوعات/حضور به meetings.space.readonly و meetings.conference.media.readonly نیاز دارد. جست‌وجوی Calendar به calendar.events.readonly نیاز دارد. برون‌بری بدنهٔ سند Drive به drive.meet.readonly نیاز دارد.

نمونه‌های ایجاد

openclaw googlemeet create

نشانی URI جلسهٔ جدید، منبع و نشست پیوستن را چاپ می‌کند. با OAuth از Meet API استفاده می‌کند؛ بدون آن از نمایهٔ واردشدهٔ Node سنجاق‌شدهٔ Chrome استفاده می‌کند. JSON روش جایگزین مرورگر:

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

اگر روش جایگزین مرورگر ابتدا به ورود Google یا مانع مجوز Meet برخورد کند، google_meet به‌جای یک رشتهٔ ساده، جزئیات ساخت‌یافته برمی‌گرداند:

{  "source": "browser",  "error": "google-login-required: برای ایجاد دوبارهٔ جلسه، وارد حساب Google در پروفایل مرورگر OpenClaw شوید و سپس دوباره امتحان کنید.",  "manualActionRequired": true,  "manualActionReason": "google-login-required",  "manualActionMessage": "برای ایجاد دوبارهٔ جلسه، وارد حساب Google در پروفایل مرورگر OpenClaw شوید و سپس دوباره امتحان کنید.",  "browser": {    "nodeId": "ba0f4e4bc...",    "targetId": "tab-1",    "browserUrl": "https://accounts.google.com/signin",    "browserTitle": "ورود - حساب‌های Google"  }}

JSON ایجاد با 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"    }  }}

ایجاد به‌طور پیش‌فرض به جلسه می‌پیوندد، اما Chrome/Chrome-node همچنان برای پیوستن از طریق مرورگر به یک نمایهٔ Google واردشده نیاز دارد؛ اگر از حساب خارج شده باشد، OpenClaw خطای manualActionRequired: true یا روش جایگزین مرورگر را گزارش می‌کند و از اپراتور می‌خواهد پیش از تلاش دوباره، ورود Google را تکمیل کند.

preview.enrollmentAcknowledged: true را فقط پس از تأیید اینکه پروژهٔ Cloud، هویت اصلی OAuth و شرکت‌کنندگان جلسه در Google Workspace Developer Preview Program برای Meet media APIs ثبت‌نام شده‌اند، تنظیم کنید.

پیکربندی

مسیر رایج عامل Chrome فقط به Plugin فعال، BlackHole، SoX، یک کلید ارائه‌دهندهٔ بلادرنگ و یک ارائه‌دهندهٔ TTS پیکربندی‌شده در OpenClaw نیاز دارد:

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

پیش‌فرض‌ها

chrome.audioBridgeCommand و chrome.audioBridgeHealthCommand به یک پل خارجی اجازه می‌دهند به‌جای chrome.audioInputCommand/chrome.audioOutputCommand مالک کل مسیر صوتی محلی باشد؛ برای محدودیت مربوط به حالتی که می‌تواند از آن‌ها استفاده کند، نکات را ببینید.

یک مهاجرت openclaw doctor --fix برای ساختار قدیمی realtime.provider: "google" وجود دارد: اگر فیلدهای realtime.voiceProvider: "google" و realtime.transcriptionProvider: "openai" از قبل تنظیم نشده باشند، این مقصود را به آن‌ها منتقل می‌کند.

بازنویسی‌های اختیاری

{  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: "Say exactly: I'm here.",    providers: {      google: {        speakerVoice: "Kore",      },    },  },}

ElevenLabs برای شنیدن و صحبت‌کردن در حالت عامل:

{  messages: {    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",              },            },          },        },      },    },  },}

صدای پایدار Meet از messages.tts.providers.elevenlabs.speakerVoiceId می‌آید. وقتی بازنویسی مدل TTS فعال باشد، پاسخ‌های عامل می‌توانند از دستورهای [[tts:speakerVoiceId=... model=eleven_v3]] مخصوص هر پاسخ نیز استفاده کنند، اما پیکربندی، پیش‌فرض قطعی برای جلسه‌ها است. هنگام پیوستن، گزارش‌ها transcriptionProvider=elevenlabs را نشان می‌دهند و هر پاسخ گفتاری، provider=elevenlabs model=eleven_v3 speakerVoiceId=<voiceId> را ثبت می‌کند.

پیکربندی مخصوص Twilio:

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

با voiceCall.enabled: true (پیش‌فرض) و انتقال Twilio، تماس صوتی پیش از بازکردن جریان رسانه‌ای بی‌درنگ، دنبالهٔ DTMF را برقرار می‌کند و سپس متن آغازین ذخیره‌شده را به‌عنوان خوشامدگویی اولیهٔ بی‌درنگ به‌کار می‌برد. اگر voice-call فعال نباشد، Google Meet همچنان می‌تواند طرح شماره‌گیری را اعتبارسنجی و ثبت کند، اما نمی‌تواند تماس Twilio را برقرار کند.

برای استفاده از زمان‌اجرای محلی و مورداعتماد Gateway که عامل فراخواننده را در کل تماس حفظ می‌کند، voiceCall.gatewayUrl را تنظیم‌نشده باقی بگذارید. URL پیکربندی‌شدهٔ Gateway همچنان یک مقصد صریح WebSocket است و نمی‌تواند منشأ Plugin را احراز هویت کند؛ پیوستن عامل‌های غیراصلی به‌جای استفادهٔ بی‌سروصدا از عاملی دیگر، به‌صورت بسته شکست می‌خورد. هنگامی که مسیریابی به‌ازای هر عامل لازم است، Google Meet و Voice Call را در یک فرایند Gateway اجرا کنید.

ابزار

عامل‌ها از ابزار google_meet استفاده می‌کنند:

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

test_speech همیشه mode: "agent" یا "bidi" را اجباری می‌کند و اگر از آن خواسته شود در mode: "transcribe" اجرا شود، شکست می‌خورد، زیرا نشست‌های فقط‌نظارتی نمی‌توانند گفتار تولید کنند. نتیجهٔ speechOutputVerified آن بر افزایش بایت‌های خروجی صوت بلادرنگ در طول همان فراخوانی مبتنی است، بنابراین نشست استفاده‌شدهٔ مجدد با صوت قدیمی، بررسی تازه محسوب نمی‌شود.

برای انتقال‌های Chrome، leave پس از کلیک روی دکمهٔ Leave تماس در Meet، زبانهٔ متعلق به کاربر را که دوباره استفاده شده است باز نگه می‌دارد. زبانه‌هایی که OpenClaw باز کرده است پس از خروج بسته می‌شوند.

وقتی Chrome روی میزبان Gateway اجرا می‌شود از transport: "chrome" و وقتی روی یک Node جفت‌شده اجرا می‌شود از transport: "chrome-node" استفاده کنید. در هر دو حالت، ارائه‌دهندگان مدل و openclaw_agent_consult روی میزبان Gateway اجرا می‌شوند، بنابراین اعتبارنامه‌های مدل همان‌جا باقی می‌مانند. گزارش‌های حالت عامل هنگام راه‌اندازی پل، ارائه‌دهنده/مدل رفع‌شدهٔ رونویسی و پس از هر پاسخ ترکیب‌شده، ارائه‌دهنده/مدل/صدا/قالب خروجی/نرخ نمونه‌برداری TTS را شامل می‌شوند. mode: "realtime" خام همچنان به‌عنوان نام مستعار سازگاری قدیمی برای mode: "agent" پذیرفته می‌شود، اما دیگر در enum مربوط به mode ابزار نمایش داده نمی‌شود.

create با اتاقی مبتنی بر API و سیاست دسترسی صریح:

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

پایان‌دادن به کنفرانس فعال یک اتاق شناخته‌شده:

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

اعتبارسنجی ابتدا-شنیدن پیش از ادعای مفیدبودن یک جلسه:

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

صحبت‌کردن در صورت درخواست:

{  "action": "speak",  "sessionId": "meet_...",  "message": "دقیقاً بگو: من اینجا هستم و گوش می‌دهم."}

status در صورت موجودبودن، وضعیت سلامت Chrome را شامل می‌شود:

حالت‌های عامل و دوسویه

حالت agent: ارائه‌دهندهٔ رونویسی بلادرنگ صوت جلسه را می‌شنود، رونویسی‌های نهایی شرکت‌کننده از طریق عامل پیکربندی‌شدهٔ OpenClaw مسیریابی می‌شوند و پاسخ از طریق TTS معمول OpenClaw بیان می‌شود. قطعه‌های نزدیک رونویسی نهایی پیش از مشورت با هم ادغام می‌شوند تا یک نوبت گفتاری چندین پاسخ جزئی قدیمی ایجاد نکند؛ هنگام ادامهٔ پخش صوت صف‌شدهٔ دستیار، ورودی بلادرنگ سرکوب می‌شود و پژواک‌های اخیر رونویسی که شبیه گفتار دستیار هستند پیش از مشورت نادیده گرفته می‌شوند تا بازگشت BlackHole باعث نشود عامل به گفتار خودش پاسخ دهد.

حالت bidi: مدل صدای بلادرنگ مستقیماً پاسخ می‌دهد و می‌تواند برای استدلال عمیق‌تر، اطلاعات جاری یا ابزارهای عادی OpenClaw، openclaw_agent_consult را فراخوانی کند. ابزار مشورت در پشت صحنه عامل عادی OpenClaw را با بافت رونویسی اخیر جلسه اجرا می‌کند و پاسخی کوتاه و مناسب گفتار برمی‌گرداند؛ در حالت agent، OpenClaw آن پاسخ را مستقیماً به TTS می‌فرستد و در حالت bidi مدل صدای بلادرنگ می‌تواند آن را بازگو کند. این حالت از همان سازوکار مشترک مشورت Voice Call استفاده می‌کند.

به‌صورت پیش‌فرض، مشورت‌ها با عامل main اجرا می‌شوند؛ برای هدایت یک مسیر Meet به فضای کاری، پیش‌فرض‌های مدل، سیاست ابزار، حافظه و تاریخچهٔ نشست یک عامل اختصاصی، realtime.agentId را تنظیم کنید. مشورت‌های حالت عامل از کلید نشست agent:<id>:subagent:google-meet:<session> مختص هر جلسه استفاده می‌کنند تا پرسش‌های بعدی بافت جلسه را حفظ کنند و هم‌زمان سیاست عادی عامل را به ارث ببرند. وقتی یک عامل در حالت عامل google_meet را فراخوانی می‌کند، نشست مشاور پیش از پاسخ‌دادن به گفتار شرکت‌کننده، از رونویسی جاری فراخواننده انشعاب می‌گیرد؛ نشست Meet جدا باقی می‌ماند تا پرسش‌های بعدی جلسه مستقیماً رونویسی فراخواننده را تغییر ندهند.

realtime.toolPolicy اجرای مشورت را کنترل می‌کند:

کلید نشست مشورت به هر نشست Meet محدود است، بنابراین فراخوانی‌های مشورت بعدی در طول همان جلسه از بافت مشورت قبلی دوباره استفاده می‌کنند.

پس از آن‌که Chrome کاملاً پیوست، بررسی آمادگی گفتاری را اجباری کنید:

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

آزمون دود کامل پیوستن و صحبت‌کردن:

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

فهرست بررسی آزمایش زنده

پیش از سپردن یک جلسه به عامل بدون نظارت:

openclaw googlemeet setupopenclaw nodes statusopenclaw googlemeet test-speech https://meet.google.com/abc-defg-hij \  --transport chrome-node \  --message "Say exactly: Google Meet speech test complete."

وضعیت موردانتظار Chrome-node:

• googlemeet setup کاملاً سبز است و وقتی Chrome-node انتقال پیش‌فرض باشد یا یک Node سنجاق شده باشد، chrome-node-connected را شامل می‌شود.
• nodes status نشان می‌دهد Node انتخاب‌شده متصل است و هر دو googlemeet.chrome و browser.proxy را اعلام می‌کند.
• زبانهٔ Meet می‌پیوندد و test-speech وضعیت سلامت Chrome را همراه با inCall: true برمی‌گرداند.

برای میزبان راه‌دور Chrome، مانند یک ماشین مجازی macOS در Parallels، کوتاه‌ترین بررسی امن پس از به‌روزرسانی Gateway یا ماشین مجازی:

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

این کار پیش از آن‌که عامل یک زبانهٔ واقعی جلسه را باز کند، ثابت می‌کند Plugin مربوط به Gateway بارگذاری شده، Node ماشین مجازی با توکن جاری متصل است و پل صوتی Meet در دسترس است.

برای آزمون دود Twilio، از جلسه‌ای استفاده کنید که جزئیات شماره‌گیری تلفنی را ارائه می‌دهد:

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

وضعیت مورد انتظار Twilio:

• googlemeet setup شامل بررسی‌های سبز twilio-voice-call-plugin، twilio-voice-call-credentials و twilio-voice-call-webhook است.
• voicecall پس از بارگذاری مجدد Gateway در CLI دردسترس است.
• نشست بازگردانده‌شده دارای transport: "twilio" و یک twilio.voiceCallId است.
• openclaw logs --follow نشان می‌دهد که TwiML مربوط به DTMF پیش از TwiML بلادرنگ ارائه شده و سپس یک پل بلادرنگ با پیام خوشامدگویی اولیه در صف ایجاد شده است.
• googlemeet leave <sessionId> تماس صوتی واگذارشده را قطع می‌کند.

عیب‌یابی

عامل نمی‌تواند ابزار Google Meet را ببیند

تأیید کنید Plugin فعال است و Gateway را دوباره بارگذاری کنید؛ عامل در حال اجرا فقط ابزارهای Plugin ثبت‌شده توسط فرایند فعلی Gateway را می‌بیند:

openclaw plugins list | grep google-meetopenclaw googlemeet setup

در میزبان‌های Gateway غیر از macOS، google_meet قابل‌مشاهده باقی می‌ماند، اما کنش‌های پاسخ صوتی محلی Chrome پیش از رسیدن به پل صوتی مسدود می‌شوند. به‌جای مسیر پیش‌فرض عامل محلی Chrome، از mode: "transcribe"، شماره‌گیری Twilio یا یک میزبان macOS با chrome-node استفاده کنید.

هیچ Node متصل و سازگار با Google Meet وجود ندارد

در میزبان Node:

openclaw plugins enable google-meetopenclaw plugins enable browserOPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 \  openclaw node run --host <gateway-lan-ip> --port 18789 --display-name parallels-macos

در میزبان Gateway:

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

Node باید متصل باشد و googlemeet.chrome و نیز browser.proxy را فهرست کند؛ پیکربندی Gateway باید هر دو را مجاز بداند:

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

اگر googlemeet setup در chrome-node-connected ناموفق بود، یا گزارش Gateway حاوی gateway token mismatch بود، Node را با توکن فعلی Gateway دوباره نصب یا راه‌اندازی کنید:

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

سپس سرویس Node را دوباره بارگذاری کنید و این موارد را مجدداً اجرا کنید:

openclaw googlemeet setupopenclaw nodes status --connected

مرورگر باز می‌شود، اما عامل نمی‌تواند بپیوندد

برای پیوستن‌های فقط‌مشاهده، googlemeet test-listen و برای پیوستن‌های بلادرنگ، googlemeet test-speech را اجرا کنید، سپس سلامت Chrome بازگردانده‌شده را بررسی کنید. اگر هرکدام manualActionRequired: true را گزارش کرد، manualActionMessage را به اپراتور نشان دهید و تا تکمیل کنش مرورگر، تلاش مجدد را متوقف کنید.

کنش‌های دستی رایج: وارد نمایه Chrome شوید؛ مهمان را از حساب میزبان Meet بپذیرید؛ هنگام نمایش اعلان بومی، مجوزهای میکروفون/دوربین Chrome را اعطا کنید؛ کادر گفت‌وگوی مجوز Meet را که گیر کرده است ببندید یا اصلاح کنید.

صرفاً به‌دلیل اینکه Meet می‌پرسد «آیا می‌خواهید افراد حاضر در جلسه صدای شما را بشنوند؟»، «وارد نشده است» را گزارش نکنید؛ این صفحه میانی انتخاب صدا در Meet است. OpenClaw در صورت امکان از طریق خودکارسازی مرورگر روی Use microphone کلیک می‌کند و همچنان منتظر وضعیت واقعی جلسه می‌ماند؛ برای حالت جایگزین مرورگر که فقط ایجاد می‌کند، ممکن است به‌جای آن روی Continue without microphone کلیک کند، زیرا ساخت URL به مسیر صوتی بلادرنگ نیاز ندارد.

ایجاد جلسه ناموفق است

googlemeet create هنگام پیکربندی OAuth از spaces.create مربوط به API ‏Meet و در غیر این صورت از مرورگر Chrome در Node سنجاق‌شده استفاده می‌کند. موارد زیر را تأیید کنید:

• ایجاد با API: ‏oauth.clientId و oauth.refreshToken (یا متغیرهای محیطی منطبق OPENCLAW_GOOGLE_MEET_*) موجود هستند و توکن نوسازی پس از افزوده‌شدن پشتیبانی ایجاد صادر شده است؛ توکن‌های قدیمی‌تر ممکن است فاقد meetings.space.created باشند، بنابراین openclaw googlemeet auth login --json را دوباره اجرا کنید.
• حالت جایگزین مرورگر: ‏defaultTransport: "chrome-node" و chromeNode.node به یک Node متصل دارای browser.proxy و googlemeet.chrome اشاره می‌کنند؛ نمایه Chrome متعلق به OpenClaw در آن Node وارد شده و می‌تواند https://meet.google.com/new را باز کند.
• تلاش‌های مجدد حالت جایگزین مرورگر: پیش از بازکردن زبانه‌ای جدید، از یک .../new موجود یا زبانه اعلان حساب Google دوباره استفاده کنید؛ به‌جای بازکردن دستی زبانه‌ای دیگر، فراخوانی ابزار را دوباره امتحان کنید.
• کنش دستی: اگر ابزار manualActionRequired: true را بازگرداند، برای راهنمایی اپراتور از browser.nodeId، browser.targetId، browserUrl و manualActionMessage استفاده کنید؛ در یک حلقه تلاش مجدد نکنید.
• صفحه میانی انتخاب صدا: اگر Meet عبارت «آیا می‌خواهید افراد حاضر در جلسه صدای شما را بشنوند؟» را نشان داد، زبانه را باز نگه دارید. OpenClaw باید روی Use microphone یا (فقط برای ایجاد) Continue without microphone کلیک کند و همچنان منتظر URL تولیدشده بماند؛ اگر نتواند، خطا باید به meet-audio-choice-required اشاره کند، نه google-login-required.

عامل می‌پیوندد، اما صحبت نمی‌کند

openclaw googlemeet setupopenclaw googlemeet doctor

برای مسیر STT -> عامل OpenClaw -> TTS از mode: "agent" و برای حالت جایگزین صوتی بلادرنگ مستقیم از mode: "bidi" استفاده کنید. mode: "transcribe" عمداً هیچ پل پاسخ صوتی‌ای را آغاز نمی‌کند. برای عیب‌یابی فقط‌مشاهده، پس از صحبت شرکت‌کنندگان openclaw googlemeet status --json <session-id> را اجرا کنید و captioning، transcriptLines و lastCaptionText را بررسی کنید. اگر inCall درست است، اما transcriptLines همچنان 0 باقی می‌ماند، ممکن است زیرنویس‌های Meet غیرفعال باشند، از زمان نصب مشاهده‌گر کسی صحبت نکرده باشد، رابط کاربری Meet تغییر کرده باشد، یا زیرنویس زنده برای زبان/حساب جلسه دردسترس نباشد.

googlemeet test-speech همیشه مسیر بلادرنگ را بررسی می‌کند و گزارش می‌دهد که آیا برای آن فراخوانی، بایت‌های خروجی پل مشاهده شده‌اند یا خیر. اگر speechOutputVerified نادرست و speechOutputTimedOut درست باشد، ممکن است ارائه‌دهنده بلادرنگ گفته را پذیرفته باشد، اما OpenClaw ندیده باشد که بایت‌های خروجی جدید به پل صوتی Chrome برسند.

همچنین تأیید کنید: یک کلید ارائه‌دهنده بلادرنگ (OPENAI_API_KEY یا GEMINI_API_KEY) در میزبان Gateway دردسترس است؛ BlackHole 2ch در میزبان Chrome قابل‌مشاهده است؛ sox در آنجا وجود دارد؛ میکروفون/بلندگوی Meet از مسیر صوتی مجازی عبور می‌کنند (doctor باید برای پیوستن‌های بلادرنگ محلی Chrome، ‏meet output routed: yes را نشان دهد).

googlemeet doctor [session-id] نشست، Node، وضعیت حضور در تماس، دلیل کنش دستی، اتصال ارائه‌دهنده بلادرنگ، realtimeReady، فعالیت ورودی/خروجی صدا، آخرین زمان‌های صوتی، شمارنده‌های بایت و URL مرورگر را چاپ می‌کند. برای JSON خام از googlemeet status [session-id] --json و برای تأیید نوسازی OAuth بدون افشای توکن‌ها از googlemeet doctor --oauth (با افزودن --meeting یا --create-space) استفاده کنید.

اگر زمان عامل تمام شده و یک زبانه Meet از قبل باز است، بدون بازکردن زبانه‌ای دیگر آن را بررسی کنید:

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

کنش ابزار معادل، recover_current_tab است: بدون بازکردن زبانه یا نشست جدید، یک زبانه Meet موجود را برای انتقال انتخاب‌شده (کنترل مرورگر محلی برای chrome، ‏Node پیکربندی‌شده برای chrome-node) متمرکز و بررسی می‌کند و مانع فعلی (ورود، پذیرش، مجوزها، وضعیت انتخاب صدا) را گزارش می‌دهد. فرمان CLI با Gateway پیکربندی‌شده ارتباط برقرار می‌کند که باید در حال اجرا باشد؛ chrome-node همچنین مستلزم اتصال Node است.

بررسی‌های راه‌اندازی Twilio ناموفق‌اند

twilio-voice-call-plugin زمانی ناموفق است که voice-call مجاز یا فعال نباشد: آن را به plugins.allow اضافه کنید، plugins.entries.voice-call را فعال کنید و Gateway را دوباره بارگذاری کنید.

twilio-voice-call-credentials زمانی ناموفق است که بخش پشتی Twilio فاقد SID حساب، توکن احراز هویت یا شماره تماس‌گیرنده باشد:

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

twilio-voice-call-webhook زمانی ناموفق است که voice-call هیچ Webhook عمومی در معرض دسترسی نداشته باشد، یا publicUrl به فضای شبکه loopback/خصوصی اشاره کند. از 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 یا fd00::/8 به‌عنوان publicUrl استفاده نکنید؛ فراخوانی‌های برگشتی اپراتور مخابراتی نمی‌توانند به آن‌ها دسترسی پیدا کنند. plugins.entries.voice-call.config.publicUrl را روی یک URL عمومی تنظیم کنید، یا یک تونل/دسترسی Tailscale پیکربندی کنید:

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

برای توسعه محلی، به‌جای URL میزبان خصوصی از تونل یا دسترسی Tailscale استفاده کنید:

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

Gateway را دوباره راه‌اندازی یا بارگذاری کنید، سپس:

openclaw googlemeet setup --transport twilioopenclaw voicecall setupopenclaw voicecall smoke

voicecall smoke به‌طور پیش‌فرض فقط آمادگی را بررسی می‌کند. برای یک شماره مشخص اجرای آزمایشی انجام دهید:

openclaw voicecall smoke --to "+15555550123"

فقط برای برقراری عمدی یک تماس خروجی واقعی، --yes را اضافه کنید:

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

تماس Twilio آغاز می‌شود، اما هرگز وارد جلسه نمی‌شود

تأیید کنید رویداد Meet جزئیات شماره‌گیری تلفنی را ارائه می‌کند و شماره دقیق شماره‌گیری را همراه با PIN یا یک توالی DTMF سفارشی وارد کنید:

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

برای ایجاد مکث پیش از PIN، از w در ابتدای --dtmf-sequence یا ویرگول در آن استفاده کنید.

اگر تماس ایجاد شده است، اما فهرست حاضران Meet هرگز شرکت‌کننده شماره‌گیری‌شده را نشان نمی‌دهد:

• openclaw googlemeet doctor <session-id>: شناسه تماس واگذارشده Twilio، اینکه آیا DTMF در صف قرار گرفته است، و اینکه آیا پیام خوشامدگویی اولیه درخواست شده است را تأیید کنید.
• openclaw voicecall status --call-id <id>: تأیید کنید تماس همچنان فعال است.
• openclaw voicecall tail: تأیید کنید Webhookهای Twilio به Gateway می‌رسند.
• openclaw logs --follow: به‌دنبال توالی Twilio Meet بگردید: Google Meet پیوستن را واگذار می‌کند، Voice Call ‏TwiML مربوط به DTMF پیش از اتصال را ذخیره و ارائه می‌کند، Voice Call ‏TwiML بلادرنگ را برای تماس Twilio ارائه می‌کند، سپس Google Meet گفتار آغازین را با voicecall.speak درخواست می‌کند.
• openclaw googlemeet setup --transport twilio را دوباره اجرا کنید؛ بررسی سبز راه‌اندازی الزامی است، اما درست‌بودن توالی PIN جلسه را اثبات نمی‌کند.
• تأیید کنید شماره شماره‌گیری متعلق به همان دعوت‌نامه Meet و همان منطقه PIN است.
• اگر Meet دیر پاسخ می‌دهد یا رونوشت تماس پس از ارسال DTMF پیش از اتصال همچنان اعلان PIN را نشان می‌دهد، voiceCall.dtmfDelayMs را از مقدار پیش‌فرض 12 ثانیه افزایش دهید.
• اگر شرکت‌کننده می‌پیوندد، اما پیام خوشامدگویی را نمی‌شنوید، openclaw logs --follow را برای درخواست voicecall.speak پس از DTMF و نیز پخش TTS جریان رسانه یا حالت جایگزین Twilio با OPENCLAW_DOCS_MARKER:calloutOpen:U2F5 بررسی کنید. اگر رونوشت همچنان «PIN جلسه را وارد کنید» را نشان می‌دهد، بخش تلفنی هنوز به اتاق Meet نپیوسته است، بنابراین شرکت‌کنندگان گفتار را نخواهند شنید.

اگر Webhookها نمی‌رسند، ابتدا Plugin ‏Voice Call را عیب‌یابی کنید: ارائه‌دهنده باید بتواند به plugins.entries.voice-call.config.publicUrl یا تونل پیکربندی‌شده دسترسی پیدا کند. عیب‌یابی تماس صوتی را ببینید.

یادداشت‌ها

API رسمی رسانه Google Meet دریافت‌محور است، بنابراین صحبت‌کردن در تماس همچنان به یک مسیر شرکت‌کننده نیاز دارد. این Plugin این مرز را آشکار نگه می‌دارد: Chrome مشارکت مرورگری و مسیریابی صوتی محلی را مدیریت می‌کند؛ Twilio مشارکت از طریق شماره‌گیری تلفنی را مدیریت می‌کند.

حالت‌های پاسخ صوتی Chrome به BlackHole 2ch به‌همراه یکی از موارد زیر نیاز دارند:

• chrome.audioInputCommand به‌همراه chrome.audioOutputCommand: ‏OpenClaw مالک پل ارتباطی است و بین این فرمان‌ها و ارائه‌دهندهٔ انتخاب‌شده، صدا را در chrome.audioFormat انتقال می‌دهد. حالت agent از رونویسی بلادرنگ به‌همراه TTS معمولی استفاده می‌کند؛ حالت bidi از ارائه‌دهندهٔ صدای بلادرنگ استفاده می‌کند. مسیر پیش‌فرض، PCM16 با نرخ 24 kHz و chrome.audioBufferBytes: 4096 است؛ G.711 mu-law با نرخ 8 kHz همچنان برای جفت‌فرمان‌های قدیمی در دسترس است.
• chrome.audioBridgeCommand: یک فرمان پل ارتباطی خارجی مالک کل مسیر صوتی محلی است و باید پس از راه‌اندازی یا اعتبارسنجی دیمن خود خارج شود. فقط برای bidi معتبر است، زیرا حالت agent برای TTS به دسترسی مستقیم به جفت‌فرمان نیاز دارد.

با پل Chrome مبتنی بر جفت‌فرمان، chrome.bargeInInputCommand می‌تواند به یک میکروفون محلی جداگانه گوش دهد و هنگامی که انسانی شروع به صحبت می‌کند، پخش دستیار را قطع کند؛ در نتیجه، حتی وقتی ورودی مشترک لوپ‌بک BlackHole هنگام پخش دستیار موقتاً متوقف می‌شود، گفتار انسان بر خروجی دستیار تقدم دارد. مانند chrome.audioInputCommand/chrome.audioOutputCommand، این یک فرمان محلی است که اپراتور پیکربندی می‌کند: از یک مسیر فرمان مورداعتماد یا فهرست آرگومان صریح استفاده کنید و هرگز اسکریپتی را از مکانی نامطمئن به کار نبرید.

برای صدای دوطرفهٔ شفاف، خروجی Meet و میکروفون Meet را از طریق دستگاه‌های مجازی جداگانه یا یک گراف دستگاه مجازی به‌سبک Loopback مسیریابی کنید؛ یک دستگاه مشترک BlackHole می‌تواند صدای سایر شرکت‌کنندگان را به تماس بازتاب دهد.

googlemeet speak پل صوتی فعال پاسخ‌گویی را برای یک نشست Chrome فعال می‌کند؛ googlemeet leave آن را متوقف می‌کند (و برای نشست‌های Twilio که از طریق Voice Call واگذار شده‌اند، تماس زیربنایی را قطع می‌کند). برای بستن کنفرانس فعال Google Meet در فضایی که با API مدیریت می‌شود نیز از googlemeet end-active-conference استفاده کنید.

مرتبط

• Plugin تماس صوتی
• حالت مکالمه
• ساخت Pluginها