Hướng dẫn cài đặt OpenClaw trên Windows, macOS, Linux và VPS Ubuntu

Cùng với sự phát triển của AI Agent, nhiều nền tảng đã vượt ra khỏi vai trò chatbot thông thường để trực tiếp thực hiện công việc trên máy tính. OpenClaw là một trong những dự án nhận được nhiều sự quan tâm nhờ khả năng tự vận hành quy trình làm việc, tương tác với phần mềm và xử lý tác vụ theo mục tiêu được giao. Hãy cùng Long Vân tìm hiểu các bước cài đặt OpenClaw chi tiết trong bài viết sau.

Mục lục

OpenClaw là gì? 

OpenClaw là một AI Agent mã nguồn mở, hỗ trợ người dùng xử lý công việc trên máy tính một cách tự động. Hệ thống có thể tiếp nhận mục tiêu, phân tích yêu cầu, xây dựng quy trình thực hiện và tự vận hành nhiều bước liên tiếp để hoàn thành nhiệm vụ nhờ khả năng tương tác với ứng dụng, trình duyệt và hệ điều hành. 

Các tính năng nổi bật của OpenClaw

• Tự động hóa công việc văn phòng: Thực hiện các tác vụ lặp lại như xử lý dữ liệu, quản lý email, cập nhật bảng tính, tạo báo cáo hoặc sắp xếp lịch làm việc. Nhờ đó, thời gian dành cho các công việc thủ công được rút ngắn đáng kể.
• Trợ lý lập trình: Hỗ trợ viết mã nguồn, phát hiện lỗi, phân tích cấu trúc dự án, tối ưu code và thực thi các lệnh phục vụ quá trình phát triển phần mềm.
• Duyệt web và nghiên cứu dữ liệu: Truy cập website, thu thập thông tin từ nhiều nguồn, tổng hợp dữ liệu và xây dựng báo cáo theo yêu cầu. Tính năng này phù hợp cho hoạt động nghiên cứu thị trường hoặc tìm kiếm tài liệu chuyên môn.
• Điều khiển từ xa qua ứng dụng chat: Cho phép gửi lệnh và theo dõi tiến trình xử lý thông qua các nền tảng nhắn tin như Telegram hoặc WhatsApp mà không cần truy cập trực tiếp vào thiết bị đang vận hành.
• Chủ động theo dõi và báo cáo: Liên tục giám sát hệ thống, dữ liệu hoặc các điều kiện được thiết lập trước. Khi xuất hiện thay đổi quan trọng, thông báo và báo cáo sẽ được gửi tự động đến người dùng.
• Làm việc sâu ở cấp hệ điều hành: Hỗ trợ thao tác trực tiếp trên máy tính như đọc và ghi tệp, thực thi lệnh terminal, điều khiển trình duyệt, sử dụng chuột và bàn phím hoặc tương tác với các phần mềm đang hoạt động.
• Ghi nhớ ngữ cảnh làm việc: Lưu lịch sử tương tác và ngữ cảnh làm việc để các yêu cầu tiếp theo được xử lý liền mạch, phù hợp với thói quen sử dụng của từng người.

Gateway, Agent, Channel là gì?

Để hiểu rõ quá trình cài đặt và vận hành OpenClaw, người dùng cần nắm được ba thành phần cốt lõi trong kiến trúc của nền tảng này:

• Gateway (Cổng dịch vụ nền): Thành phần điều phối trung tâm của hệ thống. Gateway hoạt động dưới dạng tiến trình chạy ngầm, có nhiệm vụ quản lý kết nối, bảo vệ các endpoint, lắng nghe cổng mạng nội bộ và định tuyến dữ liệu an toàn giữa người dùng với hệ thống.
• Agent (Bộ não xử lý trung tâm): Thành phần tiếp nhận prompt, lưu trữ ngữ cảnh dài hạn và kết nối với các mô hình ngôn ngữ lớn (LLM). Agent chịu trách nhiệm suy luận, chia nhỏ bài toán và kích hoạt các công cụ để hoàn thành nhiệm vụ.
• Channel (Kênh giao tiếp đầu cuối): Kết nối giữa OpenClaw và các nền tảng nhắn tin như Telegram, WhatsApp, Discord hoặc Zalo. Channel chuyển tin nhắn của người dùng thành yêu cầu để Gateway tiếp nhận, sau đó gửi phản hồi của Agent về đúng cuộc trò chuyện. Ngoài ra, người dùng có thể chat trực tiếp với Agent qua giao diện Control UI mà không cần cấu hình Channel.

>> Xem thêm: 

• OpenClaw quản lý email tự động: Giải pháp tối ưu quy trình xử lý email
• OpenClaw trong chăm sóc khách hàng: Chatbot thông minh tự xử lý ticket
• OpenClaw tự động hóa công việc: Cách AI hỗ trợ xử lý công việc hiệu quả

Cách cài đặt OpenClaw trên máy tính (Windows/Linux/macOS)

Quá trình cài đặt OpenClaw không quá phức tạp nhưng cần thực hiện đúng theo từng bước để hệ thống hoạt động ổn định. Trước khi bắt đầu, người dùng nên chuẩn bị đầy đủ môi trường cần thiết và kiểm tra cấu hình máy tính nhằm hạn chế các lỗi phát sinh trong quá trình thiết lập.

Chuẩn bị

Trước khi cài OpenClaw trên Windows, macOS hoặc Linux, hãy chuẩn bị các thành phần sau:

