Chuyển đến nội dung chính
Heartbeat so với Cron? Xem Tự động hóa để biết hướng dẫn về thời điểm sử dụng từng loại.
Heartbeat chạy các lượt tác nhân định kỳ trong phiên chính để mô hình có thể nêu ra bất cứ điều gì cần chú ý mà không gửi quá nhiều thông báo cho bạn. Heartbeat là một lượt phiên chính theo lịch — nó không tạo bản ghi tác vụ nền. Bản ghi tác vụ dành cho công việc tách rời (lượt chạy ACP, tác nhân phụ, công việc Cron cô lập). Khắc phục sự cố: Tác vụ đã lên lịch

​
Khởi động nhanh (người mới bắt đầu)

1

Chọn nhịp chạy

Giữ Heartbeat bật (mặc định là 30m, hoặc 1h cho xác thực Anthropic OAuth/token, bao gồm tái sử dụng Claude CLI) hoặc đặt nhịp chạy riêng của bạn.
2

Thêm HEARTBEAT.md (tùy chọn)

Tạo một danh sách kiểm tra HEARTBEAT.md nhỏ hoặc khối tasks: trong không gian làm việc của tác nhân.
3

Quyết định nơi gửi tin nhắn Heartbeat

target: "none" là mặc định; đặt target: "last" để định tuyến đến liên hệ gần nhất.
4

Tinh chỉnh tùy chọn

  • Bật gửi suy luận Heartbeat để minh bạch hơn.
  • Dùng ngữ cảnh khởi động nhẹ nếu lượt chạy Heartbeat chỉ cần HEARTBEAT.md.
  • Bật phiên cô lập để tránh gửi toàn bộ lịch sử hội thoại ở mỗi Heartbeat.
  • Giới hạn Heartbeat vào giờ hoạt động (giờ địa phương).
Cấu hình ví dụ: 
{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explicit delivery to last contact (default is "none")
        directPolicy: "allow", // default: allow direct/DM targets; set "block" to suppress
        lightContext: true, // optional: only inject HEARTBEAT.md from bootstrap files
        isolatedSession: true, // optional: fresh session each run (no conversation history)
        skipWhenBusy: true, // optional: also defer when this agent's subagent or nested lanes are busy
        // activeHours: { start: "08:00", end: "24:00" },
        // includeReasoning: true, // optional: send separate `Thinking` message too
      },
    },
  },
}

​
Mặc định

  • Khoảng thời gian: 30m (hoặc 1h khi chế độ xác thực phát hiện được là Anthropic OAuth/token, bao gồm tái sử dụng Claude CLI). Đặt agents.defaults.heartbeat.every hoặc agents.list[].heartbeat.every cho từng tác nhân; dùng 0m để tắt.
  • Nội dung lời nhắc (có thể cấu hình qua agents.defaults.heartbeat.prompt): Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.
  • Thời gian chờ: các lượt Heartbeat chưa đặt giá trị sẽ dùng agents.defaults.timeoutSeconds khi có cấu hình. Nếu không, chúng dùng nhịp Heartbeat với giới hạn tối đa 600 giây. Đặt agents.defaults.heartbeat.timeoutSeconds hoặc agents.list[].heartbeat.timeoutSeconds cho từng tác nhân để Heartbeat có thể chạy lâu hơn.
  • Lời nhắc Heartbeat được gửi nguyên văn dưới dạng tin nhắn của người dùng. Lời nhắc hệ thống chỉ bao gồm một phần “Heartbeat” khi Heartbeat được bật cho tác nhân mặc định, và lượt chạy được gắn cờ nội bộ.
  • Khi Heartbeat bị tắt bằng 0m, các lượt chạy thông thường cũng bỏ qua HEARTBEAT.md khỏi ngữ cảnh khởi động để mô hình không thấy các chỉ dẫn chỉ dành cho Heartbeat.
  • Giờ hoạt động (heartbeat.activeHours) được kiểm tra theo múi giờ đã cấu hình. Ngoài khung giờ đó, Heartbeat bị bỏ qua cho đến tick tiếp theo nằm trong khung giờ.
  • Heartbeat tự động trì hoãn trong khi công việc Cron đang hoạt động hoặc đang xếp hàng. Đặt heartbeat.skipWhenBusy: true để cũng trì hoãn một tác nhân trên các làn tác nhân phụ hoặc lệnh lồng nhau được khóa theo phiên của chính nó; các tác nhân ngang hàng không còn tạm dừng chỉ vì một tác nhân khác có công việc tác nhân phụ đang chạy.

