> ## 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.
# Heartbeat
**Heartbeat so với Cron?** Xem [Tự động hóa](/vi/automation) để 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](/vi/automation/tasks). 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](/vi/automation/cron-jobs#troubleshooting)
## Khởi động nhanh (người mới bắt đầu)
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.
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.
`target: "none"` là mặc định; đặt `target: "last"` để định tuyến đến liên hệ gần nhất.
* 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ụ:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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ờ](/vi/concepts/timezone)).
Heartbeat có thể phản ứng với [tác vụ nền](/vi/automation/tasks) đã 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
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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 | (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..heartbeat` ghi đè mặc định của kênh.
* `channels..accounts..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.
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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ể:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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
Khoảng thời gian Heartbeat (chuỗi thời lượng; đơn vị mặc định = phút).
Ghi đè mô hình tùy chọn cho các lượt chạy Heartbeat (`provider/model`).
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`).
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.
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.
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.
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](/vi/cli/sessions)).
* Định dạng khóa phiên: xem [Phiên](/vi/concepts/session) và [Nhóm](/vi/channels/groups).
* `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.
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`).
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 `:topic:`.
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.
Ghi đè nội dung prompt mặc định (không gộp).
Số ký tự tối đa được phép sau `HEARTBEAT_OK` trước khi gửi.
Khi true, chặn các payload cảnh báo lỗi công cụ trong các lượt chạy Heartbeat.
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.
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::`), 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](/vi/automation/tasks) 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:
```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}}
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êu | Cấ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ênh | `channels.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`:
```md theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 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ụ:
```md theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
* [Tự động hóa](/vi/automation) — tổng quan tất cả cơ chế tự động hóa
* [Tác vụ nền](/vi/automation/tasks) — cách theo dõi công việc tách rời
* [Múi giờ](/vi/concepts/timezone) — cách múi giờ ảnh hưởng đến việc lập lịch Heartbeat
* [Khắc phục sự cố](/vi/automation/cron-jobs#troubleshooting) — gỡ lỗi các vấn đề tự động hóa