Bỏ qua tới nội dung
Ông T.vn

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

12 phút đọcCập nhật
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 ngay trên máy tính của bạn và trò chuyện với bạn qua các ứng dụng nhắn tin quen thuộc như Telegram, WhatsApp, Slack, Discord. 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ộ) có thể đổi tuỳ ý. Cài đặt khá dễ: chỉ cần một dòng lệnh rồi 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 trên chính máy tính của bạn và gặp bạn ở những kênh bạn vẫ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. Repo hiện có khoảng 394 nghìn sao và hơn 82 nghìn fork, giấy phép MIT.

Vấn đề nó giải quyết khá rõ. Nhiều công cụ AI buộc bạn phải mở một trang web riêng, đưa dữ liệu lên dịch vụ của người khác, và bị khoá vào một nhà cung cấp. OpenClaw làm ngược lại: phần lõi (gọi là Gateway) chạy trên máy bạn, lưu trạng thái, bộ nhớ và thông tin đăng nhập tại đó. Còn “bộ não” là mô hình AI thì bạn chọn và thay được, vì mô hình chỉ là một plugin.

Bạn nên thử nếu là người làm kinh doanh, nhân viên văn phòng hay lập trình viên mới và muốn có một trợ lý riêng, nhắn tin được ngay trong ứng dụng chat đang dùng. Đ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, không có token, và do một quỹ độc lập (OpenClaw Foundation) quản lý. Bài này đi từ cài đặt đến vài tình huống dùng thật, và nói rõ chỗ cần cẩn thận về bảo mật.

Ứng dụng

openclaw/openclaw

OpenClaw là trợ lý AI mã nguồn mở chạy trên máy của bạn, trả lời qua Telegram, WhatsApp, Slack, Discord và hơn 20 kênh chat khác.

★ 394kTypeScriptMIT
Xem repo trên GitHub
Video giới thiệu openclawXem trên YouTubeXem trên Facebook

I.OpenClaw làm được gì

Trợ lý nằm trong ứng dụng chat của bạn. Thay vì mở một giao diện lạ, bạn nhắn cho trợ lý qua WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage… Lợi ích thực tế: bạn hỏi việc ngay trong chỗ mình đã ngồi cả ngày, không phải học thêm một công cụ mới.

Một “Gateway” điều phối mọi thứ. Gateway là trung tâm điều khiển chạy trên máy, quản lý các phiên trò chuyện, công cụ, sự kiện và kết nối với các kênh. 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. Bạn có thể hiểu nó như “tổng đài” của trợ lý.

Dùng một mình hoặc cho cả nhóm. README nói cùng một Gateway có thể chạy như “claw cá nhân” trên laptop hoặc như “claw nhiều người” dùng chung; khác biệt chỉ nằm ở cấu hình.

Đổi mô hình AI mà không phải làm lại từ đầu. Mô hình và các “khung chạy agent” (Claude, Codex, mô hình chạy cục bộ) là plugin. Nếu hôm nay bạn dùng nhà cung cấp này, mai muốn chuyển sang nhà khác hoặc sang mô hình trên máy mình, phần còn lại không phải đổi.

Mở rộng bằng công cụ, kỹ năng và plugin. README nói khả năng của trợ lý được mở rộng qua tools, skills và plugins, và có kho chia sẻ tên ClawHub. Tính năng mới thường được làm dưới dạng plugin trên bộ SDK plugin của dự án.

Ứng dụng đi kèm cho thiết bị. Các ứng dụng đồng hành và “node” thêm giọng nói, Canvas, camera, màn hình và hành động trên thiết bị, tuỳ nền tảng hỗ trợ.

Riêng tư khá rõ ràng. Theo README, nội dung bạn nhắ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. Bản thân OpenClaw mặc định chỉ “gọi về” để kiểm tra phiên bản mỗi ngày; thống kê ẩn danh là tuỳ chọn bật thêm, và đặt update.checkOnStart: false sẽ tắt cả hai.

II.Cần chuẩn bị gì