​
Lời nhắc Heartbeat dùng để làm gì

Lời nhắc mặc định được cố ý viết rộng:
  • Tác vụ nền: “Consider outstanding tasks” gợi ý tác nhân xem lại các việc cần theo dõi (hộp thư đến, lịch, lời nhắc, công việc đang xếp hàng) và nêu ra bất cứ điều gì khẩn cấp.
  • Kiểm tra với con người: “Checkup sometimes on your human during day time” gợi ý thỉnh thoảng gửi một tin nhắn nhẹ như “bạn cần gì không?”, nhưng tránh spam ban đêm bằng cách dùng múi giờ địa phương đã cấu hình của bạn (xem Múi giờ).
Heartbeat có thể phản ứng với tác vụ nền đã hoàn tất, nhưng bản thân một lượt chạy Heartbeat không tạo bản ghi tác vụ. Nếu bạn muốn Heartbeat làm một việc rất cụ thể (ví dụ: “check Gmail PubSub stats” hoặc “verify gateway health”), hãy đặt agents.defaults.heartbeat.prompt (hoặc agents.list[].heartbeat.prompt) thành nội dung tùy chỉnh (được gửi nguyên văn).

​
Hợp đồng phản hồi

  • Nếu không có gì cần chú ý, hãy trả lời bằng HEARTBEAT_OK.
  • Các lượt chạy Heartbeat có thể dùng công cụ có thể thay vào đó gọi heartbeat_respond với notify: false để không có cập nhật hiển thị, hoặc notify: true cộng với notificationText để cảnh báo. Khi có mặt, phản hồi công cụ có cấu trúc được ưu tiên hơn phương án dự phòng bằng văn bản.
  • Trong các lượt chạy Heartbeat, OpenClaw coi HEARTBEAT_OK là xác nhận khi nó xuất hiện ở đầu hoặc cuối câu trả lời. Token này bị loại bỏ và câu trả lời bị bỏ nếu nội dung còn lại ≤ ackMaxChars (mặc định: 300).
  • Nếu HEARTBEAT_OK xuất hiện ở giữa câu trả lời, nó không được xử lý đặc biệt.
  • Với cảnh báo, không bao gồm HEARTBEAT_OK; chỉ trả về văn bản cảnh báo.
Ngoài Heartbeat, HEARTBEAT_OK lạc chỗ ở đầu/cuối tin nhắn sẽ bị loại bỏ và ghi log; tin nhắn chỉ có HEARTBEAT_OK sẽ bị bỏ.

​
Cấu hình

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // default: 30m (0m disables)
        model: "anthropic/claude-opus-4-6",
        includeReasoning: false, // default: false (deliver separate Thinking message when available)
        lightContext: false, // default: false; true keeps only HEARTBEAT.md from workspace bootstrap files
        isolatedSession: false, // default: false; true runs each heartbeat in a fresh session (no conversation history)
        skipWhenBusy: false, // default: false; true also waits for this agent's subagent/nested lanes
        target: "last", // default: none | options: last | none | <channel id> (core or plugin, e.g. "imessage")
        to: "+15551234567", // optional channel-specific override
        accountId: "ops-bot", // optional multi-account channel id
        prompt: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.",
        ackMaxChars: 300, // max chars allowed after HEARTBEAT_OK
      },
    },
  },
}

