Hướng dẫn OpenClaw chi tiết nhất từ A tới Z

Bạn đã nghe đến OpenClaw – dự án AI assistant mã nguồn mở đang gây sốt cộng đồng công nghệ từ đầu năm 2026? Đây không chỉ là một chatbot thông thường mà là trợ lý AI cá nhân có thể chạy 24/7 trên máy của bạn, ghi nhớ mọi cuộc trò chuyện và kết nối với Telegram, WhatsApp, Discord.

Bài viết này sẽ hướng dẫn bạn từng bước cài đặt OpenClaw từ đầu, không yêu cầu kiến thức lập trình chuyên sâu. Dù bạn là developer hay người dùng phổ thông, bạn sẽ có thể chạy được trợ lý AI riêng sau khi đọc xong.

Trang Chủ – Tài liệu chính thức – GitHub

OpenClaw là gì?

Trước khi đi vào cài đặt, mình sẽ giải thích ngắn gọn OpenClaw là gì để bạn hiểu rõ công cụ mình sắp cài.

OpenClaw là một dự án mã nguồn mở (open-source) được phát triển bởi Peter Steinberger — một developer người Áo nổi tiếng với việc sáng lập PSPDFKit và rất nhiều công cụ về AI.

Về bản chất, OpenClaw là một gateway tự host kết nối các mô hình AI lớn như Claude của Anthropic hoặc ChatGPT của OpenAI với môi trường máy tính của bạn. Thay vì chat qua website của từng dịch vụ, bạn có thể chat qua Telegram, WhatsApp, Discord — bất kỳ nền tảng nào bạn đang dùng hàng ngày.

Điểm khác biệt cốt lõi của OpenClaw so với các chatbot khác nằm ở khả năng tự host và bộ nhớ dài hạn. Khi bạn hỏi Claude trên website, mỗi cuộc trò chuyện là một session riêng biệt và bạn phải giải thích lại context mỗi lần. Với OpenClaw, nó ghi nhớ mọi thứ bạn đã nói từ tuần trước, tháng trước — như một trợ lý thực sự hiểu về bạn.

Một ví dụ thực tế: bạn có thể cấu hình OpenClaw để mỗi sáng tự động tổng hợp tin tức công nghệ và gửi cho bạn qua Telegram. Hoặc khi bạn gửi ảnh chụp màn hình lỗi điện thoại, nó có thể phân tích và hướng dẫn cách sửa. Tất cả những điều này xảy ra trên máy của bạn, không qua server trung gian nào.

Lịch sử đổi tên: Dự án ban đầu có tên “Clawdbot”, sau đó đổi thành “Moltbot” do yêu cầu từ Anthropic vì tên quá giống với “Claude”. Hiện tại dự án đã chính thức đổi tên thành OpenClaw. Nếu bạn đọc các bài viết cũ trên mạng có nhắc đến Clawdbot hay Moltbot, đó chính là OpenClaw.

Yêu cầu hệ thống để cài đặt OpenClaw

Trước khi bắt đầu, hãy kiểm tra máy tính của bạn có đáp ứng các yêu cầu tối thiểu không. Nếu thiếu một trong các yêu cầu, quá trình cài đặt sẽ thất bại.

Phần mềm: Bạn cần Node.js phiên bản 22 trở lên (khuyến nghị Node 24). Kiểm tra bằng lệnh node --version. Nếu máy bạn đang có phiên bản cũ hơn, cần nâng cấp trước khi tiếp tục.

Phần cứng: Cấu hình tối thiểu là 8GB RAM và chip Intel hoặc Apple Silicon (M1/M2/M3/M4). Máy yếu hơn vẫn chạy được nhưng sẽ chậm và không ổn định, đặc biệt khi xử lý nhiều request cùng lúc.

Hệ điều hành: OpenClaw hỗ trợ macOS, Linux, và Windows thông qua WSL2 (Windows Subsystem for Linux). Nếu bạn dùng Windows, hãy cài WSL2 với Ubuntu trước vì chạy native trên Windows chưa được kiểm tra kỹ.

API Key: Bạn cần API Key hoặc tài khoản đã kích hoạt gói trả tiền theo tháng của Claude, ChatGPT, Gemini (hoặc tất cả nếu bạn có thể 😗). Đây là bộ não của OpenClaw — tất cả công việc AI xử lý đều thông qua các API bên ngoài này.

Hướng dẫn cài đặt OpenClaw trên máy tính cá nhân

Bây giờ chúng ta đi vào phần chính. Mình sẽ hướng dẫn từng bước chi tiết, bạn chỉ cần làm theo.

⚠️ Lưu ý bảo mật: Đừng cố gắng expose ứng dụng này ra internet từ máy tính cá nhân. Nếu bạn có nhu cầu truy cập từ xa, hãy cài OpenClaw lên VPS với Docker để bảo vệ dữ liệu trên máy luôn an toàn.

