Google Meet Plugin

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• ينضم فقط إلى عنوان URL صريح بالشكل https://meet.google.com/....
• يمكنه إنشاء مساحة Meet جديدة من خلال Google Meet API، ثم الانضمام إلى عنوان URL المُعاد.
• agent هو وضع الردّ الصوتي الافتراضي: يستمع النسخ الفوري، ويجيب وكيل OpenClaw المكوَّن، ويتحدث OpenClaw TTS العادي داخل Meet.
• يبقى bidi متاحًا كوضع احتياطي مباشر لنموذج الصوت الفوري.
• تختار الوكلاء سلوك الانضمام باستخدام mode: استخدم agent للاستماع/الردّ المباشر، أو bidi كاحتياطي مباشر للصوت الفوري، أو transcribe للانضمام/التحكم في المتصفح من دون جسر الردّ الصوتي.
• يبدأ التفويض بوصول Google OAuth شخصي أو ملف Chrome شخصي مسجّل دخوله مسبقًا.
• لا يوجد إعلان موافقة تلقائي.
• واجهة الصوت الخلفية الافتراضية في Chrome هي BlackHole 2ch.
• يمكن تشغيل Chrome محليًا أو على مضيف عقدة مقترنة.
• تقبل Twilio رقم اتصال هاتفيًا مع رقم PIN أو تسلسل DTMF اختياري؛ ولا يمكنها طلب عنوان URL لاجتماع Meet مباشرة.
• أمر CLI هو googlemeet؛ أما meet فهو محجوز لسير عمل المؤتمرات الهاتفية الأوسع للوكلاء.

​

البدء السريع

brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# only needed when realtime.voiceProvider is "google" for bidi mode
export GEMINI_API_KEY=...

sudo reboot

system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

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

openclaw googlemeet setup

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

openclaw googlemeet setup --transport twilio

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

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

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

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

openclaw googlemeet create --no-join

• إنشاء عبر API: يُستخدم عندما تكون بيانات اعتماد Google Meet OAuth مكوَّنة. هذا هو المسار الأكثر حتمية ولا يعتمد على حالة واجهة المتصفح.
• احتياطي المتصفح: يُستخدم عند غياب بيانات اعتماد OAuth. يستخدم OpenClaw عقدة Chrome المثبتة، ويفتح https://meet.google.com/new، وينتظر من Google إعادة التوجيه إلى عنوان URL حقيقي برمز اجتماع، ثم يعيد ذلك العنوان. يتطلب هذا المسار أن يكون ملف Chrome الشخصي الخاص بـ OpenClaw على العقدة مسجّل الدخول مسبقًا إلى Google. تتولى أتمتة المتصفح مطالبة الميكروفون الأولية الخاصة بـ Meet؛ ولا تُعامل تلك المطالبة كفشل في تسجيل الدخول إلى Google. كما تحاول تدفقات الانضمام والإنشاء إعادة استخدام تبويب Meet موجود قبل فتح تبويب جديد. تتجاهل المطابقة سلاسل استعلام URL غير الضارة مثل authuser، لذلك ينبغي أن تؤدي إعادة محاولة الوكيل إلى التركيز على الاجتماع المفتوح مسبقًا بدلًا من إنشاء تبويب Chrome ثانٍ.

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

​

Gateway محلي + Chrome في Parallels

• مضيف Gateway: OpenClaw Gateway، ومساحة عمل الوكيل، ومفاتيح النموذج/API، ومزود فوري، وتكوين Plugin الخاص بـ Google Meet.
• جهاز Parallels macOS VM: OpenClaw CLI/مضيف العقدة، وGoogle Chrome، وSoX، وBlackHole 2ch، وملف Chrome شخصي مسجّل الدخول إلى Google.
• غير مطلوب في VM: خدمة Gateway، أو تكوين الوكيل، أو مفتاح OpenAI/GPT، أو إعداد مزود النموذج.

brew install blackhole-2ch sox

sudo reboot

system_profiler SPAudioDataType | grep -i BlackHole
command -v sox

openclaw plugins enable google-meet

openclaw node run --host <gateway-host> --port 18789 --display-name parallels-macos

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

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