• Công cụ dòng lệnh: PowerShell trên Windows, Terminal trên macOS hoặc Linux.
• Yêu cầu phần mềm: OpenClaw yêu cầu Node.js để cài đặt và vận hành. Nếu máy chưa có Node.js, script cài đặt ở Bước 1 sẽ tự cài giúp bạn. Nếu muốn tự cài, hãy dùng một trong hai phiên bản sau:
  • Node.js 24: Từ phiên bản 24.16.0 trở lên thuộc nhánh 24.x, hoặc phiên bản 24.22.1 trở lên để có bản vá bảo mật.
  • Node.js 26: Từ phiên bản 26.1.0 hoặc 26.12.1 trở lên. Đây là phiên bản được OpenClaw khuyến nghị nhờ khả năng khởi động Gateway nhanh hơn và sử dụng ít bộ nhớ hơn.
• Chuẩn bị mô hình AI: OpenClaw hỗ trợ kết nối với nhiều nhà cung cấp mô hình AI khác nhau:
  • Google Gemini: Truy cập Google AI Studio để tạo Google Gemini API Key miễn phí.
  • Anthropic Claude: Chuẩn bị API key từ Anthropic để sử dụng các mô hình Claude.
  • OpenAI: Tạo API key trên nền tảng OpenAI để kết nối với các mô hình GPT.
  • Ollama: Sử dụng khi muốn chạy mô hình AI trực tiếp trên máy tính mà không cần gửi yêu cầu đến API bên ngoài.
• Cấu hình phần cứng khuyến nghị (CPU, RAM, ổ cứng trống):
  • CPU: Intel Core i5 hoặc AMD Ryzen 5 thế hệ mới trở lên.
  • RAM: Khuyến nghị từ 16GB.
  • Ổ cứng: SSD còn trống từ 50GB.
• Docker và Git: Không phải là yêu cầu bắt buộc khi cài đặt OpenClaw, chỉ cần chuẩn bị các công cụ này khi lựa chọn phương thức triển khai tương ứng:
  • Docker Desktop: Cài đặt khi muốn triển khai OpenClaw trong môi trường container bằng Docker.
  • Git: Cài đặt khi muốn tải mã nguồn và build OpenClaw từ source. 

>> Khám phá thêm:

• OpenClaw chạy Local không Cloud: Giải pháp AI riêng tư cho doanh nghiệp
• OpenClaw MoltBot ClawDBot lịch sử: Hành trình phát triển đến OpenClaw
• Đào tạo OpenClaw cho người mới: Bắt đầu với nhân sự số Ai chỉ trong vài bước

Bước 1: Cài đặt OpenClaw

Hãy truy cập trang cài đặt https://openclaw.ai/install, chọn tab hệ điều hành của bạn (Windows/macOS/Linux). Sau đó, bạn bấm sao chép câu lệnh cài đặt tự động được cung cấp sẵn tương ứng cho từng hệ điều hành.

• macOS/Linux: curl -fsSL https://openclaw.ai/install.sh | bash
• Windows: powershell -c "irm https://openclaw.ai/install.ps1 | iex"

Mở công cụ dòng lệnh trên máy tính:

• Đối với Windows: Nhấn nút Start, gõ PowerShell và mở Windows PowerShell.
• Đối với macOS: Nhấn Command + Space, gõ Terminal và nhấn Enter.
• Đối với Linux: Mở ứng dụng Terminal.

Dán lệnh vào cửa sổ dòng lệnh và nhấn Enter. Script sẽ kiểm tra Node.js (tự cài nếu thiếu) rồi cài đặt OpenClaw CLI. Sau khi hoàn tất, kiểm tra bằng lệnh openclaw --version.

Bước 2: Chạy quy trình thiết lập ban đầu

Chờ OpenClaw hoàn tất cài đặt, nhập lệnh openclaw onboard --install-daemon vào cửa sổ dòng lệnh rồi nhấn Enter. Khi trình hướng dẫn hiển thị thông báo bảo mật, hãy đọc và xác nhận để tiếp tục. Tiếp theo, chọn một trong hai chế độ:

• Toàn quyền truy cập (Full Access): Cho phép OpenClaw tự động tìm kiếm các ứng dụng AI, khóa API và môi trường chạy cục bộ.
• Hỏi trước (Ask First): Yêu cầu xác nhận trước khi tìm kiếm hoặc cấp quyền truy cập, phù hợp nếu muốn tự kiểm soát quá trình thiết lập.

Nếu muốn sử dụng trình hướng dẫn cổ điển với ít lời nhắc hơn, có thể chạy lệnh openclaw onboard --flow quickstart.

• Chọn nhà cung cấp mô hình: OpenClaw sẽ tự động phát hiện các quyền truy cập AI hiện có và kiểm tra khả năng hoạt động. Nếu OpenClaw chưa tự tìm thấy quyền truy cập AI, chọn Google để dùng Gemini bằng API key (cũng hỗ trợ Anthropic, OpenAI, OpenRouter…).
• Cấu hình API Key: OpenClaw sẽ kiểm tra bằng một lượt hoàn thành thực và chỉ lưu khi thành công.
• Thiết lập tìm kiếm trên Internet: Chọn Gemini (Google Search) và nhập API Key tương ứng nếu được yêu cầu. Bạn cũng có thể bỏ qua bước này nếu chưa có nhu cầu tra cứu thông tin trực tuyến.
• Kết nối ứng dụng chat (tùy chọn, thực hiện sau): Chạy openclaw channels add, hoặc chạy openclaw rồi gõ open channel wizard for telegram. Thay telegram bằng tên kênh muốn thiết lập.

Bước 3: Xác minh Gateway đang chạy

