Tác vụ nền

Các tác vụ nền theo dõi công việc chạy bên ngoài phiên hội thoại chính của bạn: các lượt chạy ACP, việc khởi tạo subagent, các lần thực thi công việc cron và các thao tác được khởi tạo từ CLI.

Tác vụ không thay thế phiên, công việc cron hoặc heartbeat — chúng là sổ ghi hoạt động ghi lại công việc tách rời nào đã diễn ra, vào thời điểm nào và có thành công hay không.

Tóm tắt

• Tác vụ là bản ghi, không phải bộ lập lịch — cron và heartbeat quyết định công việc chạy khi nào, còn tác vụ theo dõi điều gì đã xảy ra.
• ACP, subagent, mọi công việc cron và thao tác CLI đều tạo tác vụ. Các lượt heartbeat thì không.
• Mỗi tác vụ chuyển qua queued → running → terminal (thành công, thất bại, hết thời gian, bị hủy hoặc bị mất).
• Tác vụ cron vẫn hoạt động khi môi trường chạy cron còn sở hữu công việc; nếu trạng thái môi trường chạy trong bộ nhớ đã mất, quá trình bảo trì tác vụ trước tiên sẽ kiểm tra lịch sử lượt chạy cron bền vững rồi mới đánh dấu tác vụ là bị mất.
• Việc hoàn tất được điều khiển bằng cơ chế đẩy: công việc tách rời có thể thông báo trực tiếp hoặc đánh thức phiên/heartbeat của bên yêu cầu khi hoàn tất, vì vậy vòng lặp thăm dò trạng thái thường không phải là cách phù hợp.
• Các lượt chạy cron cô lập và lượt hoàn tất của subagent sẽ cố gắng dọn dẹp các thẻ trình duyệt/tiến trình được theo dõi của phiên con trước khi thực hiện bước ghi sổ dọn dẹp cuối cùng.
• Quá trình phân phối cron cô lập sẽ chặn các phản hồi tạm thời đã lỗi thời từ tác nhân cha trong khi công việc của subagent hậu duệ vẫn đang kết thúc, đồng thời ưu tiên đầu ra cuối cùng của hậu duệ nếu đầu ra đó đến trước khi phân phối.
• Thông báo hoàn tất được gửi trực tiếp đến một kênh hoặc đưa vào hàng đợi cho heartbeat tiếp theo.
• openclaw tasks list hiển thị tất cả tác vụ; openclaw tasks audit nêu bật các vấn đề.
• Bản ghi trạng thái kết thúc được giữ trong 7 ngày (bản ghi lost trong 24 giờ), sau đó tự động bị xóa bớt.

Bắt đầu nhanh

# Liệt kê tất cả tác vụ (mới nhất trước)openclaw tasks list # Lọc theo môi trường chạy hoặc trạng tháiopenclaw tasks list --runtime acpopenclaw tasks list --status running

# Hiển thị chi tiết của một tác vụ cụ thể (theo ID tác vụ, ID lượt chạy hoặc khóa phiên)openclaw tasks show <lookup>

# Hủy một tác vụ đang chạy (kết thúc phiên con)openclaw tasks cancel <lookup> # Thay đổi chính sách thông báo của một tác vụopenclaw tasks notify <lookup> state_changes

# Chạy kiểm tra tình trạngopenclaw tasks audit # Xem trước hoặc áp dụng bảo trìopenclaw tasks maintenanceopenclaw tasks maintenance --apply

# Kiểm tra trạng thái TaskFlowopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>

Những gì tạo ra tác vụ

Vòng đời tác vụ

stateDiagram-v2
    [*] --> queued
    queued --> running : tác nhân bắt đầu
    running --> succeeded : hoàn tất thành công
    running --> failed : lỗi
    running --> timed_out : vượt quá thời gian chờ
    queued --> cancelled : người vận hành hủy
    running --> cancelled : người vận hành hủy
    queued --> lost : trạng thái nền mất > 5 phút
    running --> lost : trạng thái nền mất > 5 phút

Quá trình chuyển trạng thái diễn ra tự động — các sự kiện vòng đời lượt chạy của tác nhân (bắt đầu, kết thúc, lỗi) cập nhật trạng thái tác vụ; bạn không quản lý thủ công.

