Plugin bảng công việc

Plugin Workboard bổ sung một bảng kiểu Kanban tùy chọn vào UI điều khiển: các thẻ công việc có kích thước phù hợp với agent, khả năng phân công cho agent và liên kết trở lại tác vụ, lượt chạy và phiên bảng điều khiển của thẻ.

Workboard được thiết kế nhỏ gọn: nó theo dõi công việc vận hành cục bộ cho một OpenClaw Gateway. Nó không thay thế GitHub Issues, Linear, Jira hoặc các hệ thống quản lý dự án nhóm khác.

Bật Workboard

Workboard được đóng gói sẵn nhưng bị tắt theo mặc định:

1. Mở Plugins trong UI điều khiển hoặc sử dụng /settings/plugins tương ứng với đường dẫn cơ sở đã cấu hình của UI điều khiển. Ví dụ, đường dẫn cơ sở /openclaw sử dụng /openclaw/settings/plugins.
2. Tìm Workboard và chọn Enable. Vì Workboard được tích hợp trong OpenClaw nên không cần thao tác Install.
3. Nếu UI thông báo cần khởi động lại, hãy khởi động lại Gateway.

Thẻ Workboard xuất hiện trong thanh điều hướng của bảng điều khiển sau khi runtime của plugin tải xong. Khi Workboard bị tắt, thẻ này vẫn bị ẩn khỏi thanh điều hướng. Việc mở trực tiếp tuyến /workboard khi plugin bị tắt hoặc bị chặn bởi plugins.allow/plugins.deny sẽ hiển thị trạng thái plugin không khả dụng thay vì dữ liệu thẻ.

Quy trình CLI tương đương là:

openclaw plugins enable workboardopenclaw gateway restartopenclaw dashboard

Cấu hình

Workboard không có cấu hình dành riêng cho plugin. Bật/tắt nó bằng mục nhập plugin tiêu chuẩn:

{  plugins: {    entries: {      workboard: {        enabled: true,        config: {},      },    },  },}

openclaw plugins disable workboardopenclaw gateway restart

Trường của thẻ

Các thẻ cũng chứa siêu dữ liệu cô đọng về các lần thử, bình luận, liên kết, bằng chứng, thành phần tạo tác, cài đặt tự động hóa, tệp đính kèm, nhật ký worker, trạng thái giao thức worker, quyền tiếp nhận, thông tin chẩn đoán, thông báo, mã mẫu, trạng thái lưu trữ và khả năng phát hiện phiên cũ, cùng danh sách sự kiện gần đây (created, edited, moved, linked, specified, decomposed, claimed, heartbeat, execution_updated, attempt_started, attempt_updated, comment_added, link_added, proof_added, artifact_added, attachment_added, diagnostic, notification, dispatch, orchestration, protocol_violation, archived, unarchived, stale). Siêu dữ liệu này cho phép người vận hành xem thẻ đã di chuyển qua bảng như thế nào mà không cần mở phiên được liên kết; đây là ngữ cảnh vận hành cục bộ, không thay thế bản ghi phiên hoặc lịch sử issue GitHub.

Plugin và UI điều khiển sử dụng chung một hợp đồng thẻ Workboard. Do đó, các lần làm mới bảng điều khiển giữ nguyên nguồn gốc và thẩm quyền của không gian làm việc, trạng thái tiếp nhận, các thao tác chẩn đoán và số thứ tự thông báo, thay vì tạo một bản sao thu nhỏ chỉ dành cho UI của thẻ. Các loại chẩn đoán, mức độ nghiêm trọng của chẩn đoán và loại thông báo chưa xác định sẽ bị bỏ qua cho đến khi cả hai bề mặt hỗ trợ chúng; chúng không bao giờ bị viết lại thành một trạng thái hợp lệ khác.

