vps-lite-boot — Chống OOM cho OpenClaw trên VPS yếu
Giúp VPS RAM nhỏ (1–2GB) chạy OpenClaw không bị vòng lặp restart do OOM Killer giết tiến trình openclaw-gateway.
⚠️ CẢNH BÁO — ĐỌC KỸ TRƯỚC KHI CHẠY
Skill này thay đổi cấu hình hệ thống:
Sửa openclaw.json (hạ giới hạn chạy song song) — luôn backup trước khi sửa.
Tạo/xóa swapfile và sửa /etc/fstab (thêm 1 dòng) — file ảnh hưởng lúc khởi động máy.
Chạy lệnh với quyền sudo/root.
Có thể tạo systemd drop-in để bảo vệ gateway khỏi OOM Killer.
Chỉ chạy khi người dùng hiểu và đồng ý. Nêu rõ các điểm trên và chờ xác nhận trước khi làm.
Phạm vi (scope) — chỉ đúng việc này:
Hạ agents.defaults.maxConcurrent và agents.defaults.subagents.maxConcurrent.
Đảm bảo có swap (tạo nếu chưa có) + ghi fstab an toàn.
Bảo vệ gateway khỏi OOM bằng systemd drop-in (tùy chọn, có xác nhận).
Không cài phần mềm mới, không đụng dữ liệu, không đổi cấu hình SSH hay dịch vụ không liên quan.
Nguyên nhân gốc (để hiểu đúng — KHÔNG bịa cơ chế)
OpenClaw chạy một tiến trình openclaw-gateway duy nhất (in-process). "Worker"/"session" là task BÊN TRONG tiến trình — không phải process riêng để kill. Vì vậy:
❌ KHÔNG có lệnh "tắt worker" nào cả. Kill process con/session không giúp gì.
✅ Cách giảm tải thật sự là: (1) hạ giới hạn chạy song song trong config, (2) thêm swap, (3) hạ ưu tiên OOM của gateway.
Triệu chứng OOM điển hình trên VPS 2GB:
text
Gateway start → khôi phục session → RAM thực tăng cao → Kernel OOM Killer
→ giết openclaw-gateway → systemd tự restart → lặp vô hạn
Khi nào dùng
VPS 1–2GB RAM vừa cài OpenClaw, hoặc gateway restart liên tục.
Log/thông báo có dấu hiệu: Out of memory, oom-killer, Killed process ... openclaw-gateway.
Ví dụ kích hoạt (người dùng KHÔNG cần biết từ kỹ thuật)
Người dùng chỉ cần nói điều họ thấy/điều họ muốn. Chỉ 1 câu là đủ để kích hoạt skill này:
"Tối ưu máy chủ giúp em" (câu chính — ngắn nhất, ai cũng nói được)
"Tối ưu máy chủ cho đỡ lag"
"VPS treo hoài, tối ưu giúp em"
"VPS em yếu quá, hay tự khởi động lại"
"Máy em tự nhiên đứng, phải bật lại hoài"
"Con bot em chạy được lúc rồi tự tắt"
"VPS 2GB của em lag quá"
"Em mới tạo VPS, cài xong là nó đứng luôn"
"Làm cho VPS em chạy nhẹ hơn được không"
⚠️ Lưu ý khi người dùng nói chung chung ("tối ưu máy chủ"): chỉ áp dụng skill này cho ca máy yếu / hay treo / thiếu RAM (RAM ≤2GB, gateway tự restart). Nếu ý người dùng là việc khác (dọn log, cập nhật, tối ưu web...) → hỏi lại trước, không tự làm.
Bước 0 — Xác nhận + điều tra (KHÔNG sửa gì)
Chỉ thực thi khi người yêu cầu là owner. Chạy các lệnh chỉ đọc sau, thu thập số liệu THẬT:
bash
# RAM & swap hiện tại
free -m
swapon --show
cat /proc/swaps
# Kiểm tra có bị OOM không (bằng chứng thật)
journalctl -k --since "3 days ago" 2>/dev/null | grep -iE "oom|killed process" | tail -20
dmesg 2>/dev/null | grep -iE "oom|killed process" | tail -20
# Tiến trình gateway
ps aux | grep -i openclaw-gateway | grep -v grep
# Cấu hình hiện tại (chỉ đọc các số liên quan)
python3 - <<'PY'
import json,os
p=os.path.expanduser("~/config/openclaw.json")
if not os.path.exists(p): p=os.path.expanduser("~/.openclaw/openclaw.json")
d=json.load(open(p))
ag=(d.get("agents") or {}).get("defaults") or {}
print("config:", p)
print("maxConcurrent:", ag.get("maxConcurrent"))
print("subagents.maxConcurrent:", (ag.get("subagents") or {}).get("maxConcurrent"))
PY
Báo người dùng số liệu thật + xác nhận có OOM hay không.
Nếu không có dấu hiệu OOM → nói thẳng, hỏi lại triệu chứng, KHÔNG sửa mù.
Nếu có OOM → trình bày 3 việc sẽ làm (Bước 1–3) và chờ đồng ý.
Bước 1 — Hạ giới hạn chạy song song (giảm đỉnh RAM lớn nhất)
Đây là việc đúng nhất cho triệu chứng "khôi phục session làm RAM tăng vọt".
