Plugin Google Meet

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

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

​

Gateway محلي + Chrome في Parallels

• مضيف Gateway: OpenClaw Gateway، ومساحة عمل الوكيل، ومفاتيح model/API، ومزود الوقت الفوري، وضبط Plugin Google Meet.
• جهاز Parallels macOS الافتراضي: OpenClaw CLI/مضيف Node، وGoogle Chrome، وSoX، وBlackHole 2ch، وملف Chrome شخصي مسجّل الدخول إلى Google.
• غير مطلوب في الجهاز الافتراضي: خدمة 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: العقدة المثبتة معروفة لدى Gateway لكنها غير متاحة. يجب على الوكلاء التعامل مع تلك العقدة باعتبارها حالة تشخيصية، لا مضيف Chrome قابلًا للاستخدام، والإبلاغ عن عائق الإعداد بدلًا من الرجوع إلى نقل آخر ما لم يطلب المستخدم ذلك.
• No connected Google Meet-capable node: شغّل openclaw node run في VM، وافق على الاقتران، وتأكد من تشغيل openclaw plugins enable google-meet و openclaw plugins enable browser في VM. تأكد أيضًا من أن مضيف Gateway يسمح بأمري العقدة معًا عبر 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 عبر وكيل متصفح العقدة؛ تأكد من أن إعداد متصفح العقدة يشير إلى ملف التعريف الذي تريده، مثل browser.defaultProfile: "user" أو ملف تعريف جلسة قائمة مسمى.
• تبويبات Meet مكررة: اترك chrome.reuseExistingTab: true مفعّلًا. يفعّل OpenClaw تبويبًا قائمًا لعنوان Meet URL نفسه قبل فتح تبويب جديد، كما أن إنشاء الاجتماع عبر المتصفح يعيد استخدام تبويب 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 باستخدام doctor

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 أحادي القناة signed 16-bit little-endian لاكتشاف مقاطعة الإنسان أثناء تشغيل صوت المساعد. ينطبق هذا حاليا على جسر زوج أوامر chrome المستضاف على Gateway.
• chrome.bargeInRmsThreshold: 650: مستوى RMS الذي يُحتسب كمقاطعة بشرية على chrome.bargeInInputCommand
• chrome.bargeInPeakThreshold: 2500: مستوى الذروة الذي يُحتسب كمقاطعة بشرية على chrome.bargeInInputCommand
• chrome.bargeInCooldownMs: 900: أقل تأخير بين عمليات مسح المقاطعة البشرية المتكررة
• mode: "agent": وضع الرد الصوتي الافتراضي. يتم نسخ كلام المشاركين بواسطة مزود النسخ الفوري المهيأ، وإرساله إلى وكيل OpenClaw المهيأ في جلسة وكيل فرعي لكل اجتماع، ثم نطقه مرة أخرى عبر وقت تشغيل TTS العادي في OpenClaw.
• 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: {
        speakerVoice: "Kore",
      },
    },
  },
}

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

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

​

أوضاع الوكيل و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.
• لاحتياطي المتصفح: يكون ملف تعريف Chrome الخاص بـ OpenClaw على تلك العقدة مسجل الدخول إلى 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 وتحقق من وصول Twilio webhooks إلى 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