معالج الإعداد (CLI)
استخدم معالج CLI لتكوين Clawdbot مع إعداد موجه للبوابة والقنوات والمهارات وإعدادات مساحة العمل الافتراضية.
نظرة عامة
معالج الإعداد هو طريقة الإعداد الموصى بها لـ Clawdbot على macOS أو Linux أو Windows (عبر WSL2). يوفر مسار تكوين موجه لاتصالات البوابة المحلية أو البعيدة والقنوات والمهارات وإعدادات مساحة العمل الافتراضية.
الأوامر الرئيسية
| الأمر | الوصف |
|---|---|
clawdbot onboard | معالج الإعداد الرئيسي |
clawdbot dashboard | يفتح واجهة التحكم للدردشة عبر المتصفح |
clawdbot configure | إعادة تكوين التثبيت الحالي |
clawdbot configure --section web | تكوين البحث على الويب (Brave Search API) |
أوضاع الإعداد
البدء السريع (موصى به)
التكوين الافتراضي لمعظم المستخدمين:
- بوابة محلية على العنوان المحلي
- المنفذ 18789 مع مصادقة بالرمز
- الرسائل المباشرة لـ Telegram/WhatsApp تستخدم وضع قائمة السماح
الوضع المتقدم
تحكم كامل في جميع خطوات التكوين للمستخدمين المتقدمين.
مسار التكوين
1. كشف التكوين الحالي
يكتشف المعالج ~/.clawdbot/clawdbot.json ويعرض:
- الاحتفاظ - استخدام التكوين الحالي
- التعديل - تحديث إعدادات محددة
- إعادة التعيين - البدء من جديد
2. النموذج والمصادقة
اختر مزود الذكاء الاصطناعي الخاص بك:
| المزود | الوصف |
|---|---|
| Anthropic API Key | موصى به لأفضل أداء |
| Anthropic OAuth | لمشتركي Claude Pro/Max |
| OpenAI API Key | GPT-4 ونماذج أخرى |
| OpenAI Codex | اشتراك يركز على الكود |
| Vercel AI Gateway | خيار الوكيل |
| النماذج المحلية | التشغيل بدون اتصال |
3. إعداد مساحة العمل
مساحة العمل الافتراضية: ~/.clawdbot/workspace
ملفات التمهيد المُنشأة:
AGENTS.md- تكوين الوكيلSOUL.md- إعدادات الشخصيةTOOLS.md- الأدوات المتاحةIDENTITY.md- معلومات الهوية
4. تكوين البوابة
قم بتكوين إعدادات البوابة الخاصة بك:
- المنفذ: افتراضي 18789
- عنوان الربط: محلي أو شبكة
- وضع المصادقة: قائم على الرمز (موصى به)
- Tailscale: كشف بعيد اختياري
5. إعداد القنوات
تكاملات اختيارية:
- Telegram
- Discord
- Slack
- Signal
- iMessage
- Google Chat
- Mattermost
6. تثبيت الخدمة
- macOS: LaunchAgent
- Linux/WSL2: وحدة مستخدم systemd
7. فحص الصحة
التحقق من بدء تشغيل البوابة والاتصال.
8. تثبيت المهارات
حزم مهارات اختيارية عبر npm/pnpm.
الوضع البعيد
الاتصال ببوابة موجودة تعمل في مكان آخر:
clawdbot onboard --remoteلا يتم إجراء أي تثبيت على المضيف البعيد - يقوم فقط بتكوين اتصال العميل المحلي.
الوضع غير التفاعلي
للأتمتة والبرمجة النصية:
clawdbot onboard --non-interactive \
--auth-choice anthropic \
--anthropic-api-key $ANTHROPIC_API_KEYوكلاء متعددون
إنشاء نسخ وكيل معزولة:
clawdbot agents add work
clawdbot agents add personal
clawdbot agents listلكل وكيل مساحة عمل وتكوين خاصين به.
الخطوات التالية
- دليل الإعداد - تعليمات إعداد مفصلة
- الربط - تكوين التحكم في الوصول
- القنوات - إعداد تكاملات المراسلة