الدرس 21 — دليل OpenClaw مهارة Notion: إنشاء صفحات والاستعلام عن قواعد البيانات وكتابة التقارير الأسبوعية تلقائياً (2026)
الهدف: تثبيت مهارة Notion، واستخدام Notion API لجعل OpenClaw يتحكم في Notion بلغة طبيعية: إنشاء الصفحات، استعلام قواعد البيانات، تحديث حالة المهام.
ما هي مهارة Notion؟
مهارة Notion مهارة إنتاجية عالية الاستخدام على ClawHub (68 ألف تنزيل)، تتيح عبر Notion API الرسمي التحكم الكامل في مساحة عمل Notion. إنشاء صفحات، استعلام قواعد بيانات، تحديث حالة المهام، توليد التقارير الأسبوعية — كل هذه العمليات التي كانت تتطلب تعاملاً يدوياً في واجهة Notion أصبحت تتم بجملة واحدة.
الخطوة الأولى: إنشاء Notion Integration والحصول على مفتاح API
قبل تثبيت المهارة، تحتاج لإنشاء Integration في Notion:
الخطوة 1: زر https://www.notion.so/my-integrations، وانقر "+ New integration" في الزاوية العلوية اليمنى.
الخطوة 2: أدخل اسم Integration (مثل "OpenClaw")، اختر مساحة العمل المرتبطة، وانقر "Submit".
الخطوة 3: بعد إنشاء Integration بنجاح، انسخ "Internal Integration Token"، صيغته secret_xxxxxxxxx — هذا هو مفتاح API الخاص بك.
الخطوة 4: امنح Integration صلاحية الوصول للصفحات أو قواعد البيانات المحددة. في Notion افتح الصفحة المستهدفة، انقر "..." في الزاوية العلوية اليمنى → "Add connections" → اختر Integration الذي أنشأته للتو.
ملاحظة: Notion Integration لا يمتلك أي صلاحيات بشكل افتراضي، يجب ربطه يدوياً بالصفحات التي تريد تشغيلها، وإلا لن يتمكن الذكاء الاصطناعي من الوصول إليها.
الخطوة الثانية: تثبيت المهارة وإعداد مفتاح API
في WebChat أو Telegram أرسل:
/install @steipete/notion
إعداد مفتاح API:
/config notion api_key secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
أو عبر سطر الأوامر:
pnpm openclaw config set notion.api_key "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"للتحقق من الإعداد:
pnpm openclaw run "أدرج جميع قواعد البيانات في مساحة عمل Notion"إذا أعادت قائمة بقواعد البيانات، يعني أن الإعداد تم بنجاح.
الخطوة الثالثة: إنشاء الصفحات والصفحات الفرعية
إنشاء صفحة مستقلة:
أنشئ صفحة فرعية جديدة تحت صفحة "مستندات المشاريع" بعنوان "خطة تكامل OpenClaw"،
اكتب مقدمة خلفية مشروع موجزة، حوالي 200 كلمة
إنشاء صفحة بهيكل محدد:
أنشئ تحت صفحة "محاضر الاجتماعات" محضراً لاجتماع اليوم (2026-03-30)،
يتضمن الأقسام التالية: الحضور، جدول الأعمال، القرارات، قائمة المهام
إنشاء عبر API (مناسب للسكريبتات التلقائية):
pnpm openclaw run "استخدم Notion API لإنشاء صفحة فرعية تحت page_id=xxx، العنوان: تخطيط OKR Q2، المحتوى: [محتواك]"الخطوة الرابعة: الاستعلام عن قواعد البيانات (تصفية + ترتيب)
استعلام بشروط تصفية:
استعلم عن جميع المهام ذات الحالة "قيد التنفيذ" في قاعدة بيانات "إدارة المهام"، مرتبةً تصاعدياً حسب تاريخ الاستحقاق
تصفية متعددة الشروط:
ابحث في قاعدة بيانات "تتبع المشاريع" عن: المسؤول "محمد"، الأولوية "عالية"، المستحقة هذا الأسبوع
بحث بنص:
ابحث في Notion عن جميع الصفحات التي تحتوي كلمة "بروتوكول MCP"
تدعم جميع أنواع تصفية Notion: تطابق نص، نطاق أرقام، فترة زمنية، وسوم متعددة، حقول علاقة وغيرها.
الخطوة الخامسة: تحديث بنود قاعدة البيانات
تحديث حالة مهام دفعي:
في قاعدة بيانات "إدارة المهام" غيّر حالة جميع المهام التي تجاوز تاريخ استحقاقها اليوم وحالتها ليست "مكتملة" إلى "متأخرة"
إضافة وسوم:
أضف وسم "ذكاء اصطناعي" لجميع صفحات قاعدة بيانات "المعرفة" التي تتناول "الذكاء الاصطناعي"
تحديث بند واحد:
غيّر حالة مهمة "إتمام وثيقة API" إلى "مكتملة"، واضبط تاريخ الإنجاز على اليوم
الخطوة السادسة: سير عمل فعلي — توليد التقرير الأسبوعي تلقائياً
هذا أكثر سيناريوهات توليد التقارير الأسبوعية تطبيقاً. قبل نهاية كل أسبوع أرسل:
من قاعدة بيانات "إدارة المهام" لخّص المهام المُنجزة هذا الأسبوع (2026-03-24 إلى 2026-03-28)،
أنشئ تقريراً أسبوعياً منظماً في صفحة "أرشيف التقارير"، العنوان: 2026-W13 التقرير الأسبوعي
مثال على هيكل التقرير المولّد:
# 2026-W13 التقرير الأسبوعي
## المُنجز هذا الأسبوع
- [x] إتمام وثيقة Notion Skill (الدرس 21)
- [x] إصلاح مشكلة انتهاء مهلة اتصال MCP
- [x] إطلاق ميزة جمع ملاحظات المستخدمين
## بيانات الأسبوع
- المهام المُنجزة: 8
- المهام المضافة: 3
- المهام المتأخرة: 1
## خطط الأسبوع القادم
- [ ] إتمام وثيقة الدرس 22 Auto-Updaterتشغيل تلقائي مع cron (راجع الدرس 06):
# كل جمعة الساعة 17:30 توليد وإنشاء التقرير الأسبوعي تلقائياً
30 17 * * 5 pnpm openclaw run "أنشئ التقرير الأسبوعي في Notion واحفظه"الخطوة السابعة: الدمج مع مهارة GitHub
اربط مهارة GitHub من الدرس 14 مع مهارة Notion لمزامنة سجلات التطوير تلقائياً:
استعلم عن جميع PR التي دُمجت في الفرع الرئيسي خلال 7 أيام الماضية،
صنّفها حسب وحدة الوظيفة، وزامنها مع قاعدة بيانات "سجل التطوير" في Notion،
كل بند يتضمن: عنوان PR، وقت الدمج، المؤلف، Issue المرتبط
هذا سير العمل يُحقق القيمة الجوهرية: لا تحتاج اشتراك Zapier، بل استخدم OpenClaw مباشرةً لربط GitHub وNotion.
الأسئلة الشائعة
هل تحتاج مهارة OpenClaw Notion حساباً مدفوعاً؟
لا تحتاج حساباً مدفوعاً. Notion API متاح بالكامل للحسابات المجانية، يمكنك إنشاء Integration واستخدام جميع وظائف API بما فيها إنشاء الصفحات واستعلام قواعد البيانات وتحديث البنود. القيود في الحسابات المجانية تتعلق أساساً بعدد الأعضاء المتعاونين (10 كحد أقصى) وحجم رفع الملفات (5 ميغابايت)، وهذه القيود لا تؤثر على عمليات الأتمتة بالذكاء الاصطناعي. لاحظ أن Notion API لها حد معدل الطلبات (3 طلبات في الثانية)، وستتحكم المهارة تلقائياً في معدل الطلبات عند العمليات الدفعية.
كيف أجعل الذكاء الاصطناعي يُحدّث حالة مهام Notion تلقائياً كل يوم؟
مع وظيفة المهام المجدولة من الدرس 06، أضف مهمة يومية في crontab: 0 9 * * * pnpm openclaw run "حدّث حالة مهام Notion اليوم"، ثم صف في الـ prompt قاعدة التحديث الخاصة بك. يمكنك أيضاً إعداد تحديثات مشروطة في Hooks الخاصة بـ OpenClaw، مثل تحديث حالة المهمة المقابلة في Notion تلقائياً عند دمج PR على GitHub.
هل قد يتسرّب مفتاح Notion API؟
يُخزَّن مفتاح API في ملف الإعداد المحلي لـ OpenClaw (~/.openclaw/config.json)، ولا يُرفع لأي سحابة. يُنصح بضبط صلاحيات الملف على 600 (chmod 600 ~/.openclaw/config.json) لمنع المستخدمين الآخرين على نفس الجهاز من قراءته. في حالة الاشتباه بتسريب المفتاح، اذهب فوراً لصفحة إعدادات Notion Integration وأنشئ Token جديداً، وسيُبطَل القديم فوراً. يُنصح أيضاً بإنشاء Integration بصلاحيات مُقيَّدة قدر الإمكان، بربطه فقط بالصفحات التي يحتاج فعلاً للتعامل معها.
هل تدعم جميع أنواع خصائص قاعدة بيانات Notion؟
تدعم جميع أنواع الخصائص التي تُعرّضها Notion API العامة، بما فيها: النص، الرقم، الاختيار (مفرد/متعدد)، التاريخ، الأشخاص، الملفات، مربع الاختيار، URL، البريد الإلكتروني، الهاتف، الصيغة، العلاقة، التجميع (Rollup). القيد الوحيد هو أن حقول الصيغة قابلة للقراءة فقط دون تعديل الصيغة نفسها. يقرأ الذكاء الاصطناعي Schema قاعدة البيانات أولاً ثم يُحدد نوع كل حقل تلقائياً، وعندما تقول "غيّر الحالة إلى مكتملة" سيُطابق ذلك مع نوع الخاصية الصحيح.