CLI commands
الإعداد
openclaw setup
يمثّل openclaw setup نقطة دخول وكيل النظام. في نظام مُهيّأ، يفتح
openclaw setup وحده محادثة OpenClaw تفاعلية. أما في نظام جديد، فينتقل
إلى الإعداد الأولي الموجّه. استخدم -m/--message لطلب واحد أو
--baseline لتهيئة مجلدات الإعدادات/مساحة العمل من دون المعالج.
ترتيب التوجيه:
- يؤدي أي خيار من خيارات الإعداد الأولي (
--wizardأو--baselineأو مساحة العمل أو إعادة الضبط أو الوضع غير التفاعلي أو التدفق أو النمط أو Gateway أو الخدمة الخفية أو التخطي أو الاستيراد أو الاتصال البعيد أو خيارات المصادقة) إلى تشغيل الإعداد الأولي تمامًا كما يفعلopenclaw onboard. - يشغّل
-m/--messageأو--yesوكيل النظام. - عند عدم وجود خيار توجيه، يفتح النظام التفاعلي المُهيّأ 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 نفسه الخاضع لبوابة الاستدلال.
الخيارات
| الخيار | الوصف |
|---|---|
-m, --message <text> |
تشغيل طلب OpenClaw واحد. |
--yes |
الموافقة على عمليات الكتابة الدائمة للإعدادات لطلب --message واحد. |
--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 |
النظام المُهيّأ: نظرة عامة على OpenClaw. مسار الإعداد الأولي: ملخص الإعداد الأولي. |
الخياران --classic و--non-interactive متنافيان: يفتح الوضع الكلاسيكي
المعالج المزود بالمطالبات، بينما يستخدم الإعداد غير التفاعلي مسار الأتمتة.
وضع خط الأساس
يحافظ openclaw setup --baseline على السلوك الأقدم المقتصر على خط الأساس: إذ
ينشئ مجلدات الإعدادات ومساحة العمل والجلسات، ثم يخرج من دون
تشغيل الإعداد الأولي.
أمثلة
openclaw setupopenclaw setup -m "status"openclaw setup -m "restart gateway" --yesopenclaw setup --jsonopenclaw setup --wizardopenclaw 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 onboardلإجراء الرحلة الموجّهة الكاملة، أوopenclaw configureلإجراء تغييرات محددة، أوopenclaw channels addلإضافة حسابات القنوات. - إذا اكتُشفت حالة Hermes، فيمكن للإعداد الأولي التفاعلي عرض الترحيل تلقائيًا. يتطلب الإعداد الأولي للاستيراد إعدادًا جديدًا؛ استخدم الترحيل لخطط التشغيل التجريبي والنسخ الاحتياطية ووضع الاستبدال خارج الإعداد الأولي.
