الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

تمنح الأوامر الدائمة وكيلك صلاحية تشغيل دائمة لبرامج محددة. بدلا من إعطاء تعليمات مهام منفردة في كل مرة، تعرّف برامج ذات نطاق واضح ومشغلات وقواعد تصعيد، وينفذ الوكيل باستقلالية ضمن تلك الحدود. هذا هو الفرق بين أن تقول لمساعدك “أرسل التقرير الأسبوعي” كل يوم جمعة، وبين منحه صلاحية دائمة: “أنت مسؤول عن التقرير الأسبوعي. اجمعه كل يوم جمعة، وأرسله، ولا تصعّد إلا إذا بدا أن هناك أمرا غير صحيح.”

لماذا الأوامر الدائمة

من دون الأوامر الدائمة:
  • يجب عليك توجيه الوكيل لكل مهمة
  • يبقى الوكيل خاملا بين الطلبات
  • تُنسى الأعمال الروتينية أو تتأخر
  • تصبح أنت عنق الزجاجة
مع الأوامر الدائمة:
  • ينفذ الوكيل باستقلالية ضمن حدود محددة
  • تتم الأعمال الروتينية في موعدها من دون طلب
  • لا تتدخل إلا في الاستثناءات والموافقات
  • يستغل الوكيل وقت الخمول بإنتاجية

كيف تعمل

تُعرّف الأوامر الدائمة في ملفات مساحة عمل الوكيل. النهج الموصى به هو تضمينها مباشرة في AGENTS.md (الذي يُحقن تلقائيا في كل جلسة) بحيث تكون دائما ضمن سياق الوكيل. وللتكوينات الأكبر، يمكنك أيضا وضعها في ملف مخصص مثل standing-orders.md والإشارة إليه من AGENTS.md. يحدد كل برنامج ما يلي:
  1. النطاق - ما يملك الوكيل صلاحية فعله
  2. المشغلات - متى يتم التنفيذ (جدول، حدث، أو شرط)
  3. بوابات الموافقة - ما الذي يتطلب توقيعا بشريا قبل التصرف
  4. قواعد التصعيد - متى يجب التوقف وطلب المساعدة
يحمّل الوكيل هذه التعليمات في كل جلسة عبر ملفات تمهيد مساحة العمل (راجع مساحة عمل الوكيل للاطلاع على القائمة الكاملة للملفات المحقونة تلقائيا) وينفذ بموجبها، مع دمجها مع مهام Cron للإنفاذ المعتمد على الوقت.
ضع الأوامر الدائمة في AGENTS.md لضمان تحميلها في كل جلسة. يحقن تمهيد مساحة العمل تلقائيا AGENTS.md وSOUL.md وTOOLS.md وIDENTITY.md وUSER.md وHEARTBEAT.md وBOOTSTRAP.md وMEMORY.md، لكن لا يحقن الملفات العشوائية في الأدلة الفرعية.

بنية الأمر الدائم

## Program: Weekly Status Report

**Authority:** Compile data, generate report, deliver to stakeholders
**Trigger:** Every Friday at 4 PM (enforced via cron job)
**Approval gate:** None for standard reports. Flag anomalies for human review.
**Escalation:** If data source is unavailable or metrics look unusual (>2σ from norm)

### Execution steps

1. Pull metrics from configured sources
2. Compare to prior week and targets
3. Generate report in Reports/weekly/YYYY-MM-DD.md
4. Deliver summary via configured channel
5. Log completion to Agent/Logs/

### What NOT to do

- Do not send reports to external parties
- Do not modify source data
- Do not skip delivery if metrics look bad - report accurately

الأوامر الدائمة مع مهام Cron

تحدد الأوامر الدائمة ما يملك الوكيل صلاحية فعله. وتحدد مهام Cron متى يحدث ذلك. يعملان معا:
Standing Order: "You own the daily inbox triage"

Cron Job (8 AM daily): "Execute inbox triage per standing orders"

Agent: Reads standing orders → executes steps → reports results
ينبغي أن تشير صياغة مطالبة مهمة 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 "Execute daily inbox triage per standing orders. Check mail for new alerts. Parse, categorize, and persist each item. Report summary to owner. Escalate unknowns."

أمثلة

المثال 1: المحتوى ووسائل التواصل الاجتماعي (دورة أسبوعية)

## Program: Content & Social Media

**Authority:** Draft content, schedule posts, compile engagement reports
**Approval gate:** All posts require owner review for first 30 days, then standing approval
**Trigger:** Weekly cycle (Monday review → mid-week drafts → Friday brief)

### Weekly cycle

- **Monday:** Review platform metrics and audience engagement
- **Tuesday-Thursday:** Draft social posts, create blog content
- **Friday:** Compile weekly marketing brief → deliver to owner

### Content rules

- Voice must match the brand (see SOUL.md or brand voice guide)
- Never identify as AI in public-facing content
- Include metrics when available
- Focus on value to audience, not self-promotion

المثال 2: عمليات المالية (مشغلة بحدث)

## Program: Financial Processing

