إعداد تطبيق macOS

نظرة عامة

يصف هذا الدليل تجربة الإعداد للتشغيل الأول لتطبيق Clawdbot على macOS، ويغطي الإعداد من الإطلاق الأولي حتى تمهيد الوكيل.

مسار الإعداد

يتبع الإعداد 8 خطوات:

الخطوة 1: الترحيب

شاشة الترحيب الأولية مع إشعار أمني حول قدرات Clawdbot.

الخطوة 2: اختيار البوابة

اختر وضع البوابة الخاص بك:

الخطوة 3: المصادقة

للإعدادات المحلية، قم بالمصادقة مع مزود الذكاء الاصطناعي الخاص بك:

• Anthropic OAuth - لمشتركي Claude Pro/Max
• Anthropic API Key - الوصول المباشر لـ API
• OpenAI - نماذج GPT
• مزودون آخرون - خيارات متنوعة

يفتح مسار OAuth متصفحك لمصادقة PKCE. الصق قيمة الكود/الحالة عند الطلب.

بيانات الاعتماد محفوظة في: ~/.clawdbot/credentials/oauth.json

الخطوة 4: معالج الإعداد

تكوين موجه بواسطة البوابة لـ:

• إعدادات المنفذ والشبكة
• تكاملات القنوات
• تثبيت المهارات

الخطوة 5: الأذونات

يتطلب macOS منح أذونات صريحة:

امنح الأذونات كما هو مطلوب. بعض الميزات تتطلب أذونات محددة للعمل.

الخطوة 6: تثبيت CLI

تثبيت اختياري لأمر clawdbot العام:

# مثبت في /usr/local/bin/clawdbot
clawdbot --version

الخطوة 7: محادثة الإعداد

جلسة مخصصة لتقديم الوكيل:

• ينشئ الوكيل مساحة العمل (~/.clawdbot/workspace)
• يبذر الملفات الأولية: AGENTS.md، BOOTSTRAP.md، IDENTITY.md، USER.md
• يجري أسئلة وأجوبة لتخصيص تجربتك
• يتعلم تفضيلاتك وحالات الاستخدام

الخطوة 8: جاهز

اكتمل الإعداد. يمكنك الآن:

• الدردشة مع مساعدك
• تكوين قنوات إضافية
• تثبيت المهارات
• تخصيص مساحة عملك

أوضاع البوابة

الوضع المحلي

• تعمل البوابة على Mac الخاص بك
• تعمل مسارات OAuth مباشرة
• بيانات الاعتماد محفوظة محلياً
• الأفضل للاستخدام الشخصي

الوضع البعيد

عند استخدام بوابة بعيدة:

• جميع بيانات الاعتماد موجودة على مضيف البوابة
• ملفات مساحة العمل على الجهاز البعيد
• يعمل Mac المحلي كعميل فقط
• مفيد للنشر المشترك أو على الخادم

تمهيد الوكيل

عند التشغيل الأول، يقوم الوكيل بـ:

1. إنشاء دليل مساحة العمل
2. بذر ملفات التعليمات
3. إجراء أسئلة وأجوبة التخصيص
4. تكوين التفضيلات الأولية

ملفات التمهيد

استكشاف الأخطاء

مشاكل الأذونات

إذا لم تعمل الميزات:

1. افتح تفضيلات النظام ← الخصوصية والأمان
2. تحقق من كل فئة أذونات
3. تأكد من تمكين Clawdbot
4. أعد تشغيل التطبيق إذا لزم الأمر

فشل OAuth

إذا فشلت المصادقة:

1. تحقق من اتصالك بالإنترنت
2. تحقق من حالة اشتراكك
3. جرب إدخال مفتاح API يدوياً
4. تحقق من ~/.clawdbot/credentials/ للمشاكل

البوابة لا تبدأ

1. تحقق مما إذا كان المنفذ 18789 متاحاً
2. راجع السجلات في /tmp/clawdbot/
3. جرب clawdbot health من الطرفية

الخطوات التالية

• دليل الإعداد - تكوين مفصل
• بناء مساعد - أنشئ مساعدك
• القنوات - ربط منصات المراسلة