Bảng điều khiển đang mở cập nhật từ các sự kiện vô hiệu hóa plugin.workboard.changed. Mỗi sự kiện chỉ chứa epoch và bản sửa đổi của kho lưu trữ; sau đó UI đọc lại các thẻ chính tắc thông qua RPC operator.read thông thường. Nhiều bản sửa đổi được hợp nhất thành một lần đọc tiếp theo. Workboard trì hoãn lần đọc đó khi thẻ đang được kéo, chỉnh sửa hoặc ghi, rồi tiếp tục sau khi tương tác cục bộ hoàn tất. Mỗi lần kết nối lại luôn thực hiện tải lại dữ liệu chính tắc. Không có hoạt động thăm dò toàn bộ thẻ định kỳ và Refresh vẫn khả dụng để khôi phục thủ công.

Khi có nhiều bảng, thanh công cụ bao gồm bộ lọc Board dựa trên siêu dữ liệu bảng được duy trì, thay vì chỉ dựa trên các thẻ hiện đang hiển thị. Vì vậy, các bảng trống và đã lưu trữ vẫn có thể được chọn. Các thẻ không có mã bảng rõ ràng thuộc về bảng default chính tắc. Bảng được chọn được lưu trong tham số truy vấn ?board=, nên URL Workboard đã lọc có thể được đánh dấu hoặc chia sẻ; chọn All boards sẽ xóa tham số này.

Các thẻ được lưu trữ trong trạng thái Gateway riêng của plugin và di chuyển cùng với phần còn lại của trạng thái OpenClaw thuộc Gateway đó (xem Lưu trữ).

Bắt đầu công việc từ một thẻ

Các thẻ chưa liên kết có thể bắt đầu công việc trực tiếp:

• Run Codex / Run Claude bắt đầu một lượt chạy agent được theo dõi bằng tác vụ với công cụ được chỉ định rõ ràng, gửi lời nhắc của thẻ và đánh dấu thẻ là running. Các lượt chạy Codex sử dụng openai/gpt-5.6-sol; các lượt chạy Claude sử dụng anthropic/claude-sonnet-4-6.
• Open Codex / Open Claude tạo một phiên bảng điều khiển được liên kết mà không gửi lời nhắc của thẻ hoặc di chuyển thẻ, dành cho công việc thủ công vẫn được gắn với bảng.

Các lượt bắt đầu tự động sử dụng đường dẫn lượt chạy agent được Gateway theo dõi bằng tác vụ (agent và mô hình mặc định, trừ khi Codex/Claude được chọn rõ ràng); sau đó Workboard liên kết tác vụ, mã lượt chạy và khóa phiên thu được trở lại thẻ. Mỗi lượt thực thi được liên kết cũng ghi lại phần tóm tắt lần thử (công cụ, chế độ, mô hình, mã lượt chạy, dấu thời gian, trạng thái, số lần thất bại liên tiếp) để các lỗi lặp lại luôn hiển thị.

Bảng điều khiển làm mới trạng thái tác vụ từ sổ cái tác vụ của Gateway, đối chiếu tác vụ với thẻ theo mã tác vụ, mã lượt chạy hoặc khóa phiên được liên kết. Một tác vụ đang xếp hàng/đang chạy giữ cho vòng đời của thẻ hoạt động; một tác vụ đã hoàn tất, thất bại, hết thời gian chờ hoặc bị hủy sẽ chuyển thẻ về phía review hoặc blocked theo cùng quy tắc đồng bộ như các phiên được liên kết (xem Đồng bộ vòng đời phiên).

Công cụ agent

Trạng thái bằng chứng là kết quả do worker báo cáo, không phải xác minh độc lập. Một mục passed có nghĩa là worker báo cáo lệnh hoặc bước kiểm tra của mình đã thành công; các bên sử dụng cần cổng chất lượng độc lập nên kiểm tra lệnh, URL hoặc hiện vật được đính kèm và chạy trình xác minh riêng. workboard_proof trả về proofId của bản ghi mới. Khi workboard_complete báo cáo trạng thái kết thúc của chính bằng chứng đó, hãy truyền proofId để bản ghi đang chờ được giải quyết tại chỗ mà không mất danh tính hoặc dấu thời gian. Bằng chứng đã có cùng trạng thái kết thúc sẽ được tái sử dụng mà không thay đổi. Bằng chứng hoàn tất không có proofId vẫn chỉ cho phép nối thêm, vì vậy lần thử lại sau này không thể ghi đè lịch sử cũ chỉ vì lệnh hoặc ghi chú của nó giống hệt nhau.

