OpenClaw Runbook – Hướng dẫn thực tế để chạy OpenClaw trong production

TL;DR

OpenClaw Runbook là tài liệu hướng dẫn thực tế giúp bạn chạy OpenClaw ổn định trong production mà không burn hết quota API hay bị crash liên tục. Tập trung vào coordinator/worker models, kiểm soát chi phí, và các guardrails để hệ thống chạy được vài tuần thay vì vài phút.

Nói cách khác, đây là tài liệu cho những ai muốn dùng AI agent vào việc thật – không phải demo, không phải marketing – mà là cách setup để nó chạy bền, không tốn tiền oan, và không phải fix lỗi lúc 2 giờ sáng.

Bài này dành cho ai?

1. Solo Developer / Indie Hacker

Dùng khi: Bạn đang build side project hoặc MVP, cần chạy AI agent trên VPS để automate task nhưng không muốn tốn quá nhiều tiền mỗi tháng.

Được gì: Setup ổn định, chạy được vài tuần liên tục mà không phải restart liên tục. Tiết kiệm thời gian debug vì đã có config mẫu sẵn.

2. Small Team Lead (3-10 người)

Dùng khi: Team cần tự động hóa workflow nhưng không có devops riêng. Bạn muốn agent chạy background mà không lo nó sẽ “bùng” API key hay quota.

Được gì: Có pattern về security và cost control sẵn. Không phải mò từ đầu.

3. Automation-First User (đã dùng AI agent trước)

Dùng khi: Bạn từng thử chạy agent và thấy nó chạy vài phút rồi chết, hoặc không biết cách scale lên production.

Được gì: Hướng dẫn cụ thể để chạy bền vững, có monitoring, có cách handle failure. Không phải tự mò lại từ đầu mỗi lần nó crash.

Các điểm chính

1. Không phải beginner tutorial – đây là runbook cho người đã biết cách chạy OpenClaw. Tài liệu tập trung vào coordinator vs worker models, cost control, memory boundaries, và guardrails. Nếu bạn mới bắt đầu, hãy xem docs chính thức tại docs.openclaw.ai trước.

2. Examples directory chứa template có thể copy-paste ngay. Bao gồm: agent-prompts.md (tạo specialized agents, model chains), spawning-patterns.md (spawn sub-agents từ skills/prompts/cron), security-hardening.md (API keys, tool policies, cost controls, network lockdown), và check-quotas.sh (script kiểm tra quota API). Mỗi file đều có config snippet cụ thể – lấy về xài liền.

3. Showcases sẵn sàng deploy chỉ cần thay placeholders. Ví dụ: daily-brief tự động tổng hợp thời tiết/lịch/tasks mỗi sáng, linkedin-drafter tạo content hàng tuần, homelab-access cho SSH an toàn qua Telegram. Copy cron job, điền placeholders, deploy – xong.

4. Tài nguyên cộng đồng bổ sung: ClawHub và awesome lists. ClawHub giúp discover và share AgentSkills. Ba awesome lists (usecases, tools, skills) có hàng trăm ví dụ thực tế từ cộng đồng – dùng khi cần thêm pattern ngoài những gì runbook cung cấp.

5. Phiên bản tested: OpenClaw 2026.2.x. Đây là tài liệu được tạo với sự hỗ trợ của Claude, không phải official guide hay marketing. Nghĩa là bạn nhận được trải nghiệm thực từ người đã “break it repeatedly” và muốn setup ổn định, predictable, và boring theo cách tốt. Kiểm tra version trước khi áp dụng.

Quick Start

1. Chạy script kiểm tra quota API

cd examples/
chmod +x check-quotas.sh
./check-quotas.sh

Script này sẽ cho bạn biết mình đã dùng bao nhiêu API quota tuần này. Biết số liệu trước khi bị charge – không phải guesswork.

2. Áp dụng security-quickstart

Mở examples/security-quickstart.md, copy đoạn prompt đầu tiên, paste vào OpenClaw. Đây là cách nhanh nhất để thêm guardrails cơ bản cho agent mà không cần config phức tạp.

3. Deploy một showcase đơn giản

Chọn showcases/homelab-access.md – nó dùng được ngay với Telegram, không cần setup gì nhiều. Copy cron job, thay placeholders, chạy thử.

Hoặc nếu muốn something nhẹ hơn: showcases/daily-brief.md – chạy mỗi sáng, cho bạn biết thời tiết + lịch + tasks.

Cả 3 đều không cần hiểu sâu về OpenClaw trước. Bắt đầu từ cái dễ nhất, rồi mở rộng dần.