openclaw devices list
openclaw devices approve <requestId>

openclaw nodes status

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

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

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

• Configured Google Meet node ... is not usable: offline: إن Node المثبت معروف لدى Gateway لكنه غير متاح. يجب على الوكلاء التعامل مع ذلك Node كحالة تشخيصية، لا كمضيف Chrome قابل للاستخدام، والإبلاغ عن عائق الإعداد بدلا من الرجوع إلى نقل آخر ما لم يطلب المستخدم ذلك.
• No connected Google Meet-capable node: شغّل openclaw node run في VM، وافق على الاقتران، وتأكد من تشغيل openclaw plugins enable google-meet و openclaw plugins enable browser في VM. وتأكد أيضا من أن مضيف Gateway يسمح بأمري Node كليهما عبر gateway.nodes.allowCommands: ["googlemeet.chrome", "browser.proxy"].
• BlackHole 2ch audio device not found: ثبّت blackhole-2ch على المضيف الذي يجري فحصه وأعد التشغيل قبل استخدام صوت Chrome المحلي.
• BlackHole 2ch audio device not found on the node: ثبّت blackhole-2ch داخل VM وأعد تشغيل VM.
• يفتح Chrome لكنه لا يستطيع الانضمام: سجّل الدخول إلى ملف تعريف المتصفح داخل VM، أو أبق chrome.guestName مضبوطا لانضمام الضيف. يستخدم انضمام الضيف التلقائي أتمتة متصفح OpenClaw عبر وكيل متصفح Node؛ تأكد من أن إعدادات متصفح Node تشير إلى ملف التعريف الذي تريده، مثل browser.defaultProfile: "user" أو ملف تعريف جلسة موجود مسمى.
• تبويبات Meet مكررة: اترك chrome.reuseExistingTab: true مفعلا. يفعّل OpenClaw تبويبا موجودا لعنوان Meet نفسه قبل فتح تبويب جديد، ويعيد إنشاء الاجتماع في المتصفح استخدام تبويب https://meet.google.com/new قيد التقدم أو تبويب مطالبة حساب Google قبل فتح تبويب آخر.
• لا يوجد صوت: في Meet، وجّه الميكروفون/مكبر الصوت عبر مسار جهاز الصوت الافتراضي الذي يستخدمه OpenClaw؛ استخدم أجهزة افتراضية منفصلة أو توجيها بأسلوب Loopback للحصول على صوت مزدوج نظيف.

​

ملاحظات التثبيت

• sox: أداة صوت من سطر الأوامر. يستخدم Plugin أوامر جهاز CoreAudio صريحة لجسر صوت PCM16 الافتراضي بتردد 24 كيلوهرتز.
• blackhole-2ch: برنامج تشغيل صوت افتراضي لنظام macOS. ينشئ جهاز الصوت BlackHole 2ch الذي يمكن لـ Chrome/Meet التوجيه عبره.

​

وسائل النقل

​

Chrome

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

​

Twilio

{
  plugins: {
    allow: ["google-meet", "voice-call", "google"],
    entries: {
      "google-meet": {
        enabled: true,
        config: {
          defaultTransport: "chrome-node",
          // or set "twilio" if Twilio should be the default
        },
      },
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio",
          inboundPolicy: "allowlist",
          realtime: {
            enabled: true,
            provider: "google",
            instructions: "Join this Google Meet as an OpenClaw agent. Be brief.",
            toolPolicy: "safe-read-only",
            providers: {
              google: {
                silenceDurationMs: 500,
                startSensitivity: "high",
              },
            },
          },
        },
      },
      google: {
        enabled: true,
      },
    },
  },
}

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

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

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

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

​

OAuth والفحص التمهيدي

​

إنشاء بيانات اعتماد Google

1. أنشئ مشروع Google Cloud أو اختر واحدا.
2. فعّل Google Meet REST API لذلك المشروع.
3. هيئ شاشة موافقة OAuth.
   • Internal هو الأبسط لمؤسسة Google Workspace.
   • External يعمل للإعدادات الشخصية/الاختبارية؛ أثناء وجود التطبيق في Testing، أضف كل حساب Google سيخوّل التطبيق كمستخدم اختبار.