Các thẻ đã được xác nhận từ chối thao tác bằng công cụ agent từ các agent khác, trừ khi bên gọi giữ token xác nhận do workboard_claim trả về. Mọi thẻ được trả về bởi công cụ agent hoặc lệnh gọi RPC của Gateway đều che metadata.claim.token thành [redacted] (bản thân token chỉ được trả về một lần, ở cấp cao nhất, và chỉ từ workboard_claim), để người vận hành dashboard và các agent khác có thể kiểm tra trạng thái xác nhận mà không bao giờ thấy token có thể sử dụng. Việc khôi phục được thực hiện thông qua workboard_promote/workboard_reassign/workboard_reclaim, những thao tác này không yêu cầu token.

Điều phối

Điều phối diễn ra cục bộ trong Gateway: không tạo các tiến trình hệ điều hành tùy ý. Các phiên subagent thông thường của OpenClaw vẫn chịu trách nhiệm thực thi. Một lượt điều phối:

1. Nâng cấp các thẻ có phụ thuộc đã sẵn sàng.
2. Ghi lại siêu dữ liệu điều phối trên các thẻ sẵn sàng.
3. Chặn các xác nhận đã hết hạn hoặc lượt chạy quá thời gian.
4. Đánh dấu các thẻ phân loại do bảng cấu hình làm ứng viên điều phối.
5. Xác nhận một lô nhỏ các thẻ sẵn sàng và bắt đầu lượt chạy worker thông qua runtime subagent của Gateway.

Worker nhận ngữ cảnh thẻ giới hạn cùng token xác nhận cần thiết để gửi Heartbeat, hoàn tất hoặc chặn thẻ thông qua các công cụ Workboard.

Đường dẫn workspace tuân theo quyền hệ thống tệp hiện có của bên gọi. Máy khách Gateway có operator.write có thể sử dụng các workspace của agent đã cấu hình; máy khách operator.admin có thể sử dụng các checkout khác trên máy chủ. Công cụ agent trong sandbox sử dụng quyền truy cập workspace của sandbox, còn công cụ chỉ dành cho workspace không nằm trong sandbox sử dụng thư mục gốc workspace đã cấu hình. Workboard ghi lại quyền đó khi một workspace được chỉ định và lấy phần giao với quyền hiện tại của bên gọi một lần nữa khi điều phối, vì vậy thẻ được lưu bền vững không thể mở rộng quyền truy cập của bên gọi sau này. Các thẻ cũ có workspace máy chủ rõ ràng nhưng không ghi lại quyền phải lưu lại workspace đó trước khi điều phối toàn máy chủ; các thẻ không có đường dẫn máy chủ sẽ tiếp nhận quyền của bên gọi hiện tại khi được điều phối lần đầu.

Điều phối gắn với workspace chỉ chấp nhận một thư mục hoặc checkout Git khi thư mục gốc kho lưu trữ của nó khớp chính xác với workspace của agent đích. Yêu cầu worktree được thu hẹp vào thư mục đó và lưu bền vững dưới dạng workspace thư mục, để máy chủ không hiện thực hóa checkout hoặc thực thi mã thiết lập kho lưu trữ. Worker đích phải sử dụng sandbox Docker có thể ghi, không dùng chung cho chính xác workspace đó, không có thực thi nâng quyền, các ghi đè thực thi máy chủ/node được lưu bền vững hoặc các công cụ plugin và MCP chưa được phân loại. Workboard liệt kê các công cụ đã đăng ký thay vì tin cậy tiền tố workboard_*, và việc điều phối từ chối một container Docker đang hoạt động có hàm băm mount/cấu hình trực tiếp đã lỗi thời. Điều phối báo cáo chính sách đích không tương thích thay vì khởi động một worker ít bị giới hạn hơn. Điều phối toàn máy chủ có thể nhắm đến các checkout cục bộ khác và giữ nguyên quy trình thiết lập worktree được quản lý thông thường.

