Chuyển đến nội dung chính

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.

OpenClaw chạy công việc trong nền thông qua tác vụ, công việc đã lên lịch, cam kết được suy luận, hook sự kiện và chỉ thị thường trực. Trang này giúp bạn chọn cơ chế phù hợp và hiểu cách chúng kết hợp với nhau.

Hướng dẫn quyết định nhanh

Trường hợp sử dụngKhuyến nghịLý do
Gửi báo cáo hằng ngày đúng 9 giờ sángTác vụ đã lên lịch (Cron)Thời điểm chính xác, thực thi tách biệt
Nhắc tôi sau 20 phútTác vụ đã lên lịch (Cron)Chạy một lần với thời điểm chính xác (--at)
Chạy phân tích sâu hằng tuầnTác vụ đã lên lịch (Cron)Tác vụ độc lập, có thể dùng mô hình khác
Kiểm tra hộp thư đến mỗi 30 phútHeartbeatGộp với các kiểm tra khác, có nhận biết ngữ cảnh
Theo dõi lịch cho các sự kiện sắp tớiHeartbeatPhù hợp tự nhiên với nhận biết định kỳ
Kiểm tra lại sau một cuộc phỏng vấn đã nhắc tớiCam kết được suy luậnTheo dõi giống bộ nhớ, không có yêu cầu nhắc chính xác
Hỏi thăm nhẹ nhàng sau ngữ cảnh người dùngCam kết được suy luậnGiới hạn trong cùng agent và kênh
Kiểm tra trạng thái của subagent hoặc lần chạy ACPTác vụ nềnSổ cái tác vụ theo dõi mọi công việc tách rời
Kiểm tra những gì đã chạy và thời điểm chạyTác vụ nềnopenclaw tasks listopenclaw tasks audit
Nghiên cứu nhiều bước rồi tóm tắtTask FlowĐiều phối bền vững với theo dõi phiên bản sửa đổi
Chạy script khi đặt lại phiênHookĐiều khiển bằng sự kiện, kích hoạt theo sự kiện vòng đời
Thực thi mã trong mỗi lệnh gọi công cụHook PluginHook trong tiến trình có thể chặn lệnh gọi công cụ
Luôn kiểm tra tuân thủ trước khi trả lờiChỉ thị thường trựcTự động được đưa vào mọi phiên

Tác vụ đã lên lịch (Cron) so với Heartbeat

Khía cạnhTác vụ đã lên lịch (Cron)Heartbeat
Thời điểmChính xác (biểu thức cron, một lần)Xấp xỉ (mặc định mỗi 30 phút)
Ngữ cảnh phiênMới (tách biệt) hoặc dùng chungĐầy đủ ngữ cảnh phiên chính
Bản ghi tác vụLuôn được tạoKhông bao giờ được tạo
Phân phốiKênh, webhook hoặc im lặngNội tuyến trong phiên chính
Phù hợp nhất choBáo cáo, lời nhắc, công việc nềnKiểm tra hộp thư, lịch, thông báo
Dùng Tác vụ đã lên lịch (Cron) khi bạn cần thời điểm chính xác hoặc thực thi tách biệt. Dùng Heartbeat khi công việc hưởng lợi từ ngữ cảnh phiên đầy đủ và thời điểm xấp xỉ là chấp nhận được.

Khái niệm cốt lõi

Tác vụ đã lên lịch (cron)

Cron là bộ lập lịch tích hợp của Gateway cho thời điểm chính xác. Nó lưu bền vững các công việc, đánh thức agent vào đúng thời điểm và có thể gửi đầu ra tới kênh trò chuyện hoặc endpoint webhook. Hỗ trợ lời nhắc một lần, biểu thức lặp lại và trigger webhook đến. Xem Tác vụ đã lên lịch.

Tác vụ

