تكامل Google Workspace

يشرح هذا الدليل كيفية دمج Google Workspace مع OpenClaw Ultra باستخدام GoG CLI.

الخدمات المدعومة

الخدمة	الإمكانيات
Gmail	قراءة وإرسال والبحث وتنظيم رسائل البريد الإلكتروني
Calendar	الأحداث والجداول والتذكيرات
Drive	إدارة الملفات والمشاركة والبحث
Docs	إنشاء وتحرير وتنسيق المستندات
Sheets	عمليات جداول البيانات واستعلامات البيانات
Slides	إنشاء وتحرير العروض التقديمية
Contacts	إدارة ومزامنة جهات الاتصال
Tasks	إنشاء وتتبع المهام

المتطلبات المسبقة

العنصر	المتطلب
OpenClaw Ultra	مثبت ومُهيأ
حساب Google	حساب Gmail/Workspace نشط

الخطوة 1: تثبيت GoG CLI في OpenClaw Ultra

1. افتح OpenClaw Ultra وابدأ محادثة جديدة
2. اطلب من الوكيل تثبيت GoG CLI:

   تثبيت GoG CLI لنظام Windows

3. سيساعدك الوكيل في التنزيل من الإصدار الرسمي والإضافة إلى PATH النظام
4. تحقق من التثبيت:

   gog --version

الخطوة 2: إنشاء عميل OAuth

1. قم بزيارة Google Cloud Console
2. أنشئ مشروعًا جديدًا
3. قم بتمكين واجهات برمجة التطبيقات المطلوبة (Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks) - حسب الحاجة
4. قم بتكوين شاشة موافقة OAuth لـ "خارجي"
5. أنشئ عميل OAuth لتطبيق سطح المكتب في عملاء OAuth
6. قم بتنزيل ملف JSON واحفظه في مكان آمن

الخطوة 3: المصادقة في OpenClaw Ultra

1. في المحادثة، قدم مسار ملف OAuth JSON وصادق:

   gog auth credentials /path/to/your/client_secret.json
   gog auth add [email protected] --services gmail,calendar,drive,docs,sheets,slides,contacts,tasks

2. ستفتح نافذة متصفح للتفويض
3. امنح الأذونات المطلوبة
4. سيؤكد الوكيل عند اتصال جميع الخدمات

الخطوة 4: البدء في إدارة Google Workspace

يمكنك الآن استخدام اللغة الطبيعية في المحادثة:

Gmail

• التحقق من رسائل البريد الإلكتروني غير المقروءة اليوم
• إرسال بريد إلكتروني إلى [email protected] حول الاجتماع
• البحث عن رسائل البريد الإلكتروني حول تحديثات المشروع

Calendar

• جدولة اجتماع غدًا الساعة 2 ظهرًا
• إظهار تقويمي لهذا الأسبوع
• إنشاء حدث بعنوان مراجعة الفريق

Drive

• تحميل هذا الملف إلى Drive الخاص بي
• العثور على مستندات حول تخطيط الربع الرابع
• مشاركة التقرير مع [email protected]

Docs

• إنشاء مستند جديد بعنوان ملاحظات الاجتماع
• تحرير آخر مستند أنشأته

Sheets

• إظهار البيانات من Sheet1 A1 إلى D20
• إنشاء جدول بيانات لتتبع الميزانية

Slides

• إنشاء عرض تقديمي من هذا markdown
• تحديث شرائح الحالة الأسبوعية

Contacts

• إظهار جهات الاتصال من Acme Corp
• إضافة جهة اتصال جديدة لـ Jane Doe

Tasks

• إنشاء مهمة لمراجعة الاقتراح
• إظهار مهامي لهذا الأسبوع

نصائح الأمان

WARNING

• امنح فقط الأذونات الضرورية
• راجع التطبيقات المتصلة بانتظام في حساب Google
• قم بإلغاء الوصول عندما لا يكون ضروريًا

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

المشكلة	الحل
فشلت المصادقة	أعد المصادقة في المحادثة
الأوامر لا تعمل	تحقق من تثبيت GoG CLI
أخطاء المزامنة	تحقق من اتصال الإنترنت وحاول مرة أخرى