CLI commands

الإكمال

openclaw completion

أنشئ نصوص الإكمال التلقائي للصدفة، وخزّنها مؤقتًا ضمن حالة OpenClaw، وثبّتها اختياريًا في ملف تعريف الصدفة لديك.

الاستخدام

bash
openclaw completion                          # طباعة نص zsh إلى المخرج القياسيopenclaw completion --shell fish             # طباعة نص fishopenclaw completion --write-state            # تخزين النصوص مؤقتًا لجميع الصدفاتopenclaw completion --write-state --install  # التخزين المؤقت ثم التثبيت في خطوة واحدةopenclaw completion --shell bash --write-state

الخيارات

  • -s, --shell <shell>: الصدفة المستهدفة (zsh، وbash، وpowershell، وfish؛ الافتراضي: zsh)
  • -i, --install: تثبيت الإكمال التلقائي بإضافة سطر تحميل للنص المخزّن مؤقتًا إلى ملف تعريف الصدفة
  • --write-state: كتابة نص أو نصوص الإكمال التلقائي في $OPENCLAW_STATE_DIR/completions (الافتراضي ~/.openclaw/completions) من دون طباعتها إلى المخرج القياسي؛ عند استخدام --shell، يكتب نص تلك الصدفة فقط، وإلا فيكتب نصوص الصدفات الأربع كلها
  • -y, --yes: تخطي مطالبات تأكيد التثبيت (في الوضع غير التفاعلي)

مسار التثبيت

يوجّه --install ملف تعريفك إلى النص المخزّن مؤقتًا، لذا يجب أن تكون ذاكرة التخزين المؤقت موجودة أولًا: إذا كانت مفقودة، يفشل الأمر ويطلب منك تشغيل openclaw completion --write-state. اجمع بين --write-state --install لتنفيذ العمليتين في خطوة واحدة. من دون --shell، يكتشف --install الصدفة من $SHELL (مع الرجوع إلى zsh عند تعذر ذلك).

يكتب التثبيت كتلة صغيرة باسم # OpenClaw Completion في ملف تعريف الصدفة، ويستبدل أي أسطر بطيئة أقدم من نوع source <(openclaw completion ...) بسطر تحميل النص المخزّن مؤقتًا:

الصدفة ملف التعريف
bash ~/.bashrc (يرجع إلى ~/.bash_profile عند غياب ~/.bashrc)
fish ~/.config/fish/config.fish
powershell ~/.config/powershell/Microsoft.PowerShell_profile.ps1 (على Windows: Documents/PowerShell/Microsoft.PowerShell_profile.ps1، أو Documents/WindowsPowerShell/... لـ Windows PowerShell)
zsh ~/.zshrc

ملاحظات

  • من دون --install أو --write-state، يطبع الأمر النص إلى المخرج القياسي.
  • يحمّل إنشاء الإكمال التلقائي شجرة الأوامر الكاملة مسبقًا، بما في ذلك أوامر CLI الخاصة بالـ Plugin، ولذلك تُضمَّن الأوامر الفرعية المتداخلة.
  • يحدّث openclaw update ذاكرة الإكمال التلقائي المؤقتة آليًا بعد نجاح التحديث؛ ويمكن لـ openclaw doctor إصلاح إعدادات الإكمال التلقائي المفقودة أو القديمة.

ذو صلة

Was this useful?
On this page

On this page