Để kiểm tra tình trạng kết nối, người dùng gõ câu lệnh openclaw gateway status vào cửa sổ dòng lệnh và theo dõi kết quả hiển thị trên màn hình. Nếu hệ thống hoạt động bình thường, màn hình sẽ trả về thông báo xác nhận hệ thống Gateway đang lắng nghe trên cổng 18789.

Bước 4: Mở bảng điều khiển

Người dùng tiến hành nhập câu lệnh openclaw dashboard vào cửa sổ dòng lệnh để kích hoạt giao diện điều khiển của phần mềm. Câu lệnh này sẽ tự động mở Control UI trong trình duyệt web của máy tính. Nếu trình duyệt không tự mở, truy cập http://127.0.0.1:18789/ trên chính máy đang chạy Gateway. Trang tải thành công và hiển thị giao diện quản lý nghĩa là OpenClaw đã hoạt động.

Bước 5: Gửi tin nhắn đầu tiên

Sau khi giao diện quản lý đã mở ra thành công, người dùng có thể bắt đầu kiểm tra hệ thống bằng cách gửi câu lệnh đầu tiên thông qua 2 cách:

• Cách 1 (Sử dụng Control UI): Nhập yêu cầu vào ô chat ở cuối màn hình Control UI, sau đó nhấn nút gửi để nhận phản hồi từ AI.
• Cách 2 (Sử dụng Telegram): Chỉ áp dụng khi đã kết nối Telegram. Gửi một tin nhắn bất kỳ đến bot. Nếu bot trả về mã ghép nối, chạy lệnh openclaw pairing approve telegram <CODE> trên máy cài OpenClaw để phê duyệt, sau đó gửi lại yêu cầu.

Khi đã nhận được phản hồi, hãy chuyển sang mục bảo mật ngay sau khi cài đặt để khoá các thiết lập quan trọng trước khi sử dụng thường xuyên.

>> Xem thêm: 

• OpenClaw cho doanh nghiệp: Giải pháp AI Agent giúp tối ưu vận hành và nâng cao hiệu suất làm việc
• Cấu hình máy chạy OpenClaw: Yêu cầu tối thiểu và khuyến nghị năm 2026
• OpenClaw chi phí token tốn bao nhiêu? Sự thật về chi phí AI mà nhiều người bỏ qua

Cách cài đặt OpenClaw trên VPS Ubuntu

Cài đặt OpenClaw trên máy chủ ảo (VPS) giúp hệ thống hoạt động liên tục 24/7 mà không phụ thuộc vào máy tính cá nhân. Phần này hướng dẫn triển khai bằng Docker Compose, phương án giúp tách môi trường chạy OpenClaw khỏi hệ điều hành của VPS và dễ khởi động lại khi cần.

Chuẩn bị

Trước khi tiến hành cài đặt OpenClaw trên Ubuntu, máy chủ VPS và người quản trị cần đáp ứng đầy đủ các thông số kỹ thuật tối thiểu.

• Thông tin đăng nhập VPS: Tài khoản root hoặc tài khoản có quyền sudo và địa chỉ IP của VPS để kết nối qua SSH.
• Cấu hình máy chủ khuyến nghị: CPU 2 Core, RAM từ 4GB, SSD còn trống từ 25GB. Ngoài ra, cần ít nhất 2GB RAM nếu build image trên VPS.
• Hệ điều hành tương thích: Ubuntu 22.04 LTS hoặc 24.04 LTS, đã cập nhật các gói mới nhất.
• API key: Chuẩn bị Google Gemini API Key hoặc khóa API của nhà cung cấp mô hình AI khác.

>> Xem thêm: 

• Hướng dẫn cài đặt hệ điều hành Ubuntu Server 22.04
• Hướng dẫn cài đặt OpenVPN trên Ubuntu 20.04

Bước 1: Cài đặt Docker

Docker là thành phần cần thiết để triển khai OpenClaw trên VPS theo mô hình container hóa. Bạn hãy cài đặt Docker hoặc dùng script tiện lợi dưới đây cho môi trường thử nghiệm: 

curl -fsSL https://get.docker.com -o install-docker.sh

sh install-docker.sh

Sau khi cài đặt, kiểm tra phiên bản và trạng thái dịch vụ:

docker --version 

docker compose version 

systemctl status docker 

Bước 2: Tạo user riêng cho OpenClaw

Bạn không nên chạy OpenClaw bằng quyền root trong môi trường vận hành thực tế. Thay vào đó, hãy tạo tài khoản riêng để giới hạn phạm vi ảnh hưởng khi Agent hoặc plugin gặp sự cố. Kết nối VPS qua SSH bằng tài khoản quản trị, sau đó tạo user mới:

adduser openclaw 

usermod -aG docker openclaw 

su - openclaw 

Lưu ý: Thành viên nhóm docker có quyền gần như tương đương root trên máy chủ, vì vậy chỉ cấp cho tài khoản tin cậy và không dùng chung tài khoản này. Toàn bộ thao tác cài đặt OpenClaw tiếp theo thực hiện dưới tài khoản openclaw.

Bước 3: Thiết lập mã nguồn

Bạn chuyển về thư mục home, tải mã nguồn và chạy script thiết lập:

cd ~ 

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

cd openclaw 

./scripts/docker/setup.sh 

Nếu không muốn build image trên VPS cấu hình thấp, có thể dùng image dựng sẵn trước khi chạy script: 

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest" 

Script sẽ build (hoặc tải) Docker image, chạy trình hướng dẫn cấu hình và tạo Gateway token. Trong quá trình chạy, bạn sẽ được yêu cầu chọn nhà cung cấp mô hình AI, nhập API key và cấu hình kênh chat nếu cần. 

