Luồng tác vụ là nền tảng điều phối luồng nằm trên tác vụ nền. Nó quản lý các luồng nhiều bước bền vững với trạng thái riêng, theo dõi bản sửa đổi và ngữ nghĩa đồng bộ riêng, trong khi từng tác vụ vẫn là đơn vị công việc tách rời.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Khi nào dùng Luồng tác vụ
Dùng Luồng tác vụ khi công việc trải dài qua nhiều bước tuần tự hoặc phân nhánh và bạn cần theo dõi tiến độ bền vững qua các lần khởi động lại gateway. Với các thao tác nền đơn lẻ, một tác vụ thông thường là đủ.| Kịch bản | Nên dùng |
|---|---|
| Công việc nền đơn lẻ | Tác vụ thông thường |
| Quy trình nhiều bước (A rồi B rồi C) | Luồng tác vụ (được quản lý) |
| Quan sát các tác vụ được tạo bên ngoài | Luồng tác vụ (được phản chiếu) |
| Lời nhắc một lần | Công việc Cron |
Mẫu quy trình được lên lịch đáng tin cậy
Với các quy trình lặp lại như bản tin tình báo thị trường, hãy xem lịch chạy, điều phối và kiểm tra độ tin cậy là các lớp riêng biệt:- Dùng Tác vụ đã lên lịch để đặt thời điểm.
- Dùng một phiên cron liên tục khi quy trình cần xây dựng dựa trên ngữ cảnh trước đó.
- Dùng Lobster cho các bước xác định, cổng phê duyệt và token tiếp tục.
- Dùng Luồng tác vụ để theo dõi lần chạy nhiều bước qua các tác vụ con, thời gian chờ, lần thử lại và các lần khởi động lại gateway.
session:<id> thay vì isolated khi quy trình lặp lại cần lịch sử có chủ đích, tóm tắt lần chạy trước hoặc ngữ cảnh thường trực. Dùng isolated khi mỗi lần chạy nên bắt đầu mới và toàn bộ trạng thái bắt buộc được nêu rõ trong quy trình.
Bên trong quy trình, đặt các kiểm tra độ tin cậy trước bước tóm tắt của LLM:
- Tính khả dụng của trình duyệt và lựa chọn hồ sơ, ví dụ
openclawcho trạng thái được quản lý hoặcuserkhi cần phiên Chrome đã đăng nhập. Xem Trình duyệt. - Thông tin xác thực API và hạn mức cho từng nguồn.
- Khả năng truy cập mạng tới các endpoint bắt buộc.
- Các công cụ bắt buộc đã được bật cho agent, chẳng hạn như
lobster,browservàllm-task. - Đích đến khi lỗi đã được cấu hình cho cron để có thể thấy lỗi trước khi chạy. Xem Tác vụ đã lên lịch.
sourceUrl, retrievedAt và asOf trong đầu ra. Dùng Tác vụ LLM khi bạn cần một bước mô hình được xác thực bằng schema bên trong quy trình.
Với các quy trình dùng lại cho nhóm hoặc cộng đồng, hãy đóng gói CLI, các tệp .lobster và mọi ghi chú thiết lập dưới dạng skill hoặc plugin rồi phát hành qua ClawHub. Giữ các hàng rào bảo vệ riêng cho quy trình trong gói đó, trừ khi API plugin thiếu một năng lực chung cần thiết.
Chế độ đồng bộ
Chế độ được quản lý
Luồng tác vụ sở hữu toàn bộ vòng đời từ đầu đến cuối. Nó tạo tác vụ dưới dạng các bước của luồng, thúc đẩy chúng hoàn tất và tự động tiến trạng thái luồng. Ví dụ: một luồng báo cáo hằng tuần (1) thu thập dữ liệu, (2) tạo báo cáo và (3) gửi báo cáo. Luồng tác vụ tạo từng bước dưới dạng tác vụ nền, chờ hoàn tất, rồi chuyển sang bước tiếp theo.Chế độ phản chiếu
Luồng tác vụ quan sát các tác vụ được tạo bên ngoài và giữ trạng thái luồng được đồng bộ mà không nhận quyền sở hữu việc tạo tác vụ. Điều này hữu ích khi các tác vụ xuất phát từ công việc cron, lệnh CLI hoặc các nguồn khác và bạn muốn có một góc nhìn thống nhất về tiến độ của chúng như một luồng. Ví dụ: ba công việc cron độc lập cùng tạo thành một quy trình “vận hành buổi sáng”. Một luồng phản chiếu theo dõi tiến độ chung của chúng mà không kiểm soát thời điểm hoặc cách chúng chạy.Trạng thái bền vững và theo dõi bản sửa đổi
Mỗi luồng lưu trạng thái riêng và theo dõi các bản sửa đổi để tiến độ tồn tại qua các lần khởi động lại gateway. Theo dõi bản sửa đổi cho phép phát hiện xung đột khi nhiều nguồn cố gắng tiến cùng một luồng đồng thời. Sổ đăng ký luồng dùng SQLite với bảo trì nhật ký ghi trước có giới hạn, bao gồm checkpoint định kỳ và khi tắt, để các gateway chạy lâu không giữ lại các tệp phụregistry.sqlite-wal không giới hạn.
Hành vi hủy
openclaw tasks flow cancel đặt ý định hủy cố định trên luồng. Các tác vụ đang hoạt động trong luồng sẽ bị hủy và không bước mới nào được bắt đầu. Ý định hủy tồn tại qua các lần khởi động lại, nên một luồng đã hủy vẫn ở trạng thái đã hủy ngay cả khi gateway khởi động lại trước khi tất cả tác vụ con đã kết thúc.
Lệnh CLI
| Lệnh | Mô tả |
|---|---|
openclaw tasks flow list | Hiển thị các luồng được theo dõi cùng trạng thái và chế độ đồng bộ |
openclaw tasks flow show <id> | Kiểm tra một luồng theo id luồng hoặc khóa tra cứu |
openclaw tasks flow cancel <id> | Hủy một luồng đang chạy và các tác vụ đang hoạt động của nó |
Luồng liên quan đến tác vụ như thế nào
Luồng điều phối tác vụ, không thay thế chúng. Một luồng đơn lẻ có thể điều khiển nhiều tác vụ nền trong suốt vòng đời của nó. Dùngopenclaw tasks để kiểm tra từng bản ghi tác vụ và openclaw tasks flow để kiểm tra luồng điều phối.
Liên quan
- Tác vụ nền — sổ cái công việc tách rời mà các luồng điều phối
- CLI: tác vụ — tài liệu tham chiếu lệnh CLI cho
openclaw tasks flow - Tổng quan tự động hóa — tất cả cơ chế tự động hóa trong một cái nhìn tổng quát
- Công việc Cron — các công việc đã lên lịch có thể đưa dữ liệu vào luồng