Chỉ những gì tư liệu nói:

  • Hệ điều hành: macOS, Linux hoặc Windows. README ghi trình cài đặt hỗ trợ cả ba; trên Windows có thể dùng PowerShell, và dòng lệnh bash dùng được trên macOS, Linux hoặc WSL2.
  • Node.js: gói yêu cầu Node 24.16.0 trở lên trong nhánh 24.x, hoặc 26.1.0 trở lên. README khuyến nghị mạnh dùng 24.22.1+ hoặc 26.12.1+ vì lý do bảo mật. Nếu dùng trình cài đặt tự động, nó sẽ tự chuẩn bị Node phù hợp khi cần.
  • Quyền truy cập mô hình AI: quá trình onboarding sẽ kiểm tra bạn đã truy cập được mô hình chưa, nên bạn cần có cách xác thực với nhà cung cấp mô hình mình chọn. README không liệt kê cụ thể loại key hay nhà cung cấp nào là bắt buộc, nên bạn xem thêm ở trang Models và Model providers trong tài liệu chính thức.
  • Tài khoản kênh chat: nếu muốn nhắn qua Telegram, WhatsApp… bạn cần có tài khoản tương ứng. Cách nối từng kênh nằm ở trang Channels trong tài liệu.
  • Phần cứng: tư liệu không nêu yêu cầu cấu hình cụ thể, cũng không nói bắt buộc phải có GPU. Nếu bạn định chạy mô hình cục bộ thì cần xem thêm tài liệu của mô hình đó.

Trong repo có file .env.example chỉ chứa một biến là OPENCLAW_GATEWAY_TOKEN. Nếu bạn cài theo trình cài đặt và trình hướng dẫn thì thường không phải đụng tới file này.

III.Cài đặt từng bước

  1. Mở terminalDùng Terminal (macOS/Linux/WSL2) hoặc PowerShell (Windows)
  2. Chạy trình cài đặtMột dòng lệnh, tự lo Node.js nếu thiếu
  3. Làm theo onboardingTrình hướng dẫn xác minh mô hình, tạo workspace, cấu hình Gateway
  4. Kiểm tra GatewayDùng openclaw gateway status
  5. Mở giao diện điều khiểnDùng openclaw dashboard rồi nhắn thử một câu

A.Mở terminal đúng chỗ

Terminal là cửa sổ để gõ lệnh. Trên Windows, bạn bấm Start, gõ “PowerShell” rồi mở. Trên macOS, mở ứng dụng Terminal. Trên Linux hoặc WSL2, mở cửa sổ dòng lệnh quen thuộc của bạn. Lệnh không phụ thuộc thư mục, nên mở ở đâu cũng được.

B.Chạy trình cài đặt

Đây là cách dễ nhất theo README, vì trình cài đặt tự chuẩn bị Node.js phù hợp nếu máy bạn chưa có.

Trên macOS, Linux hoặc WSL2:

Terminal
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

Trên Windows PowerShell:

PowerShell
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

Cả hai lệnh đều tải một script từ trang chủ dự án rồi chạy ngay. Vì vậy hãy chắc bạn gõ đúng địa chỉ và chỉ chạy lệnh lấy từ nguồn chính thức. Chỗ người mới hay vấp: dán nhầm lệnh bash vào PowerShell hoặc ngược lại, nên chọn đúng khối theo hệ điều hành.

C.Hoặc cài bằng npm nếu đã có Node.js

Nếu bạn đã tự quản lý Node.js, README cho phép cài gói đã phát hành:

Terminal
npm install -g openclaw@latest --allow-scripts=openclaw

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, README bảo bỏ phần --allow-scripts=openclaw. Hãy kiểm tra phiên bản Node của bạn trước (node --version) để chắc nó đáp ứng yêu cầu ở phần chuẩn bị. Cách cài bằng Docker, Nix và các hướng khác nằm ở trang hướng dẫn cài đặt trong tài liệu chính thức.

D.Làm theo trình hướng dẫn onboarding

Nếu bạn dùng trình cài đặt, README nói nó tự mở onboarding trên máy mới; bạn chỉ cần làm theo các bước hiện ra. Nếu bạn cài trực tiếp bằng npm, pnpm hoặc Bun thì tự chạy:

Terminal
openclaw onboard --install-daemon