Lưu ý bảo mật: Docker setup mặc định cho phép truy cập từ ngoài container, nên trên VPS công khai cần giới hạn truy cập cổng 18789 bằng tường lửa hoặc chỉ truy cập qua SSH tunnel/Tailscale, và không chia sẻ Gateway token. 

>> Tìm hiểu thêm:

• OpenClaw làm trợ lý cá nhân – Giải pháp AI hỗ trợ công việc hiệu quả cho doanh nghiệp hiện đại
• OpenClaw dành cho Non-Tech: Giải pháp AI Automation dễ tiếp cận cho doanh nghiệp hiện đại
• OpenClaw có miễn phí không? Chi phí thực tế khi sử dụng OpenClaw năm 2026

Bước 4: Thiết lập chạy lệnh cho OpenClaw qua Docker

OpenClaw chạy bên trong container Docker, nên cần một hàm shell để gõ lệnh openclaw thuận tiện trên VPS. Mở tệp cấu hình bằng nano ~/.bashrc và thêm đoạn sau vào cuối tệp:

openclaw() { 

  (cd "HOME/openclaw"&&dockercomposerun--rmopenclaw-cli"@") 

} 

Lưu tệp, rồi tải lại cấu hình: source ~/.bashrc

Từ đây, mọi lệnh openclaw ở các phần sau có thể chạy trên VPS Docker thông qua alias này. Để kiểm tra Gateway, dùng lệnh health theo tài liệu: 

docker compose exec openclaw-gateway node dist/index.js health --token "$OPENCLAW_GATEWAY_TOKEN" 

Bước 5: Cấu hình tự khởi động cùng VPS

Để OpenClaw tiếp tục hoạt động khi VPS khởi động lại, thực hiện các bước sau: 

• Dưới tài khoản quản trị (root hoặc sudo), bật Docker chạy cùng hệ thống: sudo systemctl enable --now docker
• Trong docker-compose.yml của dự án, kiểm tra dịch vụ openclaw-gateway đã có restart policy (ví dụ restart: unless-stopped). Nếu chưa có, bổ sung để Docker tự khởi động lại container.
• Khởi động Gateway: cd ~/openclaw && docker compose up -d openclaw-gateway
• Khởi động lại VPS và kiểm tra container đã chạy lại chưa: docker compose ps

Cách tích hợp OpenClaw vào Telegram, WhatsApp và Zalo

OpenClaw hỗ trợ kết nối với nhiều nền tảng nhắn tin như Telegram, WhatsApp và Zalo, cho phép người dùng gửi yêu cầu và nhận phản hồi từ AI Agent ngay trong ứng dụng quen thuộc. Mỗi nền tảng có cách xác thực riêng, nhưng đều cần cấu hình quyền truy cập để hạn chế người lạ nhắn tin và điều khiển Agent.

Chuẩn bị

Trước khi tích hợp, bạn cần bảo đảm các điều kiện sau:

• OpenClaw đã được cài đặt và hoàn tất quá trình onboarding.
• Gateway đang hoạt động ổn định.
• Đã cấu hình API Key của mô hình AI đang sử dụng.
• Có tài khoản Telegram, WhatsApp hoặc Zalo tương ứng.
• Có quyền truy cập Dashboard hoặc tệp cấu hình OpenClaw.
• Máy chủ duy trì kết nối Internet ổn định.

Ngoài ra, hãy bảo mật Bot Token, mã QR và các thông tin xác thực trong suốt quá trình thiết lập. Không chia sẻ token công khai hoặc đưa token vào những nơi người khác có thể truy cập.

Kết nối OpenClaw với Telegram

Để sử dụng Telegram làm kênh điều khiển, bạn cần tạo bot thông qua BotFather, cấu hình Bot Token và xác nhận tài khoản được phép nhắn tin cho bot.

• Tạo bot Telegram: Mở Telegram, tìm tài khoản @BotFather và gửi lệnh /newbot. Làm theo hướng dẫn để đặt tên, username cho bot. Sau khi hoàn tất, BotFather sẽ cấp Bot Token để kết nối với OpenClaw.
• Cấu hình Bot Token: Trên máy chủ cài OpenClaw, chạy lệnh sau và thay phần <bot-token> bằng token vừa nhận: openclaw channels add --channel telegram --token <bot-token>. Lệnh này thêm thông tin xác thực và cấu hình kênh Telegram cho OpenClaw.
• Kiểm tra và lấy yêu cầu ghép nối: Gửi một tin nhắn bất kỳ đến bot vừa tạo. OpenClaw sẽ tạo yêu cầu pairing cho tài khoản Telegram đó. Bạn có thể kiểm tra yêu cầu bằng lệnh: openclaw pairing list telegram. Sau đó, dùng mã xác nhận được cung cấp để phê duyệt: openclaw pairing approve telegram <CODE>.
• Xác nhận kết nối: Kiểm tra trạng thái kênh bằng lệnh openclaw channels status --probe. Khi tài khoản được phê duyệt, bạn có thể gửi tin nhắn để kiểm tra khả năng phản hồi của Agent. 

Nếu muốn giới hạn quyền truy cập chặt chẽ hơn, bạn có thể cấu hình allowFrom bằng Telegram User ID của tài khoản được phép nhắn tin. Khi sử dụng bot trong nhóm, cần cấu hình thêm ID nhóm và quyền truy cập tương ứng.

>> Xem thêm: OpenClaw kết nối Telegram là gì? Vì sao doanh nghiệp quan tâm?

