Automation
الأوامر الدائمة
تمنح الأوامر الدائمة وكيلك صلاحية تشغيل دائمة لبرامج محددة. فبدلًا من توجيه الوكيل لكل مهمة، تُعرّف برامج ذات نطاق ومشغّلات وقواعد تصعيد واضحة، وينفّذها الوكيل بصورة مستقلة ضمن تلك الحدود: «أنت مسؤول عن التقرير الأسبوعي. أعدّه كل يوم جمعة، وأرسله، ولا تُصعّد الأمر إلا إذا بدا أن هناك خطأ ما.»
لماذا الأوامر الدائمة؟
من دون أوامر دائمة: تُوجّه الوكيل لكل مهمة، فتُنسى الأعمال الروتينية أو تتأخر، وتصبح أنت نقطة الاختناق.
مع الأوامر الدائمة: ينفّذ الوكيل بصورة مستقلة ضمن حدود محددة، وتُنجز الأعمال الروتينية في موعدها، ولا تتدخل إلا عند وجود استثناءات أو الحاجة إلى موافقات.
آلية عملها
تُعرّف الأوامر الدائمة في ملفات مساحة عمل الوكيل. النهج الموصى به هو تضمينها مباشرةً في AGENTS.md (الذي يُحقن تلقائيًا في كل جلسة) كي تكون دائمًا ضمن سياق الوكيل. وللإعدادات الأكبر، يمكنك أيضًا وضعها في ملف مخصص مثل standing-orders.md والإشارة إليه من AGENTS.md.
يحدد كل برنامج ما يلي:
- النطاق - ما يُصرح للوكيل بفعله
- المشغّلات - متى يبدأ التنفيذ (وفق جدول زمني أو حدث أو شرط)
- بوابات الموافقة - ما يتطلب اعتمادًا بشريًا قبل تنفيذه
- قواعد التصعيد - متى يجب التوقف وطلب المساعدة
يحمّل الوكيل هذه التعليمات في كل جلسة عبر ملفات تمهيد مساحة العمل (راجع مساحة عمل الوكيل للاطلاع على القائمة الكاملة للملفات المحقونة تلقائيًا)، وينفّذها بالتكامل مع مهام Cron لفرض التنفيذ المستند إلى الوقت.
بنية الأمر الدائم
## البرنامج: تقرير الحالة الأسبوعي **الصلاحية:** جمع البيانات وإنشاء التقرير وتسليمه إلى أصحاب المصلحة**المشغّل:** كل يوم جمعة الساعة 4 مساءً (يُفرض عبر مهمة cron)**بوابة الموافقة:** لا توجد للتقارير القياسية. ضع علامة على الحالات الشاذة لمراجعتها بشريًا.**التصعيد:** إذا كان مصدر البيانات غير متاح أو بدت المقاييس غير معتادة (>2σ عن المعدل الطبيعي) ### خطوات التنفيذ 1. جلب المقاييس من المصادر المهيأة2. مقارنتها بالأسبوع السابق والأهداف3. إنشاء التقرير في Reports/weekly/YYYY-MM-DD.md4. تسليم الملخص عبر القناة المهيأة5. تسجيل الإكمال في Agent/Logs/ ### ما يجب عدم فعله - لا ترسل التقارير إلى جهات خارجية- لا تعدّل بيانات المصدر- لا تتخطَّ التسليم إذا بدت المقاييس سيئة، بل أبلغ عنها بدقةالأوامر الدائمة مع مهام Cron
تحدد الأوامر الدائمة ما يُصرح للوكيل بفعله. وتحدد مهام Cron متى يحدث ذلك. ويعملان معًا:
الأمر الدائم: "أنت مسؤول عن فرز البريد الوارد يوميًا" ↓مهمة Cron (الساعة 8 صباحًا يوميًا): "نفّذ فرز البريد الوارد وفق الأوامر الدائمة" ↓الوكيل: يقرأ الأوامر الدائمة ← ينفّذ الخطوات ← يبلّغ عن النتائجينبغي لموجّه مهمة Cron أن يشير إلى الأمر الدائم بدلًا من تكراره:
openclaw cron add \ --name daily-inbox-triage \ --cron "0 8 * * 1-5" \ --tz America/New_York \ --timeout-seconds 300 \ --announce \ --channel imessage \ --to "+1XXXXXXXXXX" \ --message "نفّذ الفرز اليومي للبريد الوارد وفق الأوامر الدائمة. افحص البريد بحثًا عن تنبيهات جديدة. حلّل كل عنصر وصنّفه واحفظه بشكل دائم. أرسل ملخصًا إلى المالك. صعّد الحالات غير المعروفة."أمثلة
المثال 1: المحتوى ووسائل التواصل الاجتماعي (دورة أسبوعية)
## البرنامج: المحتوى ووسائل التواصل الاجتماعي **الصلاحية:** صياغة المحتوى وجدولة المنشورات وإعداد تقارير التفاعل**بوابة الموافقة:** تتطلب جميع المنشورات مراجعة المالك خلال أول 30 يومًا، ثم تصبح معتمدة بموجب أمر دائم**المشغّل:** دورة أسبوعية (مراجعة يوم الاثنين ← مسودات منتصف الأسبوع ← موجز يوم الجمعة) ### الدورة الأسبوعية - **الاثنين:** مراجعة مقاييس المنصات وتفاعل الجمهور- **الثلاثاء-الخميس:** صياغة منشورات اجتماعية وإنشاء محتوى للمدونة- **الجمعة:** إعداد موجز التسويق الأسبوعي ← تسليمه إلى المالك ### قواعد المحتوى - يجب أن تتوافق النبرة مع العلامة التجارية (راجع SOUL.md أو دليل نبرة العلامة التجارية)- لا تعرّف نفسك مطلقًا بوصفك ذكاءً اصطناعيًا في المحتوى الموجّه للجمهور- أدرج المقاييس عند توفرها- ركّز على القيمة المقدمة للجمهور، لا على الترويج الذاتيالمثال 2: العمليات المالية (تُشغّل بحدث)
## البرنامج: المعالجة المالية **الصلاحية:** معالجة بيانات المعاملات وإنشاء التقارير وإرسال الملخصات**بوابة الموافقة:** لا توجد للتحليل. تتطلب التوصيات موافقة المالك.**المشغّل:** اكتشاف ملف بيانات جديد أو حلول موعد الدورة الشهرية المجدولة ### عند وصول بيانات جديدة 1. اكتشاف الملف الجديد في دليل الإدخال المحدد2. تحليل جميع المعاملات وتصنيفها3. مقارنتها بأهداف الميزانية4. وضع علامات على: العناصر غير المعتادة، وتجاوزات الحدود، والرسوم الدورية الجديدة5. إنشاء التقرير في دليل الإخراج المحدد6. تسليم الملخص إلى المالك عبر القناة المهيأة ### قواعد التصعيد - عنصر واحد > $500: تنبيه فوري- فئة تتجاوز الميزانية بنسبة 20%: ضع علامة عليها في التقرير- معاملة غير معروفة: اطلب من المالك تصنيفها- فشل المعالجة بعد محاولتين: أبلغ عن الفشل ولا تخمّنالمثال 3: المراقبة والتنبيهات (مستمر)
## البرنامج: مراقبة النظام **الصلاحية:** التحقق من سلامة النظام وإعادة تشغيل الخدمات وإرسال التنبيهات**بوابة الموافقة:** أعد تشغيل الخدمات تلقائيًا. صعّد الأمر إذا فشلت إعادة التشغيل مرتين.**المشغّل:** كل دورة Heartbeat ### الفحوصات - استجابة نقاط نهاية سلامة الخدمة- تجاوز مساحة القرص للحد الأدنى- عدم تقادم المهام المعلّقة (>24 ساعة)- عمل قنوات التسليم ### مصفوفة الاستجابة | الحالة | الإجراء | هل يُصعّد؟ || ------------------- | ------------------------------- | ---------------------------------- || توقف الخدمة | إعادة التشغيل تلقائيًا | فقط إذا فشلت إعادة التشغيل مرتين || مساحة القرص < 10% | تنبيه المالك | نعم || مهمة متقادمة > 24h | تذكير المالك | لا || القناة غير متصلة | التسجيل وإعادة المحاولة لاحقًا | إذا استمر الانقطاع > ساعتين |نمط التنفيذ والتحقق والإبلاغ
تعمل الأوامر الدائمة بأفضل صورة عند دمجها مع انضباط صارم في التنفيذ. ينبغي لكل مهمة في أمر دائم أن تتبع هذه الحلقة:
- التنفيذ - أنجز العمل الفعلي (لا تكتفِ بالإقرار بالتعليمات)
- التحقق - تأكد من صحة النتيجة (الملف موجود، والرسالة سُلّمت، والبيانات حُلّلت)
- الإبلاغ - أخبر المالك بما أُنجز وما جرى التحقق منه
### قواعد التنفيذ - تتبع كل مهمة نمط التنفيذ والتحقق والإبلاغ. بلا استثناءات.- قول "سأفعل ذلك" لا يُعد تنفيذًا. نفّذ أولًا، ثم أبلغ.- قول "تم" من دون تحقق غير مقبول. قدّم إثباتًا.- إذا فشل التنفيذ: أعد المحاولة مرة واحدة بنهج معدّل.- إذا استمر الفشل: أبلغ عن الفشل مع التشخيص. لا تفشل بصمت مطلقًا.- لا تُعد المحاولة إلى أجل غير مسمى؛ الحد الأقصى 3 محاولات، ثم صعّد الأمر.يمنع هذا النمط أكثر حالات فشل الوكيل شيوعًا: الإقرار بالمهمة من دون إكمالها.
بنية البرامج المتعددة
بالنسبة إلى الوكلاء الذين يديرون مجالات متعددة، نظّم الأوامر الدائمة في برامج منفصلة ذات حدود واضحة:
## البرنامج 1: [المجال أ] (أسبوعي) ... ## البرنامج 2: [المجال ب] (شهري + عند الطلب) ... ## البرنامج 3: [المجال ج] (عند الحاجة) ... ## قواعد التصعيد (جميع البرامج) - [معايير التصعيد المشتركة]- [بوابات الموافقة التي تنطبق على جميع البرامج]ينبغي أن يكون لكل برنامج:
- وتيرة تشغيل خاصة به (أسبوعية أو شهرية أو مدفوعة بالأحداث أو مستمرة)
- بوابات موافقة خاصة به (تحتاج بعض البرامج إلى إشراف أكبر من غيرها)
- حدود واضحة (ينبغي أن يعرف الوكيل أين ينتهي برنامج ويبدأ آخر)
أفضل الممارسات
افعل
- ابدأ بصلاحية محدودة ووسّعها مع نمو الثقة
- حدد بوابات موافقة صريحة للإجراءات عالية المخاطر
- أدرج أقسام «ما يجب عدم فعله»، فالحدود لا تقل أهمية عن الأذونات
- ادمجها مع مهام Cron لضمان تنفيذ موثوق مستند إلى الوقت
- راجع سجلات الوكيل أسبوعيًا للتحقق من اتباع الأوامر الدائمة
- حدّث الأوامر الدائمة مع تطور احتياجاتك، فهي مستندات حية
تجنّب
- منح صلاحيات واسعة منذ اليوم الأول («افعل ما تراه الأفضل»)
- إغفال قواعد التصعيد، فكل برنامج يحتاج إلى بند «متى تتوقف وتسأل»
- افتراض أن الوكيل سيتذكر التعليمات الشفهية، بل ضع كل شيء في الملف
- خلط المجالات في برنامج واحد، بل استخدم برامج منفصلة للمجالات المختلفة
- نسيان فرض التنفيذ بواسطة مهام Cron، فالأوامر الدائمة من دون مشغّلات تصبح مجرد اقتراحات
ذو صلة
- الأتمتة: جميع آليات الأتمتة في لمحة.
- مهام Cron: فرض الجدولة الزمنية للأوامر الدائمة.
- الخطافات: نصوص برمجية مدفوعة بالأحداث لأحداث دورة حياة الوكيل.
- Webhooks: مشغّلات أحداث HTTP الواردة.
- مساحة عمل الوكيل: موضع الأوامر الدائمة، بما في ذلك القائمة الكاملة لملفات التمهيد المحقونة تلقائيًا (
AGENTS.mdوSOUL.mdوما إلى ذلك).