تكامل 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. قم بتمكين APIs المطلوبة (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
أخطاء المزامنة	تحقق من اتصال الإنترنت وحاول مرة أخرى