Bước 1. Cài Homebrew (macOS)

Nếu bạn dùng macOS, bước đầu tiên là cài Homebrew — trình quản lý package phổ biến nhất trên Mac. OpenClaw cần Homebrew để cài Node.js và các dependency khác.

Mở Terminal (tìm trong Spotlight bằng Cmd + Space, gõ “Terminal”) và chạy lệnh:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Quá trình cài mất khoảng 2-5 phút tùy tốc độ mạng. Sau khi xong, kiểm tra bằng lệnh:

brew --version

Nếu hiện ra phiên bản (ví dụ Homebrew 4.x.x) là thành công. Tiếp theo cài Node.js qua Homebrew:

brew install node

Kiểm tra Node.js đã cài xong:

node --version

💡 Ghi chú: Nếu bạn dùng Linux hoặc Windows (WSL2), bạn không cần Homebrew. Cài Node.js trực tiếp bằng NodeSource hoặc nvm.

Bước 2. Cài đặt OpenClaw với 1 dòng lệnh

Mở Terminal (macOS/Linux) hoặc PowerShell (Windows) và chạy lệnh tương ứng.

macOS / Linux

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

Windows PowerShell

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

Bước 3: Cấu hình onboard

Sau khi cài đặt hoàn tất, OpenClaw sẽ tự động chạy wizard onboarding để thiết lập ban đầu. Nếu wizard không tự khởi chạy, bạn có thể chạy thủ công bằng lệnh:

openclaw onboard --install-daemon

Wizard sẽ hỏi bạn một loạt câu hỏi để thiết lập. Dưới đây là giải thích từng bước:

I understand this is powerful and inherently risky. Continue?
Chọn Yes để tiếp tục.

Onboarding mode
Chọn QuickStart nếu bạn mới bắt đầu — đây là chế độ đơn giản nhất.

Model/auth provider
Chọn mô hình AI bạn muốn sử dụng. Ví dụ: Anthropic (Claude), OpenAI (ChatGPT), hoặc Google (Gemini).

AI Auth Method
Tuỳ theo dịch vụ bạn chọn mà sẽ có các cách xác thực khác nhau. Ví dụ nếu bạn chọn OpenAI, nên chọn OpenAI Codex (ChatGPT OAuth) để xác thực thông qua OAuth và sử dụng gói Pro trong tài khoản thay vì token — tiết kiệm hơn nhiều.

Sau khi chọn auth method, trình duyệt sẽ tự mở (nếu cài trên máy cá nhân) để bạn đăng nhập và cấp quyền. Hoặc bạn có thể copy liên kết trong terminal và dán vào trình duyệt.

Default model
Chọn model mặc định tương ứng với dịch vụ đã chọn, ví dụ anthropic/claude-sonnet-4-20250514.

Select channel
Chọn kênh nhắn tin cần tích hợp đầu tiên. Bạn cứ chọn nền tảng bạn đang dùng và làm theo hướng dẫn.

Install skills
Chọn skills cần sử dụng (ấn <Space> để chọn). Có thể bỏ qua và cài sau.

Sau khi onboarding thành công, OpenClaw sẽ chạy ngầm trên máy bạn. Kiểm tra trạng thái bằng lệnh:

openclaw gateway status

Bước 4: Truy cập Control UI

OpenClaw đi kèm một giao diện web để quản lý và chat. Mở trình duyệt và truy cập:

http://127.0.0.1:18789/

Đây là Control UI — từ đây bạn có thể chat thử với OpenClaw mà không cần cấu hình bất kỳ nền tảng nhắn tin nào. Nếu mọi thứ hoạt động, xin chúc mừng — bạn đã cài đặt thành công!

Kết nối OpenClaw với các nền tảng nhắn tin

Sức mạnh thực sự của OpenClaw nằm ở khả năng chat từ các ứng dụng bạn dùng hàng ngày. Phần này hướng dẫn kết nối với các nền tảng phổ biến.

WhatsApp

Kết nối WhatsApp yêu cầu bạn scan QR code như khi đăng nhập WhatsApp Web. Chạy lệnh:

openclaw channels login --channel whatsapp

Lệnh channels login chỉ dùng cho WhatsApp (quét QR code). Telegram và Discord dùng channels add với token, không cần login.

Terminal sẽ hiển thị QR code. Mở WhatsApp trên điện thoại, vào Settings → Linked Devices → Link a Device và quét QR code này. Sau khi liên kết thành công, bạn có thể chat với OpenClaw như với một liên hệ WhatsApp bình thường.

Lưu ý: WhatsApp có giới hạn về số lượng tin nhắn và thiết bị liên kết. Nếu gặp vấn đề, đọc thêm trong tài liệu chính thức.