​
Phạm vi và thứ tự ưu tiên

  • agents.defaults.heartbeat đặt hành vi Heartbeat toàn cục.
  • agents.list[].heartbeat được hợp nhất lên trên; nếu bất kỳ tác nhân nào có khối heartbeat, chỉ các tác nhân đó chạy Heartbeat.
  • channels.defaults.heartbeat đặt mặc định về khả năng hiển thị cho tất cả kênh.
  • channels.<channel>.heartbeat ghi đè mặc định của kênh.
  • channels.<channel>.accounts.<id>.heartbeat (kênh nhiều tài khoản) ghi đè cài đặt theo kênh.

​
Heartbeat theo từng tác nhân

Nếu bất kỳ mục agents.list[] nào bao gồm khối heartbeat, chỉ các tác nhân đó chạy Heartbeat. Khối theo từng tác nhân được hợp nhất lên trên agents.defaults.heartbeat (vì vậy bạn có thể đặt mặc định chung một lần và ghi đè theo tác nhân). Ví dụ: hai tác nhân, chỉ tác nhân thứ hai chạy Heartbeat. 
{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explicit delivery to last contact (default is "none")
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          timeoutSeconds: 45,
          prompt: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.",
        },
      },
    ],
  },
}

​
Ví dụ về giờ hoạt động

Giới hạn Heartbeat vào giờ làm việc trong một múi giờ cụ thể: 
{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explicit delivery to last contact (default is "none")
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // optional; uses your userTimezone if set, otherwise host tz
        },
      },
    },
  },
}
Ngoài khung giờ này (trước 9 giờ sáng hoặc sau 10 giờ tối giờ miền Đông), Heartbeat sẽ bị bỏ qua. Tick theo lịch tiếp theo nằm trong khung giờ sẽ chạy bình thường.

​
Thiết lập 24/7

Nếu bạn muốn Heartbeat chạy cả ngày, hãy dùng một trong các mẫu sau:
  • Bỏ hẳn activeHours (không giới hạn theo khung giờ; đây là hành vi mặc định).
  • Đặt khung giờ trọn ngày: activeHours: { start: "00:00", end: "24:00" }.
Không đặt cùng thời gian start và end (ví dụ 08:00 đến 08:00). Điều đó được coi là một khung giờ có độ rộng bằng không, nên Heartbeat luôn bị bỏ qua.

​
Ví dụ nhiều tài khoản

