OpenClaw là gì, cách cài đặt và kết nối với Telegram

OpenClaw xuất hiện trên bảng tin của tôi vào mùa đông năm ngoái, khi dự án đổi tên hai lần trong một tuần và có thêm hàng trăm nghìn sao trên GitHub. Kể từ đó, ngày càng nhiều người tìm kiếm “cài đặt openclaw” và “openclaw telegram”.

Dưới đây, tôi sẽ xem qua tài liệu chính thức: công cụ này là gì, khác Claude Code như thế nào, cách cài đặt trên Windows, macOS hoặc Linux, chọn mô hình ra sao và kết nối bot Telegram thế nào. Tôi cũng dành riêng một phần nói về bảo mật, vì OpenClaw từng liên quan đến một vài sự cố gây chú ý.

Tìm hiểu cách sử dụng dịch vụ trong tài liệu Ailoot.

OpenClaw là gì, giải thích đơn giản?#

OpenClaw kết nối mô hình AI với bot Telegram của bạn. Khi công cụ và quyền liên quan đã được cấu hình, nó có thể tóm tắt tin nhắn hoặc đặt lời nhắc. Tiến trình gateway và cấu hình cục bộ chạy trên máy tính hoặc máy chủ của bạn. Điều đó không khiến mọi cuộc trò chuyện trở thành cục bộ: khi chọn mô hình đám mây, yêu cầu và ngữ cảnh liên quan được gửi tới nhà cung cấp ấy. Nếu kết nối qua Ailoot, yêu cầu đi qua Ailoot tới nhà cung cấp mô hình đã chọn. Suy luận cục bộ cần mô hình cục bộ và không có dự phòng đám mây; tin nhắn Telegram vẫn đi qua Telegram và công cụ được bật có thể liên hệ dịch vụ khác.

Dự án được phát triển bởi cộng đồng mã nguồn mở OpenClaw. Kho lưu trữ GitHub được lập vào ngày 24 tháng 11 năm 2025, và tính đến ngày 22 tháng 8 năm 2026, dự án có 387 nghìn sao và 81 nghìn forks—một trong những dự án mở phát triển nhanh nhất năm nay. Ngôn ngữ lập trình là TypeScript.

Dự án có lịch sử đổi tên khá thú vị; biết điều này sẽ giúp bạn không nhầm lẫn khi đọc các bài viết cũ. Ban đầu, dự án có tên Warelay, một cổng kết nối cho WhatsApp. Sau đó là Clawdbot. Tháng 1 năm 2026, Anthropic yêu cầu đổi tên vì vấn đề nhãn hiệu, và dự án mang tên Moltbot trong vài ngày. Ngày 30 tháng 1 năm 2026, dự án có tên cuối cùng: OpenClaw. Vì vậy, nếu bạn gặp hướng dẫn về “Clawdbot” hoặc “Moltbot”, đó vẫn là cùng một dự án; các bài viết ấy chỉ được viết trước khi đổi tên.

Linh vật của dự án là Molty the lobster, và “lột xác” (thay lớp vỏ) trở thành hình ảnh ẩn dụ chính thức cho mỗi lần đổi tên.

OpenClaw khác Claude Code và Hermes Agent như thế nào?#

Mọi người thường hỏi tôi về sự khác biệt này, vì nhìn từ bên ngoài, tất cả đều giống “AI agent”. Đây là bảng so sánh:

Cách đọc bảng này: Tôi dùng Claude Code để phát triển; công cụ này mạnh nhất khi bạn cần một mô hình mạnh và làm việc với mã. OpenClaw và Hermes phục vụ mục đích khác: một agent luôn chạy, túc trực trong Telegram, nhớ cuộc trò chuyện hôm qua và hoàn thành công việc theo lịch. Việc chọn giữa OpenClaw và Hermes khó phân định hơn; hiện đã có hướng dẫn Hermes về cài đặt và thiết lập.

Nếu bạn chỉ đang chọn công cụ, hãy bắt đầu với phần tổng quan: mọi người lập trình bằng gì trong năm 2026 và nên giao những nhiệm vụ nào cho AI agent. Tôi cũng có một bài viết riêng về cách cài đặt Claude Code.

Cần chuẩn bị gì trước khi cài OpenClaw?#

Hãy kiểm tra phiên bản Node trước—đây là yêu cầu bắt buộc duy nhất:

node --version

