Raft

Raft یک عامل OpenClaw را از طریق CLI محلی Raft به یک عامل خارجی Raft متصل می‌کند. Raft اعلان‌های بیدارباش احراز هویت‌شده را به Gateway می‌فرستد؛ سپس عامل از CLI ‏Raft برای بررسی و ارسال پیام‌ها استفاده می‌کند. فقط گفت‌وگوی مستقیم (بدون گروه).

نصب

Raft یک Plugin خارجی رسمی است. آن را روی میزبان Gateway نصب کنید:

openclaw plugins install @openclaw/raftopenclaw gateway restart

جزئیات: Pluginها

پیش‌نیازها

• یک فضای کاری 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 بیدارباش را که فقط روی 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
• یکپارچه‌سازی Raft در Hermes