CLI commands
الإعداد
openclaw setup
يشغّل openclaw setup مسار الإعداد الأولي الموجّه نفسه الذي يشغّله openclaw onboard:
إذ يتحقق من إعداد الاستدلال ويحفظه أولًا، ثم يبدأ Crestodian لتهيئة
مساحة العمل وGateway والقنوات والمهارات وفحوصات السلامة. استخدم --baseline عندما
تحتاج فقط إلى تهيئة مجلدات الإعدادات ومساحة العمل دون المعالج.
في الوضع الموجّه، تمثّل --workspace <dir> مساحة العمل المقترحة على Crestodian؛
ولا تُحفَظ إلا بعد موافقتك على ذلك المقترح. أما الإعداد الأساسي والتقليدي
وغير التفاعلي، فيحفظ مساحة العمل المقدّمة عبر مساره المعتاد.
يقبل 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 اسمًا مستعارًا
للتوافق مع مساعد Crestodian المشروط بالاستدلال، ولا يوجد له مكافئ في setup.
الخيارات
| العلامة | الوصف |
|---|---|
--workspace <dir> |
مقترح مساحة العمل في الوضع الموجّه؛ يُحفَظ مباشرةً في الإعداد الأساسي والتقليدي وغير التفاعلي. |
--baseline |
إنشاء مجلدات الإعدادات الأساسية ومساحة العمل والجلسات دون إجراء الإعداد الأولي. |
--wizard |
مقبولة لأغراض التوافق؛ يشغّل الإعداد مسار الإعداد الأولي افتراضيًا. |
--non-interactive |
تشغيل الإعداد الأولي دون مطالبات. |
--accept-risk |
الإقرار بمخاطر منح الوكيل وصولًا إلى النظام بأكمله؛ مطلوبة مع --non-interactive. |
--mode <mode> |
وضع الإعداد الأولي: local أو remote. |
--flow <flow> |
مسار الإعداد الأولي: quickstart أو advanced أو manual أو import. |
--reset |
إعادة ضبط الإعدادات وبيانات الاعتماد والجلسات قبل الإعداد الأولي (ومساحة العمل فقط مع --reset-scope full). |
--reset-scope <scope> |
نطاق إعادة الضبط: config أو config+creds+sessions أو full. |
--import-from <provider> |
مزوّد الترحيل المطلوب تشغيله أثناء الإعداد الأولي. |
--import-source <path> |
المجلد الرئيسي للوكيل المصدر من أجل --import-from. |
--import-secrets |
استيراد الأسرار المدعومة أثناء ترحيل الإعداد الأولي. |
--remote-url <url> |
عنوان URL لاتصال WebSocket الخاص بـGateway البعيد. |
--remote-token <token> |
رمز Gateway البعيد (اختياري). |
--json |
إخراج ملخص بتنسيق JSON. |
لا يمكن استخدام --classic و--non-interactive معًا: إذ يفتح الوضع التقليدي
المعالج التفاعلي، بينما يستخدم الإعداد غير التفاعلي مسار الأتمتة.
الوضع الأساسي
يحافظ openclaw setup --baseline على السلوك القديم المقتصر على الإعداد الأساسي:
إذ ينشئ أدلة الإعدادات ومساحة العمل والجلسات، ثم ينهي التنفيذ دون
تشغيل الإعداد الأولي.
أمثلة
openclaw setupopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>ملاحظات
- بعد الإعداد الأساسي، شغّل
openclaw setupأوopenclaw onboardلخوض الرحلة الموجّهة الكاملة، أوopenclaw configureلإجراء تغييرات محددة، أوopenclaw channels addلإضافة حسابات القنوات. - إذا اكتُشفت حالة Hermes، يمكن لمسار الإعداد الأولي التفاعلي أن يعرض الترحيل تلقائيًا. يتطلب الإعداد الأولي للاستيراد إعدادًا جديدًا؛ استخدم الترحيل للحصول على خطط التشغيل التجريبي والنسخ الاحتياطية ووضع الاستبدال خارج الإعداد الأولي.
