هندسة Clawdbot

نظرة عامة على هندسة Clawdbot

يتبع Clawdbot هندسة Gateway-Agent التي تفصل بين نقل الرسائل ومعالجة الذكاء الاصطناعي. يتيح هذا التصميم قابلية التوسع والموثوقية ودعم القنوات المتعددة.

مكونات النظام

طبقة البوابة

بوابة Clawdbot هي المنسق المركزي:

طبقة الوكلاء

يتعامل وكلاء Clawdbot مع معالجة الذكاء الاصطناعي:

تدفق الرسائل

التدفق الوارد

Provider → Gateway → Router → Agent → Runtime

1. يستقبل المزود الرسالة
2. تقوم البوابة بتوحيد التنسيق
3. يختار الموجه الوكيل المستهدف
4. يعالج الوكيل الرسالة
5. يولد وقت التشغيل الاستجابة

التدفق الصادر

Runtime → Agent → Gateway → Provider → User

1. يولد وقت التشغيل الاستجابة
2. يقوم الوكيل بتنسيق الرسالة
3. توجه البوابة إلى المزود
4. يسلم المزود الرسالة

واجهة WebSocket API

الاتصال

const ws = new WebSocket('ws://localhost:3010');

ws.on('open', () => {
  ws.send(JSON.stringify({
    type: 'auth',
    token: 'your-token'
  }));
});

أنواع الرسائل

إدارة الحالة

حالة الجلسة

يحافظ Clawdbot على الحالة في مستويات متعددة:

Global State
  └── Agent State
        └── Session State
              └── Message State

استمرارية الحالة

قابلية التوسع

التوسع الأفقي

يدعم Clawdbot التوسع الأفقي:

• نسخ متعددة من البوابة خلف موازن الحمل
• مخزن جلسات مشترك للاتساق
• معالجة رسائل بدون حالة

حدود الموارد

نموذج الأمان

المصادقة

• مصادقة مفتاح API
• مصادقة WebSocket المستندة إلى الرمز
• بيانات اعتماد لكل مزود

التفويض

• أذونات على مستوى الأداة
• عزل على مستوى الوكيل
• التحكم في الوصول على مستوى الجلسة

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

• بوابة Clawdbot - تكوين البوابة
• مفاهيم Clawdbot - المفاهيم الأساسية
• أدوات Clawdbot - تكوين الأدوات