Cách cài OpenClaw: Hướng dẫn cài đặt từ A-Z cho người mới (2026)

OpenClaw là trợ lý AI mã nguồn mở (miễn phí, ai cũng có thể sử dụng và đóng góp) do Peter Steinberger phát triển — mã nguồn công khai tại github.com/openclaw/openclaw. Nó biến các nền tảng nhắn tin bạn dùng hàng ngày — Telegram, WhatsApp, Slack, Discord và hơn 20 kênh khác — thành nơi bạn giao việc cho AI: viết nội dung, phân tích dữ liệu, tự động hóa quy trình, quản lý cộng đồng, và nhiều hơn nữa.

Bài viết này hướng dẫn bạn 4 cách cài đặt OpenClaw — từ nhanh nhất (1 dòng lệnh) đến không cần cài gì (dùng cloud). Mỗi bước đều giải thích rõ: bạn đang làm gì, cần gì, và làm sao biết bước đó đã thành công.

Mới biết đến OpenClaw? Đọc OpenClaw là gì? Tổng quan đầy đủ nhất 2026 để hiểu OpenClaw làm được gì trước khi cài đặt.

---

Chọn cách cài đặt phù hợp với bạn

Không phải ai cũng cần cùng một con đường. Bảng dưới đây giúp bạn chọn nhanh:

Cách cài	Thời gian	Cần biết kỹ thuật?	Phù hợp với ai
Cách 1: One-liner (script cài tự động)	5-10 phút	Biết mở Terminal cơ bản	Người muốn cài nhanh trên macOS/Linux
Cách 2: npm global install	5-10 phút	Biết mở Terminal cơ bản	Người đã quen Node.js
Cách 3: Từ source code	15-30 phút	Có kinh nghiệm lập trình	Developer muốn đọc/sửa mã nguồn
Cách 4: TryOpenClaw.io (cloud)	2 phút	Không cần	Mọi người — đặc biệt nếu bạn không muốn cài đặt

Không biết nên chọn cách nào? Nếu bạn dùng macOS hoặc Linux, chọn Cách 1 (one-liner). Nếu bạn không muốn cài gì cả, chọn Cách 4 (TryOpenClaw cloud).

---

Trước khi bắt đầu: Hiểu kiến trúc OpenClaw

OpenClaw gồm 3 thành phần chính hoạt động cùng nhau — biết điều này giúp bạn hiểu mỗi bước cài đặt đang setup phần nào, và debug nhanh hơn nếu gặp lỗi:

Gateway — “tổng đài” điều phối của OpenClaw. Nó chạy ngầm trên máy bạn (như một dịch vụ nền), nhận tin nhắn bạn gửi từ Telegram/Slack/Discord, chuyển cho AI xử lý, rồi trả kết quả về. Gateway hoạt động qua địa chỉ nội bộ ws://127.0.0.1:18789 — bạn không cần nhớ con số này, chỉ cần biết nó chạy trên máy bạn.

Model AI (LLM) — “bộ não” xử lý yêu cầu. OpenClaw không tự tạo câu trả lời — nó gửi yêu cầu đến model AI bên ngoài như Claude (Anthropic), GPT (OpenAI), hoặc Gemini (Google). Bạn cần có API key (mã truy cập) từ một trong các nhà cung cấp này, hoặc chạy model trên chính máy bạn qua Ollama.

Channel — nơi bạn “nói chuyện” với OpenClaw. Thay vì mở một app riêng, bạn giao việc qua kênh nhắn tin quen thuộc: WhatsApp, Telegram, Slack, Discord, Signal, iMessage, và hơn 20 kênh khác. OpenClaw cũng có giao diện web riêng (WebChat) và app companion trên macOS, iOS, Android.

Dòng chảy xử lý: Bạn gửi tin nhắn → Channel chuyển đến Gateway → Gateway gọi Model AI → Kết quả trả về Channel.

Đọc thêm: Tính năng OpenClaw chi tiết — khám phá toàn bộ khả năng: voice, Canvas, Skills, browser control, cron job…

---

Yêu cầu hệ thống

Đây là những gì máy tính bạn cần có. Nếu bạn chọn Cách 4 (TryOpenClaw cloud), bạn không cần lo phần này — mọi thứ đã được setup sẵn trên server.