Theo README, bước này xác minh quyền truy cập mô hình, tạo workspace và cấu hình Gateway. Chỗ cần chú ý: khi trình hướng dẫn hỏi về mô hình hay thông tin xác thực, hãy điền ngay trong cửa sổ đó, đừng dán key vào file nào khác hay gửi cho ai.

E.Kiểm tra Gateway và mở giao diện

Sau onboarding, README đưa hai lệnh:

Terminal
openclaw gateway status
openclaw dashboard

Lệnh đầu cho biết Gateway có đang chạy không. Lệnh sau mở giao diện điều khiển (Control UI) trên trình duyệt.

OpenClaw chạy công cụ trực tiếp trên máy của bạn cho phiên chính, trừ khi bạn cấu hình sandbox. Hãy đọc hướng dẫn bảo mật của dự án trước khi cho người khác dùng chung hoặc mở Gateway ra ngoài Internet. Ngoài ra, tin nhắn chuyển tới trợ lý phải được coi là dữ liệu không đáng tin.

IV.Kiểm tra đã chạy được chưa

Theo README, cách kiểm tra gồm ba việc:

  1. Chạy openclaw gateway status và xem Gateway báo đang hoạt động.
  2. Chạy openclaw dashboard để mở Control UI.
  3. Gõ thử một tin nhắn trong giao diện đó. Nếu trợ lý trả lời, nghĩa là cả Gateway lẫn mô hình đang hoạt động.

Nếu onboarding đã báo xác minh được quyền truy cập mô hình nhưng trợ lý vẫn không trả lời, hãy xem mục lỗi bên dưới. Tài liệu chính thức cũng có phần hướng dẫn kênh và xử lý sự cố ở trang Getting started.

V.Dùng vào việc thật

Các tình huống dưới đây bám theo khả năng README mô tả: trợ lý trả lời qua kênh chat, dùng mô hình bạn chọn, có công cụ và kỹ năng mở rộng. Prompt chỉ là câu mẫu để bạn tham khảo, bạn sửa theo việc của mình.

A.Chủ shop nhờ trợ lý soạn tin trả lời khách

Bối cảnh: chị chủ shop quần áo online suốt ngày trả lời câu hỏi lặp lại về giá, đổi trả, thời gian giao.

Cách làm: chị nối OpenClaw với kênh chat mình dùng (ví dụ Telegram hoặc WhatsApp, cách nối xem trang Channels trong tài liệu), rồi nhắn cho trợ lý như nhắn một người:

text
Viết giúp mình 3 mẫu tin nhắn trả lời khách hỏi về chính sách đổi trả trong 7 ngày. Giọng thân thiện, ngắn gọn.

Kết quả: chị nhận ngay các mẫu tin để chọn và chỉnh. Lưu ý đây là trợ lý trả lời cho chính chị, còn việc cho khách nhắn trực tiếp vào trợ lý là chuyện khác, cần đọc kỹ phần bảo mật trước.

Trợ lý AI tốt nhất là trợ lý nằm sẵn trong ứng dụng chat bạn đang mở cả ngày.

Ông T

B.Nhân viên văn phòng tóm tắt và soạn nội dung ngay trong Slack

Bối cảnh: một bạn nhân viên hành chính thường xuyên phải viết lại email, tóm tắt biên bản họp.

Cách làm: sau khi nối kênh Slack hoặc dùng thẳng Control UI từ openclaw dashboard, bạn dán nội dung và nhắn:

text
Tóm tắt đoạn biên bản sau thành 5 gạch đầu dòng, nêu rõ ai làm gì, hạn khi nào.

Kết quả: một bản tóm tắt gọn để gửi lại cho nhóm. Vì nội dung của bạn đi tới nhà cung cấp mô hình đã cấu hình, đừng dán thông tin mật của công ty nếu chưa kiểm tra chính sách của nhà cung cấp đó.

C.Lập trình viên mới đổi mô hình và thêm plugin

Bối cảnh: một bạn mới học lập trình muốn thử nhiều mô hình khác nhau mà không phải cài lại cả hệ thống.