Quyền workspace không tạo ra mô hình quyền vòng đời thẻ thứ hai. Các bên gọi có thể thay đổi thẻ Workboard có thể di chuyển chúng theo cách thủ công qua cùng các trạng thái trên mọi bề mặt; quyền truy cập workspace chỉ đọc chỉ ngăn việc điều phối worker cần quyền ghi.

Lựa chọn worker

Mỗi lượt chạy bắt đầu tối đa 3 worker theo mặc định. Các thẻ sẵn sàng được sắp xếp theo mức ưu tiên, sau đó là vị trí, rồi thời điểm tạo. Một lượt chạy chỉ bắt đầu một thẻ cho mỗi chủ sở hữu/agent và bỏ qua các chủ sở hữu đã có công việc đang chạy hoặc đang được review trên bảng. Các thẻ đã lưu trữ, thẻ có claim đang hoạt động và thẻ không ở trạng thái ready không bao giờ được chọn để khởi động worker (chúng vẫn có thể chịu tác động từ phía dữ liệu của quá trình điều phối: dọn dẹp claim cũ, thăng cấp phần phụ thuộc, dọn dẹp do hết thời gian chờ).

Khóa phiên được xác định tất định theo từng bảng/thẻ, vì vậy các lần điều phối lặp lại sẽ định tuyến về cùng một làn worker thay vì tạo các phiên không liên quan:

• Thẻ đã được giao: agent:<agentId>:subagent:workboard-<boardId>-<cardId>
• Thẻ chưa được giao: subagent:workboard-<boardId>-<cardId> (Gateway phân giải agent mặc định đã cấu hình)

Nếu không thể khởi động worker sau khi một thẻ được claim, Workboard sẽ chặn thẻ, xóa claim, ghi lại lỗi khởi động lượt chạy và thêm một dòng nhật ký worker — hiển thị trong bảng điều khiển, JSON của CLI, công cụ agent và phần chẩn đoán thẻ.

Điểm truy cập

• Thao tác điều phối trên bảng điều khiển
• openclaw workboard dispatch
• /workboard dispatch trên một kênh hỗ trợ lệnh

Cả ba đều sử dụng runtime subagent của Gateway khi Gateway khả dụng. CLI có một cơ chế dự phòng dành cho người vận hành: nếu lệnh gọi Gateway thất bại do lỗi kết nối/không khả dụng (hoặc lỗi unknown method đối với các Gateway cũ hơn), đồng thời không có đích --url/--token rõ ràng và không áp dụng Gateway từ xa đã cấu hình (OPENCLAW_GATEWAY_URL hoặc gateway.mode: remote), CLI sẽ chạy quá trình điều phối chỉ dữ liệu đối với trạng thái SQLite cục bộ — có thể thăng cấp các phần phụ thuộc, dọn dẹp claim cũ và chặn các lượt chạy hết thời gian chờ, nhưng không thể khởi động worker. Các lỗi xác thực, quyền và xác thực dữ liệu từ một Gateway có thể truy cập không được coi là không khả dụng; chúng xuất hiện dưới dạng lỗi lệnh, tương tự mọi lỗi Gateway khi đã cung cấp đích --url/--token rõ ràng.

Siêu dữ liệu bảng có thể đặt autoDecompose, autoDecomposePerDispatch, defaultAssignee và orchestratorProfile. OpenClaw ghi lại ý định này và đưa nó vào ngữ cảnh worker; quá trình đặc tả/phân rã thực tế vẫn được thực hiện thông qua các công cụ Workboard thông thường.

CLI và lệnh gạch chéo

openclaw workboard list [--board <id>] [--status <status>] [--include-archived] [--json]openclaw workboard create "Fix stale card lifecycle" --priority high --labels bug,workboardopenclaw workboard show <card-id> [--json]openclaw workboard move <card-id> --status <status> [--json]openclaw workboard dispatch [--board <id>] [--json]

