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

​
التثبيت

Raft هو Plugin خارجي رسمي. ثبّته على مضيف Gateway: 
openclaw plugins install @openclaw/raft
openclaw 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 check
raft --profile openclaw message send
Raft ليس وسيلة نقل عادية لرسائل الدفع. لا يرسل OpenClaw تلقائيًا النص النهائي للنموذج مرة أخرى عبر الجسر، لذلك يجب على الوكيل استخدام Raft CLI بعد معالجة إيقاظ.

​
التحقق

تحقق من أن OpenClaw يمكنه العثور على CLI وأن لديه ملف تعريفًا مهيأً: 
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
ثم أرسل رسالة إلى وكيل Raft الخارجي. يجب أن يعرض سجل Gateway بدء تشغيل جسر Raft، متبوعًا بإيقاظ وارد. يجب أن يستخدم الوكيل ملف تعريف Raft المهيأ لفحص رسائله المعلّقة.

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

ثبّت Raft CLI على مضيف Gateway واجعل raft متاحًا على PATH الخاص بالخدمة. تحقق منه باستخدام raft --help، ثم أعد تشغيل Gateway.
تحقق من أن ملف التعريف المهيأ مسجّل الدخول وينتمي إلى وكيل Raft الخارجي المقصود. شغّل raft --profile <profile> agent bridge مباشرةً لرؤية تشخيص CLI.
هذا متوقع عندما لا يستدعي الوكيل Raft CLI. لا يحمل جسر الإيقاظ متون الرسائل أو الردود النهائية التلقائية. تحقق من سياسة أدوات الوكيل وتأكد من أنه يستطيع تشغيل raft --profile <profile> message check وmessage send.

​
المراجع