4. أضف النطاقات التي يطلبها OpenClaw:
   • 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
5. أنشئ معرف عميل OAuth.
   • نوع التطبيق: Web application.
   • URI إعادة التوجيه المعتمد:
     http://localhost:8085/oauth2callback
     
6. انسخ معرف العميل وسر العميل.

​

إصدار رمز التحديث

openclaw googlemeet auth login --json

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

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

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

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

​

التحقق من OAuth باستخدام الطبيب

openclaw googlemeet doctor --oauth --json

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

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

• 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-hij

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

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

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

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

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

openclaw googlemeet artifacts --conference-record conferenceRecords/abc123 \
  --format markdown --output meet-artifacts.md
openclaw googlemeet attendance --conference-record conferenceRecords/abc123 \
  --format markdown --output meet-attendance.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

{
  "action": "export",
  "conferenceRecord": "conferenceRecords/abc123",
  "includeDocumentBodies": true,
  "outputDir": "meet-export",
  "zip": true
}

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

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

• يفعل OPENCLAW_LIVE_TEST=1 الاختبارات الحية المحمية.
• يشير OPENCLAW_GOOGLE_MEET_LIVE_MEETING إلى عنوان URL لاجتماع Meet محتفظ به، أو رمز، أو spaces/{id}.
• يوفر OPENCLAW_GOOGLE_MEET_CLIENT_ID أو GOOGLE_MEET_CLIENT_ID معرف عميل OAuth.
• يوفر OPENCLAW_GOOGLE_MEET_REFRESH_TOKEN أو GOOGLE_MEET_REFRESH_TOKEN رمز التحديث.
• اختياري: يستخدم OPENCLAW_GOOGLE_MEET_CLIENT_SECRET و OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN و OPENCLAW_GOOGLE_MEET_ACCESS_TOKEN_EXPIRES_AT أسماء الرجوع نفسها بدون بادئة OPENCLAW_.

openclaw googlemeet create

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

{
  "source": "browser",
  "error": "google-login-required: Sign in to Google in the OpenClaw browser profile, then retry meeting creation.",
  "manualActionRequired": true,
  "manualActionReason": "google-login-required",
  "manualActionMessage": "Sign in to Google in the OpenClaw browser profile, then retry meeting creation.",
  "browser": {
    "nodeId": "ba0f4e4bc...",
    "targetId": "tab-1",
    "browserUrl": "https://accounts.google.com/signin",
    "browserTitle": "Sign in - Google Accounts"
  }
}

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

​

التكوين

brew install blackhole-2ch sox
export OPENAI_API_KEY=sk-...
# or
export GEMINI_API_KEY=...

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

