First steps
الإعداد الأولي (تطبيق macOS)
مسار التشغيل الأول لتطبيق macOS: اختر مكان تشغيل Gateway، واتصل بواجهة خلفية موثّقة للذكاء الاصطناعي، وامنح الأذونات، ثم سلّم المهمة إلى طقس التهيئة الخاص بالوكيل. للتعرّف على الإعداد الأولي عبر CLI ومقارنة المسارين، راجع نظرة عامة على الإعداد الأولي.
الموافقة على تحذير macOS
الموافقة على البحث عن الشبكات المحلية
الترحيب وإشعار الأمان
نموذج الثقة الأمنية:
- افتراضيًا، يكون OpenClaw وكيلًا شخصيًا ضمن حدود مشغّل واحد موثوق به.
- تحتاج الإعدادات المشتركة أو متعددة المستخدمين إلى تأمين محكم: افصل حدود الثقة، وحافظ على وصول الأدوات عند الحد الأدنى، واتبع إرشادات الأمان.
- يضبط الإعداد الأولي المحلي الإعدادات الجديدة افتراضيًا على
tools.profile: "coding"، بحيث تحتفظ عمليات الإعداد الجديدة بأدوات نظام الملفات ووقت التشغيل من دون استخدام ملف التعريفfullغير المقيّد. - إذا كانت الخطافات أو Webhook أو مصادر المحتوى الأخرى غير الموثوق بها مفعّلة، فاستخدم فئة قوية وحديثة من النماذج، وحافظ على سياسة صارمة للأدوات والعزل ضمن بيئة اختبار معزولة.
المحلي مقابل البعيد
أين يعمل Gateway؟
- جهاز Mac هذا (محلي فقط): يهيئ الإعداد الأولي المصادقة ويكتب بيانات الاعتماد محليًا.
- بعيد (عبر SSH/Tailnet): لا يهيئ الإعداد الأولي المصادقة المحلية؛
يجب أن تكون بيانات الاعتماد موجودة مسبقًا على مضيف Gateway. يخزّن حقل رمز Gateway البعيد
الرمز الذي يستخدمه تطبيق macOS للاتصال بذلك Gateway؛ وتُحفظ قيم SecretRef الموجودة في
gateway.remote.tokenإلى أن تستبدلها. - التهيئة لاحقًا: تخطَّ الإعداد واترك التطبيق غير مهيأ.
CLI
يثبّت الإعداد المحلي CLI العام openclaw عبر npm أو pnpm أو bun،
مع تفضيل npm أولًا. يظل Node بيئة التشغيل الموصى بها لتشغيل Gateway
نفسه. ويُعاد استخدام عمليات التثبيت المتوافقة الموجودة.
الاتصال بخدمة الذكاء الاصطناعي
يتخطى Gateway المتصل، الذي يحتوي بالفعل على نموذج وكيل مهيأ، هذه الصفحة بالكامل ويفتح واجهة الوكيل المعتادة. ولا يُشغّل إعداد Crestodian وموفّر الخدمة إلا مع Gateway جديد أو غير مكتمل.
بمجرد أن يصبح Gateway جاهزًا، يبحث الإعداد الأولي عن وسائل الوصول إلى الذكاء الاصطناعي المتوفرة لديك بالفعل:
تسجيل دخول Claude Code أو Codex، أو OPENAI_API_KEY /
ANTHROPIC_API_KEY. يُختبر أفضل خيار بإكمال حقيقي، ولا يُحفظ
إلا بعد أن يستجيب؛ وعند فشل الاختبار، يجرّب التطبيق تلقائيًا
الخيار التالي ويوضح سبب فشل الخيار السابق. وإذا عُثر على عدة خيارات،
يمكنك التبديل بينها قبل المتابعة.
يظل Gemini CLI متاحًا للوكلاء العاديين بعد الإعداد، لكنه لا يُعرض هنا لأنه لا يستطيع فرض اختبار استدلال من دون أدوات.
يمكنك أيضًا تسجيل الدخول من خلال مسار OAuth أو إقران الجهاز الخاص بالموفّر. تتضمن الخيارات المدمجة OpenAI/ChatGPT وOpenRouter وGitHub Copilot وGoogle Gemini CLI وxAI وMiniMax Global وCN وChutes. تأتي القائمة من Plugins موفّري استدلال النص النشطين في Gateway بدلًا من قائمة ثابتة في التطبيق، وبذلك يمكن لموفّر آخر الاشتراك من دون إضافة تعليمات برمجية خاصة به إلى macOS.
يستخدم منتقي المفتاح/الرمز اليدوي سجل الموفّرين نفسه. في كل مسار، يوفر الموفّر نموذج البدء والتهيئة الخاصة به؛ ويتحقق OpenClaw من بيانات الاعتماد باستخدام الاختبار المباشر نفسه قبل تخزين ملف تعريف المصادقة. يظل زر Next مقفلًا إلى أن تجتاز إحدى الواجهات الخلفية الاختبار، ولذلك لا يمكن أن تبدأ أول محادثة للوكيل من دون استدلال يعمل. بعد اجتياز ذلك الفحص المباشر، يصبح Crestodian متاحًا للمساعدة في تهيئة بقية مساحة العمل وGateway والقنوات والميزات الاختيارية الأخرى؛ ويظل متاحًا أيضًا لاحقًا ضمن Settings → Crestodian.
الأذونات
يطلب الإعداد الأولي أذونات TCC التالية: الأتمتة (AppleScript)، والإشعارات، وتسهيلات الاستخدام، وتسجيل الشاشة، والميكروفون، والتعرّف على الكلام، والكاميرا، والموقع.
الإنهاء
بعد اجتياز الاستدلال للاختبار، يتولى Crestodian بقية الإعداد الاختياري ويمكنه نقلك إلى محادثة الوكيل المعتادة. يؤدي إكمال استعراض الأذونات إلى فتح المحادثة نفسها؛ ولا ينشئ التطبيق مساحة عمل أو يبدأ محادثة منفصلة لإعداد الوكيل قبل Crestodian. راجع التهيئة الأولية لمعرفة ما يحدث على مضيف Gateway أثناء أول دورة فعلية للوكيل.
