Tự động hóa với HEARTBEAT.md: Để OpenClaw làm việc khi bạn ngủ

Từ “hỏi rồi trả lời” sang “tự biết mà làm”

Phần lớn AI agent hoạt động theo kiểu reactive: bạn hỏi, nó trả lời. Bạn không hỏi, nó im. Nhưng nhiều tác vụ quan trọng không nên phụ thuộc vào việc bạn nhớ hỏi — kiểm tra server có chạy không, SSL certificate sắp hết hạn chưa, backup đêm qua có thành công không.

OpenClaw giải quyết vấn đề này bằng HEARTBEAT.md — một file checklist mà agent tự chạy qua định kỳ, giống nhịp tim đập đều. Không cần bạn nhắc, không cần bạn online.

HEARTBEAT.md hoạt động thế nào?

OpenClaw Gateway chạy như daemon ở background. Mặc định cứ 30 phút một lần, agent sẽ:

1. Đọc file HEARTBEAT.md trong workspace
2. Duyệt qua từng mục trong checklist
3. Quyết định mục nào cần hành động (dựa trên thời gian, điều kiện)
4. Thực hiện hành động nếu cần
5. Nhắn cho bạn nếu có gì đáng chú ý
6. Nếu không có gì, im lặng trả về HEARTBEAT_OK

Nghĩa là: agent chỉ “quấy rầy” bạn khi thực sự có vấn đề. Không spam, không báo cáo vô nghĩa.

Viết HEARTBEAT.md đầu tiên

Bắt đầu đơn giản. Đây là ví dụ HEARTBEAT.md cho developer chạy VPS:

# Heartbeat Checklist

## Mỗi 30 phút
- [ ] Kiểm tra server production (10.10.10.2) có respond không
  - Ping hoặc curl health endpoint
  - Nếu không respond sau 3 lần thử: gửi alert qua Telegram

## Mỗi giờ
- [ ] Kiểm tra disk usage trên VPS
  - Nếu > 85%: cảnh báo
  - Nếu > 95%: cảnh báo khẩn cấp + tự dọn Docker images cũ

## Mỗi 6 giờ
- [ ] Kiểm tra SSL certificate
  - Nếu hết hạn trong 7 ngày: nhắc renew
  - Nếu hết hạn trong 1 ngày: chạy certbot renew tự động

## Mỗi ngày (lúc 8h sáng)
- [ ] Tóm tắt hoạt động hôm qua
  - Commits mới, deployments, incidents
  - Gửi bản tóm tắt qua Telegram

## Mỗi tuần (thứ Hai)
- [ ] Kiểm tra backup database
  - Verify file backup mới nhất < 24h
  - Kiểm tra kích thước backup có hợp lý không
  - Báo cáo nếu backup bị thiếu hoặc kích thước bất thường

Lưu ý: Agent sẽ tự phân biệt tần suất dựa trên mô tả. Bạn viết “mỗi giờ”, agent sẽ chỉ kiểm tra mục đó khi đã qua 1 giờ kể từ lần kiểm tra trước. Không cần cấu hình cron phức tạp.

Cấu hình tần suất heartbeat

Mặc định heartbeat chạy mỗi 30 phút. Bạn có thể thay đổi trong openclaw.json:

{
  "gateway": {
    "heartbeat": {
      "interval": "15m",
      "enabled": true
    }
  }
}

Nếu dùng Anthropic OAuth (thay vì API key riêng), heartbeat mặc định giảm xuống mỗi giờ để tiết kiệm quota.

Mẹo: Đừng đặt interval quá thấp (dưới 10 phút). Mỗi heartbeat là một phiên agent đầy đủ — tốn token và tài nguyên. 15-30 phút là cân bằng tốt giữa phản ứng nhanh và chi phí.

Sub-Agents: Chia nhỏ công việc phức tạp

Khi một tác vụ heartbeat quá phức tạp cho một agent xử lý, OpenClaw hỗ trợ sub-agents — agent con được sinh ra để xử lý một phần công việc cụ thể.

Agent chính có thể dùng tool sessions_spawn để tạo sub-agent:

## Heartbeat: Báo cáo tuần
- [ ] Mỗi thứ Hai 9h sáng, tạo báo cáo tuần:
  - Spawn sub-agent "report-builder" để thu thập dữ liệu từ GitHub
  - Spawn sub-agent "metrics-analyzer" để phân tích traffic và performance
  - Tổng hợp kết quả từ các sub-agent
  - Format thành báo cáo gọn, gửi qua Telegram

Sub-agents chạy trong sandbox riêng, có context riêng, và báo kết quả lại cho agent chính. Giống như bạn giao việc cho team — mỗi người xử lý phần của mình, rồi bạn tổng hợp.

Quản lý sub-agents:

# Xem sub-agents đang chạy
openclaw agents list

# Dừng một sub-agent cụ thể
openclaw agents kill report-builder

# Dừng tất cả sub-agents
openclaw agents kill --all

Ví dụ thực tế: Setup tự động hóa cho VPS OnMay

Đây là setup HEARTBEAT.md hoàn chỉnh cho khách hàng OnMay chạy AI agent 24/7:

# OnMay VPS Heartbeat

## Monitoring (mỗi 15 phút)
- [ ] Health check: curl http://localhost:3000/api/v1/health
  - Nếu fail: restart Docker container "openclaw-gateway"
  - Nếu fail sau restart: alert Telegram + ghi log

## Tài nguyên (mỗi giờ)  
- [ ] Kiểm tra RAM usage
  - Nếu > 85%: xoá Docker cache (docker system prune -f)
  - Nếu > 95% sau khi prune: alert khẩn cấp