Đầu ra văn bản list ẩn các thẻ đã lưu trữ theo mặc định (--include-archived ghi đè hành vi này); --json luôn bao gồm các thẻ đã lưu trữ, phù hợp với hợp đồng đầy đủ về thẻ được các tập lệnh hiện có sử dụng. show và move chấp nhận một tiền tố id không mơ hồ. list, create, show và move luôn đọc/ghi trực tiếp trạng thái plugin cục bộ. Chỉ dispatch gọi Gateway đang chạy, với cơ chế dự phòng được mô tả ở trên.

Xem CLI Workboard để biết đầy đủ các cờ, đầu ra JSON, hành vi dự phòng của Gateway, cách xử lý tiền tố id, quy tắc lựa chọn khi điều phối và cách khắc phục sự cố.

/workboard list, /workboard show <card-id>, /workboard create <title>, /workboard move <card-id> --status <status> và /workboard dispatch phản ánh CLI. Liệt kê và hiển thị là các thao tác đọc dành cho mọi người gửi lệnh được ủy quyền. Tạo, di chuyển và điều phối yêu cầu trạng thái chủ sở hữu trên các giao diện trò chuyện hoặc một ứng dụng khách Gateway có operator.write/operator.admin. Các thao tác di chuyển thủ công của người vận hành sử dụng cùng hành vi ghi đè claim như thao tác kéo và thả trên bảng điều khiển. Quyền truy cập worktree của chúng vẫn tuân theo cùng ranh giới không gian làm việc được mô tả ở trên.

Đồng bộ vòng đời phiên

Các thẻ có thể liên kết với một phiên bảng điều khiển hiện có hoặc một phiên được tạo khi bạn bắt đầu công việc từ thẻ. Các thẻ được liên kết hiển thị trực tiếp vòng đời phiên: đang chạy, cũ, đã liên kết nhưng không hoạt động, hoàn tất, thất bại hoặc thiếu. Bạn cũng có thể ghi nhận một phiên hiện có từ thẻ Sessions bằng Add to Workboard; thẻ liên kết với phiên đó, sử dụng nhãn phiên hoặc lời nhắc gần đây của người dùng làm tiêu đề, đồng thời điền ghi chú ban đầu từ lời nhắc gần đây của người dùng cùng phản hồi mới nhất của trợ lý khi có.

Nếu phiên được liên kết bị thiếu, thẻ vẫn giữ liên kết để cung cấp ngữ cảnh và vẫn cung cấp các điều khiển bắt đầu nhằm khởi động lại trong một phiên mới. Nếu một phiên được liên kết đang hoạt động ngừng báo cáo hoạt động gần đây, Workboard đánh dấu thẻ là stale và lưu trạng thái đó dưới dạng siêu dữ liệu cho đến khi vòng đời xóa nó.

Khi một thẻ đang ở trạng thái công việc hoạt động, Workboard sẽ theo dõi phiên được liên kết:

Trạng thái review thủ công được ưu tiên. Việc di chuyển một thẻ sang review, blocked hoặc done sẽ dừng tự động đồng bộ cho thẻ đó cho đến khi bạn chuyển thẻ trở lại todo hoặc running.

Việc bắt đầu một thẻ sử dụng các phiên Gateway thông thường; Workboard chỉ lưu siêu dữ liệu và liên kết của thẻ. Bản chép lời cuộc trò chuyện, lựa chọn mô hình và vòng đời lượt chạy vẫn do hệ thống phiên thông thường quản lý. Sử dụng Stop trên một thẻ được liên kết đang hoạt động để hủy lượt chạy hiện tại — Workboard đánh dấu thẻ đó là blocked để thẻ vẫn hiển thị cho việc xử lý tiếp theo.

Các thẻ mới có thể bắt đầu từ các mẫu Workboard (bugfix, docs, release, pr_review, plugin). Mẫu điền sẵn tiêu đề, ghi chú, nhãn và mức ưu tiên; id mẫu được lưu dưới dạng siêu dữ liệu thẻ.

Quy trình làm việc trên bảng điều khiển