Kết nối OpenClaw với WhatsApp

WhatsApp sử dụng mã QR để liên kết tài khoản với OpenClaw. Bạn cần thực hiện xác thực trên điện thoại đang đăng nhập WhatsApp, sau đó phê duyệt những tài khoản được phép nhắn tin cho Agent.

• Khởi tạo phiên kết nối: Trên máy chủ OpenClaw, chạy lệnh openclaw channels login --channel whatsapp. OpenClaw sẽ hiển thị mã QR để liên kết tài khoản.
• Quét mã QR: Mở WhatsApp trên điện thoại, truy cập Thiết bị liên kết (Linked Devices) → Liên kết thiết bị (Link a Device) rồi quét mã QR trên màn hình máy chủ.
• Phê duyệt người nhắn tin: Sau khi liên kết thành công, gửi một tin nhắn đến tài khoản WhatsApp đã kết nối. Nếu OpenClaw đang sử dụng chính sách pairing, hệ thống sẽ tạo yêu cầu xác nhận. Kiểm tra bằng lệnh openclaw pairing list whatsapp, sau đó phê duyệt bằng lệnh openclaw pairing approve whatsapp <CODE>.
• Kiểm tra hoạt động: Gửi tin nhắn thử nghiệm để xác nhận Agent có thể nhận và phản hồi yêu cầu.

Lưu ý: Mã QR chỉ dùng để liên kết tài khoản WhatsApp với OpenClaw. Việc phê duyệt người được phép nhắn tin là bước riêng biệt, giúp kiểm soát quyền truy cập vào Agent. 

>> Xem thêm: OpenClaw kết nối WhatsApp: Hướng dẫn thiết lập và sử dụng

Kết nối OpenClaw với Zalo

OpenClaw hiện hỗ trợ tích hợp Zalo thông qua Zalo Bot API. Tính năng này đang ở trạng thái thử nghiệm, hỗ trợ tin nhắn cá nhân. Để thiết lập, bạn thực hiện các bước cơ bản sau:

• Tạo Zalo Bot: Truy cập Zalo Bot Platform, đăng nhập và tạo bot theo hướng dẫn. Sau khi hoàn tất, nền tảng sẽ cung cấp Bot Token.
• Cấu hình Bot Token: Thêm token vào khoá channels.zalo.botToken trong cấu hình hoặc đặt biến môi trường ZALO_BOT_TOKEN (biến môi trường chỉ áp dụng cho tài khoản mặc định). Sau đó khởi động lại Gateway.
• Kiểm tra kết nối: Chạy lệnh openclaw channels status --probe để kiểm tra trạng thái kênh Zalo. Nếu Gateway chưa hoạt động, hãy khởi động dịch vụ trước khi kiểm tra.
• Phê duyệt tài khoản: Gửi tin nhắn đến bot trên Zalo. Nếu hệ thống tạo yêu cầu pairing, kiểm tra bằng lệnh openclaw pairing list zalo và phê duyệt bằng lệnh openclaw pairing approve zalo <CODE>.

OpenClaw mặc định sử dụng cơ chế long-polling để nhận tin nhắn từ Zalo, không yêu cầu máy chủ có địa chỉ webhook công khai. Tích hợp này áp dụng cho Zalo Bot Creator/Marketplace, không đồng nghĩa với việc hỗ trợ mọi loại Zalo Official Account (OA).

>> Xem thêm: Hướng dẫn kết nối OpenClaw với Zalo tạo Chatbot AI đơn giản 

Bảo mật ngay sau khi cài đặt

Khác với chatbot thông thường, OpenClaw có thể truy cập và thao tác trực tiếp với tệp tin, dòng lệnh và mạng nội bộ. Vì vậy, bạn cần thiết lập các lớp bảo vệ ngay sau khi cài đặt để hạn chế nguy cơ bị tấn công và rò rỉ dữ liệu.

Vì sao bảo mật OpenClaw quan trọng?

Cấu hình bảo mật không đầy đủ có thể khiến OpenClaw trở thành mục tiêu của các cuộc tấn công. Một số rủi ro phổ biến gồm:

• Quét cổng tự động: Mặc định Gateway chỉ lắng nghe ở loopback. Nếu chuyển sang bind lan hoặc 0.0.0.0 mà thiếu tường lửa và xác thực, các công cụ quét như Shodan hoặc Censys có thể phát hiện cổng 18789 của instance.
• Thực thi mã từ xa (RCE): Gateway bị mở ra ngoài và thiếu bảo vệ có thể bị lợi dụng để yêu cầu Agent chạy lệnh shell độc hại, dẫn đến nguy cơ chiếm quyền máy tính hoặc máy chủ.
• Rò rỉ API Key và dữ liệu: API key của Claude, OpenAI, Gemini có thể bị đánh cắp khi hệ thống bị xâm nhập, gây phát sinh chi phí trái phép; tài liệu nội bộ mà Agent từng truy cập cũng có nguy cơ bị lộ.

Các điểm bảo vệ hệ thống cốt lõi

Sau khi hoàn tất cài đặt, bạn nên thực hiện lần lượt 5 bước dưới đây để tăng cường bảo mật cho OpenClaw.

Bước 1: Cập nhật OpenClaw

Thường xuyên cập nhật phiên bản mới để khắc phục các lỗ hổng bảo mật và lỗi phân quyền. Sử dụng lệnh openclaw update.

Bước 2: Khóa gateway.bind ở giao diện Loopback

Loopback chỉ cho phép kết nối từ chính máy chạy Gateway. Kiểm tra giá trị hiện tại (kết quả mong đợi là loopback): 