Cách làm: vì mô hình là plugin, bạn đổi nhà cung cấp theo hướng dẫn ở trang Models trong tài liệu, phần còn lại (kênh chat, workspace, Gateway) giữ nguyên. Muốn thêm khả năng mới, bạn xem phần Tools, Skills, Plugins và kho ClawHub mà README chỉ tới. Nếu muốn đọc hoặc sửa mã nguồn, README nói repo là một pnpm workspace và npm install ở thư mục gốc không được hỗ trợ:

Terminal
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build

Kết quả: bạn có bản mã nguồn để nghiên cứu hoặc đóng góp. Quy trình đóng góp nằm trong file CONTRIBUTING.md của repo, và README ghi rõ PR có sự hỗ trợ của AI được chào đón.

D.Cho người quen dùng chung, bắt đầu bằng ghép cặp an toàn

Bối cảnh: bạn muốn cho đồng nghiệp hoặc người nhà nhắn thử với trợ lý của mình.

Cách làm: theo README, các kênh có tin nhắn riêng mặc định sẽ “ghép cặp” (pair) với người lạ. Khi có yêu cầu ghép cặp, bạn duyệt bằng lệnh:

Terminal
openclaw pairing approve <channel> <code>

Thay <channel> bằng tên kênh và <code> bằng mã ghép cặp nhận được.

Kết quả: chỉ người bạn đã duyệt mới nhắn được với trợ lý. Trước khi mở rộng hơn nữa, hãy đọc hướng dẫn bảo mật, hướng dẫn mở Gateway ra ngoài và hướng dẫn sandbox trong tài liệu.

VI.Lỗi hay gặp và cách xử lý

Tư liệu không liệt kê danh sách lỗi cụ thể, nên các mục dưới đây là những tình huống rất dễ gặp với loại công cụ này. Chi tiết xử lý chính xác hãy xem trang Getting started và FAQ của dự án.

Lệnh openclaw báo không tìm thấy. Thường do terminal chưa nạp lại đường dẫn sau khi cài. Hãy đóng terminal, mở cửa sổ mới rồi thử lại. Nếu cài bằng npm, kiểm tra npm đã cài gói toàn cục thành công chưa.

Phiên bản Node không đúng. Gói yêu cầu Node 24.16.0 trở lên trong nhánh 24.x hoặc 26.1.0 trở lên. Chạy node --version để xem. Nếu thấp hơn, hoặc không muốn tự quản lý Node, hãy dùng trình cài đặt một dòng lệnh vì nó tự chuẩn bị Node phù hợp.

Lệnh npm báo lỗi liên quan tới --allow-scripts. README nói cờ này dành cho npm 12 hoặc npm 11.16 trở lên; với npm 11.15 trở xuống thì bỏ cờ đó đi. Kiểm tra phiên bản npm trước khi chạy lại.

Gateway không chạy hoặc trợ lý không trả lời. Chạy openclaw gateway status để xem trạng thái. Nếu chưa ổn, chạy lại openclaw onboard --install-daemon để kiểm tra lại quyền truy cập mô hình và cấu hình. Lý do hay gặp là thông tin xác thực mô hình điền sai hoặc hết hạn.

Dùng npm install trong thư mục mã nguồn. README nói rõ npm install ở thư mục gốc repo không được hỗ trợ. Nếu bạn clone repo để phát triển, hãy dùng pnpm install như hướng dẫn. Còn nếu chỉ muốn dùng trợ lý thì không cần clone, cài theo phần trên là đủ.

VII.Có nên dùng không

Điểm mạnh:

  • Chạy trên máy bạn, dữ liệu, bộ nhớ và thông tin đăng nhập nằm trong tay bạn.
  • Gặp trợ lý ngay trong hơn 20 kênh chat quen thuộc, kèm ứng dụng cho nhiều hệ điều hành.
  • Đổi mô hình AI dễ vì mô hình là plugin; có cả mô hình chạy cục bộ.
  • Miễn phí, giấy phép MIT, không có gói trả phí hay dịch vụ lưu trữ riêng của dự án, do một quỹ độc lập quản lý.
  • Dự án vẫn được cập nhật đều trong vài tháng gần đây.

