OpenClaw: trợ lý AI chạy trên máy bạn, trả lời qua Telegram, Slack, WhatsApp — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về openclaw/openclaw — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: OpenClaw: trợ lý AI chạy trên máy bạn, chat qua Telegram, WhatsApp — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
OpenClaw là trợ lý AI mã nguồn mở, chạy trên máy tính của bạn và nhắn tin với bạn qua các ứng dụng chat quen thuộc như Telegram, WhatsApp, Slack, Discord, iMessage. Dữ liệu, bộ nhớ và thông tin đăng nhập nằm trên máy bạn, còn mô hình AI (Claude, Codex, mô hình chạy cục bộ) thì đổi được tuỳ ý. Cài đặt chỉ cần một dòng lệnh, sau đó làm theo trình hướng dẫn trên màn hình.
OpenClaw là một trợ lý AI mã nguồn mở chạy ngay trên máy tính của bạn, rồi "hẹn gặp" bạn trong những kênh bạn đã dùng hằng ngày: Discord, iMessage, Slack, Teams, Telegram, WhatsApp và hơn 20 kênh khác. Ngoài ra còn có ứng dụng riêng cho macOS, iOS, Android, Windows và Linux. Biểu tượng của dự án là một chú tôm hùm 🦞.
Vấn đề nó giải quyết khá đời thường: bạn muốn một trợ lý AI luôn sẵn sàng, nhắn tin là có trả lời, nhưng không muốn giao hết dữ liệu cho một dịch vụ trọn gói. Với OpenClaw, trạng thái làm việc, bộ nhớ và thông tin đăng nhập nằm trên phần cứng của bạn. Mô hình AI chỉ là một "plugin", muốn đổi từ Claude sang Codex hay một mô hình chạy cục bộ thì đổi, phần còn lại giữ nguyên.
Bài này hợp với người làm kinh doanh, nhân viên văn phòng và lập trình viên mới muốn có trợ lý riêng, kiểm soát được. Điểm đáng giá nhất theo README: dự án không có gói trả phí, không có dịch vụ lưu trữ riêng và không có token. Hiện repo có khoảng 394.414 sao và 82.882 fork, giấy phép MIT. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thế nào trước khi cài.
openclaw/openclaw
OpenClaw là trợ lý AI mã nguồn mở chạy trên máy của bạn, trò chuyện qua Telegram, WhatsApp, Slack, Discord, iMessage và hơn 20 kênh khác.
I.OpenClaw làm được gì
A.Trò chuyện ở nơi bạn đã quen
Bạn không phải mở thêm một ứng dụng lạ. OpenClaw kết nối với WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage và nhiều dịch vụ nhắn tin khác. Bạn nhắn như nhắn với đồng nghiệp, trợ lý trả lời ngay trong khung chat đó.
B.Một Gateway điều phối tất cả
Gateway là "trạm điều khiển" chạy trên máy bạn, quản lý các phiên làm việc, công cụ, sự kiện và kết nối với từng kênh chat. Giao diện web (Control UI), dòng lệnh (CLI) và giao diện terminal (TUI) đều kết nối vào Gateway này. Nó chạy được như trợ lý cá nhân trên một chiếc laptop, hoặc làm trợ lý dùng chung cho nhiều người. README nói hai chế độ chỉ khác nhau ở cấu hình.
C.Đổi mô hình AI không làm hỏng gì
OpenClaw làm việc với cả mô hình trên đám mây lẫn mô hình chạy cục bộ. Vì mô hình là plugin, bạn có thể thử cái này, chuyển sang cái kia mà không phải dựng lại từ đầu. Với người quan tâm chi phí và quyền riêng tư, đây là điểm rất thực tế.
D.Mở rộng bằng công cụ, skill và plugin
Trợ lý có thể được thêm công cụ (tools), kỹ năng (skills) và plugin. Theo README, tính năng mới thường nên làm thành plugin trên bộ SDK của dự án và chia sẻ qua ClawHub. Nghĩa là bạn không cần chờ tác giả: nếu đã có người làm plugin, bạn lấy dùng.
E.Ứng dụng đi kèm cho thiết bị
Các ứng dụng đồng hành (companion apps) và "nodes" bổ sung giọng nói, Canvas, camera, màn hình và các thao tác trên chính thiết bị, ở những nền tảng được hỗ trợ.
F.Quyền riêng tư rõ ràng
Prompt của bạn sẽ đi tới nhà cung cấp mô hình và nền tảng chat mà bạn tự cấu hình. Ngoài ra, mặc định OpenClaw chỉ gọi ra ngoài để kiểm tra phiên bản mỗi ngày; thống kê ẩn danh là tuỳ chọn bạn tự bật. Đặt update.checkOnStart: false để tắt cả hai.
II.Cần chuẩn bị gì
- Hệ điều hành: README ghi trình cài đặt hỗ trợ macOS, Linux và Windows. Trên macOS/Linux/WSL2 dùng lệnh bash, trên Windows dùng PowerShell.
- Node.js: nếu bạn dùng trình cài đặt tự động, nó tự chuẩn bị bản Node phù hợp khi cần. Nếu bạn tự quản lý Node,
package.jsonyêu cầu Node từ 24.16.0 (dòng 24.x) hoặc từ 26.1.0 trở lên. README khuyên dùng 24.22.1+ hoặc 26.12.1+ để an toàn hơn. - Truy cập mô hình AI: quá trình onboarding sẽ kiểm tra quyền truy cập mô hình. Bạn nên có sẵn tài khoản hoặc khoá của nhà cung cấp mô hình mà bạn định dùng. Danh sách nhà cung cấp xem ở tài liệu chính thức. Tư liệu mình có không nói cụ thể về chi phí, nên bạn tự kiểm tra bảng giá của nhà cung cấp mô hình.
- Tài khoản kênh chat: muốn nhắn qua Telegram, WhatsApp, Slack… thì bạn cần có tài khoản ở các dịch vụ đó. Cách nối từng kênh nằm trong hướng dẫn getting started và mục Channels của tài liệu.
- Phần cứng: README không nêu yêu cầu GPU hay RAM tối thiểu. Mình chưa có thông tin về điểm này.
- Biến cấu hình: file
.env.exampletrong repo chỉ có một biến tênOPENCLAW_GATEWAY_TOKEN.
III.Cài đặt từng bước
- Mở terminalDùng bash trên macOS/Linux/WSL2 hoặc PowerShell trên Windows
- Chạy lệnh càiMột dòng lệnh tải và cài OpenClaw
- Làm theo trình onboardingChọn mô hình, tạo workspace, cấu hình Gateway
- Kiểm tra GatewayChạy openclaw gateway status
- Mở giao diện điều khiểnChạy openclaw dashboard rồi nhắn thử một câu
A.Mở terminal đúng loại
Trên macOS, Linux hoặc WSL2, mở Terminal. Trên Windows, mở PowerShell. Lệnh bên dưới khác nhau giữa hai nhóm này nên bạn chọn đúng nhóm của mình.
B.Chạy lệnh cài đặt
README cho biết trình cài đặt hỗ trợ macOS, Linux và Windows, và tự chuẩn bị Node.js phù hợp khi cần.
macOS / Linux / WSL2:
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iexCả hai lệnh đều tải một đoạn script từ trang chính thức rồi chạy luôn. Nếu bạn thận trọng, hãy mở địa chỉ script trên trình duyệt đọc qua trước khi chạy.
C.Hoặc cài bằng npm nếu bạn đã có Node
Nếu bạn đã tự quản lý Node.js (đúng phiên bản nêu ở trên), có thể cài thẳng gói đã phát hành:
npm install -g openclaw@latest --allow-scripts=openclawREADME ghi lệnh này dành cho npm 12 hoặc npm 11.16 trở lên. Với npm 11.15 trở xuống, bạn bỏ phần --allow-scripts=openclaw. Muốn xem các cách cài khác như Docker hay Nix, mở hướng dẫn cài đặt trong tài liệu chính thức.
D.Làm theo trình onboarding
Với trình cài đặt tự động, onboarding tự chạy ở lần cài mới. Bạn chỉ cần làm theo các bước nó hiện ra. Nếu bạn cài trực tiếp bằng npm, pnpm hoặc Bun thì tự chạy:
openclaw onboard --install-daemonTheo README, bước này kiểm tra quyền truy cập mô hình, tạo workspace và cấu hình Gateway. Chỗ người mới hay vấp là bước chọn mô hình và nhập khoá: hãy chuẩn bị sẵn thông tin đăng nhập của nhà cung cấp trước khi bắt đầu.
Khoá API và token của bạn nên giữ riêng tư. Đừng gửi chúng vào nhóm chat, đừng đưa vào ảnh chụp màn hình hay đăng lên GitHub. Biến OPENCLAW_GATEWAY_TOKEN cũng nên coi như mật khẩu.
E.Cài từ mã nguồn (dành cho người muốn phát triển)
Nếu bạn là lập trình viên muốn xem hoặc sửa mã, repo là một pnpm workspace. README nói rõ: chạy npm install thường ở thư mục gốc là không được hỗ trợ.
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:buildNgười dùng bình thường không cần bước này. Xem thêm CONTRIBUTING.md và hướng dẫn thiết lập từ mã nguồn trong tài liệu.
IV.Kiểm tra đã chạy được chưa
Sau khi onboarding xong, chạy hai lệnh sau:
openclaw gateway status
openclaw dashboardLệnh đầu cho bạn biết Gateway có đang chạy không. Lệnh thứ hai mở Control UI, tức giao diện web điều khiển. Hãy gõ một tin nhắn thử vào đó. Nếu trợ lý trả lời, nghĩa là mô hình, workspace và Gateway đã nối đúng với nhau. Đó cũng là cách kiểm tra mà README nêu.
Nếu chưa chạy, xem phần lỗi thường gặp bên dưới và hướng dẫn getting started của tài liệu chính thức, nơi có mục xử lý sự cố.
V.Dùng vào việc thật
Các tình huống dưới đây bám theo khả năng được nêu trong README: nhắn tin qua kênh chat, dùng mô hình AI bạn cấu hình, mở rộng bằng skill và plugin. Câu lệnh mẫu chỉ là gợi ý để bạn thử, kết quả thực tế phụ thuộc mô hình và cấu hình của bạn.
A.Chủ shop nhỏ muốn có trợ lý ngay trong Telegram hoặc WhatsApp
Bối cảnh: bạn bán hàng online, cả ngày dùng điện thoại, không muốn mở thêm ứng dụng nào. Bạn cài OpenClaw trên một máy tính để bật, nối kênh Telegram hoặc WhatsApp theo hướng dẫn Channels. Sau đó bạn nhắn thẳng vào đó:
Viết giúp mình 3 mẫu tin trả lời khách hỏi về thời gian giao hàng, giọng thân thiện, ngắn gọn.Kết quả: trợ lý trả lời ngay trong khung chat bạn đang dùng, bạn chép lại và dùng. Dữ liệu và bộ nhớ của trợ lý nằm trên máy bạn, còn nội dung câu hỏi thì đi tới nhà cung cấp mô hình bạn chọn.
Trợ lý AI tốt nhất là cái nằm sẵn trong khung chat bạn đã mở mỗi ngày.
Ông T
B.Nhân viên văn phòng soạn nhanh và ghi nhớ việc
Bối cảnh: bạn hay phải soạn email, tóm tắt nội dung họp, nhắc việc. Bạn mở Control UI bằng lệnh openclaw dashboard và nhắn:
Tóm tắt ghi chú họp sau thành 5 gạch đầu dòng và liệt kê việc cần làm kèm người phụ trách: [dán ghi chú vào đây]Kết quả: bạn có bản tóm tắt dùng được ngay. Lưu ý: tư liệu README không hứa tính năng nào riêng cho lịch hay email, nên đừng kỳ vọng trợ lý tự đọc hộp thư của bạn nếu bạn chưa cài công cụ hoặc plugin tương ứng.
C.Dev mới thử đổi mô hình và thêm kỹ năng
Bối cảnh: bạn là lập trình viên mới, muốn so sánh vài mô hình cho cùng một việc. Vì mô hình là plugin, bạn có thể đổi nhà cung cấp trong cấu hình mà không phải dựng lại cả hệ thống. Cách làm: xem mục Models và Model providers trong tài liệu, đổi cấu hình, rồi hỏi cùng một câu ở Control UI để so sánh kết quả. Muốn thêm khả năng mới, bạn tìm plugin hoặc skill trên ClawHub, hoặc tự viết bằng plugin SDK.
D.Nhóm nhỏ dùng chung một trợ lý
Bối cảnh: một nhóm 3-5 người muốn cùng dùng một trợ lý trong Slack hoặc Discord. README nói một Gateway có thể chạy như "multiplayer claw" cho nhiều người, chỉ khác ở cấu hình. Trước khi cho người khác nhắn vào, bạn phải đọc phần Security: các kênh nhắn riêng (DM) mặc định yêu cầu ghép cặp với người lạ, và bạn duyệt bằng:
openclaw pairing approve <channel> <code>Thay <channel> bằng tên kênh và <code> bằng mã ghép cặp mà người kia nhận được. Kết quả: chỉ những người bạn duyệt mới nói chuyện được với trợ lý.
VI.Lỗi hay gặp và cách xử lý
A.Báo sai phiên bản Node.js
Nếu bạn cài bằng npm mà Node cũ hơn yêu cầu, quá trình sẽ lỗi hoặc cảnh báo. Kiểm tra bằng node --version. package.json yêu cầu từ 24.16.0 (dòng 24.x) hoặc từ 26.1.0. Cách dễ nhất cho người mới là dùng trình cài đặt tự động, vì nó tự chuẩn bị Node phù hợp.
B.Lỗi khi cài bằng npm vì cờ --allow-scripts
README nêu rõ cờ này chỉ dành cho npm 12 hoặc npm 11.16 trở lên. Nếu bạn dùng npm 11.15 trở xuống, hãy chạy lại lệnh nhưng bỏ phần --allow-scripts=openclaw.
C.Chạy npm install trong thư mục repo bị lỗi
Đây là chuyện của người cài từ mã nguồn. Repo dùng pnpm workspace và README nói npm install ở thư mục gốc không được hỗ trợ. Hãy dùng pnpm install.
D.Gateway không chạy hoặc không trả lời
Chạy openclaw gateway status để xem trạng thái. Nếu onboarding chưa xong, chạy lại openclaw onboard --install-daemon. Nếu vẫn lỗi, xem mục xử lý sự cố trong hướng dẫn getting started hoặc hỏi ở cộng đồng hỗ trợ chính thức do dự án nêu trong README.
E.Người lạ nhắn tin nhưng không được trả lời
Đây thường không phải lỗi: các kênh nhắn riêng ghép cặp với người gửi lạ theo mặc định. Hãy duyệt bằng openclaw pairing approve <channel> <code> nếu bạn muốn cho họ dùng. Ngược lại, coi mọi tin nhắn đến là dữ liệu không đáng tin, như README dặn.
VII.Có nên dùng không
Điểm mạnh. Bạn kiểm soát dữ liệu: trạng thái, bộ nhớ và thông tin đăng nhập nằm trên máy bạn. Mô hình đổi được. Có mặt trên rất nhiều kênh chat và nhiều hệ điều hành. Giấy phép MIT, không có gói trả phí, dịch vụ lưu trữ riêng hay token. Dự án do một tổ chức phi lợi nhuận độc lập (OpenClaw Foundation) quản lý, và repo vẫn được cập nhật trong 3 tháng gần đây.
Giới hạn cần biết. Đây không phải công cụ "cài xong là hết việc": bạn phải tự chọn mô hình, tự nối kênh chat, tự chịu trách nhiệm cấu hình. Quan trọng nhất, README cảnh báo công cụ chạy ngay trên máy chủ của bạn cho phiên chính trừ khi bạn cấu hình sandbox. Vì vậy, trước khi cho người khác nhắn vào hoặc mở Gateway ra ngoài Internet, bạn nên đọc kỹ hướng dẫn bảo mật, runbook về việc mở Gateway ra ngoài và hướng dẫn sandbox. Prompt của bạn vẫn đi tới nhà cung cấp mô hình bạn chọn, nên "chạy trên máy bạn" không có nghĩa là không có dữ liệu nào rời khỏi máy.
Khi nào chọn cách khác. Nếu bạn chỉ cần hỏi đáp thỉnh thoảng, một ứng dụng chat AI có sẵn trên web sẽ đơn giản hơn. Nếu bạn không muốn đụng vào terminal và cấu hình, OpenClaw sẽ hơi nặng tay. Còn nếu bạn muốn trợ lý riêng, nằm trong các kênh chat quen thuộc, cho phép thay mô hình và mở rộng bằng plugin, thì đây là một lựa chọn đáng thử, miễn là bạn đọc phần bảo mật trước.
Câu hỏi thường gặp
OpenClaw có miễn phí không?
Theo README, OpenClaw là mã nguồn mở giấy phép MIT và không có gói trả phí, dịch vụ lưu trữ riêng hay token. Tuy nhiên bạn vẫn có thể phải trả phí cho nhà cung cấp mô hình AI mà bạn chọn. Tư liệu mình có không nêu chi phí cụ thể của từng nhà cung cấp.
OpenClaw chạy được trên Windows không?
Được. README ghi trình cài đặt hỗ trợ macOS, Linux và Windows, với lệnh PowerShell riêng cho Windows. Ngoài ra có ứng dụng cho macOS, iOS, Android, Windows và Linux.
Có cần GPU không?
README không nêu yêu cầu GPU hay cấu hình phần cứng tối thiểu, nên mình chưa có thông tin chắc chắn. OpenClaw làm việc với cả mô hình trên đám mây lẫn mô hình chạy cục bộ; nếu bạn chọn chạy mô hình cục bộ thì nhu cầu phần cứng sẽ phụ thuộc vào mô hình đó.
Dữ liệu của mình có an toàn không?
README cho biết trạng thái, bộ nhớ và thông tin đăng nhập nằm trên phần cứng của bạn. Prompt vẫn được gửi tới nhà cung cấp mô hình và nền tảng chat bạn cấu hình. Mặc định OpenClaw chỉ kiểm tra phiên bản mỗi ngày, còn thống kê ẩn danh là tuỳ chọn tự bật. Ngoài ra, công cụ chạy trên máy chủ cho phiên chính trừ khi bạn cấu hình sandbox, nên cần đọc hướng dẫn bảo mật.
Cài đặt có khó không?
Với người mới, cách dễ nhất là chạy một dòng lệnh cài đặt tự động (bash hoặc PowerShell) rồi làm theo trình onboarding. Nếu cài bằng npm, bạn phải có đúng phiên bản Node.js theo yêu cầu. Cài từ mã nguồn cần pnpm và dành cho người muốn phát triển.
OpenClaw dùng được những mô hình AI nào?
README nói OpenClaw làm việc với mô hình trên đám mây lẫn mô hình chạy cục bộ, và nhắc tới Claude, Codex và mô hình cục bộ như các plugin có thể đổi qua lại. Danh sách đầy đủ nhà cung cấp nằm trong tài liệu Model providers chính thức.
Làm sao thêm tính năng mới cho OpenClaw?
Bạn có thể dùng công cụ, skill và plugin. README nói tính năng mới thường nên làm thành plugin trên plugin SDK và chia sẻ qua ClawHub. Chi tiết cách viết plugin có trong tài liệu chính thức.