openclaw config get gateway.bind

Nếu giá trị khác, đặt lại và khởi động lại Gateway: 

openclaw config set gateway.bind loopback 

openclaw gateway restart 

Với OpenClaw chạy bằng Docker trên VPS, script thiết lập có thể đặt bind kiểu lan để truy cập qua cổng đã publish; khi đó cần giới hạn cổng 18789 bằng tường lửa.

Bước 3: Kiểm tra token xác thực của Gateway 

Xác thực Gateway được bật mặc định và wizard onboarding đã tạo sẵn token. Xem token hiện tại: 

openclaw config get gateway.auth.token 

Nếu cần tạo token mới, chạy lệnh sau rồi khởi động lại Gateway: 

openclaw doctor --generate-gateway-token 

openclaw gateway restart 

Lưu token ở nơi an toàn để đăng nhập Control UI và không chia sẻ công khai. Có thể chuyển sang xác thực bằng mật khẩu bằng cách đặt gateway.auth.mode là password.

>> Xem thêm:

• OpenClaw có an toàn không? Những rủi ro cần biết trước khi sử dụng
• OpenClaw và tương lai AI tự động hóa trong doanh nghiệp
• OpenClaw - AI dành cho người muốn tự động hóa mọi thứ

Bước 4: Giữ cơ chế phê duyệt lệnh (Exec Approvals) 

Cấu hình mặc định dành cho một người vận hành tin cậy cho phép Agent chạy lệnh trên máy chủ Gateway mà không cần hỏi phê duyệt. Để tăng mức an toàn, bạn nên bật yêu cầu phê duyệt và chỉ cho phép các lệnh đáng tin cậy. Kiểm tra chính sách hiện tại: openclaw approvals get . Chỉ thêm vào danh sách cho phép (allowlist) những lệnh đáng tin cậy và thật sự cần thiết.

Bước 5: Chạy OpenClaw bằng tài khoản người dùng thường 

• Không chạy OpenClaw bằng root trên Linux hoặc Administrator trên Windows; dùng tài khoản riêng với quyền tối thiểu cần thiết (cách tạo user xem tại Bước 2 phần VPS Ubuntu).
• Cài đặt và chạy OpenClaw bằng cùng một tài khoản này để lệnh openclaw và thư mục cấu hình ~/.openclaw nằm trong cùng môi trường.
• Cách thiết lập này giúp giới hạn phạm vi ảnh hưởng khi xảy ra sự cố bảo mật, đồng thời bảo vệ các tệp tin và thành phần quan trọng của hệ điều hành.

Xử lý lỗi thường gặp khi cài đặt OpenClaw

Trong quá trình cài đặt OpenClaw, bạn có thể gặp một số lỗi liên quan đến môi trường hệ thống, phiên bản phần mềm hoặc cấu hình kết nối với mô hình AI. Xác định đúng nguyên nhân sẽ giúp khắc phục sự cố nhanh hơn.

Lỗi phiên bản Node.js không khớp

Khi cài đặt hoặc khởi chạy OpenClaw qua giao diện dòng lệnh (CLI), tiến trình có thể dừng đột ngột và hiển thị thông báo như Unsupported engine hoặc SyntaxError.

• Nguyên nhân: Phiên bản Node.js trên máy không đáp ứng yêu cầu của phiên bản OpenClaw đang cài đặt.
• Cách khắc phục:
  • Kiểm tra phiên bản Node.js bằng lệnh node -v. Nếu phiên bản không đáp ứng yêu cầu, hãy nâng cấp theo hướng dẫn cài đặt chính thức của OpenClaw.
  • Nếu sử dụng NVM, bạn có thể cài và chuyển sang Node.js 24 bằng lệnh: nvm install 24 && nvm use 24. Sau đó, kiểm tra lại phiên bản và chạy lại quá trình cài đặt.

>> Xem thêm:

• Đánh giá OpenClaw: AI mã nguồn mở mạnh nhất hiện nay?
• OpenClaw vs ChatGPT: AI nào mạnh hơn trong tự động hóa công việc?
• OpenClaw trong giáo dục: AI hỗ trợ giảng dạy và tạo bài giảng

Lỗi API Provider returned a billing error

OpenClaw vẫn hiển thị giao diện bình thường nhưng không thể phản hồi tin nhắn. Khi gửi yêu cầu, hệ thống trả về lỗi 402 Payment Required hoặc Insufficient Credit.

• Nguyên nhân: Tài khoản API của nhà cung cấp như OpenAI, Anthropic (Claude) hoặc DeepSeek đã hết số dư, vượt hạn mức sử dụng hoặc gặp sự cố thanh toán.
• Cách khắc phục: Vào trang quản lý tài khoản của nhà cung cấp, kiểm tra mục Billing, hạn mức và trạng thái thanh toán; nạp thêm số dư hoặc điều chỉnh hạn mức, sau đó khởi động lại Gateway bằng lệnh openclaw gateway restart.

Lưu ý: Nếu hệ thống báo lỗi xác thực (ví dụ 401, invalid API key) thì đây là lỗi API key, không phải lỗi thanh toán; hãy tạo key mới, cập nhật vào cấu hình OpenClaw rồi chạy openclaw gateway restart.

Lỗi không tìm thấy hoặc không tải được tệp cấu hình

Khi khởi động Gateway, OpenClaw có thể hiển thị thông báo Configuration file missing, Invalid config hoặc không thể tải cấu hình. 