Giới hạn cần biết:

  • Công cụ chạy trực tiếp trên máy cho phiên chính nếu bạn chưa bật sandbox, nên cần đọc kỹ phần bảo mật trước khi cho người khác dùng hoặc mở ra Internet.
  • Nội dung bạn nhắn vẫn đi tới nhà cung cấp mô hình bạn chọn, nên “dữ liệu nằm trên máy” không có nghĩa là mọi thứ không bao giờ rời máy.
  • Chi phí dùng mô hình (nếu bạn chọn dịch vụ có tính phí) do nhà cung cấp mô hình quyết định, README không nói chi tiết về phần này.
  • Hệ thống khá rộng (Gateway, kênh, node, plugin), nên người mới có thể mất thời gian làm quen, nhất là phần nối từng kênh chat.

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 trên web sẽ nhanh hơn. Nếu bạn muốn một trợ lý riêng, nằm trong các ứng dụng nhắn tin đang dùng, kiểm soát được dữ liệu và đổi mô hình tuỳ ý, OpenClaw đáng để thử. Hãy bắt đầu với một người dùng (chính bạn), một kênh, rồi mới mở rộng.

4.6/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

OpenClaw có miễn phí không?

README nói 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 chi phí dùng mô hình AI (nếu bạn chọn dịch vụ tính phí) phụ thuộc nhà cung cấp mô hình, tư liệu chưa nêu cụ thể.

OpenClaw chạy được trên Windows không?

Được. README ghi trình cài đặt hỗ trợ macOS, Linux và Windows, trong đó Windows dùng lệnh PowerShell riêng. Dự án cũng có ứng dụng cho macOS, iOS, Android, Windows và Linux.

Cần cài Node.js phiên bản nào?

Gói yêu cầu Node 24.16.0 trở lên trong nhánh 24.x, hoặc 26.1.0 trở lên; README khuyến nghị 24.22.1+ hoặc 26.12.1+ vì bảo mật. Nếu dùng trình cài đặt một dòng lệnh, nó tự chuẩn bị Node phù hợp khi cần.

Dữ liệu của tôi có an toàn không?

Theo README, trạng thái, bộ nhớ và thông tin đăng nhập nằm trên máy của bạn. Nhưng nội dung bạn nhắn vẫn đ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ỉ gọi về để kiểm tra phiên bản hằng ngày, và công cụ chạy trên máy cho phiên chính trừ khi bạn bật sandbox.

Có cần GPU hay máy cấu hình mạnh không?

Tư liệu không nêu yêu cầu phần cứng hay GPU. Vì mô hình AI có thể là dịch vụ bên ngoài hoặc mô hình cục bộ, nhu cầu cấu hình sẽ phụ thuộc bạn chọn cách nào; nếu chạy mô hình cục bộ, hãy xem tài liệu của mô hình đó.

OpenClaw dùng được với những mô hình AI nào?

README nói mô hình và khung chạy agent như Claude, Codex và mô hình cục bộ đều là plugin có thể thay đổi mà không phải đổi phần còn lại. Danh sách đầy đủ nằm ở trang Models và Model providers trong tài liệu chính thức.

Làm sao cho người khác nhắn với trợ lý của tôi một cách an toàn?

README nói các kênh có tin nhắn riêng mặc định ghép cặp với người lạ, và bạn duyệt bằng lệnh openclaw pairing approve <channel> <code>. Trước khi cho nhiều người dùng hoặc mở Gateway ra ngoài, hãy đọc hướng dẫn bảo mật và sandbox của dự án.

Chuyển nhanh tới mục

  1. I.OpenClaw làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở terminal đúng chỗ
    2. B.Chạy trình cài đặt
    3. C.Hoặc cài bằng npm nếu đã có Node.js
    4. D.Làm theo trình hướng dẫn onboarding
    5. E.Kiểm tra Gateway và mở giao diện
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop nhờ trợ lý soạn tin trả lời khách
    2. B.Nhân viên văn phòng tóm tắt và soạn nội dung ngay trong Slack
    3. C.Lập trình viên mới đổi mô hình và thêm plugin
    4. D.Cho người quen dùng chung, bắt đầu bằng ghép cặp an toàn
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.