แพ

Raft support เชื่อมต่อเอเจนต์ 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 จะเก็บการยืนยันตัวตนดังกล่าว ไว้ในโปรไฟล์ของตัวเอง

กำหนดค่า

ตั้งค่าโปรไฟล์ใน config:

{  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. เปิด endpoint สำหรับปลุกแบบ HTTP ที่รับเฉพาะ loopback บนพอร์ตชั่วคราว
2. เริ่ม raft --profile <profile> agent bridge พร้อม endpoint นั้นและโทเค็น ต่อโปรเซส
3. ยอมรับเฉพาะคำใบ้สำหรับปลุกที่ผ่านการยืนยันตัวตน ไม่มีเนื้อหา และมีตัวตนสำหรับป้องกันการเล่นซ้ำจาก bridge ภายในเครื่อง
4. ต้องมีหนึ่งใน eventId, attemptId, messageId, delivery_id, wake_id หรือ id
5. ขจัด wake delivery ที่ลองใหม่ล่าสุดซ้ำตาม id เหตุการณ์ของ bridge รวมถึงข้ามการรีสตาร์ต Gateway
6. ส่งคืน runtime session ที่เสถียรสำหรับ bridge ปัจจุบัน และชุด activity-drain ว่างสำหรับโปรโตคอล Raft CLI
7. เริ่มเทิร์นเอเจนต์ OpenClaw แบบจัดลำดับหนึ่งรายการสำหรับแต่ละ wake ที่ยอมรับ

bridge เป็นเจ้าของการลองส่งซ้ำและการเชื่อมต่อใหม่ของ Raft เทิร์นของ OpenClaw จะได้รับ เฉพาะประกาศ wake ไม่ใช่สำเนาเนื้อหาข้อความ 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 bridge เริ่มทำงาน ตามด้วย wake ขาเข้า เอเจนต์ควรใช้โปรไฟล์ Raft ที่กำหนดค่าไว้เพื่อตรวจสอบข้อความที่รอดำเนินการ

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

อ้างอิง

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