**Authority:** Process transaction data, generate reports, send summaries
**Approval gate:** None for analysis. Recommendations require owner approval.
**Trigger:** New data file detected OR scheduled monthly cycle

### When new data arrives

1. Detect new file in designated input directory
2. Parse and categorize all transactions
3. Compare against budget targets
4. Flag: unusual items, threshold breaches, new recurring charges
5. Generate report in designated output directory
6. Deliver summary to owner via configured channel

### Escalation rules

- Single item > $500: immediate alert
- Category > budget by 20%: flag in report
- Unrecognizable transaction: ask owner for categorization
- Failed processing after 2 retries: report failure, do not guess

المثال 3: المراقبة والتنبيهات (مستمرة)

## Program: System Monitoring

**Authority:** Check system health, restart services, send alerts
**Approval gate:** Restart services automatically. Escalate if restart fails twice.
**Trigger:** Every heartbeat cycle

### Checks

- Service health endpoints responding
- Disk space above threshold
- Pending tasks not stale (>24 hours)
- Delivery channels operational

### Response matrix

| Condition        | Action                   | Escalate?                |
| ---------------- | ------------------------ | ------------------------ |
| Service down     | Restart automatically    | Only if restart fails 2x |
| Disk space < 10% | Alert owner              | Yes                      |
| Stale task > 24h | Remind owner             | No                       |
| Channel offline  | Log and retry next cycle | If offline > 2 hours     |

نمط التنفيذ والتحقق والإبلاغ

تعمل الأوامر الدائمة بأفضل شكل عند دمجها مع انضباط تنفيذ صارم. ينبغي لكل مهمة في أمر دائم أن تتبع هذه الحلقة:
  1. التنفيذ - نفذ العمل الفعلي (لا تكتف بالإقرار بالتعليمات)
  2. التحقق - تأكد أن النتيجة صحيحة (الملف موجود، الرسالة سُلّمت، البيانات حُللت)
  3. الإبلاغ - أخبر المالك بما تم إنجازه وما تم التحقق منه
### Execution rules

- Every task follows Execute-Verify-Report. No exceptions.
- "I'll do that" is not execution. Do it, then report.
- "Done" without verification is not acceptable. Prove it.
- If execution fails: retry once with adjusted approach.
- If still fails: report failure with diagnosis. Never silently fail.
- Never retry indefinitely - 3 attempts max, then escalate.
يمنع هذا النمط أكثر أوضاع فشل الوكلاء شيوعا: الإقرار بالمهمة من دون إكمالها.

بنية متعددة البرامج

بالنسبة إلى الوكلاء الذين يديرون عدة مجالات، نظّم الأوامر الدائمة كبرامج منفصلة ذات حدود واضحة:
## Program 1: [Domain A] (Weekly)

...

## Program 2: [Domain B] (Monthly + On-Demand)

...

## Program 3: [Domain C] (As-Needed)

...

## Escalation Rules (All Programs)

- [Common escalation criteria]
- [Approval gates that apply across programs]
ينبغي أن يكون لكل برنامج:
  • وتيرة تشغيل خاصة به (أسبوعية، شهرية، مدفوعة بالأحداث، مستمرة)
  • بوابات موافقة خاصة به (تحتاج بعض البرامج إلى رقابة أكبر من غيرها)
  • حدود واضحة (ينبغي أن يعرف الوكيل أين ينتهي برنامج وأين يبدأ آخر)

أفضل الممارسات

افعل

  • ابدأ بصلاحية ضيقة ووسّعها مع بناء الثقة
  • عرّف بوابات موافقة صريحة للإجراءات عالية المخاطر
  • ضمّن أقسام “ما لا يجب فعله” - فالحدود مهمة بقدر أهمية الأذونات
  • ادمجها مع مهام Cron لتنفيذ موثوق قائم على الوقت
  • راجع سجلات الوكيل أسبوعيا للتحقق من اتباع الأوامر الدائمة
  • حدّث الأوامر الدائمة مع تطور احتياجاتك - فهي مستندات حية

تجنب

  • منح صلاحية واسعة في اليوم الأول (“افعل ما تراه أفضل”)
  • تخطي قواعد التصعيد - يحتاج كل برنامج إلى بند “متى يجب التوقف والسؤال”
  • افتراض أن الوكيل سيتذكر التعليمات الشفهية - ضع كل شيء في الملف
  • خلط المجالات في برنامج واحد - استخدم برامج منفصلة لمجالات منفصلة
  • نسيان الإنفاذ عبر مهام Cron - فالأوامر الدائمة من دون مشغلات تصبح مجرد اقتراحات

ذات صلة

  • الأتمتة: نظرة سريعة على جميع آليات الأتمتة.
  • مهام Cron: إنفاذ الجداول الزمنية للأوامر الدائمة.
  • الخطافات: نصوص برمجية مدفوعة بالأحداث لأحداث دورة حياة الوكيل.
  • Webhook: مشغلات أحداث HTTP واردة.
  • مساحة عمل الوكيل: حيث تعيش الأوامر الدائمة، بما في ذلك القائمة الكاملة لملفات التمهيد المحقونة تلقائيا (AGENTS.md وSOUL.md وما إلى ذلك).