แพลอยน้ำ

Raft เชื่อมต่อเอเจนต์ OpenClaw กับ Raft External Agent ผ่าน Raft CLI ภายในเครื่อง Raft ส่งสัญญาณปลุกที่ผ่านการยืนยันตัวตนไปยัง Gateway จากนั้นเอเจนต์จะ ใช้ Raft CLI เพื่อตรวจสอบและส่งข้อความ รองรับเฉพาะแชตโดยตรง (ไม่รองรับกลุ่ม)

การติดตั้ง

Raft เป็น Plugin ภายนอกอย่างเป็นทางการ ติดตั้งบนโฮสต์ Gateway:

openclaw plugins install @openclaw/raftopenclaw gateway restart

รายละเอียด: Plugin

ข้อกำหนดเบื้องต้น

• พื้นที่ทำงาน Raft ที่มี External Agent
• ติดตั้ง Raft CLI บนโฮสต์เดียวกับ Gateway ของ OpenClaw และอยู่ใน PATH ของบริการ
• โปรไฟล์ Raft CLI ที่ลงชื่อเข้าใช้แล้วและเชื่อมโยงกับ External Agent นั้น

Plugin ไม่จัดเก็บข้อมูลประจำตัวของ Raft โดย Raft CLI จะเก็บ ข้อมูลการยืนยันตัวตนดังกล่าวไว้ในโปรไฟล์ของตนเอง

การกำหนดค่า

ตั้งค่าโปรไฟล์ในการกำหนดค่า:

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

สำหรับบัญชีเริ่มต้น คุณสามารถตั้งค่า RAFT_PROFILE ในสภาพแวดล้อมของ Gateway แทนได้:

RAFT_PROFILE=openclaw

ใช้บัญชีที่มีชื่อเมื่อ Gateway หนึ่งรายการเชื่อมต่อกับ Raft External Agent มากกว่าหนึ่งรายการ:

{  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. ส่งคืนเซสชันรันไทม์ที่คงที่สำหรับบริดจ์ปัจจุบันและ ชุดระบายกิจกรรมที่ว่างเปล่าสำหรับโปรโตคอล 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 External Agent บันทึกของ Gateway ควรแสดง การเริ่มต้นบริดจ์ Raft ตามด้วยสัญญาณปลุกขาเข้า เอเจนต์ควรใช้ โปรไฟล์ Raft ที่กำหนดค่าไว้เพื่อตรวจสอบข้อความที่รอดำเนินการ

การแก้ไขปัญหา

แหล่งอ้างอิง

• Raft
• เอกสาร Raft
• การผสานรวม Hermes กับ Raft