ربط خدمات Google بأوبن كلاو: Gmail والتقويم وDrive للمبتدئين

Aفريق ArabClaw7 دقيقة قراءة

ما ستتعلمه: كيفية ربط حسابات Google الخاصة بك (البريد والتقويم والملفات) بأوبن كلاو دون كتابة أكواد معقدة. ستتمكن من أتمتة إرسال الرسائل والتحقق من المواعيد وتنظيم الملفات تلقائياً.

المقدمة

معظم الناس يقضون ساعات أسبوعياً في مهام روتينية: فرز الرسائل، البحث عن موعد في التقويم، تحميل ملفات إلى Drive. هذا الوقت مهدر. إذا كنت تستخدم أوبن كلاو (OpenClaw)، فلديك أداة قوية لتحويل هذه المهام الممله إلى عمليات مؤتمتة تعمل وحدها.

الخبر الجيد: ربط Google بأوبن كلاو ليس معقداً كما يبدو. لا تحتاج إلى أن تكون مطوراً لتفعل هذا. في هذا المقال، سنأخذك خطوة بخطوة عبر العملية بأكملها، من إعداد اعتمادات Google إلى بناء أتمتة تعمل فعلاً.

إعداد مشروع Google Cloud وتفعيل الواجهات البرمجية

قبل أن تربط أي شيء، تحتاج إلى إنشاء مشروع على Google Cloud Platform وتفعيل الواجهات البرمجية الصحيحة. هذه الخطوة الأساسية غالباً ما تربك المبتدئين، لكنها سهلة جداً إذا اتبعت التعليمات بدقة.

توجه إلى console.cloud.google.com وسجل الدخول بحسابك. انقر على "إنشاء مشروع" وأعطه اسماً واضحاً مثل "أوبن كلاو أتمتة". بعد إنشاء المشروع، ستظهر لك لوحة التحكم الرئيسية.

الآن تحتاج إلى تفعيل ثلاث واجهات برمجية:

  1. Gmail API — للتحكم برسائلك البريدية
  2. Google Calendar API — للوصول إلى مواعيدك
  3. Google Drive API — لإدارة ملفاتك

في شريط البحث العلوي، اكتب "Gmail API" واضغط Enter. اضغط "تفعيل" (Enable). كرر نفس العملية مع "Google Calendar API" و "Google Drive API". لا تتجاوز هذه الخطوة — الواجهات البرمجية يجب أن تكون مفعلة قبل محاولة الاتصال.

الواجهة البرمجيةالوظيفةالصلاحيات الأساسية
Gmail APIقراءة وإرسال الرسائلread, send, labels
Google Calendar APIالوصول للمواعيد والأحداثread, write, delete
Google Drive APIتحميل وتحميل الملفاتfiles.create, files.get

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

بعد تفعيل الواجهات البرمجية، تحتاج إلى إنشاء "مفاتيح" تسمح لأوبن كلاو بالوصول إلى حسابك. في Google Cloud Console، انقر على "Credentials" من القائمة اليسرى، ثم اضغط على "Create Credentials" واختر "OAuth 2.0 Client ID".

ستطلب منك Google اختيار نوع التطبيق. اختر "Desktop application" إذا كنت تختبر محلياً على جهازك، أو "Web application" إذا كنت تخطط لتشغيل الأتمتة على خادم بعيد.

بعد إنشاء بيانات الاعتماد، ستحصل على ملف JSON يحتوي على:

  • Client ID
  • Client Secret
  • Authorization URIs

احفظ هذا الملف في مكان آمن. لا تشاركه مع أحد — هذا مفتاح وصول حسابك.

إذا كنت تعمل مع أوبن كلاو على OpenClaw.ai، فستحتاج إلى نسخ هذه البيانات إلى إعدادات التطبيق.

ربط البريد الإلكتروني (Gmail)

ربط Gmail هو الاستخدام الأكثر شيوعاً. تخيل أنك تريد تصنيف الرسائل تلقائياً أو حفظ المرفقات أو إرسال ردود متكررة. كل هذا ممكن.

في أوبن كلاو، ستستخدم وظائف (functions) مدمجة للتفاعل مع Gmail. إليك مثال على اتصال بسيط:

openclaw-auth google-oauth \
  --credentials /path/to/credentials.json \
  --scope "https://www.googleapis.com/auth/gmail.modify"

هذا الأمر يفتح متصفح يطلب منك تسجيل الدخول إلى Google والموافقة على أن يصل أوبن كلاو إلى بريدك. بعد الموافقة، يتم حفظ token الوصول محلياً.

بعد الموافقة، يمكنك استخدام وظائف Gmail مباشرة:

openclaw list-emails \
  --from sender@example.com \
  --limit 10 \
  --format json

هذا يسترجع آخر 10 رسائل من مرسل معين بصيغة JSON يمكنك معالجتها.