• Nguyên nhân: Tệp cấu hình chưa được tạo, bị đặt sai đường dẫn, chứa cú pháp không hợp lệ hoặc có những thiết lập không còn tương thích với phiên bản OpenClaw hiện tại.
• Cách khắc phục:
  • Kiểm tra đường dẫn cấu hình mặc định ~/.openclaw/openclaw.json và xác nhận tệp có nội dung hợp lệ.
  • Chạy openclaw config validate để kiểm tra cấu hình.
  • Nếu phát hiện lỗi cấu hình hoặc thiết lập cũ không tương thích, chạy openclaw doctor --fix để áp dụng các biện pháp sửa chữa được đề xuất.
  • Nếu Dashboard yêu cầu token xác thực, chạy openclaw doctor --generate-gateway-token, khởi động lại Gateway và lấy token bằng lệnh openclaw gateway auth-token --show.

Lưu ý: OpenClaw sử dụng tệp cấu hình JSON5 có tên openclaw.json theo mặc định, không phải config.yml.

Lỗi bị từ chối quyền trong quá trình cài đặt

Khi cài đặt hoặc cập nhật OpenClaw, hệ thống có thể hiển thị thông báo EACCES: permission denied khi chạy npm hoặc SYSTEM_RUN_DENIED khi Agent thực thi lệnh.

• Nguyên nhân: Lỗi EACCES thường xuất hiện khi tài khoản hiện tại không có quyền ghi vào thư mục cài đặt npm. Trong khi đó, SYSTEM_RUN_DENIED thường liên quan đến cơ chế phê duyệt lệnh hoặc danh sách cho phép của OpenClaw.
• Cách khắc phục:
  • Với EACCES (Linux/npm): Đổi thư mục cài đặt toàn cục của npm sang thư mục của người dùng, tránh dùng sudo npm:
    • mkdir -p "$HOME/.npm-global"
    • npm config set prefix "$HOME/.npm-global"
    • export PATH="HOME/.npm-global/bin:PATH"
    • Thêm dòng export vào ~/.bashrc hoặc ~/.zshrc để giữ lâu dài. Có thể dùng NVM để cài Node.js và npm trong thư mục người dùng.
  • Với SYSTEM_RUN_DENIED: Kiểm tra yêu cầu phê duyệt trong Exec Approvals hoặc cấu hình allowlist. Chỉ cấp quyền cho những lệnh đáng tin cậy và cần thiết.

Lỗi cổng 18789 bị chiếm dụng

Khi khởi động Gateway, OpenClaw có thể dừng tiến trình và hiển thị thông báo EADDRINUSE hoặc another gateway instance is already listening.

• Nguyên nhân: Cổng mặc định 18789 đã được một tiến trình khác sử dụng. Trường hợp phổ biến là Gateway đang chạy ở một cửa sổ terminal khác hoặc có nhiều dịch vụ OpenClaw cùng khởi động.
• Cách khắc phục:
  • Kiểm tra trạng thái Gateway bằng lệnh openclaw gateway status.
  • Xác định tiến trình đang sử dụng cổng 18789 bằng lệnh lsof -i :18789 trên Linux/macOS. Với Windows, có thể dùng netstat -ano | findstr :18789.
  • Nếu phát hiện Gateway chạy trùng, hãy dừng tiến trình không cần thiết thay vì khởi chạy thêm một phiên mới.
  • Nếu cần sử dụng nhiều Gateway trên cùng máy, hãy cấu hình cổng riêng cho từng phiên và bảo đảm chúng sử dụng thư mục cấu hình, dữ liệu độc lập.

Bạn cũng có thể chạy openclaw doctor để kiểm tra xung đột cổng và các dịch vụ Gateway đang tồn tại.

>> Xem thêm:

• OpenClaw tự động hóa công việc: Cách AI hỗ trợ xử lý công việc hiệu quả
• OpenClaw lỗi không khởi động: Nguyên nhân và cách khắc phục
• OpenClaw so với n8n, Zapier: Đâu là lựa chọn phù hợp cho tự động hóa AI?

Lỗi Gateway không chạy nền sau khi đóng Terminal

OpenClaw hoạt động bình thường khi mở Terminal nhưng ngừng phản hồi sau khi người dùng đóng cửa sổ dòng lệnh hoặc đăng xuất khỏi máy chủ.

• Nguyên nhân: Gateway đang được chạy trực tiếp trong phiên Terminal thay vì được cài đặt dưới dạng dịch vụ nền. Trên Linux, dịch vụ systemd cấp người dùng cũng có thể dừng sau khi đăng xuất nếu chưa bật cơ chế duy trì phiên. Lỗi này thường gặp khi bỏ qua tuỳ chọn --install-daemon ở bước onboarding hoặc khi chạy Gateway thủ công bằng lệnh openclaw gateway.
• Cách khắc phục:
  • Cài đặt Gateway dưới dạng dịch vụ bằng lệnh openclaw gateway install.
  • Trên Linux, bật chế độ duy trì dịch vụ sau khi đăng xuất bằng lệnh sudo loginctl enable-linger $USER.
  • Khởi động dịch vụ bằng systemctl --user enable --now openclaw-gateway.service.
  • Kiểm tra trạng thái bằng openclaw gateway status.

Sau khi thiết lập, Gateway có thể tiếp tục chạy nền và tự khởi động theo cơ chế quản lý dịch vụ của hệ điều hành.

Lỗi dashboard thông báo “Pairing Required”

Khi truy cập Control UI, người dùng có thể thấy thông báo pairing required hoặc không thể kết nối dù Gateway vẫn đang hoạt động.

