QuotaCheap Playbook

Cài OpenClaw: từ installer đến Gateway, Control UI và health check production

Hướng dẫn cài OpenClaw cho production: installer script, npm/source/container options, Gateway service, Control UI, port/bind/auth, status/logs/doctor và Q…

Cài được CLI mới là ngày 0. Muốn chạy agent thật, bạn cần hiểu Gateway service, port/bind/auth, health checks, logs, doctor và cách Control UI nối vào runtime.

Playbook tiếng Việt về cài OpenClaw: system requirements, installer script, npm/pnpm/bun/source/container options, onboarding, Gateway service, status checks, Control UI, port/bind/auth, hot reload, troubleshooting PATH và QuotaCheap model gateway positioning.

Cài OpenClaw không khó.

Nhưng cài xong mà hiểu mình vừa cài cái gì mới là phần quan trọng.

Nhiều người nhìn agent framework như một CLI: chạy được lệnh là xong.

OpenClaw không chỉ là CLI.

Nó có Gateway always on, channel connections, sessions, tools, cron, plugin routes, Control UI, auth boundary, config reload, model provider access và operator diagnostics.

Nếu bạn chỉ nhớ một câu: CLI là tay điều khiển; Gateway mới là runtime sống.

Bài này đi từ install đến vận hành ngày đầu: chọn cách cài, onboard, verify, hiểu Gateway service, Control UI, port/bind/auth, logs, doctor, và chỗ QuotaCheap nằm trong stack model access.

System requirements: Node 24 hoặc Node 22.19+ OpenClaw install docs nêu requirements: Node 24 recommended hoặc Node 22.19+.

macOS, Linux, Windows.

Windows có native Windows Hub app, PowerShell CLI installer, hoặc WSL2 Gateway.

pnpm chỉ cần nếu build from source.

Recommended installer script tự detect OS, install Node nếu cần, install OpenClaw, rồi launch onboarding.

Điểm thực dụng: nếu bạn chỉ muốn dùng OpenClaw nhanh, dùng installer.

Nếu bạn muốn build/contribute, hãy đi source path.

Nếu bạn deploy headless/server, đọc thêm Docker/Podman/Nix/Ansible/VPS docs.

Recommended install: script installer macOS / Linux / WSL2: Windows PowerShell: Không muốn chạy onboarding ngay: Windows tương ứng: Đây là path hợp cho phần lớn người dùng.

Installer xử lý phần nhàm chán: Node, package, onboarding.

Nhàm chán mà đúng là tốt: cài agent framework không nên bắt đầu bằng yak shaving Node version.

Alternative installs: npm, pnpm, bun, source, local prefix Nếu bạn quản lý Node global packages riêng: Với pnpm: Với bun: Docs lưu ý: Bun supported cho global CLI install path, nhưng Node vẫn là recommended daemon runtime cho Gateway.

Local prefix installer khi muốn OpenClaw và Node nằm dưới prefix như ~/.openclaw: From source cho contributors: Production rule: chọn install method theo mục tiêu vận hành, không theo cảm xúc “mình thích tool X”.

CLI only khác daemon runtime.

Local laptop khác VPS.

Source checkout khác package release.

Verify install: version, doctor, gateway status Sau install, docs đưa ba check cơ bản: Đây nên là muscle memory.