Telegram

Telegram là nền tảng được khuyến nghị vì setup đơn giản và không có nhiều giới hạn như WhatsApp. Bạn cần tạo bot qua @BotFather trước.

Mở Telegram, tìm @BotFather và gửi lệnh /newbot. BotFather sẽ hỏi tên và username cho bot — username phải kết thúc bằng “bot” (ví dụ: MyAssistantBot). Sau khi tạo xong, bạn nhận được một token dạng 123456789:ABCdefGHIjklMNO.

Thêm token vào OpenClaw:

openclaw channels add --channel telegram --token "123456789:ABCdefGHIjklMNO"

Mở bot trên Telegram và bấm Start hoặc gửi lệnh /start. Telegram sẽ trả về mã pairing kèm lệnh cấp quyền:

Ví dụ ở ảnh trên, mã pairing code là NL7NRBMA. Bạn cần chạy lệnh sau trong terminal để approve:

openclaw pairing approve telegram NL7NRBMA

Sau đó bạn có thể thoải mái trò chuyện với bot trên Telegram.

Discord

Discord cần tạo bot trước rồi mời vào server. Mình chia ra từng bước cho dễ theo.

Bước 1: Tạo Application trên Discord Developer Portal

Truy cập Discord Developer Portal và đăng nhập bằng tài khoản Discord của bạn. Bấm New Application, đặt tên (ví dụ: “OpenClaw Assistant”) rồi bấm Create.

Bước 2: Tạo Bot và lấy Token

Trong trang Application vừa tạo, chọn menu Bot ở sidebar trái.

Bấm Reset Token để lấy bot token. Copy token này và lưu lại, bạn sẽ cần nó ở bước sau.

⚠️ Token chỉ hiển thị một lần sau khi reset. Nếu mất, bạn phải reset lại token mới.

Bước 3: Bật Message Content Intent

Vẫn ở trang Bot, kéo xuống phần Privileged Gateway Intents. Bật cả 3 intents:

• Presence Intent (Intent hiện diện)
• Server Members Intent (Intent thành viên máy chủ)
• Message Content Intent (Intent Nội Dung Tin Nhắn – quan trọng nhất, không bật cái này thì bot không đọc được tin nhắn)

Bấm Save Changes ở cuối trang.

Bước 4: Mời bot vào server Discord

Chọn menu OAuth2 ở sidebar. Trong phần OAuth2 URL Generator:

• Mục Scopes: tích chọn bot, applications.commands
• Mục Bot Permissions: tích chọn Send Messages, Read Message History, Attach Files, Embed Links, Use Slash Commands

Copy URL được generate ở cuối trang, mở link đó trong trình duyệt. Chọn server bạn muốn mời bot vào rồi bấm Authorize.

Bước 5: Kết nối với OpenClaw

Quay lại terminal, chạy lệnh sau với token đã copy ở bước 2:

openclaw channels add --channel discord --token "your-discord-bot-token"

Restart gateway để áp dụng:

openclaw gateway restart

Bước 6: Test thử

Mở server Discord đã mời bot, gửi tin nhắn trong channel bất kỳ mà bot có quyền đọc. Nếu bot trả lời, bạn đã setup xong. Nếu bot chỉ cần phản hồi khi được tag, bạn có thể cấu hình thêm trong openclaw.json phần channels.discord.

💡 Mặc định bot sẽ phản hồi mọi tin nhắn trong DM. Trong server (group), bot chỉ phản hồi khi được mention hoặc reply. Muốn thay đổi hành vi này, xem thêm phần cấu hình group messages trong tài liệu Discord.

Các lệnh cơ bản và tính năng hay dùng

Sau khi cài đặt xong, đây là các lệnh và tính năng bạn sẽ dùng thường xuyên nhất.

Slash commands: Trong bất kỳ nền tảng nào (Telegram, WhatsApp, Discord), bạn có thể dùng các lệnh sau:

• /status — Hiển thị trạng thái bot: model đang dùng, tokens đã sử dụng, uptime
• /reset hoặc /new — Xóa context và bắt đầu cuộc trò chuyện mới
• /model — Chuyển đổi giữa các model (Claude Sonnet, Claude Opus, GPT-4o,…)

Multimodal: Bạn có thể gửi hình ảnh cho bot phân tích — ví dụ chụp màn hình lỗi và hỏi cách sửa, hoặc gửi ảnh công thức nấu ăn và nhờ giải thích. Bot sẽ “nhìn” được hình ảnh và phản hồi phù hợp.

Automation: OpenClaw hỗ trợ cron jobs và heartbeats. Bạn có thể cấu hình để bot tự động thực hiện các tác vụ lặp đi lặp lại — ví dụ mỗi sáng 7h tổng hợp tin tức, hoặc check giá vàng mỗi giờ.

