الإعداد الأولي (CLI)

CLI onboarding هي الطريقة الموصى بها لإعداد OpenClaw على macOS أو Linux أو Windows (عبر WSL2؛ موصى به بشدة). تُهيئ Gateway محليًا أو اتصالًا بـ Gateway بعيد، إضافة إلى القنوات وSkills وافتراضات مساحة العمل ضمن مسار إرشادي واحد.

openclaw onboard

لإعادة التهيئة لاحقًا:

openclaw configure
openclaw agents add <name>

# البدء السريع مقابل المتقدم

يبدأ onboarding بخيار البدء السريع (الافتراضات) مقابل المتقدم (تحكم كامل).

# ما الذي يهيئه onboarding

يرشدك الوضع المحلي (الافتراضي) عبر هذه الخطوات:

1. النموذج/المصادقة — اختر أي مزود/مسار مصادقة مدعوم (مفتاح API أو OAuth أو مصادقة يدوية خاصة بالمزود)، بما في ذلك مزود مخصص (متوافق مع OpenAI، أو متوافق مع Anthropic، أو اكتشاف تلقائي غير معروف). اختر نموذجًا افتراضيًا. ملاحظة أمان: إذا كان هذا الوكيل سيشغّل أدوات أو يعالج محتوى webhook/hooks، ففضّل أقوى نموذج متاح من أحدث جيل وأبقِ سياسة الأدوات صارمة. الشرائح الأضعف/الأقدم أسهل عرضة لحقن المطالبات. للتشغيلات غير التفاعلية، يخزن --secret-input-mode ref مراجع مدعومة بمتغيرات البيئة في ملفات المصادقة الشخصية بدلًا من قيم مفاتيح API بنص صريح. في وضع ref غير التفاعلي، يجب تعيين متغير بيئة المزود؛ تمرير أعلام مفاتيح مضمنة دون متغير البيئة ذاك يفشل بسرعة. في التشغيلات التفاعلية، يتيح لك اختيار وضع مرجع السر الإشارة إما إلى متغير بيئة أو مرجع مزود مُهيأ (file أو exec)، مع تحقق تمهيدي سريع قبل الحفظ. بالنسبة إلى Anthropic، يوفر onboarding/configure التفاعلي Anthropic Claude CLI كالمسار المحلي المفضل ومفتاح Anthropic API كمسار الإنتاج الموصى به. يبقى Anthropic setup-token متاحًا أيضًا كمسار مصادقة رمزية مدعوم.
2. مساحة العمل — موقع ملفات الوكيل (الافتراضي ~/.openclaw/workspace). يضيف ملفات التمهيد الأولية.
3. Gateway — المنفذ، عنوان الربط، وضع المصادقة، تعريض Tailscale. في وضع الرمز التفاعلي، اختر التخزين الافتراضي للرمز بنص صريح أو انتقل إلى SecretRef. مسار SecretRef للرمز غير التفاعلي: --gateway-token-ref-env <ENV_VAR>.
4. القنوات — قنوات الدردشة المدمجة والمرفقة مثل BlueBubbles وDiscord وFeishu وGoogle Chat وMattermost وMicrosoft Teams وQQ Bot وSignal وSlack وTelegram وWhatsApp والمزيد.
5. Daemon — يثبّت LaunchAgent (macOS)، أو وحدة مستخدم systemd (Linux/WSL2)، أو مهمة Windows Scheduled Task أصلية مع احتياطي مجلد Startup لكل مستخدم. إذا كانت مصادقة الرمز تتطلب رمزًا وكان gateway.auth.token مُدارًا عبر SecretRef، يتحقق تثبيت daemon منه لكنه لا يحفظ الرمز المحلول في بيانات وصفية لبيئة خدمة المشرف. إذا كانت مصادقة الرمز تتطلب رمزًا وكان SecretRef للرمز المُهيأ غير محلول، يُحظر تثبيت daemon مع إرشادات قابلة للتنفيذ. إذا كان كل من gateway.auth.token وgateway.auth.password مُهيأين وكان gateway.auth.mode غير معيّن، يُحظر تثبيت daemon إلى أن يُعيّن الوضع صراحةً.
6. فحص الصحة — يبدأ Gateway ويتحقق من أنه يعمل.
7. Skills — يثبّت Skills الموصى بها والاعتماديات الاختيارية.

لا يهيئ الوضع البعيد إلا العميل المحلي للاتصال بـ Gateway في مكان آخر. لا يثبّت أو يغيّر أي شيء على المضيف البعيد.

# إضافة وكيل آخر

استخدم openclaw agents add <name> لإنشاء وكيل منفصل له مساحة عمل وجلسات وملفات مصادقة شخصية خاصة به. التشغيل دون --workspace يطلق onboarding.

ما يعيّنه:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

ملاحظات:

• تتبع مساحات العمل الافتراضية ~/.openclaw/workspace-<agentId>.
• أضف bindings لتوجيه الرسائل الواردة (يمكن لـ onboarding فعل ذلك).
• أعلام غير تفاعلية: --model، --agent-dir، --bind، --non-interactive.

# المرجع الكامل

للاطلاع على تفصيلات خطوة بخطوة ومخرجات التهيئة، راجع مرجع إعداد CLI. لأمثلة غير تفاعلية، راجع أتمتة CLI. للمرجع التقني الأعمق، بما في ذلك تفاصيل RPC، راجع مرجع onboarding.

# وثائق ذات صلة

• مرجع أوامر CLI: openclaw onboard
• نظرة عامة على onboarding: نظرة عامة على onboarding
• onboarding لتطبيق macOS: onboarding
• طقس التشغيل الأول للوكيل: تمهيد الوكيل