• defaultTransport: "chrome"
• defaultMode: "agent" (يُقبل "realtime" فقط كاسم بديل قديم للتوافق مع "agent"؛ ينبغي لاستدعاءات الأدوات الجديدة أن تستخدم "agent")
• chromeNode.node: معرّف/اسم/IP اختياري للعقدة لـ chrome-node
• chrome.audioBackend: "blackhole-2ch"
• chrome.guestName: "OpenClaw Agent": الاسم المستخدم على شاشة ضيف Meet عند عدم تسجيل الدخول
• chrome.autoJoin: true: محاولة بأفضل جهد لملء اسم الضيف والنقر على Join Now عبر أتمتة متصفح OpenClaw على chrome-node
• chrome.reuseExistingTab: true: تنشيط تبويب Meet موجود بدلًا من فتح نسخ مكررة
• chrome.waitForInCallMs: 20000: انتظار تبويب Meet حتى يبلّغ أنه داخل المكالمة قبل تشغيل مقدمة الرد الصوتي
• chrome.audioFormat: "pcm16-24khz": تنسيق صوت زوج الأوامر. استخدم "g711-ulaw-8khz" فقط لأزواج الأوامر القديمة/المخصصة التي لا تزال تصدر صوتًا هاتفيًا.
• chrome.audioBufferBytes: 4096: مخزن معالجة SoX المؤقت لأوامر صوت زوج أوامر Chrome المولدة. هذا نصف المخزن الافتراضي في SoX والبالغ 8192 بايت، ما يقلل زمن انتقال الأنبوب الافتراضي مع ترك مساحة لرفعه على المضيفات المشغولة. تُثبت القيم الأدنى من حد SoX الأدنى إلى 17 بايت.
• chrome.audioInputCommand: أمر SoX يقرأ من CoreAudio BlackHole 2ch ويكتب الصوت بتنسيق chrome.audioFormat
• chrome.audioOutputCommand: أمر SoX يقرأ الصوت بتنسيق chrome.audioFormat ويكتب إلى CoreAudio BlackHole 2ch
• chrome.bargeInInputCommand: أمر ميكروفون محلي اختياري يكتب PCM أحادي القناة little-endian موقّعًا 16-بت لاكتشاف مقاطعة الإنسان أثناء تشغيل صوت المساعد. ينطبق هذا حاليًا على جسر زوج أوامر chrome المستضاف على Gateway.
• chrome.bargeInRmsThreshold: 650: مستوى RMS الذي يُعد مقاطعة بشرية على chrome.bargeInInputCommand
• chrome.bargeInPeakThreshold: 2500: مستوى الذروة الذي يُعد مقاطعة بشرية على chrome.bargeInInputCommand
• chrome.bargeInCooldownMs: 900: الحد الأدنى للتأخير بين عمليات مسح المقاطعة البشرية المتكررة
• mode: "agent": وضع الرد الصوتي الافتراضي. يُنسخ كلام المشاركين بواسطة موفر النسخ الفوري المهيأ، ويُرسل إلى وكيل OpenClaw المهيأ في جلسة وكيل فرعي لكل اجتماع، ثم يُنطق عبر وقت تشغيل OpenClaw TTS العادي.
• mode: "bidi": وضع رجوع احتياطي لنموذج فوري ثنائي الاتجاه مباشر. يجيب موفر الصوت الفوري على كلام المشاركين مباشرة وقد يستدعي openclaw_agent_consult للحصول على إجابات أعمق/مدعومة بالأدوات.
• mode: "transcribe": وضع مراقبة فقط من دون جسر الرد الصوتي.
• realtime.provider: "openai": رجوع احتياطي للتوافق يُستخدم عندما لا تكون حقول الموفر محددة النطاق أدناه مضبوطة.
• realtime.transcriptionProvider: "openai": معرّف الموفر الذي يستخدمه وضع agent للنسخ الفوري.
• realtime.voiceProvider: معرّف الموفر الذي يستخدمه وضع bidi للصوت الفوري المباشر. عيّن هذا إلى "google" لاستخدام Gemini Live مع إبقاء نسخ وضع الوكيل على OpenAI.
• realtime.toolPolicy: "safe-read-only"
• realtime.instructions: ردود منطوقة موجزة، مع openclaw_agent_consult للإجابات الأعمق
• realtime.introMessage: فحص جاهزية منطوق قصير عند اتصال الجسر الفوري؛ عيّنه إلى "" للانضمام بصمت
• realtime.agentId: معرّف وكيل OpenClaw اختياري لـ openclaw_agent_consult؛ الافتراضي هو main

{
  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-2.5-flash-native-audio-preview-12-2025",
    agentId: "jay",
    toolPolicy: "owner",
    introMessage: "Say exactly: I'm here.",
    providers: {
      google: {
        voice: "Kore",
      },
    },
  },
}

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

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

​

الأداة

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

• inCall: يبدو أن Chrome داخل مكالمة Meet
• micMuted: حالة ميكروفون Meet بأفضل جهد
• manualActionRequired / manualActionReason / manualActionMessage: يحتاج ملف تعريف المتصفح إلى تسجيل دخول يدوي، أو قبول مضيف Meet، أو أذونات، أو إصلاح تحكم المتصفح قبل أن يعمل الكلام
• speechReady / speechBlockedReason / speechBlockedMessage: ما إذا كان الكلام المدار عبر Chrome مسموحًا الآن. تعني speechReady: false أن OpenClaw لم يرسل عبارة المقدمة/الاختبار إلى جسر الصوت.
• providerConnected / realtimeReady: حالة جسر الصوت الفوري
• lastInputAt / lastOutputAt: آخر صوت شوهد من الجسر أو أُرسل إليه
• audioOutputRouted / audioOutputDeviceLabel: ما إذا كان إخراج وسائط تبويب Meet قد وُجّه بنشاط إلى جهاز BlackHole الذي يستخدمه الجسر
• lastSuppressedInputAt / suppressedInputBytes: إدخال local loopback تم تجاهله أثناء نشاط تشغيل المساعد

