النطاق	الوصف
`main` (افتراضي)	جميع الرسائل المباشرة تشارك الجلسة الرئيسية
`per-peer`	العزل حسب معرف المرسل عبر القنوات
`per-channel-peer`	العزل حسب القناة + المرسل
`per-account-channel-peer`	العزل حسب الحساب + القناة + المرسل

مفاتيح الجلسة

المصدر	تنسيق المفتاح
الدردشات المباشرة	`agent:<agentId>:<mainKey>`
دردشات المجموعات	`agent:<agentId>:<channel>:group:<id>`
مهام كرون	`cron:<job.id>`
Webhooks	`hook:<uuid>`

دورة حياة الجلسة

يُعاد استخدام الجلسات حتى انتهاء صلاحيتها
إعادة التعيين اليومية الافتراضية في الساعة 4:00 صباحًا بالتوقيت المحلي
إعادة تعيين اختيارية عند الخمول عبر idleMinutes

إعداد الوكلاء المتعددين

ما هو الوكيل؟

الوكيل هو عقل محدد النطاق بالكامل مع:

مساحة العمل: الملفات، AGENTS.md، SOUL.md، قواعد الشخصية
دليل الحالة: ملفات تعريف المصادقة، سجل النماذج
مخزن الجلسة: سجل الدردشة + حالة التوجيه
المهارات: لكل وكيل عبر مجلد skills/ في مساحة العمل

وضع الوكيل الواحد (افتراضي)

agentId افتراضيًا هو main
مفاتيح الجلسات بصيغة agent:main:<mainKey>
مساحة العمل في ~/.clawdbot/workspace

إضافة وكلاء

# إضافة وكيل جديد
clawdbot agents add work

# عرض الوكلاء مع الربط
clawdbot agents list --bindings

قواعد التوجيه

يتم توجيه الرسائل إلى الوكلاء عبر الربط:

{
  "bindings": [
    {
      "agentId": "alex",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "dm", "id": "+15551230001" }
      }
    }
  ]
}

معالجة الرسائل

البث والتقسيم

يدعم Clawdbot الاستجابات المتدفقة:

تحديثات الرسائل الجزئية
مؤشرات الكتابة
التسليم المقسم للاستجابات الطويلة

سياسة إعادة المحاولة

يتم إعادة محاولة الرسائل الفاشلة مع:

التراجع الأسي
حدود إعادة المحاولة القابلة للتكوين
معالجة الأخطاء

أين تُخزن الحالة

العنصر	الموقع
التكوين	`~/.clawdbot/clawdbot.json`
الجلسات	`~/.clawdbot/agents/<agentId>/sessions/`
النصوص	`~/.clawdbot/agents/<agentId>/sessions/<SessionId>.jsonl`
ملفات تعريف المصادقة	`~/.clawdbot/agents/<agentId>/agent/auth-profiles.json`

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

بوابة Clawdbot - تكوين البوابة
أدوات Clawdbot - تكوين الأدوات
قنوات Clawdbot - إعداد القنوات

مفاهيم Clawdbot

On this page