الخطوات الأولى

معالج الإعداد (CLI)

معالج الإعداد هو الطريقة الموصى بها لإعداد OpenClaw على أنظمة macOS، أو Linux، أو Windows (عبر WSL2؛ موصى به بشدة). يقوم بتكوين بوابة محلية أو اتصال ببوابة بعيدة، بالإضافة إلى القنوات، والمهارات، وإعدادات مساحة العمل الافتراضية في تدفق موجه واحد.

openclaw onboard

ℹ️ أسرع محادثة أولى: افتح واجهة التحكم (لا حاجة لإعداد قناة). نفّذ الأمر openclaw dashboard وتحدث في المتصفح. الوثائق: لوحة التحكم.

لإعادة التكوين لاحقًا:

openclaw configure
openclaw agents add <name>

ℹ️ --json لا تعني الوضع غير التفاعلي. للنصوص البرمجية، استخدم --non-interactive.

💡 يتضمن معالج الإعداد خطوة بحث على الويب حيث يمكنك اختيار مزود (Perplexity، أو Brave، أو Gemini، أو Grok، أو Kimi) ولصق مفتاح API الخاص بك حتى يتمكن الوكيل من استخدام web_search. يمكنك أيضًا تكوين هذا لاحقًا باستخدام openclaw configure --section web. الوثائق: أدوات الويب.

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

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

  • بوابة محلية (loopback)
  • مساحة العمل الافتراضية (أو مساحة العمل الحالية)
  • منفذ البوابة 18789
  • مصادقة البوابة رمز (Token) (يتم إنشاؤه تلقائيًا، حتى على loopback)
  • سياسة الأدوات الافتراضية للإعدادات المحلية الجديدة: tools.profile: "coding" (يتم الحفاظ على الملف الشخصي الصريح الموجود)
  • افتراضي عزل الرسائل المباشرة: يكتب الإعداد المحلي session.dmScope: "per-channel-peer" عندما لا يكون مضبوطًا. التفاصيل: مرجع إعداد CLI
  • تعريض Tailscale معطّل
  • رسائل Telegram و WhatsApp المباشرة تنتقل افتراضيًا إلى قائمة السماح (سيتم مطالبتك برقم هاتفك)

ما يقوم المعالج بتكوينه

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

  1. النموذج/المصادقة — اختر أي مزود/تدفق مصادقة مدعوم (مفتاح API، أو OAuth، أو رمز الإعداد)، بما في ذلك المزود المخصص (متوافق مع OpenAI، أو متوافق مع Anthropic، أو الكشف التلقائي عن غير المعروف). اختر نموذجًا افتراضيًا. ملاحظة أمنية: إذا كان هذا الوكيل سيشغّل أدوات أو يعالج محتوى webhook/hooks، ففضل أقوى نموذج من الجيل الأخير متاح واحتفظ بسياسة الأدوات صارمة. المستويات الأضعف/الأقدم أسهل في حقن الأوامر (prompt-injection). للتشغيل غير التفاعلي، يقوم --secret-input-mode ref بتخزين مراجع مدعومة بالبيئة في ملفات تعريف المصادقة بدلاً من قيم مفاتيح API كنص عادي. في الوضع غير التفاعلي ref، يجب تعيين متغير البيئة الخاص بالمزود؛ تمرير وسائط مفتاح مضمنة بدون متغير البيئة هذا يفشل بسرعة. في عمليات التشغيل التفاعلية، يتيح لك اختيار وضع المرجع السري الإشارة إلى متغير بيئة أو إلى مرجع مزود مُكوّن (file أو exec)، مع التحقق المسبق السريع قبل الحفظ.
  2. مساحة العمل — موقع ملفات الوكيل (الافتراضي ~/.openclaw/workspace). يزرع ملفات التمهيد.
  3. البوابة — المنفذ، عنوان الربط، وضع المصادقة، تعريض Tailscale. في وضع الرمز التفاعلي، اختر تخزين الرمز كنص عادي افتراضي أو اختر SecretRef. مسار SecretRef للرمز غير التفاعلي: --gateway-token-ref-env <ENV_VAR>.
  4. القنوات — WhatsApp، أو Telegram، أو Discord، أو Google Chat، أو Mattermost، أو Signal، أو BlueBubbles، أو iMessage.
  5. الخدمة الخلفية — تثبيت LaunchAgent (على macOS) أو وحدة مستخدم systemd (على Linux/WSL2). إذا كانت مصادقة الرمز تتطلب رمزًا وكان gateway.auth.token مُدارًا بواسطة SecretRef، فإن تثبيت الخدمة الخلفية يتحقق منه ولكنه لا يحفظ الرمز المُحلّل في بيانات وصفية لبيئة خدمة المشرف. إذا كانت مصادقة الرمز تتطلب رمزًا وكان مرجع SecretRef المُكوّن للرمز غير محلول، يتم حظر تثبيت الخدمة الخلفية مع توجيهات قابلة للتنفيذ. إذا تم تكوين كل من gateway.auth.token و gateway.auth.password ولم يتم تعيين gateway.auth.mode، يتم حظر تثبيت الخدمة الخلفية حتى يتم تعيين الوضع صراحةً.
  6. فحص الصحة — تشغيل البوابة والتحقق من أنها تعمل.
  7. المهارات — تثبيت المهارات الموصى بها والتبعيات الاختيارية.

ℹ️ إعادة تشغيل المعالج لا تمسح أي شيء إلا إذا اخترت صراحةً إعادة تعيين (أو مررت --reset). --reset في CLI يطبق افتراضيًا على التكوين، والمعلومات الاعتمادية، والجلسات؛ استخدم --reset-scope full لتضمين مساحة العمل. إذا كان التكوين غير صالح أو يحتوي على مفاتيح قديمة، يطلب منك المعالج تشغيل openclaw doctor أولاً.

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

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

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

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

ملاحظات:

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

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

للحصول على تفصيلات خطوة بخطوة مفصلة، والبرمجة النصية غير التفاعلية، وإعداد Signal، وواجهة برمجة تطبيقات RPC، وقائمة كاملة بحقول التكوين التي يكتبها المعالج، راجع مرجع المعالج.

وثائق ذات صلة

نظرة عامة على الإعدادالإعداد: تطبيق macOS