Việc hoàn tất lượt chạy của tác nhân là căn cứ có thẩm quyền đối với các bản ghi tác vụ đang hoạt động. Một lượt chạy tách rời thành công được hoàn tất với trạng thái succeeded, lỗi lượt chạy thông thường được hoàn tất với trạng thái failed, hết thời gian được hoàn tất với trạng thái timed_out, còn kết quả hủy/dừng được hoàn tất với trạng thái cancelled. Khi tác vụ đã ở trạng thái kết thúc, các tín hiệu vòng đời đến sau không hạ cấp trạng thái đó — tác vụ đã bị người vận hành hủy hoặc đã ở trạng thái failed/timed_out/lost vẫn giữ nguyên ngay cả khi tín hiệu thành công đến sau đó.

lost phụ thuộc vào môi trường chạy:

• Tác vụ ACP: chỉ một lượt ACP trực tiếp trong cùng tiến trình ở Gateway mới chứng minh lượt chạy còn hoạt động; chỉ riêng siêu dữ liệu phiên được lưu bền vững là không đủ. Kiểm tra CLI ngoại tuyến giữ cách xử lý thận trọng và không bao giờ thu hồi tác vụ ACP.
• Tác vụ subagent: phiên con nền đã biến mất khỏi kho tác nhân đích (hoặc mang dấu mốc khôi phục sau khi khởi động lại).
• Tác vụ cron: môi trường chạy cron không còn theo dõi công việc là đang hoạt động và lịch sử lượt chạy cron bền vững không hiển thị kết quả kết thúc cho lượt chạy đó. Kiểm tra CLI ngoại tuyến không coi trạng thái môi trường chạy cron trống trong chính tiến trình của nó là căn cứ có thẩm quyền.
• Tác vụ CLI: tác vụ có ID lượt chạy/ID nguồn sử dụng ngữ cảnh lượt chạy trực tiếp, vì vậy các hàng phiên con hoặc phiên trò chuyện còn sót lại không giữ chúng ở trạng thái hoạt động sau khi lượt chạy do Gateway sở hữu biến mất. Tác vụ CLI cũ không có danh tính lượt chạy vẫn quay về dùng phiên con. Các lượt chạy openclaw agent dựa trên Gateway cũng được hoàn tất từ kết quả lượt chạy, nên lượt chạy đã hoàn tất không tiếp tục ở trạng thái hoạt động cho đến khi trình quét đánh dấu chúng là lost.

Phân phối và thông báo

Khi một tác vụ đạt trạng thái kết thúc, OpenClaw sẽ thông báo cho bạn. Có hai đường dẫn phân phối:

Phân phối trực tiếp — nếu tác vụ có đích kênh (requesterOrigin), thông báo hoàn tất sẽ được gửi thẳng đến kênh đó (Discord, Slack, Telegram, v.v.). Thay vào đó, lượt hoàn tất tác vụ nhóm và kênh được định tuyến qua phiên của bên yêu cầu để tác nhân cha có thể viết phản hồi hiển thị. Đối với lượt hoàn tất của subagent, OpenClaw cũng giữ nguyên định tuyến luồng/chủ đề đã liên kết khi có thể và có thể điền to / tài khoản còn thiếu từ tuyến được lưu của phiên yêu cầu (lastChannel / lastTo / lastAccountId) trước khi từ bỏ phân phối trực tiếp.

Phân phối qua hàng đợi phiên — nếu phân phối trực tiếp thất bại hoặc không đặt nguồn gốc, bản cập nhật sẽ được đưa vào hàng đợi dưới dạng sự kiện hệ thống trong phiên của bên yêu cầu và xuất hiện ở heartbeat tiếp theo.

Điều đó có nghĩa là quy trình thông thường dựa trên cơ chế đẩy: bắt đầu công việc tách rời một lần, sau đó để môi trường chạy đánh thức hoặc thông báo cho bạn khi hoàn tất. Chỉ thăm dò trạng thái tác vụ khi bạn cần gỡ lỗi, can thiệp hoặc thực hiện một cuộc kiểm tra rõ ràng.

Chính sách thông báo

Kiểm soát lượng thông tin bạn nhận được về mỗi tác vụ:

Thay đổi chính sách khi tác vụ đang chạy:

openclaw tasks notify <lookup> state_changes

Tham chiếu CLI

openclaw tasks list [--runtime <acp|subagent|cron|cli>] [--status <status>] [--json]

openclaw tasks show <lookup> [--json]

openclaw tasks cancel <lookup>

openclaw tasks notify <lookup> <done_only|state_changes|silent>

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]

openclaw tasks maintenance [--json]openclaw tasks maintenance --apply [--json]