Sổ cái tác vụ nền theo dõi mọi công việc tách rời: lần chạy ACP, tạo subagent, thực thi cron tách biệt và thao tác CLI. Tác vụ là bản ghi, không phải bộ lập lịch. Dùng openclaw tasks listopenclaw tasks audit để kiểm tra chúng. Xem Tác vụ nền.

Cam kết được suy luận

Cam kết là các bộ nhớ theo dõi ngắn hạn và cần bật rõ ràng. OpenClaw suy luận chúng từ các cuộc trò chuyện bình thường, giới hạn chúng trong cùng agent và kênh, rồi gửi các lần kiểm tra đến hạn thông qua heartbeat. Các lời nhắc chính xác do người dùng yêu cầu vẫn thuộc về cron. Xem Cam kết được suy luận.

Task Flow

Task Flow là nền tảng điều phối luồng phía trên các tác vụ nền. Nó quản lý các luồng nhiều bước bền vững với chế độ đồng bộ được quản lý và phản chiếu, theo dõi phiên bản sửa đổi, cùng openclaw tasks flow list|show|cancel để kiểm tra. Xem Task Flow.

Chỉ thị thường trực

Chỉ thị thường trực cấp cho agent quyền vận hành lâu dài cho các chương trình đã định nghĩa. Chúng nằm trong các tệp workspace (thường là AGENTS.md) và được đưa vào mọi phiên. Kết hợp với cron để thực thi theo thời gian. Xem Chỉ thị thường trực.

Hook

Hook nội bộ là các script điều khiển bằng sự kiện, được kích hoạt bởi sự kiện vòng đời agent (/new, /reset, /stop), compaction phiên, khởi động gateway và luồng tin nhắn. Chúng được tự động phát hiện từ các thư mục và có thể được quản lý bằng openclaw hooks. Để chặn lệnh gọi công cụ trong tiến trình, hãy dùng hook Plugin. Xem Hook.

Heartbeat

Heartbeat là một lượt phiên chính định kỳ (mặc định mỗi 30 phút). Nó gộp nhiều kiểm tra (hộp thư đến, lịch, thông báo) trong một lượt agent với đầy đủ ngữ cảnh phiên. Các lượt Heartbeat không tạo bản ghi tác vụ và không kéo dài độ mới của việc đặt lại phiên hằng ngày/khi nhàn rỗi. Dùng HEARTBEAT.md cho một checklist nhỏ, hoặc khối tasks: khi bạn muốn các kiểm tra định kỳ chỉ chạy khi đến hạn bên trong chính heartbeat. Tệp heartbeat trống sẽ bỏ qua dưới dạng empty-heartbeat-file; chế độ tác vụ chỉ đến hạn bỏ qua dưới dạng no-tasks-due. Heartbeat trì hoãn khi công việc cron đang hoạt động hoặc đang xếp hàng, và heartbeat.skipWhenBusy cũng có thể trì hoãn chúng khi subagent hoặc các làn lồng nhau đang bận. Xem Heartbeat.

Cách chúng hoạt động cùng nhau

  • Cron xử lý lịch chính xác (báo cáo hằng ngày, đánh giá hằng tuần) và lời nhắc một lần. Mọi lần thực thi cron đều tạo bản ghi tác vụ.
  • Heartbeat xử lý việc giám sát thường kỳ (hộp thư đến, lịch, thông báo) trong một lượt được gộp mỗi 30 phút.
  • Hook phản ứng với các sự kiện cụ thể (đặt lại phiên, compaction, luồng tin nhắn) bằng script tùy chỉnh. Hook Plugin bao phủ lệnh gọi công cụ.
  • Chỉ thị thường trực cung cấp cho agent ngữ cảnh bền vững và ranh giới quyền hạn.
  • Task Flow điều phối các luồng nhiều bước phía trên từng tác vụ riêng lẻ.
  • Tác vụ tự động theo dõi mọi công việc tách rời để bạn có thể kiểm tra và kiểm toán.

Liên quan