Raft

Hỗ trợ Raft kết nối một tác nhân OpenClaw với Raft External Agent thông qua Raft CLI cục bộ. Raft gửi các gợi ý đánh thức đã xác thực đến Gateway. Sau đó tác nhân dùng Raft CLI để kiểm tra và gửi tin nhắn.

Cài đặt

Raft là một Plugin bên ngoài chính thức. Cài đặt trên máy chủ Gateway:

openclaw plugins install @openclaw/raftopenclaw gateway restart

Chi tiết: Plugin

Điều kiện tiên quyết

• Một không gian làm việc Raft có External Agent.
• Raft CLI được cài đặt trên cùng máy chủ với OpenClaw Gateway.
• Một hồ sơ Raft CLI đã đăng nhập và được liên kết với External Agent đó.

Plugin không lưu trữ thông tin xác thực Raft. Raft CLI giữ xác thực đó trong hồ sơ riêng của nó.

Cấu hình

Đặt hồ sơ trong cấu hình:

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

Với tài khoản mặc định, bạn cũng có thể đặt RAFT_PROFILE trong môi trường Gateway:

RAFT_PROFILE=openclaw

Dùng tài khoản có tên khi một Gateway kết nối với nhiều Raft External Agent:

{  channels: {    raft: {      accounts: {        support: {          profile: "support-agent",        },        engineering: {          profile: "engineering-agent",        },      },    },  },}

Luồng thiết lập tương tác ghi lại cùng hồ sơ:

openclaw channels setup raft

Cách hoạt động

Khi Gateway khởi động, Plugin:

1. Mở một điểm cuối HTTP đánh thức chỉ cho loopback trên một cổng tạm thời.
2. Khởi động raft --profile <profile> agent bridge với điểm cuối đó và một token riêng cho từng tiến trình.
3. Chỉ chấp nhận các gợi ý đánh thức đã xác thực, không có nội dung, có định danh chống phát lại từ cầu nối cục bộ.
4. Yêu cầu một trong các giá trị eventId, attemptId, messageId, delivery_id, wake_id, hoặc id.
5. Khử trùng lặp các lượt phân phối đánh thức được thử lại gần đây theo id sự kiện cầu nối, bao gồm cả sau khi Gateway khởi động lại.
6. Trả về một phiên thời gian chạy ổn định cho cầu nối hiện tại và một lô rút hoạt động trống cho giao thức Raft CLI.
7. Khởi động một lượt tác nhân OpenClaw được tuần tự hóa cho mỗi lần đánh thức được chấp nhận.

Cầu nối sở hữu việc thử lại và kết nối lại phân phối của Raft. Lượt OpenClaw chỉ nhận một thông báo đánh thức, không phải nội dung tin nhắn Raft được sao chép. Nó dùng CLI để đọc các tin nhắn đang chờ và gửi phản hồi:

raft --profile openclaw message checkraft --profile openclaw message send

Xác minh

Kiểm tra rằng OpenClaw có thể tìm thấy CLI và có hồ sơ đã cấu hình:

openclaw channels status --probeopenclaw plugins inspect raft --runtime --json

Sau đó gửi một tin nhắn đến Raft External Agent. Nhật ký Gateway sẽ hiển thị cầu nối Raft khởi động, tiếp theo là một lần đánh thức đến. Tác nhân nên dùng hồ sơ Raft đã cấu hình để kiểm tra các tin nhắn đang chờ.

Khắc phục sự cố

Tham khảo

• Raft
• Tài liệu Raft
• Tích hợp Hermes Raft