Các phiên bản 22.22.3+, 24.15+ và 25.9+ được hỗ trợ; Node 26 được khuyến nghị. Nếu lệnh trả về “command not found” hoặc phiên bản đã cũ, đừng lo: trình cài đặt chính thức sẽ tải phiên bản Node mới về cho bạn, nên bạn không cần cài đặt thủ công.

Việc còn lại là chọn mô hình. OpenClaw không tự suy nghĩ: nó gọi mô hình mà bạn chọn. Các lựa chọn về chi phí gồm: khóa Anthropic, OpenAI hoặc Google—bạn trả tiền cho nhà cung cấp theo mức sử dụng thực tế; hoặc mô hình cục bộ thông qua Ollama—không tốn tiền nhưng đòi hỏi phần cứng mạnh. Tôi sẽ trình bày cả hai lựa chọn trong các phần riêng bên dưới.

Cài OpenClaw trên macOS và Linux như thế nào?#

Cách được khuyến nghị là dùng trình cài đặt chính thức:

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

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

   Tập lệnh phát hiện hệ điều hành, kiểm tra Node (và cài đặt nếu cần), cài OpenClaw rồi mở trình hướng dẫn thiết lập. Nếu muốn xem qua trước khi chạy trình hướng dẫn, hãy thêm cờ: bash -s -- --no-onboard.

2. Kiểm tra mọi thứ đã được cài đặt

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Lệnh đầu tiên hiển thị phiên bản, lệnh thứ hai kiểm tra cấu hình, còn lệnh thứ ba xác nhận cổng kết nối đang chạy và lắng nghe trên cổng 18789.

Nếu dùng npm và muốn tự quản lý việc cài đặt:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Gần đây có một vấn đề cần lưu ý, được trình bày trong một chương riêng của tài liệu. npm 12 mặc định chặn tập lệnh cài đặt gói, và nếu không có cờ --allow-scripts=openclaw, quá trình cài đặt sẽ dừng với thông báo allowScripts. Với npm 11.15 trở xuống, không cần cờ này—chưa có giới hạn đó. Kiểm tra phiên bản bằng: npm --version.

Cờ --install-daemon trong lệnh thứ hai thiết lập chế độ tự khởi động: trên macOS là LaunchAgent; trên Linux là dịch vụ systemd. Nó khởi gateway sau reboot hoặc đăng nhập theo điều kiện service manager, không ngăn ngủ hay giữ chạy khi máy tắt. Trả lời Telegram cần host thức và có mạng; dùng server luôn bật nếu cần phản hồi khi laptop ngủ hoặc tắt.

Cài OpenClaw trên Windows như thế nào?#

Lựa chọn đầu tiên dành cho những người thích cửa sổ hơn terminal. Windows Hub là ứng dụng OpenClaw gốc cho Windows 10 (20H2+) và Windows 11, hiện đang ở giai đoạn beta. Truy cập trang bản phát hành Windows Hub và tải trình cài đặt phù hợp với bộ xử lý của bạn: OpenClawCompanion-Setup-x64.exe cho máy tính thông thường hoặc arm64 cho ARM. Sau khi cài đặt, OpenClaw Companion sẽ xuất hiện trong menu Start, kèm biểu tượng khay hệ thống, cửa sổ trò chuyện và phần cài đặt.

Khi mở lần đầu, ứng dụng sẽ đề nghị “Set up locally”—hãy chấp nhận. Ứng dụng sẽ tạo một môi trường WSL riêng có tên OpenClawGateway, cài cổng kết nối bên trong đó và kết nối với cổng. Ứng dụng sẽ không động đến bản Ubuntu hiện có của bạn, nếu có.

Lựa chọn thứ hai là dùng PowerShell:

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

Dòng đầu tiên cài OpenClaw; dòng thứ hai đăng ký chế độ tự khởi động qua Windows Task Scheduler. Nếu chính sách trên máy tính chặn việc tạo tác vụ, OpenClaw sẽ tự chuyển sang phương án dự phòng: tạo lối tắt trong thư mục Startup để cổng kết nối khởi động khi bạn đăng nhập.

Lựa chọn thứ ba là WSL2, được tài liệu gọi là môi trường chạy tương thích nhất trên Windows. Cài Ubuntu, bật systemd, rồi làm theo hướng dẫn Linux ở phần trước:

wsl --install -d Ubuntu-24.04

Trong WSL, bật systemd trong /etc/wsl.conf (phần [boot], dòng systemd=true), khởi động lại WSL bằng cách chạy wsl --shutdown từ PowerShell, rồi cài OpenClaw bằng lệnh Linux. Nếu bạn không biết “distribution” và “systemd” nghĩa là gì, hãy dùng Windows Hub; ứng dụng sẽ làm tất cả những việc này giúp bạn.