- [ ] Kiểm tra disk
  - Nếu > 80%: xoá Docker images không dùng
  - Log rotation cho files > 100MB

## OpenClaw (mỗi 6 giờ)
- [ ] Kiểm tra agent có responsive không
  - Test bằng ping message
  - Nếu không response: restart gateway
- [ ] Kiểm tra memory index
  - Nếu index outdated > 24h: trigger reindex

## Bảo mật (mỗi ngày)
- [ ] Kiểm tra auth log cho brute force attempts
  - Nếu > 50 failed login từ cùng IP: block IP bằng iptables
- [ ] Scan Docker images cho known vulnerabilities
  - Alert nếu có CVE severity HIGH trở lên

## Báo cáo (mỗi ngày lúc 7h)
- [ ] Tóm tắt ngày qua:
  - Uptime percentage
  - Số request đã xử lý
  - Top 5 errors
  - Disk/RAM/CPU trung bình
  - Gửi qua Telegram dạng compact

Kết hợp Heartbeat với Memory

Một pattern mạnh mẽ: để heartbeat tự ghi kết quả vào daily notes. Ví dụ thêm vào HEARTBEAT.md:

## Logging (mỗi heartbeat)
- [ ] Ghi kết quả kiểm tra vào memory/YYYY-MM-DD.md
  - Format: ## Heartbeat [HH:MM] — [OK/WARN/ERROR]
  - Chỉ ghi chi tiết khi có cảnh báo hoặc lỗi

Lợi ích: khi bạn hỏi “server hôm nay thế nào?”, agent có thể xem daily notes thay vì phải kiểm tra lại — trả lời nhanh hơn và không tốn thêm tài nguyên.

Multi-Agent: Mỗi agent một nhiệm vụ

OpenClaw hỗ trợ chạy nhiều agent song song trên cùng Gateway. Mỗi agent có workspace riêng, HEARTBEAT.md riêng, và kênh giao tiếp riêng.

Ví dụ setup 3 agent trên VPS OnMay:

Trong openclaw.json:

{
  "agents": {
    "list": [
      {
        "id": "dev-assistant",
        "workspace": "~/.openclaw/workspaces/dev",
        "channels": ["telegram-personal"]
      },
      {
        "id": "ops-monitor",
        "workspace": "~/.openclaw/workspaces/ops",
        "channels": ["telegram-alerts"]
      },
      {
        "id": "customer-support",
        "workspace": "~/.openclaw/workspaces/support",
        "channels": ["website-chat"]
      }
    ]
  }
}

Mỗi agent có HEARTBEAT.md phù hợp với vai trò:

• dev-assistant — Heartbeat kiểm tra CI/CD, code quality
• ops-monitor — Heartbeat kiểm tra server, security, backup
• customer-support — Heartbeat kiểm tra ticket chưa trả lời, SLA

Tin nhắn đến được Gateway tự động route đến đúng agent dựa trên kênh (channel) và nội dung.

Bảo mật cho autonomous workflows

Agent chạy tự động 24/7 cần được kiểm soát chặt hơn agent chỉ chạy khi bạn chat:

Giới hạn quyền. Trong HEARTBEAT.md, chỉ liệt kê các tác vụ bạn tin tưởng agent tự làm. Các hành động nguy hiểm (xoá dữ liệu, deploy production) nên yêu cầu xác nhận trước.

Logging đầy đủ. Bật hook log-tool-calls để ghi lại mọi hành động agent thực hiện trong heartbeat. Nếu có vấn đề, bạn có audit trail.

Alert thông minh. Đừng để agent gửi quá nhiều alert — bạn sẽ bắt đầu ignore chúng (alert fatigue). Cấu hình ngưỡng hợp lý và gom nhiều cảnh báo nhỏ thành một tóm tắt.

Test trước khi deploy. Chạy heartbeat vài ngày ở chế độ “dry run” (chỉ log, không hành động) trước khi bật auto-fix. Đảm bảo agent phán đoán đúng trước khi cho nó quyền hành động.

Chi phí chạy heartbeat

Mỗi heartbeat tick là một phiên agent nhỏ, tốn khoảng 1.000-5.000 token tuỳ độ phức tạp checklist. Với heartbeat mỗi 30 phút:

• 48 ticks/ngày × 3.000 token = ~144.000 token/ngày
• Với Claude Sonnet (~$3/1M token input): khoảng $0.43/ngày
• Với Haiku (~$0.25/1M token): khoảng $0.04/ngày

Mẹo tiết kiệm: Dùng model nhỏ (Haiku, GPT-4o mini) cho heartbeat. Phần lớn tác vụ monitoring không cần model mạnh — kiểm tra ping response hay disk usage là việc đơn giản.

Tổng kết

HEARTBEAT.md biến OpenClaw từ chatbot thụ động thành trợ lý chủ động. Agent tự kiểm tra, tự cảnh báo, và có thể tự xử lý những vấn đề đơn giản — tất cả chỉ bằng một file markdown.

Trên VPS OnMay, OpenClaw chạy 24/7 với đủ tài nguyên cho cả agent lẫn heartbeat. Bạn ngủ, agent vẫn canh server. Bạn đi chơi, agent vẫn gửi báo cáo. Đó là sức mạnh của Zero-Human-Ops mà OnMay hướng tới.

Bắt đầu với 2-3 mục heartbeat đơn giản (health check, disk monitor, daily summary). Thêm dần khi bạn tin tưởng agent hơn. Và nhớ: agent chạy tự động chỉ tốt khi bạn thiết lập đúng giới hạn cho nó.