• Nguyên nhân: Trình duyệt hoặc thiết bị đang truy cập chưa được Gateway phê duyệt. OpenClaw sử dụng cơ chế Device Pairing để xác minh thiết bị trước khi cấp quyền kết nối.
• Cách khắc phục:
  • Kiểm tra danh sách thiết bị đang chờ phê duyệt bằng lệnh openclaw devices list.
  • Nếu có yêu cầu mới, xem thông tin thiết bị và phê duyệt bằng lệnh openclaw devices approve <requestId>.
  • Tải lại Dashboard và kiểm tra trạng thái kết nối.

Nếu vẫn gặp lỗi, hãy kiểm tra lại địa chỉ Gateway, token xác thực và trạng thái dịch vụ bằng lệnh openclaw gateway status. Không nên tắt cơ chế xác thực chỉ để bỏ qua yêu cầu ghép nối.

>> Xem thêm:

• Hướng dẫn cách dùng OpenClaw (tiếng Việt) chuẩn xác
• Cách sử dụng OpenClaw tạo content mạng xã hội tự động
• OpenClaw bảo mật rủi ro: Những vấn đề doanh nghiệp cần lưu ý khi triển khai AI Agent

Câu hỏi thường gặp về “cách cài đặt OpenClaw”

OpenClaw dùng để làm gì?

OpenClaw là nền tảng AI Agent mã nguồn mở có khả năng tiếp nhận yêu cầu, lập kế hoạch và tự động thực hiện các tác vụ trên máy tính hoặc máy chủ. Khác với chatbot thông thường, OpenClaw có thể sử dụng công cụ, tương tác với phần mềm và xử lý nhiều bước công việc liên tiếp. Người dùng có thể điều khiển Agent thông qua Telegram, WhatsApp hoặc Discord.

OpenClaw và Claude khác nhau như thế nào?

Claude là mô hình ngôn ngữ do Anthropic phát triển, có khả năng phân tích thông tin và tạo phản hồi. Trong khi đó, OpenClaw là nền tảng điều phối AI Agent, có thể kết nối với Claude hoặc các mô hình AI khác để thực hiện tác vụ thực tế. Nói cách khác, Claude cung cấp năng lực xử lý ngôn ngữ, còn OpenClaw giúp mô hình sử dụng công cụ và triển khai hành động theo yêu cầu.

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

OpenClaw là phần mềm mã nguồn mở nên người dùng không phải trả phí bản quyền khi cài đặt. Tuy nhiên, chi phí vận hành còn phụ thuộc vào mô hình AI và môi trường triển khai. Nếu sử dụng API của OpenAI, Anthropic hoặc nhà cung cấp khác, bạn cần thanh toán theo mức sử dụng. Ngoài ra, việc cài OpenClaw trên VPS cũng phát sinh chi phí thuê máy chủ. Sử dụng model local có thể giúp giảm chi phí API nhưng đòi hỏi phần cứng phù hợp.

OpenClaw cài trên Windows hay WSL2 tốt hơn?

OpenClaw có thể cài trực tiếp trên Windows thông qua PowerShell hoặc chạy trong WSL2. Theo tài liệu chính thức, WSL2 vẫn là môi trường chạy Gateway tương thích với Linux nhất trên Windows, phù hợp khi vận hành lâu dài. Nếu thích dùng ứng dụng desktop, bạn có thể cài Windows Hub, ứng dụng native mà tài liệu hiện khuyến nghị cho Windows. Cài trực tiếp trên Windows phù hợp khi chỉ cần dùng CLI và Gateway ở mức cơ bản.

OpenClaw chạy được với model local không?

Có. OpenClaw hỗ trợ kết nối với các mô hình AI chạy cục bộ thông qua công cụ tương thích như Ollama. Cách này cho phép bạn sử dụng model trên máy tính hoặc máy chủ riêng mà không cần gửi yêu cầu đến API bên ngoài. Tuy nhiên, hiệu suất phụ thuộc vào RAM, VRAM, CPU/GPU và kích thước mô hình. Bạn cũng nên kiểm tra khả năng hỗ trợ tool calling nếu muốn Agent thực hiện các tác vụ tự động.

Kết luận

Trên đây là hướng dẫn chi tiết cách cài đặt OpenClaw trên máy tính và khắc phục một số lỗi thường gặp trong quá trình thiết lập. Thực hiện đúng các bước sẽ giúp hệ thống vận hành ổn định, đồng thời khai thác hiệu quả khả năng tự động hóa của AI Agent.

Nếu có nhu cầu triển khai OpenClaw trong môi trường chuyên nghiệp hoặc vận hành liên tục, bạn cần lựa chọn hạ tầng có hiệu năng và độ ổn định phù hợp. Long Vân cung cấp giải pháp OpenClaw AI Server với tài nguyên được tối ưu cho nhu cầu triển khai AI, hỗ trợ quá trình cài đặt và mở rộng hệ thống. Khi sử dụng dịch vụ tại Long Vân, bạn sẽ nhận được những lợi ích sau:

• Tích hợp sẵn môi trường OpenClaw, triển khai trong vài phút.
• Máy chủ hiệu năng cao, được tối ưu cho OpenClaw.
• Cung cấp tài liệu tham khảo giúp sử dụng OpenClaw AI hiệu quả.
• Tiết kiệm chi phí đầu tư và vận hành hạ tầng riêng.

Thông tin liên hệ Long Vân:

• VP HCM: Tòa nhà Long Vân, 37/2/6 Ðường 12, P. An Khánh, TP. Hồ Chí Minh
• Tel: 1800 6070
• Email: sale@longvan.net