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

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.

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, event hook và chỉ dẫn 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 model khác
Kiểm tra hộp thư đến mỗi 30 phútHeartbeatGộp với các lần 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 buổi phỏng vấn đã được nhắc tớiCam kết được suy luậnTheo dõi giống bộ nhớ, không phải yêu cầu nhắc nhở chính xác
Kiểm tra quan tâ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 một 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à khi nàoTác vụ nềnopenclaw tasks listopenclaw tasks audit
Nghiên cứu nhiều bước rồi tóm tắtLuồng tác vụĐiều phối bền vững với theo dõi bản sửa đổi
Chạy script khi đặt lại phiênHookTheo sự kiện, kích hoạt trên các sự kiện vòng đời
Thực thi mã trên mỗi lần gọi công cụHook PluginHook trong tiến trình có thể chặn các lần gọi công cụ
Luôn kiểm tra tuân thủ trước khi trả lờiChỉ dẫn thường trựcTự động được chèn 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, chạy 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 chungToàn bộ 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ư đến, 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 được lợi từ toàn bộ ngữ cảnh phiên và thời điểm xấp xỉ là đủ.

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 sẵn của Gateway để định thời chính xác. Nó lưu giữ công việc, đánh thức agent vào đúng thời điểm và có thể phân phối đầu ra tới một kênh chat hoặc endpoint webhook. Hỗ trợ lời nhắc chạy một lần, biểu thức lặp lại và trình kích hoạt webhook đi vào. 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, bật theo lựa chọn. OpenClaw suy luận chúng từ các cuộc trò chuyện thông thường, giới hạn chúng trong cùng agent và kênh, rồi phân phố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.

Luồng tác vụ

Luồng tác vụ 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 bản sửa đổi và openclaw tasks flow list|show|cancel để kiểm tra. Xem Luồng tác vụ.

Chỉ dẫn thường trực

Chỉ dẫn 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 đã xác định. Chúng nằm trong các tệp workspace (thường là AGENTS.md) và được chèn vào mọi phiên. Kết hợp với cron để thực thi theo thời gian. Xem Chỉ dẫn thường trực.

Hook

Hook nội bộ là các script theo 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ần 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 lần kiểm tra (hộp thư đến, lịch, thông báo) trong một lượt agent với toàn bộ 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/nhàn rỗi. Dùng HEARTBEAT.md cho một danh sách kiểm tra nhỏ, hoặc khối tasks: khi bạn muốn kiểm tra định kỳ chỉ khi đến hạn bên trong chính heartbeat. Tệp heartbeat rỗng được bỏ qua dưới dạng empty-heartbeat-file; chế độ tác vụ chỉ khi đến hạn được bỏ qua dưới dạng no-tasks-due. Heartbeat sẽ 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 một agent khi subagent có khóa theo phiên của cùng agent đó 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 chạy một lần. Mọi lần thực thi cron đều tạo bản ghi tác vụ.
  • Heartbeat xử lý giám sát thường lệ (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ủ các lần gọi công cụ.
  • Chỉ dẫn thường trực cung cấp cho agent ngữ cảnh bền vững và ranh giới quyền hạn.
  • Luồng tác vụ đ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à audit chúng.

Liên quan