Task Flow là nền tảng điều phối luồng nằm phía 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, 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://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Khi nào dùng Task Flow
Dùng Task Flow khi công việc trải dài qua nhiều bước tuần tự hoặc rẽ 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à đủ.| Tình huống | Sử dụng |
|---|---|
| Công việc nền đơn lẻ | Tác vụ thông thường |
| Đường ống nhiều bước (A rồi B rồi C) | Task Flow (quản lý) |
| Quan sát các tác vụ được tạo bên ngoài | Task Flow (phản chiếu) |
| Nhắc nhở một lần | Công việc Cron |
Mẫu workflow được lập lịch đáng tin cậy
Với các workflow định kỳ như bản tóm tắt thông tin 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ập lịch để định thời.
- Dùng một phiên cron bền vững khi workflow cần xây dựng dựa trên ngữ cảnh trước đó.
- Dùng Lobster cho các bước tất định, cổng phê duyệt và token tiếp tục.
- Dùng Task Flow để theo dõi lần chạy nhiều bước qua các tác vụ con, chờ, thử lại và các lần khởi động lại gateway.
session:<id> thay vì isolated khi workflow định kỳ cần lịch sử có chủ đích, tóm tắt các 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à mọi trạng thái cần thiết đều được khai báo rõ trong workflow.
Trong workflow, đặt các kiểm tra độ tin cậy trước bước tóm tắt bằng LLM:
- 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 một 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 lỗi được cấu hình cho cron để các lỗi preflight hiển thị được. Xem Tác vụ đã lập lịch.
sourceUrl, retrievedAt và asOf trong đầu ra. Dùng LLM Task khi bạn cần một bước mô hình đã xác thực schema bên trong workflow.
Với các workflow có thể tái sử dụng cho đội 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 xuất bản qua ClawHub. Giữ các rào chắn dành riêng cho workflow 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ý
Task Flow sở hữu 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, điều khiển chúng đến khi 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. Task Flow 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
Task Flow quan sát các tác vụ được tạo bên ngoài và giữ trạng thái luồng đồng bộ mà không sở hữu việc tạo tác vụ. Điều này hữu ích khi tác vụ bắt nguồn 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 chế độ xem hợp nhất về tiến độ của chúng dưới dạng 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 bền vững trạng thái riêng và theo dõi các bản sửa đổi để tiến độ vẫ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ì write-ahead-log 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 một ý định hủy bám dính trên luồng. Các tác vụ đang hoạt động trong luồng bị hủy và không có 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 bị 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ó |
Cách luồng liên quan đến tác vụ
Luồng điều phối tác vụ, không thay thế chúng. Một luồng đơn 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 nháy mắt
- Công việc Cron — các công việc đã lập lịch có thể đưa vào luồng