{
  "action": "speak",
  "sessionId": "meet_...",
  "message": "Say exactly: I'm here and listening."
}

​

أوضاع agent و bidi

• safe-read-only: إظهار أداة الاستشارة وحصر الوكيل العادي في read وweb_search وweb_fetch وx_search وmemory_search و memory_get.
• owner: إظهار أداة الاستشارة والسماح للوكيل العادي باستخدام سياسة أدوات الوكيل العادية.
• none: عدم إظهار أداة الاستشارة لنموذج الصوت الفوري.

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

• googlemeet setup كلها خضراء.
• يتضمن googlemeet setup الفحص chrome-node-connected عندما يكون Chrome-node هو النقل الافتراضي أو تكون عقدة مثبتة.
• يعرض nodes status أن العقدة المحددة متصلة.
• تعلن العقدة المحددة عن كل من googlemeet.chrome وbrowser.proxy.
• تنضم علامة تبويب Meet إلى المكالمة، ويُرجع test-speech حالة سلامة Chrome مع inCall: true.

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

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

• يتضمن googlemeet setup فحوصات خضراء لـ twilio-voice-call-plugin و twilio-voice-call-credentials وtwilio-voice-call-webhook.
• يكون voicecall متاحًا في CLI بعد إعادة تحميل Gateway.
• تحتوي الجلسة المُرجعة على transport: "twilio" وtwilio.voiceCallId.
• يعرض openclaw logs --follow تقديم DTMF TwiML قبل TwiML الفوري، ثم جسرًا فوريًا مع التحية الأولية في قائمة الانتظار.
• يؤدي googlemeet leave <sessionId> إلى إنهاء المكالمة الصوتية المفوضة.

​

استكشاف الأخطاء وإصلاحها

​

لا يستطيع الوكيل رؤية أداة Google Meet

openclaw plugins list | grep google-meet
openclaw googlemeet setup

​

لا توجد عقدة متصلة قادرة على Google Meet

openclaw plugins enable 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

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

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

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

openclaw googlemeet setup
openclaw nodes status --connected

​

يفتح المتصفح لكن الوكيل لا يستطيع الانضمام

• سجّل الدخول إلى ملف Chrome الشخصي.
• اقبل الضيف من حساب مضيف Meet.
• امنح أذونات ميكروفون/كاميرا Chrome عند ظهور مطالبة الأذونات الأصلية في Chrome.
• أغلق مربع حوار أذونات Meet العالق أو أصلحه.

​

فشل إنشاء الاجتماع

• لإنشاء API: أن oauth.clientId وoauth.refreshToken مكوّنان، أو أن متغيرات البيئة المطابقة OPENCLAW_GOOGLE_MEET_* موجودة.
• لإنشاء API: أن رمز التحديث قد أُصدر بعد إضافة دعم الإنشاء. قد تفتقد الرموز الأقدم نطاق meetings.space.created؛ أعد تشغيل openclaw googlemeet auth login --json وحدّث إعداد Plugin.
• لاحتياطي المتصفح: أن defaultTransport: "chrome-node" وchromeNode.node يشيران إلى عقدة متصلة تحتوي على browser.proxy وgooglemeet.chrome.
• لاحتياطي المتصفح: أن ملف OpenClaw الشخصي في Chrome على تلك العقدة مسجل دخوله إلى Google ويمكنه فتح https://meet.google.com/new.
• لاحتياطي المتصفح: تعيد المحاولات استخدام علامة تبويب موجودة لـ https://meet.google.com/new أو مطالبة حساب Google قبل فتح علامة تبويب جديدة. إذا انتهت مهلة وكيل، فأعد محاولة استدعاء الأداة بدلًا من فتح علامة تبويب Meet أخرى يدويًا.
• لاحتياطي المتصفح: إذا أعادت الأداة manualActionRequired: true، فاستخدم browser.nodeId وbrowser.targetId وbrowserUrl وmanualActionMessage المُرجعة لتوجيه المشغّل. لا تعِد المحاولة في حلقة حتى يكتمل ذلك الإجراء.
• لاحتياطي المتصفح: إذا عرض Meet “Do you want people to hear you in the meeting?”، فاترك علامة التبويب مفتوحة. ينبغي أن ينقر OpenClaw على Use microphone أو، للاحتياطي الخاص بالإنشاء فقط، على Continue without microphone عبر أتمتة المتصفح وأن يواصل انتظار عنوان URL المولّد لـ Meet. إذا لم يستطع ذلك، فينبغي أن يذكر الخطأ meet-audio-choice-required لا google-login-required.