Chọn mô hình và hoàn tất thiết lập ban đầu như thế nào?#

Mô hình là động cơ của trợ lý. Trình hướng dẫn thiết lập sẽ đưa ra danh sách nhà cung cấp; đây là ba lựa chọn thiết thực:

Anthropic có một chi tiết khá hay: nếu Claude Code đã được cài trên máy và bạn đã đăng nhập, OpenClaw có thể dùng phiên đăng nhập đó. Trước hết, chạy claude auth login trên máy, rồi bảo OpenClaw sử dụng nó:

openclaw models auth login --provider anthropic --method cli --set-default

Nếu cổng kết nối chạy dưới dạng dịch vụ nền (đúng như khi dùng --install-daemon), khóa phải khả dụng với dịch vụ. Để làm vậy, hãy đặt khóa trong ~/.openclaw/.env—trình hướng dẫn sẽ làm giúp bạn, nên không cần tự sửa tệp. Sau mỗi thay đổi, hãy khởi động lại và kiểm tra:

openclaw gateway restart
openclaw models status

Nếu việc trả phí là trở ngại, hãy dùng mô hình cục bộ trong phần Ollama.

Kết nối OpenClaw với Telegram như thế nào?#

Telegram là kênh kết nối nhanh nhất: bạn chỉ cần token bot, không cần xác minh tài khoản doanh nghiệp. Tài liệu gọi đây là cách dễ nhất để bắt đầu nhắn tin với trợ lý từ điện thoại. Dưới đây là toàn bộ quy trình:

1. Tạo bot bằng BotFather

   Mở cuộc trò chuyện Telegram với @BotFather (hãy chắc chắn đúng chính xác tên người dùng này—có rất nhiều tài khoản giả), gửi /newbot, rồi chọn tên và tên người dùng kết thúc bằng bot. Bạn sẽ nhận được token dạng 123456789:ABCdef...—đó là khóa của bot, hãy giữ kín như mật khẩu.

2. Nhập token vào OpenClaw

   Cách dễ nhất là dùng trình hướng dẫn: chạy openclaw configure và chọn kênh Telegram. Cách thủ công là dùng thiết lập channels.telegram.botToken hoặc biến môi trường TELEGRAM_BOT_TOKEN. Tài liệu nói rõ rằng lệnh openclaw channels login telegram không tồn tại; Telegram chỉ kết nối bằng token.

3. Khởi động cổng kết nối và nhắn cho bot

   openclaw gateway
   

   Mở bot của bạn trong Telegram và gửi tin nhắn. Bot sẽ trả lời bằng mã ghép nối gồm tám ký tự. Đây là biện pháp bảo vệ: tin nhắn sẽ không được xử lý cho đến khi bạn phê duyệt người gửi.

4. Phê duyệt chính bạn

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Mã có hiệu lực trong một giờ, vì vậy đừng chờ quá lâu. Người gửi đầu tiên được phê duyệt sẽ tự động trở thành chủ sở hữu các lệnh đặc quyền.

Có hai điểm dễ gây rắc rối mà mọi người thường gặp.

Điểm thứ nhất là nhóm. OpenClaw mặc định chặn tất cả các nhóm: bạn cần cho phép bot rõ ràng trong thiết lập channels.telegram.groups và giữ chế độ requireMention: true bật trong nhóm. Khi đó, bot chỉ trả lời khi được gọi bằng tên người dùng, chứ không chen vào cuộc trò chuyện chung. Telegram cũng có chế độ riêng tư cho bot: trong nhóm, mặc định bot chỉ thấy các lệnh. Tắt chế độ này bằng /setprivacy thông qua @BotFather. Sau khi thay đổi, bạn cần xóa bot khỏi nhóm rồi thêm lại; nếu không, Telegram sẽ không áp dụng thiết lập.

Điểm thứ hai là không mở quyền truy cập cho tất cả mọi người. Phần cài đặt có chế độ dmPolicy: "open" với dấu hoa thị trong danh sách truy cập: bất kỳ ai tìm thấy tên người dùng của bot đều có thể ra lệnh cho bot. Với một trợ lý cá nhân, đó là con đường trực tiếp để người khác kiểm soát máy tính của bạn. Hãy giữ bật tính năng ghép nối bằng mã hoặc nhập ID số của bạn vào allowFrom.

Chạy OpenClaw với mô hình cục bộ qua Ollama như thế nào?#

