رَفت

يربط Raft وكيل OpenClaw بوكيل Raft خارجي عبر CLI المحلي لـ Raft. يرسل Raft تلميحات تنبيه مصادَقًا عليها إلى Gateway؛ ثم يستخدم الوكيل CLI لـ Raft للتحقق من الرسائل وإرسالها. المحادثات المباشرة فقط (من دون مجموعات).

التثبيت

Raft هو Plugin خارجي رسمي. ثبّته على مضيف Gateway:

openclaw plugins install @openclaw/raftopenclaw gateway restart

التفاصيل: الإضافات

المتطلبات الأساسية

• مساحة عمل Raft تحتوي على وكيل خارجي.
• تثبيت CLI لـ Raft على المضيف نفسه الذي يشغّل Gateway الخاص بـ OpenClaw، وأن يكون متاحًا ضمن PATH الخاص بالخدمة.
• ملف تعريف في CLI لـ Raft سبق تسجيل الدخول إليه وربطه بذلك الوكيل الخارجي.

لا يخزّن Plugin بيانات اعتماد Raft؛ إذ يحتفظ CLI لـ Raft بهذه المصادقة في ملف تعريفه الخاص.

الإعداد

عيّن ملف التعريف في الإعدادات:

{  channels: {    raft: {      enabled: true,      profile: "openclaw",    },  },}

بالنسبة إلى الحساب الافتراضي، يمكنك بدلًا من ذلك تعيين RAFT_PROFILE في بيئة Gateway:

RAFT_PROFILE=openclaw

استخدم حسابًا مسمّى عندما يتصل Gateway واحد بأكثر من وكيل Raft خارجي:

{  channels: {    raft: {      accounts: {        support: {          profile: "support-agent",        },        engineering: {          profile: "engineering-agent",        },      },    },  },}

يسجّل الإعداد التفاعلي ملف التعريف نفسه:

openclaw channels add --channel raft

آلية العمل

عند بدء تشغيل Gateway، ينفّذ Plugin ما يلي:

1. يفتح نقطة نهاية HTTP للتنبيه مقتصرة على local loopback عبر منفذ مؤقت.
2. يشغّل raft --profile <profile> agent bridge باستخدام نقطة النهاية هذه ورمز مميز خاص بكل عملية.
3. لا يقبل إلا تلميحات تنبيه مصادَقًا عليها وخالية من المحتوى، وتحمل هوية لمنع إعادة التشغيل، من الجسر المحلي.
4. يشترط وجود أحد الحقول eventId أو attemptId أو messageId أو delivery_id أو wake_id أو id في كل حمولة تنبيه.
5. يزيل تكرار عمليات تسليم التنبيه المعاد إرسالها استنادًا إلى معرّف حدث الجسر لمدة 24 ساعة، بما في ذلك عبر عمليات إعادة تشغيل Gateway.
6. يعيد جلسة وقت تشغيل مستقرة للجسر الحالي ودفعة فارغة لتفريغ النشاط لبروتوكول CLI لـ Raft.
7. يبدأ دورة واحدة متسلسلة لوكيل OpenClaw لكل تنبيه مقبول.

يتولى الجسر إعادة محاولات التسليم وإعادة الاتصال في Raft. لا تتلقى دورة OpenClaw سوى إشعار تنبيه، وليس نسخة من نص رسالة Raft. وتستخدم CLI لقراءة الرسائل المعلّقة وإرسال ردها:

raft --profile openclaw message checkraft --profile openclaw message send

التحقق

تحقق من أن OpenClaw يستطيع العثور على CLI وأن لديه ملف تعريف مُعدًا:

openclaw channels status --probeopenclaw plugins inspect raft --runtime --json

ثم أرسل رسالة إلى وكيل Raft الخارجي. ينبغي أن يعرض سجل Gateway بدء تشغيل جسر Raft، يتبعه تنبيه وارد. وينبغي أن يستخدم الوكيل ملف تعريف Raft المُعد للتحقق من رسائله المعلّقة.

استكشاف الأخطاء وإصلاحها

المراجع

• Raft
• وثائق Raft
• تكامل Hermes مع Raft