طوف

يدعم Raft ربط وكيل OpenClaw بوكيل Raft خارجي عبر Raft CLI المحلي. يرسل Raft تلميحات إيقاظ موثّقة إلى Gateway. ثم يستخدم الوكيل Raft CLI لفحص الرسائل وإرسالها.

التثبيت

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

openclaw plugins install @openclaw/raftopenclaw gateway restart

التفاصيل: Plugins

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

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

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

التهيئة

اضبط ملف التعريف في الإعدادات:

{  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 setup raft

كيف يعمل

عند بدء تشغيل Gateway، يقوم Plugin بما يلي:

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