Plugin السجل اليومي

​

قبل البدء

• Node متصل يوفّر screen.snapshot أو logbook.snapshot. يحتاج Node الخاص بتطبيق macOS إلى إذن Screen Recording. ويحصل مضيف Node لنظام macOS دون واجهة رسومية (openclaw node host run) على الأمر logbook.snapshot الذي يوفّره Plugin والمدعوم بأداة النظام screencapture.
• تمكين Plugin ‏Codex المضمّن ومصادقته. يوفّر Codex حاليًا عقد استخراج الصور المنظّم الذي يتطلبه Logbook. سجّل الدخول باستخدام openclaw models auth login --provider openai؛ وراجع بيئة تشغيل Codex للاطلاع على مسارات مصادقة أخرى.
• نموذج وكيل افتراضي يعمل. يستخدمه Logbook لتركيب البطاقات وملاحظات الاجتماع اليومي وأسئلة وأجوبة اليوم بعد مرحلة الرؤية.

​

البدء السريع

openclaw plugins enable codex
openclaw plugins enable logbook

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
      logbook: {
        enabled: true,
        config: {
          visionModel: "codex/gpt-5.6-sol",
        },
      },
    },
  },
}

openclaw gateway restart
openclaw plugins inspect logbook --runtime --json
openclaw nodes status --connected
openclaw nodes describe --node <idOrNameOrIp>
openclaw dashboard

​

آلية العمل

1. الالتقاط: كل captureIntervalSeconds (الافتراضي 30 ثانية)، يستدعي Logbook أمر الالتقاط الخاص بـ Node المحدد ويخزّن إطار JPEG بعد تغيير حجمه. تُعلَّم الإطارات المتطابقة المتتالية على أنها خمول وتُستبعد من التحليل.
2. الملاحظة: بعد انقضاء نافذة تحليل (الافتراضي 15 دقيقة)، يأخذ Plugin عينات تصل إلى 16 إطارًا نشطًا ويرسلها إلى نموذج الرؤية، الذي يعيد ملاحظات نشاط ذات طوابع زمنية (“VS Code: تعديل store.ts وإصلاح خطأ في النوع”). كما تؤدي فجوة التقاط أطول من دقيقتين أو حلول منتصف الليل المحلي إلى إغلاق النافذة الحالية.
3. التركيب: تُراجع الملاحظات مع بطاقات آخر 45 دقيقة الموجودة لتكوين بطاقات خط زمني (مدة كل منها 10-60 دقيقة) تتضمن عنوانًا وملخصًا وفئة والتطبيق الرئيسي وأي مشتتات موجزة.
4. التنقية: تُحذف الإطارات الأقدم من retentionDays (الافتراضي 14). ويُحتفظ بالبطاقات والملاحظات والاجتماعات اليومية المخزنة مؤقتًا.

​

تدفق النماذج والبيانات

​

الإعداد

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
      logbook: {
        enabled: true,
        config: {
          captureEnabled: true,
          captureIntervalSeconds: 30,
          analysisIntervalMinutes: 15,
          nodeId: "my-mac",
          screenIndex: 0,
          maxWidth: 1440,
          visionModel: "codex/gpt-5.6-sol",
          retentionDays: 14,
        },
      },
    },
  },
}

​

اختيار نموذج الرؤية

1. plugins.entries.logbook.config.visionModel
2. أول إدخال Codex يدعم الصور ضمن tools.media.image.models
3. أول إدخال Codex يدعم الصور ضمن tools.media.models

​

علامة تبويب لوحة المعلومات

• الخط الزمني: بطاقات قابلة للتوسيع لكل نشاط مع ألوان الفئات والتطبيق الرئيسي وشرائح المشتتات وإطار رئيسي من لقطة الشاشة.
• نظرة سريعة على اليوم: نسبة التركيز وتوزيع الفئات وأبرز التطبيقات.
• الاجتماع اليومي: يحوّل الأمس واليوم إلى تحديث جاهز للصق.
• اسأل عن يومك: أسئلة بلغة طبيعية تُجاب استنادًا إلى الخط الزمني المتتبَّع (“متى راجعت طلب سحب Gateway؟”).
• حلّل الآن: يغلق نافذة الالتقاط الحالية فورًا بدلًا من انتظار فاصل التحليل.

