Skip to main content

​
openclaw setup

يمثّل openclaw setup نقطة دخول وكيل النظام. في نظام مُهيّأ، يفتح openclaw setup وحده محادثة OpenClaw تفاعلية. أما في نظام جديد، فينتقل إلى الإعداد الأولي الموجّه. استخدم -m/--message لطلب واحد أو --baseline لتهيئة مجلدات الإعدادات/مساحة العمل من دون المعالج. ترتيب التوجيه:
  1. يؤدي أي خيار من خيارات الإعداد الأولي (--wizard أو --baseline أو مساحة العمل أو إعادة الضبط أو الوضع غير التفاعلي أو التدفق أو النمط أو Gateway أو الخدمة الخفية أو التخطي أو الاستيراد أو الاتصال البعيد أو خيارات المصادقة) إلى تشغيل الإعداد الأولي تمامًا كما يفعل openclaw onboard.
  2. يشغّل -m/--message أو --yes وكيل النظام.
  3. عند عدم وجود خيار توجيه، يفتح النظام التفاعلي المُهيّأ OpenClaw. أما النظام الجديد فيشغّل الإعداد الأولي. في نظام مُهيّأ، يطبع --json نظرة عامة على النظام حتى من دون TTY؛ ويُبقي خيار الإعداد الأولي ملخص JSON الخاص بالإعداد الأولي.
في الوضع الموجّه، تكون --workspace <dir> مساحة العمل المقترحة على OpenClaw؛ ولا تُحفَظ إلا بعد الموافقة على ذلك الاقتراح. تحفظ إعدادات خط الأساس والكلاسيكية وغير التفاعلية مساحة العمل المقدّمة من خلال تدفقها المعتاد. يعمل اكتشاف الاستدلال الموجّه على مضيف Gateway في macOS أو Linux. تستدعي CLI وتطبيق macOS أداة الاكتشاف نفسها المملوكة لـ Gateway، والتي تتحقق من النماذج المُهيّأة، وعمليات تسجيل الدخول المدعومة في CLI، ومتغيرات بيئة مفاتيح API، ونماذج Ollama أو LM Studio المثبتة مسبقًا. لا تُنزَّل النماذج المحلية أبدًا بواسطة هذه العملية التلقائية؛ ويجب أن يستجيب المرشح المحدد لعملية إكمال فعلية قبل حفظ إعدادات موفّره ونموذجه. يقبل setup خيارات الإعداد الأولي نفسها التي يقبلها openclaw onboard، بما فيها المصادقة (--auth-choice و--token وخيارات مفاتيح الموفّر)، وGateway (--gateway-port و--gateway-bind و--gateway-auth و--install-daemon)، وTailscale ‏(--tailscale)، وإعادة الضبط (--reset و--reset-scope)، والتدفق (--flow quickstart|advanced|manual|import)، وخيارات التخطي (--skip-channels و--skip-skills و--skip-bootstrap و--skip-search و--skip-health و--skip-ui و--skip-hooks). راجع الإعداد الأولي و أتمتة CLI للاطلاع على المرجع الكامل للخيارات وأمثلة الوضع غير التفاعلي. يظل openclaw onboard --modern مدخل توافق لمساعد OpenClaw نفسه الخاضع لبوابة الاستدلال.
يُستخدم openclaw setup لعمليات التثبيت ذات الإعدادات القابلة للتعديل. في وضع Nix ‏(OPENCLAW_NIX_MODE=1)، يرفض OpenClaw كتابة إعدادات التجهيز لأن ملف الإعدادات تديره Nix. استخدم البدء السريع لـ nix-openclaw من الطرف الأول أو إعدادات المصدر المكافئة لحزمة Nix أخرى.

​
الخيارات

الخياران --classic و--non-interactive متنافيان: يفتح الوضع الكلاسيكي المعالج المزود بالمطالبات، بينما يستخدم الإعداد غير التفاعلي مسار الأتمتة.

​
وضع خط الأساس

يحافظ openclaw setup --baseline على السلوك الأقدم المقتصر على خط الأساس: إذ ينشئ مجلدات الإعدادات ومساحة العمل والجلسات، ثم يخرج من دون تشغيل الإعداد الأولي.

​
أمثلة

​
ملاحظات

  • بعد إعداد خط الأساس، شغّل openclaw onboard لإجراء الرحلة الموجّهة الكاملة، أو openclaw configure لإجراء تغييرات محددة، أو openclaw channels add لإضافة حسابات القنوات.
  • إذا اكتُشفت حالة Hermes، فيمكن للإعداد الأولي التفاعلي عرض الترحيل تلقائيًا. يتطلب الإعداد الأولي للاستيراد إعدادًا جديدًا؛ استخدم الترحيل لخطط التشغيل التجريبي والنسخ الاحتياطية ووضع الاستبدال خارج الإعداد الأولي.

​
ذو صلة