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ỉ 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 phối 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 cô lập
Nhắc tôi sau 20 phútTác vụ đã lên lịch (Cron)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, nhận biết ngữ cảnh
Theo dõi lịch cho 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ắcCam kết được suy luậnTheo dõi giống bộ nhớ, không yêu cầu nhắc 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 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 toán nội dung đã 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 phiên đặt lạiHookĐiều khiển bằng sự kiện, kích hoạt theo sự kiện vòng đời
Thực thi mã trên 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ỉ dẫn thường trựcĐược tự động đư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)Gần đúng (mặc định mỗi 30 phút)
Ngữ cảnh phiênMới (cô lập) 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 cô lập. Dùng Heartbeat khi công việc hưởng lợi từ toàn bộ ngữ cảnh phiên và thời điểm gần đúng 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 của Gateway dành cho thời điểm chính xác. Nó lưu công việc, đánh thức agent đúng lúc và có thể gửi đầu ra đến 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à trình kích hoạt 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 cô lập 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à bộ nhớ theo dõi ngắn hạn, cần bật rõ ràng. 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 gửi các lượt kiểm tra đến hạn thông qua Heartbeat. 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 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 chế độ đồng bộ được quản lý và phản chiếu, theo dõi phiên bản sửa đổi và openclaw tasks flow list|show|cancel để kiểm tra. Xem Task Flow.

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

Chỉ dẫn thường trực cấp cho agent thẩm 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 dựa trên thời gian. Xem Chỉ dẫn 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, 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 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 gia hạn độ 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 các kiểm tra định kỳ chỉ-đến-hạn ngay trong Heartbeat. Tệp Heartbeat rỗng được bỏ qua dưới dạng empty-heartbeat-file; chế độ tác vụ chỉ-đến-hạn được bỏ qua dưới dạng no-tasks-due. Heartbeat hoãn lại khi công việc cron đang hoạt động hoặc được xếp hàng, và heartbeat.skipWhenBusy cũng có thể hoãn chúng khi subagent hoặc lane lồng nhau đang bận. Xem Heartbeat.

Cách chúng phối hợp với 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ý giám sát định kỳ (hộp thư đến, lịch, thông báo) trong một lượt 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ỉ dẫn thường trực cung cấp cho agent ngữ cảnh bền vững và ranh giới thẩm quyền.
  • Task Flow điều phối các luồng nhiều bước bên 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