Dùng accountId để nhắm đến một tài khoản cụ thể trên các kênh nhiều tài khoản như Telegram: 
{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678:topic:42", // optional: route to a specific topic/thread
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​
Ghi chú trường

​
every
string
Khoảng thời gian Heartbeat (chuỗi thời lượng; đơn vị mặc định = phút).
​
model
string
Ghi đè mô hình tùy chọn cho các lượt chạy Heartbeat (provider/model).
​
includeReasoning
boolean
mặc định:"false"
Khi bật, cũng gửi tin nhắn Thinking riêng khi có sẵn (cùng dạng với /reasoning on).
​
lightContext
boolean
mặc định:"false"
Khi là true, các lượt chạy Heartbeat dùng ngữ cảnh khởi động nhẹ và chỉ giữ HEARTBEAT.md từ các tệp khởi động trong không gian làm việc.
​
isolatedSession
boolean
mặc định:"false"
Khi là true, mỗi Heartbeat chạy trong một phiên mới không có lịch sử hội thoại trước đó. Dùng cùng mẫu cô lập như Cron sessionTarget: "isolated". Giảm mạnh chi phí token cho mỗi Heartbeat. Kết hợp với lightContext: true để tiết kiệm tối đa. Định tuyến gửi vẫn dùng ngữ cảnh phiên chính.
​
skipWhenBusy
boolean
mặc định:"false"
Khi là true, các lượt chạy Heartbeat trì hoãn trên các làn bận bổ sung của tác nhân đó: tác nhân phụ được khóa theo phiên của chính nó hoặc công việc lệnh lồng nhau. Các làn Cron luôn trì hoãn Heartbeat, ngay cả khi không có cờ này, để các máy chủ mô hình cục bộ không chạy lời nhắc Cron và Heartbeat cùng lúc.
​
session
string
Khóa phiên tùy chọn cho các lượt chạy Heartbeat.
  • main (mặc định): phiên chính của tác nhân.
  • Khóa phiên rõ ràng (sao chép từ openclaw sessions --json hoặc CLI phiên).
  • Định dạng khóa phiên: xem Phiên và Nhóm.
​
target
string
  • last: gửi đến kênh bên ngoài được dùng gần nhất.
  • kênh rõ ràng: bất kỳ kênh hoặc id Plugin nào đã cấu hình, ví dụ discord, matrix, telegram, hoặc whatsapp.
  • none (mặc định): chạy Heartbeat nhưng không gửi ra bên ngoài.
​
directPolicy
"allow" | "block"
mặc định:"allow"
Kiểm soát hành vi gửi trực tiếp/DM. allow: cho phép gửi Heartbeat trực tiếp/DM. block: chặn gửi trực tiếp/DM (reason=dm-blocked).
​
to
string
Ghi đè người nhận tùy chọn (id theo kênh, ví dụ E.164 cho WhatsApp hoặc id cuộc trò chuyện Telegram). Với chủ đề/luồng Telegram, dùng <chatId>:topic:<messageThreadId>.
​
accountId
string
ID tài khoản tùy chọn cho các kênh nhiều tài khoản. Khi target: "last", ID tài khoản áp dụng cho kênh cuối cùng đã phân giải nếu kênh đó hỗ trợ tài khoản; nếu không thì bị bỏ qua. Nếu ID tài khoản không khớp với tài khoản đã cấu hình cho kênh đã phân giải, việc gửi sẽ bị bỏ qua.
​
prompt
string
Ghi đè nội dung prompt mặc định (không gộp).
​
ackMaxChars
number
mặc định:"300"
Số ký tự tối đa được phép sau HEARTBEAT_OK trước khi gửi.
​
suppressToolErrorWarnings
boolean
Khi true, chặn các payload cảnh báo lỗi công cụ trong các lượt chạy Heartbeat.
​
timeoutSeconds
number
mặc định:"global timeout or min(every, 600)"
Số giây tối đa cho một lượt tác nhân Heartbeat trước khi bị hủy. Để trống để dùng agents.defaults.timeoutSeconds nếu đã đặt, nếu không sẽ dùng nhịp Heartbeat được giới hạn ở 600 giây.
​
activeHours
object
Giới hạn các lượt chạy Heartbeat trong một khung thời gian. Đối tượng có start (HH:MM, bao gồm; dùng 00:00 cho đầu ngày), end (HH:MM, không bao gồm; cho phép 24:00 cho cuối ngày), và timezone tùy chọn.
  • Bỏ qua hoặc "user": dùng agents.defaults.userTimezone của bạn nếu đã đặt, nếu không thì dùng múi giờ hệ thống máy chủ.
  • "local": luôn dùng múi giờ hệ thống máy chủ.
  • Bất kỳ mã định danh IANA nào (ví dụ America/New_York): được dùng trực tiếp; nếu không hợp lệ, quay về hành vi "user" ở trên.
  • start và end không được bằng nhau đối với một cửa sổ hoạt động; các giá trị bằng nhau được xem là độ rộng bằng không (luôn nằm ngoài cửa sổ).
  • Ngoài cửa sổ hoạt động, các Heartbeat được bỏ qua cho đến tick tiếp theo nằm trong cửa sổ.

​
Hành vi gửi

  • Heartbeat mặc định chạy trong phiên chính của tác nhân (agent:<id>:<mainKey>), hoặc global khi session.scope = "global". Đặt session để ghi đè sang một phiên kênh cụ thể (Discord/WhatsApp/v.v.).
  • session chỉ ảnh hưởng đến ngữ cảnh chạy; việc gửi được kiểm soát bởi target và to.
  • Để gửi đến một kênh/người nhận cụ thể, đặt target + to. Với target: "last", việc gửi dùng kênh bên ngoài cuối cùng cho phiên đó.
  • Các lần gửi Heartbeat mặc định cho phép mục tiêu trực tiếp/DM. Đặt directPolicy: "block" để chặn gửi đến mục tiêu trực tiếp trong khi vẫn chạy lượt Heartbeat.
  • Nếu hàng đợi chính, lane phiên mục tiêu, lane cron, hoặc một công việc cron đang hoạt động bận, Heartbeat sẽ bị bỏ qua và thử lại sau.
  • Nếu skipWhenBusy: true, subagent theo khóa phiên của tác nhân này và các lane lồng nhau cũng hoãn các lượt chạy Heartbeat. Các lane bận của tác nhân khác không hoãn tác nhân này.
  • Nếu target không phân giải được đích bên ngoài nào, lượt chạy vẫn diễn ra nhưng không gửi thông điệp đi.
  • Nếu showOk, showAlerts, và useIndicator đều bị tắt, lượt chạy bị bỏ qua ngay từ đầu với reason=alerts-disabled.
  • Nếu chỉ tắt gửi cảnh báo, OpenClaw vẫn có thể chạy Heartbeat, cập nhật dấu thời gian tác vụ đến hạn, khôi phục dấu thời gian phiên rảnh, và chặn payload cảnh báo ra ngoài.
  • Nếu mục tiêu Heartbeat đã phân giải hỗ trợ trạng thái đang nhập, OpenClaw hiển thị đang nhập trong khi lượt chạy Heartbeat hoạt động. Trạng thái này dùng cùng mục tiêu mà Heartbeat sẽ gửi đầu ra chat đến, và bị tắt bởi typingMode: "never".
  • Các phản hồi chỉ dành cho Heartbeat không giữ phiên sống. Siêu dữ liệu Heartbeat có thể cập nhật hàng phiên, nhưng hết hạn do rảnh dùng lastInteractionAt từ thông điệp người dùng/kênh thực cuối cùng, và hết hạn hằng ngày dùng sessionStartedAt.
  • Lịch sử Control UI và WebChat ẩn prompt Heartbeat và các xác nhận chỉ OK. Bản ghi phiên bên dưới vẫn có thể chứa các lượt đó để kiểm tra/phát lại.
  • Các tác vụ nền tách rời có thể đưa một sự kiện hệ thống vào hàng đợi và đánh thức Heartbeat khi phiên chính cần nhận thấy điều gì đó nhanh chóng. Lần đánh thức đó không biến lượt chạy Heartbeat thành tác vụ nền.

​
Điều khiển hiển thị

Theo mặc định, các xác nhận HEARTBEAT_OK bị chặn trong khi nội dung cảnh báo được gửi. Bạn có thể điều chỉnh điều này theo từng kênh hoặc từng tài khoản: 
channels:
  defaults:
    heartbeat:
      showOk: false # Hide HEARTBEAT_OK (default)
      showAlerts: true # Show alert messages (default)
      useIndicator: true # Emit indicator events (default)
  telegram:
    heartbeat:
      showOk: true # Show OK acknowledgments on Telegram
  whatsapp:
    accounts:
      work:
        heartbeat:
          showAlerts: false # Suppress alert delivery for this account
Độ ưu tiên: theo tài khoản → theo kênh → mặc định kênh → mặc định tích hợp sẵn.

​
Mỗi cờ làm gì

  • showOk: gửi một xác nhận HEARTBEAT_OK khi mô hình trả về phản hồi chỉ OK.
  • showAlerts: gửi nội dung cảnh báo khi mô hình trả về phản hồi không phải OK.
  • useIndicator: phát sự kiện chỉ báo cho các bề mặt trạng thái UI.
Nếu cả ba đều false, OpenClaw bỏ qua hoàn toàn lượt chạy Heartbeat (không gọi mô hình).

​
Ví dụ theo kênh so với theo tài khoản

channels:
  defaults:
    heartbeat:
      showOk: false
      showAlerts: true
      useIndicator: true
  slack:
    heartbeat:
      showOk: true # all Slack accounts
    accounts:
      ops:
        heartbeat:
          showAlerts: false # suppress alerts for the ops account only
  telegram:
    heartbeat:
      showOk: true

​
Mẫu thường gặp

Mục tiêuCấu hình
Hành vi mặc định (OK im lặng, bật cảnh báo)(không cần cấu hình)
Hoàn toàn im lặng (không thông điệp, không chỉ báo)channels.defaults.heartbeat: { showOk: false, showAlerts: false, useIndicator: false }
Chỉ chỉ báo (không thông điệp)channels.defaults.heartbeat: { showOk: false, showAlerts: false, useIndicator: true }
OK chỉ trong một kênhchannels.telegram.heartbeat: { showOk: true }

​
HEARTBEAT.md (tùy chọn)

Nếu có tệp HEARTBEAT.md trong workspace, prompt mặc định sẽ yêu cầu tác nhân đọc nó. Hãy xem nó như “danh sách kiểm tra Heartbeat” của bạn: nhỏ, ổn định, và an toàn để xem xét mỗi 30 phút. Trong các lượt chạy bình thường, HEARTBEAT.md chỉ được chèn khi hướng dẫn Heartbeat được bật cho tác nhân mặc định. Tắt nhịp Heartbeat bằng 0m hoặc đặt includeSystemPromptSection: false sẽ bỏ nó khỏi ngữ cảnh bootstrap bình thường. Trên harness Codex gốc, nội dung HEARTBEAT.md không được chèn vào lượt. Nếu tệp tồn tại và có nội dung không phải khoảng trắng, các hướng dẫn chế độ cộng tác Heartbeat sẽ chỉ Codex tới tệp và bảo nó đọc trước khi tiếp tục. Nếu HEARTBEAT.md tồn tại nhưng gần như trống (chỉ có dòng trống, chú thích Markdown/HTML, tiêu đề Markdown như # Heading, dấu fence, hoặc khung danh sách kiểm tra trống), OpenClaw bỏ qua lượt chạy Heartbeat để tiết kiệm các lệnh gọi API. Lần bỏ qua đó được báo cáo là reason=empty-heartbeat-file. Nếu thiếu tệp, Heartbeat vẫn chạy và mô hình quyết định phải làm gì. Giữ nó thật nhỏ (danh sách kiểm tra hoặc lời nhắc ngắn) để tránh phình prompt. Ví dụ HEARTBEAT.md: 
# Heartbeat checklist

- Quick scan: anything urgent in inboxes?
- If it's daytime, do a lightweight check-in if nothing else is pending.
- If a task is blocked, write down _what is missing_ and ask Peter next time.

​
Khối tasks:

HEARTBEAT.md cũng hỗ trợ một khối tasks: có cấu trúc nhỏ cho các kiểm tra theo khoảng thời gian bên trong chính Heartbeat. Ví dụ: 
tasks:

- name: inbox-triage
  interval: 30m
  prompt: "Check for urgent unread emails and flag anything time sensitive."
- name: calendar-scan
  interval: 2h
  prompt: "Check for upcoming meetings that need prep or follow-up."

# Additional instructions

- Keep alerts short.
- If nothing needs attention after all due tasks, reply HEARTBEAT_OK.
  • OpenClaw phân tích khối tasks: và kiểm tra từng tác vụ theo interval riêng của nó.
  • Chỉ các tác vụ đến hạn được đưa vào prompt Heartbeat cho tick đó.
  • Nếu không có tác vụ nào đến hạn, Heartbeat bị bỏ qua hoàn toàn (reason=no-tasks-due) để tránh một lệnh gọi mô hình lãng phí.
  • Nội dung không phải tác vụ trong HEARTBEAT.md được giữ lại và nối thêm làm ngữ cảnh bổ sung sau danh sách tác vụ đến hạn.
  • Dấu thời gian lần chạy cuối của tác vụ được lưu trong trạng thái phiên (heartbeatTaskState), vì vậy các khoảng thời gian vẫn tồn tại qua các lần khởi động lại bình thường.
  • Dấu thời gian tác vụ chỉ được nâng lên sau khi một lượt chạy Heartbeat hoàn tất đường phản hồi bình thường. Các lượt chạy empty-heartbeat-file / no-tasks-due bị bỏ qua không đánh dấu tác vụ là đã hoàn tất.
Chế độ tác vụ hữu ích khi bạn muốn một tệp Heartbeat chứa nhiều kiểm tra định kỳ mà không phải trả chi phí cho tất cả chúng ở mọi tick.

​
Tác nhân có thể cập nhật HEARTBEAT.md không?

Có — nếu bạn yêu cầu. HEARTBEAT.md chỉ là một tệp bình thường trong workspace của tác nhân, nên bạn có thể bảo tác nhân (trong một cuộc chat bình thường) điều gì đó như:
  • “Cập nhật HEARTBEAT.md để thêm kiểm tra lịch hằng ngày.”
  • “Viết lại HEARTBEAT.md để nó ngắn hơn và tập trung vào các theo dõi hộp thư đến.”
Nếu bạn muốn việc này diễn ra chủ động, bạn cũng có thể đưa một dòng rõ ràng vào prompt Heartbeat của mình như: “Nếu danh sách kiểm tra trở nên cũ, hãy cập nhật HEARTBEAT.md bằng một danh sách tốt hơn.”
Đừng đưa bí mật (khóa API, số điện thoại, token riêng tư) vào HEARTBEAT.md — nó trở thành một phần của ngữ cảnh prompt.

​
Đánh thức thủ công (theo yêu cầu)

Bạn có thể đưa một sự kiện hệ thống vào hàng đợi và kích hoạt Heartbeat ngay lập tức bằng: 
openclaw system event --text "Check for urgent follow-ups" --mode now
Nếu nhiều tác nhân đã cấu hình heartbeat, một lần đánh thức thủ công sẽ chạy ngay tất cả Heartbeat của các tác nhân đó. Dùng --mode next-heartbeat để chờ tick đã lên lịch tiếp theo.

​
Gửi reasoning (tùy chọn)

Theo mặc định, Heartbeat chỉ gửi payload “câu trả lời” cuối cùng. Nếu bạn muốn minh bạch hơn, hãy bật:
  • agents.defaults.heartbeat.includeReasoning: true
Khi được bật, Heartbeat cũng sẽ gửi một thông điệp riêng có tiền tố Thinking (cùng dạng với /reasoning on). Điều này có thể hữu ích khi tác nhân đang quản lý nhiều phiên/codex và bạn muốn thấy vì sao nó quyết định ping bạn — nhưng nó cũng có thể rò rỉ nhiều chi tiết nội bộ hơn mức bạn muốn. Nên giữ tắt trong chat nhóm.

​
Nhận thức chi phí

Heartbeat chạy các lượt tác nhân đầy đủ. Khoảng thời gian ngắn hơn tiêu tốn nhiều token hơn. Để giảm chi phí:
  • Dùng isolatedSession: true để tránh gửi toàn bộ lịch sử hội thoại (từ khoảng 100K token xuống khoảng 2-5K mỗi lượt chạy).
  • Dùng lightContext: true để giới hạn các tệp bootstrap chỉ còn HEARTBEAT.md.
  • Đặt một model rẻ hơn (ví dụ ollama/llama3.2:1b).
  • Giữ HEARTBEAT.md nhỏ.
  • Dùng target: "none" nếu bạn chỉ muốn cập nhật trạng thái nội bộ.

​
Tràn ngữ cảnh sau Heartbeat

Nếu một Heartbeat trước đó để lại một phiên hiện có trên một mô hình cục bộ nhỏ hơn, ví dụ một mô hình Ollama với cửa sổ 32k, và lượt phiên chính tiếp theo báo tràn ngữ cảnh, hãy đặt lại mô hình runtime của phiên về mô hình chính đã cấu hình. Thông điệp đặt lại của OpenClaw nêu rõ điều này khi mô hình runtime cuối cùng khớp với heartbeat.model đã cấu hình. Các Heartbeat hiện tại giữ nguyên mô hình runtime hiện có của phiên chia sẻ sau khi lượt chạy hoàn tất. Bạn vẫn có thể dùng isolatedSession: true để chạy Heartbeat trong một phiên mới, kết hợp với lightContext: true để có prompt nhỏ nhất, hoặc chọn một mô hình Heartbeat có cửa sổ ngữ cảnh đủ lớn cho phiên chia sẻ.

​
Liên quan