openclaw tasks flow list [--status <status>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>

Bảng tác vụ trong trò chuyện (/tasks)

Dùng /tasks trong bất kỳ phiên trò chuyện nào để xem các tác vụ nền được liên kết với phiên đó. Bảng hiển thị tối đa năm tác vụ đang hoạt động và vừa hoàn tất, kèm theo runtime, trạng thái, thời gian và thông tin chi tiết về tiến độ hoặc lỗi.

Khi phiên hiện tại không có tác vụ liên kết nào hiển thị, /tasks sẽ chuyển sang số lượng tác vụ cục bộ của tác nhân để bạn vẫn có thông tin tổng quan mà không làm lộ chi tiết của các phiên khác.

Để xem sổ cái đầy đủ dành cho người vận hành, hãy dùng CLI: openclaw tasks list.

Giao diện điều khiển

Giao diện điều khiển web có trang Tác vụ trong thanh bên, hiển thị trực tiếp các tác vụ nền đang hoạt động và gần đây. Dùng trang này để kiểm tra tiến độ, mở các phiên được liên kết, làm mới sổ cái hoặc hủy tác vụ đang xếp hàng và đang chạy.

Các ngăn trò chuyện cũng có thanh Tác vụ nền có thể thu gọn, được giới hạn theo tác nhân của ngăn: các tác vụ và tác nhân phụ đang chạy kèm nút dừng, một phần đã hoàn tất và các liên kết Xem bản ghi đến phiên con của từng tác vụ. Mở thanh này từ nút chuyển đổi hoạt động trong tiêu đề ngăn (hoặc nút hoạt động nổi trong chế độ trò chuyện một ngăn).

Tích hợp trạng thái (áp lực tác vụ)

openclaw status bao gồm một dòng tổng quan nhanh về tác vụ:

Tác vụ    2 đang hoạt động · 1 đang xếp hàng · 1 đang chạy · 1 sự cố · kiểm tra sạch · 6 được theo dõi

Bản tóm tắt đếm công việc đang hoạt động (queued + running), thất bại (failed + timed_out + lost), các phát hiện kiểm tra và tổng số bản ghi được theo dõi; tải JSON cũng phân chia số lượng theo runtime (acp, subagent, cron, cli).

Cả /status và công cụ session_status đều sử dụng ảnh chụp tác vụ có nhận biết việc dọn dẹp: ưu tiên các tác vụ đang hoạt động, ẩn các hàng đã hết hạn và chỉ hiển thị tác vụ đã kết thúc trong một khoảng thời gian ngắn gần đây (5 phút), đồng thời tập trung vào các thất bại khi không còn công việc đang hoạt động. Điều này giúp thẻ trạng thái tập trung vào những gì quan trọng ngay lúc này.

Lưu trữ và bảo trì

Vị trí lưu tác vụ

Các bản ghi tác vụ và trạng thái gửi được lưu bền vững trong cơ sở dữ liệu trạng thái SQLite dùng chung của OpenClaw:

~/.openclaw/state/openclaw.sqlite   (các bảng: task_runs, task_delivery_state, flow_runs)

Đặt OPENCLAW_STATE_DIR để chuyển toàn bộ thư mục gốc trạng thái (mặc định là ~/.openclaw) sang vị trí khác; đường dẫn cơ sở dữ liệu dùng chung cũng di chuyển theo.

Sổ đăng ký được nạp vào bộ nhớ trong lần sử dụng đầu tiên và mọi thao tác ghi đều được lưu trở lại SQLite, vì vậy các bản ghi vẫn tồn tại sau khi Gateway khởi động lại. Mức tăng trưởng của WAL được giới hạn bằng ngưỡng điểm kiểm tra tự động mặc định của SQLite cùng các điểm kiểm tra PASSIVE định kỳ; khi tắt và khi bảo trì rõ ràng, các điểm kiểm tra sử dụng TRUNCATE để quá trình đóng thông thường thu hồi không gian WAL mà không khiến trình quét nền phải chờ các trình đọc đang hoạt động.

Các kho tệp phụ trợ cũ từ những bản cài đặt trước (tasks/runs.sqlite, flows/registry.sqlite) được openclaw doctor nhập vào cơ sở dữ liệu dùng chung.

Bảo trì tự động

Một trình quét chạy mỗi 60 giây (lượt đầu tiên khoảng 5 giây sau khi Gateway khởi động) và xử lý bốn việc:

Mối quan hệ giữa tác vụ và các hệ thống khác

Nội dung liên quan

• Tự động hóa - tổng quan nhanh về tất cả cơ chế tự động hóa
• CLI: Tác vụ - tài liệu tham khảo lệnh CLI
• Heartbeat - các lượt xử lý định kỳ của phiên chính
• Tác vụ theo lịch - lập lịch công việc nền
• Luồng tác vụ - điều phối luồng phía trên các tác vụ