ربط التقويس والمواعيد (Google Calendar)

التقويس هو عصب الإنتاجية. ربط Google Calendar بأوبن كلاو يعني أنك تستطيع قراءة المواعيد القادمة والتحقق من التضارب وحتى إنشاء أحداث جديدة تلقائياً.

بعد تفعيل الواجهة البرمجية وإنشاء بيانات الاعتماد (نفس الخطوات السابقة)، استخدم هذا الأمر:

openclaw list-calendar-events \
  --calendar-id primary \
  --start-time "2025-03-01T00:00:00Z" \
  --end-time "2025-03-31T23:59:59Z"

هذا يسترجع جميع الأحداث في شهر مارس. إذا أردت إضافة موعد جديد:

openclaw create-calendar-event \
  --calendar-id primary \
  --title "اجتماع مع الفريق" \
  --start-time "2025-03-15T10:00:00Z" \
  --duration-minutes 60 \
  --description "نقاش حول المشروع الجديد"

الفائدة الحقيقية تأتي عندما تدمج هذا مع نظام الذاكرة في أوبن كلاو. يمكنك حفظ المواعيد المهمة وسياقها، والعودة إليها لاحقاً.

ربط التخزين السحابي (Google Drive)

Google Drive هو المخزن الرئيسي للملفات. ربطه بأوبن كلاو يعني أنك تستطيع تنزيل الملفات وتحميلها وتنظيمها تلقائياً.

نفس عملية الموافقة والاعتماد:

openclaw-auth google-oauth \
  --credentials /path/to/credentials.json \
  --scope "https://www.googleapis.com/auth/drive"

بعد الموافقة، جرب أوامر بسيطة:

openclaw list-files \
  --parent-folder-id root \
  --limit 20

هذا يسترجع الملفات والمجلدات الموجودة في الجذر (صفحتك الرئيسية في Drive).

إذا أردت تحميل ملف:

openclaw upload-file \
  --file-path /home/user/documents/report.pdf \
  --parent-folder-id your_folder_id \
  --file-name "تقرير الربع الأول"

أو تحميل ملف من Drive:

openclaw download-file \
  --file-id abc123xyz \
  --output-path /home/user/downloads/

سيناريو تطبيقي عملي: شركة استشارات تأتمت عملياتها

لنفترض أن لديك شركة استشارات صغيرة باسم "الرؤية الاستشارية". تستقبل رسائل من عملاء يطلبون استشارات، وتريد:

  1. حفظ كل رسالة جديدة في مجلد معين في Drive
  2. إضافة موعد متابعة تلقائي في التقويس
  3. إرسال رد آلي يؤكد استقبال الطلب

الخطوة 1: إعداد المشروع

أنشئ مشروع Google Cloud جديد (كما شرحنا أعلاه) وفعّل الثلاث واجهات. احفظ بيانات اعتمادات OAuth2.

الخطوة 2: إنشاء مجلد في Drive

في Google Drive، أنشئ مجلد اسمه "طلبات العملاء". انسخ معرف المجلد (أنت في الرابط).

الخطوة 3: بناء الأتمتة

أنشئ ملف تكوين في أوبن كلاو يفعل التالي:

automation:
  name: "معالجة طلبات الاستشارة"
  trigger: "new_email_from:*@*.com"
  actions:
    - action: "save_attachment_to_drive"
      folder_id: "your_folder_id"
    - action: "create_calendar_event"
      title: "متابعة طلب من {{ email.sender_name }}"
      start_time: "now + 2 days"
      duration: 30
    - action: "send_reply"
      to: "{{ email.sender }}"
      subject: "تم استقبال طلبك"
      body: "شكراً على تواصلك معنا. سيتم مراجعة طلبك والرد عليك خلال يومين."

النتيجة: كل رسالة واردة تُحفظ تلقائياً في Drive، وموعد متابعة يُضاف إلى التقويس، والعميل يتلقى تأكيداً فوراً. لا حاجة لك للقيام بأي شيء يدوي.

إذا أردت أتمتة أكثر تطوراً، يمكنك استخدام فارس، المساعد الذكي العربي على تيليجرام — وهو منتج جاهز مبني على أوبن كلاو لا يتطلب إعدادات معقدة.

الأمان والخصوصية: نقاط مهمة

عندما تمنح أوبن كلاو وصولاً إلى حسابك، أنت تضع ثقة. إليك أفضل الممارسات:

استخدم OAuth2 وليس كلمات المرور: لا تدخل كلمة مرورك مباشرة في أوبن كلاو. استخدم OAuth2 دائماً. هذا يعني أن Google تتحكم بالوصول، وأنت تستطيع سحبه في أي لحظة.

حدّد الصلاحيات بدقة: في Google Cloud Console، لا تفعّل صلاحيات أوسع مما تحتاج. إذا كنت فقط تقرأ الرسائل، لا تعطِ حق الحذف.

