openclaw workboard là bề mặt terminal cho
Plugin Workboard được đóng gói sẵn. Nó cho phép người vận hành liệt kê thẻ, tạo
thẻ, xem xét một thẻ, và yêu cầu Gateway đang chạy phân phối công việc sẵn sàng vào
các lượt chạy worker của tác nhân con.
Bật Plugin trước khi dùng lệnh:
Cách dùng
list
| Cờ | Mục đích |
|---|---|
--board <id> | Giới hạn kết quả trong một không gian tên bảng |
--status <status> | Giới hạn kết quả trong một trạng thái Workboard |
--include-archived | Bao gồm thẻ đã lưu trữ trong đầu ra văn bản gọn |
--json | In danh sách thẻ đầy đủ dưới dạng JSON cho máy |
/workboard list. Truyền --include-archived để hiển thị chúng. Đầu ra JSON
giữ danh sách thẻ đầy đủ, bao gồm cả thẻ đã lưu trữ, cho tự động hóa hiện có.
create
| Cờ | Mục đích |
|---|---|
--notes <text> | Ghi chú ban đầu của thẻ |
--status <status> | Trạng thái ban đầu, mặc định todo |
--priority <priority> | Mức ưu tiên, mặc định normal |
--agent <id> | Gán thẻ cho một tác nhân hoặc id chủ sở hữu |
--board <id> | Lưu thẻ trong một không gian tên bảng |
--labels <items> | Nhãn phân tách bằng dấu phẩy |
--json | In thẻ đã tạo dưới dạng JSON cho máy |
create ghi trực tiếp vào trạng thái SQLite của Workboard. Thẻ sẽ ngay lập tức
hiển thị trong tab Workboard của Control UI và với các công cụ Workboard.
show
dispatch
dispatch trước tiên gọi phương thức RPC của Gateway đang chạy
workboard.cards.dispatch. Đường dẫn đó dùng cùng runtime tác nhân con như hành động
phân phối trên dashboard, nên các thẻ sẵn sàng sẽ trở thành các lượt chạy worker được theo dõi theo tác vụ với
khóa phiên được liên kết. Thẻ có tác nhân được gán sẽ dùng khóa phiên tác nhân con theo phạm vi tác nhân;
thẻ chưa được gán giữ khóa tác nhân con không theo phạm vi để tác nhân mặc định đã cấu hình của Gateway
được giữ nguyên.
Vòng lặp phân phối:
- Đưa các thẻ con có dependency sẵn sàng lên
ready. - Chặn claim đã hết hạn hoặc lượt chạy worker đã quá thời gian.
- Ghi siêu dữ liệu phân phối trên các thẻ sẵn sàng.
- Chọn một lô nhỏ các thẻ sẵn sàng chưa được claim.
- Claim từng thẻ đã chọn cho bộ phân phối hoặc tác nhân được gán.
- Bắt đầu một lượt chạy worker tác nhân con với ngữ cảnh thẻ được giới hạn và token claim của thẻ.
- Lưu id lượt chạy worker, khóa phiên, liên kết tác vụ khi sổ cái tác vụ của Gateway báo cáo, trạng thái thực thi, và nhật ký worker trên thẻ.
--url hoặc --token rõ ràng được báo cáo trực tiếp.
Đầu ra văn bản báo cáo các lần khởi động worker:
started và startFailures; fallback chỉ dữ liệu bao gồm
gatewayUnavailable: true. Token claim được biên tập khỏi đầu ra JSON của thẻ.
Trong dashboard, cùng kết quả phân phối được hiển thị dưới dạng tóm tắt ngắn để
người vận hành có thể thấy bao nhiêu thẻ đã bắt đầu, được đưa lên sẵn sàng, bị chặn, được thu hồi, hoặc
thất bại mà không cần mở chi tiết thẻ.
Tương đương với lệnh slash
Các kênh có khả năng lệnh có thể dùng lệnh slash tương ứng:/workboard list và /workboard show là các lệnh đọc dành cho người gửi lệnh được ủy quyền.
/workboard create và /workboard dispatch thay đổi trạng thái bảng và
yêu cầu trạng thái chủ sở hữu trên bề mặt trò chuyện hoặc một client Gateway có operator.write
hoặc operator.admin.
Quyền
Đường dẫn phân phối CLI gọi RPC của Gateway với phạm vioperator.read và
operator.write. Token Gateway chỉ đọc có thể xem dữ liệu Workboard
thông qua các phương thức đọc, nhưng không thể tạo thẻ hoặc phân phối worker.
Các lệnh list, create, và show cục bộ hoạt động trên thư mục trạng thái OpenClaw cục bộ
được hồ sơ hiện tại sử dụng. Dùng --dev hoặc --profile <name> trên lệnh
openclaw cấp cao nhất khi bạn cần một gốc trạng thái khác.
Khắc phục sự cố
Không có thẻ nào xuất hiện
Xác nhận Plugin đã được bật cho cùng hồ sơ và gốc trạng thái:--dev hoặc --profile.
Dispatch báo chỉ dữ liệu
Khởi động hoặc khởi động lại Gateway:openclaw workboard dispatch. Fallback chỉ dữ liệu hữu ích cho việc dọn dẹp
trạng thái cục bộ, nhưng lượt chạy worker cần Gateway đang hoạt động.
Dispatch không khởi động gì
Kiểm tra có ít nhất một thẻready không có claim đang hoạt động:
done, giải phóng claim cũ thông qua các công cụ Workboard,
hoặc chạy phân phối lại sau khi worker đang hoạt động kết thúc.