Thành phần	Yêu cầu	Ghi chú
Hệ điều hành	macOS, Linux, hoặc Windows (qua WSL2)	Windows cần cài thêm WSL2 — xem hướng dẫn Windows
Node.js	Version 24 (khuyến nghị) hoặc 22.16+	Đây là môi trường chạy code JavaScript — OpenClaw cần nó để hoạt động
RAM	Tối thiểu 2 GB, khuyến nghị 4 GB+	Nếu VPS ít RAM, có thể thêm swap — xem hướng dẫn Linux
Ổ cứng	5 GB trống	SSD cho trải nghiệm nhanh hơn
Kết nối mạng	Bắt buộc	OpenClaw cần gọi API đến model AI qua internet

Kiểm tra nhanh: Mở Terminal (macOS/Linux) hoặc PowerShell (Windows) và chạy:

node -v

Nếu hiện v22.x.x hoặc v24.x.x trở lên → bạn đã sẵn sàng. Nếu báo lỗi command not found hoặc version thấp hơn 22, bạn cần cài Node.js trước — xem mục “Cài Node.js” ở phần dưới.

---

Cài Node.js (nếu chưa có)

Node.js là nền tảng để chạy OpenClaw. Nếu lệnh node -v ở trên đã cho kết quả v22+ thì bạn bỏ qua mục này.

macOS / Linux:

Cách dễ nhất là dùng nvm (Node Version Manager — công cụ quản lý phiên bản Node.js):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

Đóng Terminal, mở lại, rồi chạy:

nvm install 24

Kiểm tra thành công: Chạy node -v — phải hiện v24.x.x.

Windows:

Tải Node.js trực tiếp từ nodejs.org/en/download (chọn bản LTS), cài như một phần mềm bình thường. Hoặc nếu bạn đã cài WSL2, dùng cách macOS/Linux bên trên trong WSL terminal.

Hướng dẫn chi tiết theo OS: Mac · Windows · Linux

---

Cách 1: Cài bằng script tự động (One-liner) — Khuyến nghị

Đây là cách OpenClaw chính thức khuyến nghị (xem README trên GitHub). Một dòng lệnh duy nhất xử lý mọi thứ: tải OpenClaw, cài đặt, và cấu hình daemon (chương trình chạy nền — tự khởi động khi bạn bật máy).

Bước 1: Chạy lệnh cài đặt

macOS / Linux / WSL2 — mở Terminal và chạy:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell) — mở PowerShell với quyền Administrator và chạy:

iex (irm https://openclaw.ai/install.ps1)

Quá trình này tự động tải và cài OpenClaw. Bạn sẽ thấy tiến trình hiện trên màn hình. Đợi cho đến khi thấy thông báo cài đặt thành công.

Cách biết bước này thành công: Sau khi lệnh chạy xong, thử gõ openclaw --version — nếu hiện số phiên bản (ví dụ v2026.4.8), OpenClaw đã được cài.

Bước 2: Chạy Onboard Wizard

Đây là bước quan trọng nhất — OpenClaw có sẵn một wizard (trình hướng dẫn tương tác) giúp bạn thiết lập mọi thứ cần thiết:

openclaw onboard --install-daemon

Wizard sẽ lần lượt hướng dẫn bạn:

1. Cài Gateway daemon — chương trình chạy nền giúp OpenClaw luôn sẵn sàng, kể cả khi bạn đóng Terminal. Daemon được cài dưới dạng LaunchAgent (macOS), systemd service (Linux), hoặc Task Scheduler (Windows).

1. Chọn model AI — bạn sẽ chọn dùng Claude, GPT, Gemini, hoặc model khác. Wizard hỏi bạn nhập API key tương ứng. (Chưa có API key? Xem Hướng dẫn cấu hình API Key — chỉ mất 5 phút để tạo.)

1. Kết nối channel — chọn kênh nhắn tin bạn muốn giao tiếp với OpenClaw (Telegram, WhatsApp, Slack, Discord…). Wizard hướng dẫn bạn lấy token từ kênh đã chọn và kết nối.

1. Cấu hình Workspace — wizard tạo thư mục ~/.openclaw/workspace chứa các file cấu hình chính: AGENTS.md (hướng dẫn agent hành xử), SOUL.md (tính cách agent), TOOLS.md (công cụ agent được dùng). Bạn có thể chỉnh sửa các file này sau.

Cách biết bước này thành công: Sau khi wizard hoàn tất, chạy:

openclaw doctor

Lệnh openclaw doctor kiểm tra tất cả các thành phần (Gateway, model, channel) và báo trạng thái từng phần. Nếu tất cả đều hiện “OK” hoặc checkmark xanh, bạn đã sẵn sàng.

Bước 3: Giao task đầu tiên

Mở ứng dụng nhắn tin bạn đã kết nối (ví dụ Telegram) và gửi cho bot OpenClaw một tin nhắn đơn giản:

“Tóm tắt 3 tin công nghệ mới nhất hôm nay”

Nếu bot trả lời với nội dung hợp lý — xin chúc mừng, bạn đã cài đặt OpenClaw thành công!

Lưu ý bảo mật: Mặc định, OpenClaw yêu cầu xác thực khi có người lạ nhắn tin cho bot. Người gửi sẽ nhận được mã pairing — bạn duyệt bằng lệnh openclaw pairing approve <channel> <code>. Điều này ngăn người ngoài sử dụng bot (và tốn credit) của bạn.

---

Cách 2: Cài bằng npm/pnpm/bun (Package Manager)

Nếu bạn đã quen dùng Node.js package manager, cách này đơn giản và quen thuộc:

Bước 1: Cài OpenClaw global

Chọn package manager bạn dùng:

npm (phổ biến nhất):

npm install -g openclaw@latest

pnpm:

pnpm add -g openclaw@latest

bun:

bun add -g openclaw@latest

Cách biết thành công: Chạy openclaw --version — hiện số phiên bản là OK.

Bước 2: Chạy Onboard Wizard

Giống hệt Cách 1:

openclaw onboard --install-daemon

Wizard hướng dẫn bạn qua các bước: cài daemon, chọn model, kết nối channel, và cấu hình workspace. Chi tiết mỗi bước đã mô tả ở Cách 1 — Bước 2 phía trên.

Cách biết thành công: openclaw doctor hiện tất cả OK.

Gặp lỗi sharp build? Một số hệ thống cần build thêm thư viện native. Xem Lỗi thường gặp khi cài OpenClaw để fix nhanh.

---

Cách 3: Cài từ Source Code (dành cho Developer)

Cách này phù hợp nếu bạn muốn đọc mã nguồn, đóng góp code, hoặc chạy bản phát triển mới nhất.

Bước 1: Clone repository

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Repository chính thức: github.com/openclaw/openclaw — đây cũng là nơi bạn có thể theo dõi release mới, report bug, và đóng góp code.

Cách biết thành công: Thư mục openclaw xuất hiện và bạn đang ở trong đó. Chạy ls sẽ thấy các file như package.json, README.md.

Bước 2: Cài dependencies và build

OpenClaw dùng pnpm làm package manager chính khi build từ source:

# Cài pnpm nếu chưa có
npm install -g pnpm

# Cài dependencies + build
pnpm install && pnpm ui:build && pnpm build

Quá trình này tải về tất cả thư viện cần thiết và biên dịch mã nguồn. Có thể mất 2-5 phút tùy tốc độ mạng.

Cách biết thành công: Không có dòng nào hiện ERR! hoặc error. Terminal trả về prompt bình thường.

Bước 3: Chạy Gateway

pnpm gateway:watch

Lệnh này khởi động Gateway ở chế độ development — tự động reload khi bạn sửa code.

Cách biết thành công: Terminal hiện log Gateway đang chạy, không có lỗi đỏ.

Bước 4: Cấu hình và kết nối

Từ đây, sử dụng openclaw onboard (không cần --install-daemon vì bạn đang chạy manual) hoặc tự chỉnh sửa file ~/.openclaw/openclaw.json để cấu hình model và channel. Xem hướng dẫn cấu hình API Key cho danh sách đầy đủ các option.

Hướng dẫn chi tiết cấu hình model: Cấu hình API Key OpenClaw — từ Claude đến GPT

---

Cách 4: Dùng TryOpenClaw.io — không cài gì cả

Nếu bạn không muốn mở Terminal, không muốn cài Node.js, không muốn quản lý server — TryOpenClaw.io là giải pháp cloud chạy OpenClaw sẵn cho bạn. Mọi thứ đã được setup: OpenClaw, Gateway, bảo mật, backup, auto-update.

Bước 1: Đăng ký tài khoản

Truy cập app.tryopenclaw.io/auth/register và tạo tài khoản bằng email.

Bước 2: Chọn gói

Gói	Giá	Phù hợp với
Basic	99.000 VND/tháng	Cá nhân, thử nghiệm
Standard	249.000 VND/tháng	Freelancer, công việc hàng ngày
Premium	499.000 VND/tháng	Team nhỏ, workflow nặng

Tất cả các gói đều có: cloud riêng (isolated instance), mã hóa dữ liệu, backup hàng ngày, tự phục hồi khi crash.

Bước 3: Chọn model AI và bắt đầu

Sau khi thanh toán, hệ thống tự động deploy instance OpenClaw trong 1-2 phút. Bạn vào Dashboard → nhấn “Cài đặt Instance” → chọn model (Claude hoặc GPT) → dán API key hoặc dùng credit TryOpenClaw trực tiếp (không cần tạo API key riêng) → nhấn Deploy.

Cách biết thành công: Dashboard hiện trạng thái “Running”. Bạn có thể giao task ngay.

Bước 4: Kết nối Channel

Vào Dashboard → mục Channels → chọn kênh (Telegram, Discord, Slack…) → làm theo hướng dẫn dán token. Test bằng cách gửi tin nhắn cho bot.

Hướng dẫn đầy đủ: Chạy OpenClaw trên Cloud — không cần cài đặt ·

---

Các tùy chọn cài đặt nâng cao

Ngoài 4 cách chính ở trên, OpenClaw còn hỗ trợ nhiều phương thức cài đặt khác cho các nhu cầu đặc biệt:

Docker / Podman — chạy OpenClaw trong container, cô lập hoàn toàn với hệ thống. Phù hợp nếu bạn quen Docker hoặc muốn deploy trên server production. Xem hướng dẫn trong README trên GitHub.

Nix — cấu hình declarative, phù hợp với người dùng NixOS hoặc muốn reproducible builds.

Ansible — tự động hóa việc cài đặt trên nhiều server cùng lúc.

Remote Gateway — chạy Gateway trên một server Linux, kết nối từ máy khác qua Tailscale hoặc SSH tunnel. Phù hợp nếu bạn muốn Gateway chạy 24/7 trên VPS nhưng điều khiển từ laptop.

Các phương thức này dành cho người có kinh nghiệm kỹ thuật. Danh sách đầy đủ xem tại GitHub README. Nếu bạn mới bắt đầu, hãy dùng 4 cách chính ở trên.

---

Sau khi cài xong: Những bước tiếp theo

Cài đặt xong mới chỉ là bước đầu. Để thực sự khai thác sức mạnh của OpenClaw, hãy đi theo lộ trình này:

Ngay lập tức — Test một task đơn giản: Gửi tin nhắn: “Tóm tắt nội dung trang web [URL bất kỳ]” hoặc “Viết cho tôi 3 ý tưởng post Facebook về [chủ đề]”. Mục tiêu: xác nhận OpenClaw phản hồi đúng.

Ngày 1-3 — Cài Skills mở rộng: Skills là module giúp OpenClaw xử lý tác vụ chuyên biệt (ví dụ: SEO, viết code, phân tích tài chính). Duyệt và cài từ ClawHub (marketplace) bằng lệnh openclaw skills install <tên> hoặc qua Dashboard nếu dùng TryOpenClaw.

Tuần 2+ — Xây workflow tự động: Kết hợp nhiều task thành quy trình: cron job (lặp theo lịch), webhook trigger, hoặc chuỗi task liên tiếp. Ví dụ: mỗi sáng 8h, OpenClaw tự tổng hợp tin → phân tích → gửi briefing qua Telegram.

Khám phá Skills: OpenClaw Skills là gì? · Top Skills bạn nên cài ngay

---

Cập nhật và bảo trì

Cập nhật OpenClaw: Khi có phiên bản mới:

openclaw update

Hoặc chọn kênh cập nhật: openclaw update --channel stable (ổn định), beta (tính năng mới, có thể còn lỗi), hoặc dev (bản phát triển mới nhất). Theo dõi changelog và release mới tại github.com/openclaw/openclaw/releases.

Trên TryOpenClaw, bạn chỉ cần nhấn nút “Upgrade” trên Dashboard — không cần chạy lệnh.

Kiểm tra sức khỏe hệ thống: Bất cứ lúc nào bạn nghi ngờ OpenClaw có vấn đề:

openclaw doctor

Lệnh này kiểm tra Gateway, kết nối model, channel, và báo chính xác thành phần nào đang gặp lỗi.

---

5 lỗi phổ biến nhất khi cài đặt (và cách fix nhanh)

1. openclaw: command not found sau khi cài xong Nguyên nhân: Terminal chưa nhận đường dẫn (PATH) mới. Fix: đóng Terminal rồi mở lại, hoặc chạy source ~/.bashrc (Linux) / source ~/.zshrc (macOS).

2. node: command not found hoặc Node.js version quá cũ Nguyên nhân: Chưa cài Node.js hoặc version dưới 22. Fix: cài nvm rồi chạy nvm install 24 — xem mục “Cài Node.js” ở trên.

3. API key không hoạt động (lỗi 401 Unauthorized) Nguyên nhân: Key sai, hết credit, hoặc copy thừa khoảng trắng. Fix: kiểm tra key trên dashboard provider, đảm bảo còn credit, copy lại không thừa khoảng trắng.

4. Port đã bị chiếm (EADDRINUSE) Nguyên nhân: Có ứng dụng khác đang dùng port mặc định. Fix: tắt ứng dụng đó hoặc đổi port trong config OpenClaw.

5. Lỗi permission (EACCES) khi cài global package Nguyên nhân: npm cố ghi vào thư mục hệ thống. Fix: dùng nvm (tự quản lý quyền) hoặc đổi npm prefix — không nên dùng sudo npm install.

Hướng dẫn fix chi tiết 15+ lỗi: Lỗi thường gặp khi cài OpenClaw và cách khắc phục

---

So sánh nhanh: Tự cài vs TryOpenClaw Cloud

Tiêu chí	Tự cài (Cách 1-3)	TryOpenClaw Cloud (Cách 4)
Thời gian setup	5-30 phút	2 phút
Cần biết kỹ thuật	Cơ bản (Terminal)	Không
Chi phí hạ tầng	VPS ~$5-20/tháng (nếu cần 24/7)	Từ 99K VND/tháng
Uptime	Phụ thuộc bạn	99.9%, tự phục hồi
Cập nhật	Chạy lệnh openclaw update	1 click trên Dashboard
Backup	Tự thiết lập	Hàng ngày, tự động
Toàn quyền kiểm soát	Có	Giới hạn trong Dashboard

Tự cài phù hợp nếu bạn muốn kiểm soát hoàn toàn hoặc có nhu cầu tùy biến sâu. TryOpenClaw phù hợp nếu bạn muốn tập trung vào sử dụng thay vì vận hành.

Phân tích sâu: OpenClaw tự cài đặt vs TryOpenClaw Cloud — nên chọn gì?

---

FAQ — Câu hỏi thường gặp

Cài OpenClaw mất bao lâu? Cách nhanh nhất (one-liner hoặc npm) mất 5-10 phút nếu đã có Node.js. TryOpenClaw cloud chỉ mất 2 phút. Cài từ source mất 15-30 phút.

Cần biết lập trình để cài OpenClaw không? Cách 1 và 2 chỉ cần biết mở Terminal và copy-paste lệnh. Cách 4 (TryOpenClaw) hoàn toàn không cần kỹ thuật. Chỉ Cách 3 (từ source) cần kiến thức lập trình.

OpenClaw có chạy trên điện thoại không? OpenClaw chạy trên máy tính hoặc server, nhưng bạn tương tác qua ứng dụng nhắn tin trên điện thoại (Telegram, WhatsApp…). OpenClaw cũng có app companion trên iOS và Android để nhận thông báo và điều khiển bằng giọng nói.

API key tốn bao nhiêu tiền? Phụ thuộc vào provider và model bạn chọn. Anthropic (Claude) thường tặng $5 credit cho tài khoản mới — đủ cho vài trăm task đơn giản. Hoặc dùng TryOpenClaw với hệ thống credit tích hợp, không cần tạo API key riêng.

OpenClaw có chạy offline không? Không, vì cần gọi API đến model AI. Ngoại trừ trường hợp bạn dùng model local (Ollama) — nhưng cần máy có GPU mạnh và chất lượng output thấp hơn Claude/GPT.

Dữ liệu của tôi có an toàn không? OpenClaw chạy trên máy bạn (self-host) nên dữ liệu không đi qua server bên thứ ba ngoài nhà cung cấp model AI. Với TryOpenClaw, mỗi user có instance riêng biệt (isolated), dữ liệu mã hóa và backup hàng ngày.

---

Tổng kết

Cài đặt OpenClaw có 4 con đường rõ ràng — chọn con đường phù hợp với kỹ năng và nhu cầu của bạn:

1. One-liner script → cài nhanh, tự động, phù hợp phần lớn người dùng
2. npm/pnpm/bun → quen thuộc cho ai đã dùng Node.js
3. Từ source → cho developer muốn đóng góp hoặc tùy biến
4. TryOpenClaw.io → không cài gì, dùng ngay trong 2 phút

Điều quan trọng nhất sau khi cài: giao task đầu tiên ngay. Đừng cố tối ưu config hay cài mọi skill — bắt đầu đơn giản, mở rộng dần.

---