​

أساليب Gateway

​

ملاحظات الخصوصية

• قد تحتوي اللقطات على أي شيء ظاهر على الشاشة، بما في ذلك الأسرار. لا تغادر الإطارات الجهاز مطلقًا إلا بوصفها مدخلات مأخوذة كعينات لنموذج الملاحظة المُعدّ.
• قد تغادر الملاحظات والبطاقات الحديثة والأسئلة الجهاز عبر نموذج الوكيل الافتراضي أثناء تركيب البطاقات أو إنشاء الاجتماع اليومي أو الأسئلة والأجوبة. طبّق سياسة معالجة البيانات الخاصة بالموفّر على مساري النموذج.
• استخدم مسارات محلية لكل من نموذج الملاحظة المنظّم ونموذج الوكيل الافتراضي عندما تحتاج إلى مسار معالجة محلي بالكامل.
• تُكتب الإطارات وقاعدة بيانات الخط الزمني والالتقاطات المؤقتة بأذونات ملفات للمالك فقط.
• تُعد إضافة screen.snapshot إلى gateway.nodes.denyCommands مفتاح الإيقاف القاطع لالتقاط الشاشة: فهي تحظر التقاط Node الخاص بالتطبيق وأمر logbook.snapshot الخاص بـ Logbook على حد سواء.
• يؤدي ضبط tools.media.image.enabled: false أيضًا إلى منع Logbook من استعارة نماذج صور الوسائط للتحليل؛ وعندئذٍ لا يُستخدم إلا visionModel صريح في إعداد Plugin.

​

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

​

علامة تبويب Logbook مفقودة

1. تتضمن نتيجة openclaw plugins list --enabled القيمة logbook.
2. أُعيد تشغيل Gateway بعد تغيير Plugin أو قائمة السماح.
3. يتضمن اتصال واجهة التحكم النطاق operator.write؛ لا تتلقى جلسات القراءة فقط واصف علامة التبويب التفاعلية.

​

يُبلغ الالتقاط عن خطأ

openclaw nodes status --connected
openclaw nodes describe --node <idOrNameOrIp>
openclaw logs --follow

• تأكد من أن Node يوفّر screen.snapshot أو logbook.snapshot.
• امنح إذن تسجيل الشاشة على جهاز Mac المستخدم للالتقاط.
• إذا تم إعداد nodeId، فتأكد من مطابقته لمعرّف Node أو اسم العرض.
• تحقق من أن gateway.nodes.denyCommands لا يحتوي على screen.snapshot.

​

تنجح عمليات الالتقاط ولكن لا تظهر أي بطاقات

• تعني حالة النموذج مفقود أنه لم يتم العثور على مسار رؤية منظّم متوافق. فعّل Plugin ‏Codex وصادِق عليه، أو عيّن visionModel صريحًا وصالحًا. تظل الإطارات الملتقطة في حالة انتظار أثناء غياب النموذج، ويمكن تحليلها بعد إصلاح الإعداد.
• انتظر مدة analysisIntervalMinutes، أو حدّد حلّل الآن بعد التقاط النشاط.
• تُعد الإطارات المتطابقة المتتالية دليلاً على الخمول ولا تدخل في دُفعات التحليل. غيّر الشاشة الظاهرة قبل الاختبار.
• إذا أظهرت أحدث دفعة خطأً، فأصلح مشكلة النموذج أو المصادقة وحدّد حلّل الآن. لا تُعاد محاولة الدُفعات الفاشلة إلا عند تنفيذ هذا الإجراء الصريح لتجنب الإنفاق المتكرر على النموذج.

​

ذو صلة

• إدارة Plugins
• بيئة تشغيل Codex
• فهم الوسائط
• العُقد
• استكشاف أخطاء العُقد وإصلاحها
• واجهة التحكم