احفظ بيانات الاعتماد بأمان: ملف credentials.json يجب أن يُخزّن في مكان آمن (على جهازك المحلي مثلاً) وليس على خادم عام أو في repository عام على GitHub.

راقب النشاط: بين الحين والآخر، تحقق من صفحة Google Account Security وانظر الأجهزة والتطبيقات التي لديها وصول إلى حسابك.

استكشاف الأخطاء الشائعة

عند العمل مع Google والواجهات البرمجية، ستواجه أخطاء معينة بشكل متكرر:

رمز الخطأالسببالحل
401 Unauthorizedالبيانات منتهية الصلاحية أو غير صحيحةأعد الموافقة عبر OAuth2
403 Forbiddenالصلاحيات غير كافيةتحقق من نطاقات OAuth في Google Console
429 Rate Limitطلبت الكثير من العمليات بسرعة كبيرةأضف تأخير بين الطلبات
404 Not Foundالمجلد أو الملف لا يوجدتحقق من معرفات المجلدات والملفات

الأسئلة الشائعة

سؤال 1: هل يمكنني ربط حسابات Google متعددة؟

الجواب: نعم، تماماً. كل حساب يحتاج إلى بيانات اعتماد منفصلة وموافقة OAuth2 خاصة به. في أوبن كلاو، تستطيع حفظ عدة اتصالات والتبديل بينها. إذا كان لديك حساب شخصي وحساب عمل، يمكنك إنشاء أتمتات منفصلة لكل منهما.

سؤال 2: ماذا إذا نسيت كلمة مرور حسابي في منتصف العملية؟

الجواب: الأتمتات التي أنشأتها ستستمر في العمل — لأن أوبن كلاو لا يحفظ كلمة المرور بالأساس، بل يحفظ token OAuth. حتى إذا غيرت كلمة المرور، التطبيق سيعمل بلا مشاكل. لكن إذا سحبت الوصول من Google Account Settings، ستتوقف الأتمتات.

سؤال 3: كم من الرسائل والملفات يمكنني معالجتها بدون دفع؟

الجواب: Google تقدم quota محدود مجاني لكل API. لـ Gmail مثلاً، المتوسط هو آلاف الطلبات يومياً دون تكلفة. لكن إذا كنت تدير عملية ضخمة جداً، قد تحتاج إلى نموذج الدفع. تحقق من Google Cloud Console لترى استخدامك الحالي.

سؤال 4: هل يمكن أتمتة الرسائل المرسلة أيضاً؟

الجواب: نعم، يمكنك مراقبة الرسائل المرسلة والتفاعل معها. مثلاً، تستطيع إضافة وسم تلقائياً على الرسائل التي أرسلتها لعميل معين، أو حفظ نسخة من كل رسالة مهمة في Drive. استخدم صلاحية "gmail.modify" لهذا.

سؤال 5: هل يؤثر استخدام أوبن كلاو على أداء حسابي في Google؟

الجواب: لا تأثير سلبي مباشر. لكن إذا أنشأت أتمتات تحمّل حجماً ضخماً جداً من الملفات أو الرسائل في وقت واحد، قد تبطئ الأداء مؤقتاً. الحل هو نشر العمليات على فترات زمنية (مثلاً بدلاً من معالجة 1000 ملف مرة واحدة، قسّمها على 10 دفعات).

الخلاصة والخطوات التالية

ربط Google بأوبن كلاو ليس مستحيلاً أو معقداً. أنت الآن تملك كل المعلومات التي تحتاجها:

  1. إنشاء مشروع Google Cloud
  2. تفعيل الواجهات البرمجية الثلاث
  3. إنشاء بيانات اعتماد OAuth2
  4. استخدام أوامر أوبن كلاو للتفاعل مع البريد والتقويس والملفات

ابدأ بشيء بسيط — حفظ الرسائل من مرسل معين أو إضافة موعد تلقائي. بعد أن تشعر بالراحة، توسّع الأتمتات. قراءة أتمتة تيليغرام مع أوبن كلاو قد تعطيك أفكاراً لربط قنوات أخرى.

إذا كان الإعداد الذاتي يبدو معقداً، جرّب فارس، المساعد الذكي العربي على تيليجرام — إنه مبني على أوبن كلاو وجاهز للاستخدام الفوري دون إعدادات تقنية.

ماذا بعد؟ جرّب ربط أول خدمة لك اليوم. لا تنتظر. الأتمتة ليست مستقبلاً بعيداً — إنها الآن.

جاهز لتجربة OpenClaw؟

ابدأ الآن مع دليل التثبيت الكامل بالعربية وابنِ أول وكيل ذكاء اصطناعي خاص بك.

دليل التثبيت

مقالات ذات صلة