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

السكريبتات

يحتوي الدليل scripts/ على سكريبتات مساعدة لسير العمل المحلي ومهام التشغيل. استخدمها عندما تكون المهمة مرتبطة بوضوح بسكريبت؛ وإلا ففضّل استخدام CLI.

الاصطلاحات

  • السكريبتات اختيارية ما لم تتم الإشارة إليها في الوثائق أو قوائم التحقق الخاصة بالإصدار.
  • فضّل واجهات CLI عندما تكون موجودة (مثال: تستخدم مراقبة المصادقة openclaw models status --check).
  • افترض أن السكريبتات خاصة بالمضيف؛ واقرأها قبل تشغيلها على جهاز جديد.

سكريبتات مراقبة المصادقة

تتم تغطية مراقبة المصادقة في المصادقة. أما السكريبتات الموجودة ضمن scripts/ فهي إضافات اختيارية لسير عمل systemd/Termux على الهاتف.

مساعد قراءة GitHub

استخدم scripts/gh-read عندما تريد أن يستخدم gh رمز تثبيت GitHub App المميز لاستدعاءات القراءة ذات النطاق الخاص بالمستودع، مع إبقاء gh العادي على تسجيلك الشخصي لعمليات الكتابة. متغيرات البيئة المطلوبة:
  • OPENCLAW_GH_READ_APP_ID
  • OPENCLAW_GH_READ_PRIVATE_KEY_FILE
متغيرات البيئة الاختيارية:
  • OPENCLAW_GH_READ_INSTALLATION_ID عندما تريد تخطي البحث عن التثبيت المعتمد على المستودع
  • OPENCLAW_GH_READ_PERMISSIONS كتجاوز مفصول بفواصل لمجموعة أذونات القراءة الفرعية المطلوب طلبها
ترتيب حل المستودع:
  • gh ... -R owner/repo
  • GH_REPO
  • git remote origin
أمثلة:
  • scripts/gh-read pr view 123
  • scripts/gh-read run list -R openclaw/openclaw
  • scripts/gh-read api repos/openclaw/openclaw/pulls/123

عند إضافة سكريبتات

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