1. Mở thẻ Workboard trong Control UI.
2. Tạo một thẻ với tiêu đề, ghi chú, mức ưu tiên, nhãn, agent tùy chọn và phiên được liên kết tùy chọn — hoặc mở Sessions và chọn Add to Workboard cho một phiên hiện có.
3. Kéo thẻ giữa các cột hoặc đưa tiêu điểm vào điều khiển trạng thái thu gọn của thẻ rồi sử dụng menu hay ArrowLeft/ArrowRight. Trong khi kéo, thẻ nguồn mờ đi và các cột có thể thả sẽ có đường viền.
4. Bắt đầu công việc từ thẻ để tạo hoặc tái sử dụng một phiên bảng điều khiển.
5. Mở phiên được liên kết từ thẻ trong khi agent làm việc.
6. Để quá trình đồng bộ vòng đời chuyển công việc đang chạy sang review/blocked, sau đó di chuyển thủ công thẻ sang done khi được chấp nhận.

Chẩn đoán

Thông tin chẩn đoán được tính từ siêu dữ liệu thẻ cục bộ. Các kiểm tra tích hợp sẵn gắn cờ:

Quyền

Các phương thức RPC của Gateway nằm dưới workboard.*:

Không phương thức RPC nào yêu cầu operator.admin. Các trình duyệt được kết nối với quyền người vận hành chỉ đọc có thể kiểm tra bảng nhưng không thể thay đổi thẻ. Phạm vi quản trị mở rộng các đường dẫn máy chủ Workboard được chấp nhận; nó không thay đổi các phương thức khả dụng.

Lưu trữ

Workboard lưu dữ liệu lâu bền trong một cơ sở dữ liệu SQLite quan hệ do plugin sở hữu nằm trong thư mục trạng thái OpenClaw: bảng, thẻ, nhãn, sự kiện vòng đời, lần thử chạy, bình luận, liên kết phần phụ thuộc, bằng chứng, tham chiếu tạo tác, siêu dữ liệu và blob của tệp đính kèm, thông tin chẩn đoán, thông báo, nhật ký worker, trạng thái giao thức và đăng ký đều nằm trong các bảng Workboard (không phải mục khóa-giá trị của plugin). Tệp xuất thẻ giữ nguyên diễn tiến của bảng mà không nhúng nội dung blob của tệp đính kèm.

Các bản cài đặt đã sử dụng Workboard trong bản phát hành .28 có thể chạy openclaw doctor --fix để di chuyển các không gian tên trạng thái plugin cũ đã phát hành (workboard.cards, workboard.boards, workboard.notify và, nếu có, workboard.attachments) vào cơ sở dữ liệu quan hệ.

Khắc phục sự cố

Thẻ cho biết Workboard không khả dụng

openclaw plugins inspect workboard --runtime --json

Nếu plugins.allow đã được cấu hình, hãy thêm workboard vào đó. Nếu plugins.deny chứa workboard, hãy xóa mục đó trước khi bật plugin.

Không lưu được thẻ

Xác nhận kết nối trình duyệt có quyền truy cập operator.write. Các phiên người vận hành chỉ đọc có thể liệt kê thẻ nhưng không thể tạo, chỉnh sửa, di chuyển hoặc xóa chúng.

Việc bắt đầu một thẻ không mở đúng phiên mong đợi

Kiểm tra id agent và phiên được liên kết của thẻ, sau đó mở Sessions hoặc Chat để kiểm tra trạng thái lượt chạy thực tế.

Quá trình điều phối không khởi động worker

Xác nhận có ít nhất một thẻ ready không có claim đang hoạt động:

openclaw workboard list --status ready

Nếu CLI báo cáo quá trình điều phối chỉ dữ liệu, hãy khởi động hoặc khởi động lại Gateway rồi thử lại — quá trình điều phối chỉ dữ liệu cập nhật trạng thái bảng cục bộ nhưng không thể khởi động các lượt chạy worker subagent. Thẻ cũng có thể bị bỏ qua khi một thẻ khác của cùng chủ sở hữu hoặc agent đang chạy hoặc đang chờ review; hãy hoàn tất, chặn hoặc giải phóng công việc đang hoạt động đó trước khi điều phối thêm công việc cho cùng chủ sở hữu.

Liên quan

• Control UI
• CLI Workboard
• Plugin
• Quản lý plugin
• Phiên