Bộ nhớ dài hạn: Đây là tính năng phân biệt OpenClaw với chatbot thông thường. OpenClaw lưu trữ context qua các file memory trong workspace. Khi bạn hỏi “hôm qua tôi hỏi gì?”, bot có thể truy xuất và trả lời chính xác. Tính năng này đặc biệt hữu ích khi bạn muốn bot hiểu context dài hạn về công việc, sở thích, hoặc các dự án đang làm.

Lưu ý quan trọng về bảo mật

Đây là phần bạn PHẢI đọc kỹ trước khi sử dụng OpenClaw trong môi trường thực tế.

Vấn đề lớn nhất là nhiều người dùng vô tình mở port 18789 (Control UI) ra internet public mà không có authentication. Kẻ xấu có thể truy cập, đọc toàn bộ lịch sử chat, lấy API keys, và thậm chí thực thi lệnh trên máy của bạn.

Để sử dụng an toàn, bạn cần tuân thủ các nguyên tắc sau:

• KHÔNG BAO GIỜ expose port 18789 ra internet public. Nếu cần truy cập từ xa, sử dụng SSH tunnel hoặc VPN như Tailscale (khuyến nghị).
• Bật pairing mode cho tất cả các channels — điều này yêu cầu người lạ phải có mã xác nhận mới chat được với bot.
• Bảo mật file cấu hình chứa API keys — đừng commit lên GitHub hay chia sẻ với ai.

Nếu bạn muốn chạy OpenClaw trên server để truy cập từ xa, hãy đọc bài Deploy OpenClaw trên VPS Việt Nam để hiểu cách thiết lập an toàn.

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

Chi phí sử dụng OpenClaw bao nhiêu?

Bản thân OpenClaw là open-source miễn phí. Tuy nhiên, bạn sẽ trả tiền cho API của model AI (Claude hoặc GPT) và chi phí vận hành (điện, VPS nếu chạy trên server). Với Claude Pro subscription $20/tháng, bạn có thể chat thoải mái cho mục đích cá nhân. Heavy users có thể cần Claude Max $100-200/tháng.

OpenClaw có token crypto chính thức không?

KHÔNG. Đã có token crypto mạo danh (CLAWD) đạt market cap $16 triệu USD trước khi crash 90%. Nhà phát triển Peter Steinberger đã xác nhận OpenClaw KHÔNG có bất kỳ token chính thức nào. Nếu ai đó mời bạn mua token liên quan, đó là lừa đảo.

Có thể chạy OpenClaw trên Raspberry Pi không?

Về lý thuyết là được, nhưng không khuyến khích. Raspberry Pi có RAM giới hạn và CPU yếu, OpenClaw sẽ chậm và có thể crash khi xử lý request phức tạp. Nếu muốn chạy 24/7 với chi phí thấp, thuê VPS với 4GB RAM là lựa chọn tốt hơn.

So với Claude Code thì OpenClaw khác gì?

Claude Code là công cụ dành cho developer, chạy trong terminal và tập trung vào coding. OpenClaw là trợ lý cá nhân đa năng, kết nối với các nền tảng nhắn tin và có bộ nhớ dài hạn. Nếu bạn cần AI hỗ trợ code, dùng Claude Code. Nếu muốn trợ lý chat 24/7 đa nền tảng, chọn OpenClaw.

OpenClaw có hỗ trợ tiếng Việt không?

OpenClaw sử dụng Claude hoặc GPT làm “não bộ”, cả hai đều hỗ trợ tiếng Việt tốt. Bạn có thể chat tiếng Việt thoải mái và bot sẽ trả lời bằng tiếng Việt.

Kết luận

OpenClaw là một bước tiến đáng kể trong việc đưa AI vào cuộc sống hàng ngày. Thay vì phải truy cập website mỗi khi cần hỏi AI, bạn có thể chat qua Telegram, WhatsApp — những ứng dụng bạn mở mỗi ngày. Bộ nhớ dài hạn giúp AI hiểu context của bạn, còn khả năng tự host đảm bảo dữ liệu ở trên máy của bạn.

Tuy nhiên, hãy nhớ rằng đây là dự án còn mới và có rủi ro bảo mật thực sự. Đọc kỹ hướng dẫn bảo mật, không expose ra internet public, và luôn cập nhật phiên bản mới nhất.

Nếu bạn muốn triển khai OpenClaw trên VPS để chạy 24/7, AZDIGI cung cấp các gói VPS với cấu hình phù hợp từ 99.000 VNĐ/tháng. Với đội ngũ hỗ trợ kỹ thuật 24/7, bạn có thể yên tâm deploy mà không lo vấn đề server. Liên hệ ngay để được tư vấn cấu hình phù hợp với nhu cầu sử dụng của bạn.