Mô hình cục bộ chạy trên phần cứng của bạn và không phát sinh tiền token nhà cung cấp mô hình khi chỉ suy luận cục bộ. Chọn Local only và không dùng dự phòng đám mây để giữ suy luận tại máy. Tin nhắn Telegram vẫn đi qua mạng Telegram và công cụ trực tuyến được bật có thể gửi dữ liệu tới dịch vụ khác.

1. Cài Ollama

   Tải trình cài đặt từ ollama.com/download—có phiên bản cho macOS, Windows và Linux.

2. Tải mô hình

   ollama pull gemma4
   

3. Kết nối Ollama với OpenClaw

   openclaw onboard
   

   Chọn nhà cung cấp Ollama và một chế độ: Local only (các mô hình của bạn), Cloud only (mô hình từ ollama.com) hoặc Cloud + Local. Trình hướng dẫn sẽ tìm máy chủ cục bộ và hiển thị các mô hình đã cài đặt.

4. Kiểm tra

   openclaw models list --provider ollama
   

Đây là lưu ý thẳng thắn mà nếu bỏ qua, phần này sẽ giống một bài quảng cáo. Tài liệu OpenClaw nói rõ rằng để dùng agent với mô hình cục bộ một cách thoải mái, cần phần cứng ngang với hai máy Mac Studio cấu hình tối đa; card đồ họa 24 GB chỉ xử lý được các yêu cầu nhẹ và có độ trễ. Mô hình nhỏ và nén mạnh sẽ cắt ngắn ngữ cảnh và kém chống chịu hơn trước những chỉ dẫn độc hại ẩn trong văn bản của người khác. Nói đơn giản: mô hình cục bộ trên một chiếc laptop tốt đủ để “thử và hiểu nó là gì”, nhưng mô hình đám mây vẫn đáng tin cậy hơn nhiều cho công việc hằng ngày với một trợ lý dùng công cụ.

Một cảnh báo nữa từ tài liệu, dành cho những ai thiết lập WSL2 + Ollama + NVIDIA GPU: trình cài đặt Ollama Linux chính thức bật tự khởi động với chính sách khởi động lại “always”, và trên WSL2 cùng GPU, điều này có thể khiến máy rơi vào vòng lặp khởi động lại. Cách khắc phục là tắt chế độ tự khởi động dịch vụ. Nếu gặp vấn đề này, hãy xem phần khắc phục sự cố trên trang Ollama trong tài liệu.

Chạy OpenClaw có an toàn không?#

Tôi sẽ bắt đầu bằng điểm chính mà không phải ai cũng hiểu. OpenClaw có quyền truy cập vào máy của bạn: tệp, lệnh và trình duyệt. Tài liệu nói thẳng: dự án được thiết kế cho một người dùng đáng tin cậy và bạn không nên cho người ngoài quyền truy cập vào bot. Nếu ai đó có thể nhắn tin cho agent của bạn, họ có thể dùng nó để thao tác trên máy tính của bạn.

Những bước tối thiểu cần làm:

1. Bật ghép nối bằng mã hoặc dùng danh sách truy cập—tôi đã viết về cách thiết lập trong phần Telegram.
2. Đừng mở cổng kết nối ra bên ngoài nếu không cần. Theo mặc định, nó chỉ lắng nghe trên máy của bạn; hãy giữ nguyên như vậy.
3. Chạy kiểm tra tích hợp sau mỗi lần thay đổi cấu hình:

openclaw security audit

Lệnh này kiểm tra quyền truy cập mở, quyền công cụ quá rộng, token yếu và cổng bị lộ. Có thể tự động khắc phục một số phát hiện bằng cờ --fix.

Một lưu ý riêng về lừa đảo—đây không phải chuyện giả định. Khi dự án vội vàng đổi tên vào tháng 1 năm 2026, những bot chiếm giữ tên miền đã chiếm các địa chỉ cũ chỉ trong vài giây và lập tức đăng ví tiền mã hóa; những “nhà phát triển OpenClaw” giả bắt đầu quảng bá trò lừa đảo token. Từ đó có hai quy tắc cứng. Chỉ tải OpenClaw từ openclaw.ai hoặc github.com/openclaw/openclaw. Và dự án không có tiền mã hóa: bất kỳ “OpenClaw token” nào cũng là lừa đảo. Tuyệt đối không gửi tiền cho nó.

OpenClaw có thể làm gì sau khi cài đặt?#

Đây là những việc tôi sẽ thử, theo thứ tự:

1. Gateway và mô hình. Chạy openclaw gateway status, rồi mở openclaw dashboard. Bảng tải được xác nhận Control UI có thể truy cập. Gửi “Reply with: model connection test” trong chat của nó và kiểm tra có câu trả lời AI; chỉ tải trang chưa kiểm tra mô hình.
2. Telegram và tác vụ mong muốn. Sau khi cấu hình bot và phê duyệt ghép nối của chính mình, gửi tin nhắn mới cho bot ấy trong Telegram và kiểm tra câu trả lời đến tại đó. Sau đó thử một tác vụ giới hạn có kết quả nhìn thấy, như tóm tắt thư mục thử nghiệm không chứa dữ liệu riêng mà bạn đã cho phép đọc. Với lời nhắc, kiểm tra lịch đã lưu và thông báo được giao riêng rẽ. Câu trả lời trong dashboard không chứng minh giao tin Telegram hay thực thi lịch.
3. Tác vụ theo lịch. Trợ lý có thể chạy công việc theo lịch—bản tóm tắt buổi sáng trong Telegram, kiểm tra email thường xuyên. Đó là lý do bạn giữ cổng kết nối chạy suốt ngày đêm.
4. Bộ nhớ. OpenClaw lưu bộ nhớ dài hạn trong các tệp Markdown thông thường trong thư mục làm việc: bạn là ai, nên trả lời bạn thế nào và đã ghi nhớ gì từ các cuộc trò chuyện trước. Bạn có thể tự mở và đọc các tệp—không có hộp đen nào cả.
5. Kỹ năng. Dự án có danh mục kỹ năng và plugin tạo sẵn với các bước kiểm tra bảo mật tích hợp. Kỹ năng của người khác là mã của người khác trên máy bạn, nên danh mục sẽ kiểm tra chúng.

Có một quy tắc ở đây: đừng bật tất cả mọi thứ cùng lúc. Bắt đầu bằng một cuộc trò chuyện ổn định, rồi đến Telegram, sau đó mới thêm lịch. Như vậy, mỗi lỗi sẽ xuất hiện ở bước riêng thay vì biến thành “mọi thứ hỏng hết mà tôi chẳng biết ở đâu”.

Cần làm gì nếu cài đặt gặp trục trặc?#

Hãy xem qua ba tình huống phổ biến.

“openclaw: command not found” ngay sau khi cài đặt. Gần như lúc nào cũng là vấn đề đường dẫn: thư mục chứa các gói npm toàn cục không có trong PATH của terminal. Các lệnh chẩn đoán trong tài liệu là:

node -v
npm prefix -g
echo "$PATH"

Đường dẫn từ lệnh thứ hai phải xuất hiện trong kết quả lệnh thứ ba. Nếu không có, hãy thêm nó vào cài đặt shell hoặc chỉ cần đóng rồi mở lại terminal: đôi khi đường dẫn Node chỉ xuất hiện trong phiên mới sau khi cài đặt.

Cổng kết nối đang chạy nhưng trợ lý im lặng. Triệu chứng được nêu trong phần FAQ của tài liệu: không có phản hồi cho tin nhắn đầu tiên và bộ đếm token ở mức 0. Điều đó có nghĩa là agent thậm chí chưa khởi chạy—thường nhất là do chưa cấu hình mô hình. Kiểm tra theo thứ tự này:

openclaw gateway restart
openclaw status
openclaw models status

Nếu đã cấu hình mô hình mà vẫn không có phản hồi, openclaw logs --follow sẽ hiển thị nhật ký trực tiếp và điểm hệ thống bị mắc kẹt.

Bot Telegram không trả lời. Kiểm tra theo thứ tự này: token thuộc về bot mà bạn đang nhắn; cổng kết nối đang chạy (openclaw gateway status); và bạn đã được phê duyệt ghép nối (openclaw pairing list telegram). Mã ghép nối có hiệu lực trong một giờ—nếu hôm qua bạn đã nhắn cho bot, hãy nhắn lại và phê duyệt mã mới.

Khi hoàn toàn bế tắc, tài liệu gợi ý một cách bất ngờ nhưng hợp lý: đưa thông tin chẩn đoán cho một AI agent cục bộ có thể xem máy của bạn. Claude Code hoặc Codex, nếu được cung cấp đầu ra của openclaw status --all và openclaw doctor, có thể hiểu cấu hình nhanh hơn bộ phận hỗ trợ qua chat. Một vòng tròn khép kín—AI sửa AI.

Mọi người còn hỏi gì về OpenClaw?#

Tìm hiểu về Ailoot.