​

ينضم الوكيل لكنه لا يتحدث

openclaw googlemeet setup
openclaw googlemeet doctor

• توفر مفتاح مزود فوري على مضيف Gateway، مثل OPENAI_API_KEY أو GEMINI_API_KEY.
• ظهور BlackHole 2ch على مضيف Chrome.
• وجود sox على مضيف Chrome.
• توجيه ميكروفون Meet ومكبّر الصوت عبر مسار الصوت الافتراضي الذي يستخدمه OpenClaw. ينبغي أن يعرض doctor القيمة meet output routed: yes لانضمامات Chrome المحلية الفورية.

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

​

فشل فحوصات إعداد Twilio

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

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

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

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

openclaw voicecall smoke --to "+15555550123"

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

​

تبدأ مكالمة Twilio لكنها لا تدخل الاجتماع أبدًا

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

• شغّل openclaw googlemeet doctor <session-id> لتأكيد معرّف مكالمة Twilio المفوّضة، وما إذا كان DTMF قد وُضع في قائمة الانتظار، وما إذا كانت التحية التمهيدية قد طُلبت.
• شغّل openclaw voicecall status --call-id <id> وتأكد من أن المكالمة ما زالت نشطة.
• شغّل openclaw voicecall tail وتحقق من وصول Webhooks الخاصة بـ 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.
• زد voiceCall.dtmfDelayMs عن القيمة الافتراضية البالغة 12 ثانية إذا كان Meet يجيب ببطء أو كان نص المكالمة ما يزال يعرض المطالبة بإدخال رقم PIN بعد إرسال DTMF قبل الاتصال.
• إذا انضم المشارك لكنك لا تسمع التحية، فتحقق من openclaw logs --follow بحثًا عن طلب voicecall.speak بعد DTMF وعن تشغيل TTS عبر دفق الوسائط أو احتياطي Twilio <Say>. إذا كان نص المكالمة ما يزال يحتوي على “enter the meeting PIN”، فهذا يعني أن طرف الهاتف لم ينضم بعد إلى غرفة Meet، ولذلك لن يسمع المشاركون في الاجتماع الكلام.

​

ملاحظات

• chrome.audioInputCommand مع chrome.audioOutputCommand: يمتلك OpenClaw الجسر ويمرر الصوت بتنسيق chrome.audioFormat بين تلك الأوامر والمزوّد المحدد. يستخدم وضع الوكيل النسخ في الوقت الحقيقي مع TTS عادي؛ ويستخدم وضع bidi مزوّد الصوت في الوقت الحقيقي. مسار Chrome الافتراضي هو PCM16 بتردد 24 كيلوهرتز مع chrome.audioBufferBytes: 4096؛ ويظل G.711 mu-law بتردد 8 كيلوهرتز متاحًا لأزواج الأوامر القديمة.
• chrome.audioBridgeCommand: يمتلك أمر جسر خارجي مسار الصوت المحلي بالكامل ويجب أن يخرج بعد بدء تشغيل العفريت الخاص به أو التحقق منه. هذا صالح فقط لـ bidi لأن وضع agent يحتاج إلى وصول مباشر لزوج الأوامر من أجل TTS.

​

ذات صلة

• Plugin المكالمات الصوتية
• وضع التحدث
• بناء Plugins