Thư viện miễn phí
Hướng dẫn cài OpenClaw từ A-Z
Từng bước cài OpenClaw bằng OpenClaw Setup, kết nối model AI, tạo bot và nối Zalo, Facebook Messenger, Telegram, kèm video hướng dẫn. Chưa rõ OpenClaw là gì, đọc series OpenClaw từ A-Z trên blog trước.
Video hướng dẫn
Xem thao tác trên màn hình
Tự tạo trợ lý AI cá nhân với OpenClaw, không cần biết code
OpenClaw là gì, dùng vào việc gì, và hai cách cài để có trợ lý AI trên Telegram.
Video quay từ tháng 3 đến tháng 7/2026, một số đoạn dùng Docker và giao diện cũ. OpenClaw Setup nay chạy trực tiếp trên máy (Native) và đã đổi vài màn hình: khi khác video, làm theo các bước chữ bên dưới (cập nhật theo OpenClaw Setup 5.19).
YouTube @monkeytech-vn Các bước
Cài đặt theo từng chương
Chương 1
Chuẩn bị
Chuẩn bị đủ những thứ dưới đây thì phần cài đặt trôi chảy trong một buổi.
- 1
Một máy luôn bật
Windows, macOS, Linux hoặc máy chủ VPS Linux. Máy tắt thì bot nghỉ và lịch nhắc không chạy.
- 2
Git và Node.js
Cần có Git. Node.js 24 LTS là bắt buộc; bộ cài tự cài Node.js 24 nếu máy chưa có.
- 3
Tài khoản cho kênh
Tài khoản Zalo phụ cho bot (không dùng tài khoản chính), quyền quản trị Trang Facebook nếu dùng Messenger, hoặc bot Telegram tạo từ @BotFather.
- 4
Nguồn model AI
Tài khoản hoặc API key của nhà cung cấp AI để nối vào 9Router ở chương 3.
- 1
Chương 2
Cài OpenClaw Setup
OpenClaw Setup là bảng điều khiển trên trình duyệt, cài OpenClaw và 9Router giúp bạn. Bot chạy trực tiếp trên máy (Native); Docker không còn dùng cho dự án mới.
- 1
Chạy lệnh cài
Mở Terminal (macOS, Linux) hoặc PowerShell (Windows) và chạy lệnh dưới. Sau này muốn mở lại bảng điều khiển, chạy lại đúng lệnh này.
npx create-openclaw-bot - 2
Mở bảng điều khiển
Trình duyệt tự mở trang dưới. Nếu không, mở tay.
http://127.0.0.1:51789 - 3
Chọn hệ điều hành
Chọn Windows, macOS, Linux hoặc VPS. Ô Docker hiện nhưng đã khoá.
- 4
Nhập thư mục và tên dự án, bấm Cài đặt
Ví dụ thư mục: D:\bot (Windows), /Users/<tên-bạn>/bot (macOS), /home/<tên-bạn>/bot (Linux). Bộ cài cài OpenClaw và 9Router vào đó.
- 1
Chương 3
Kết nối model AI qua 9Router
9Router là bộ chuyển tiếp chạy trên máy, nối bot với các nhà cung cấp AI. Bot gọi model tên smart-route; bạn quyết định smart-route dùng những model nào.
- 1
Đăng nhập 9Router
Bấm Mở website 9Router trong OpenClaw Setup, đăng nhập bằng mật khẩu mặc định 123456. Không mở cổng 9Router ra internet.
- 2
Tạo API key của 9Router
Vào mục Endpoints, tạo một key mới, dán vào ô 9Router API key trong OpenClaw Setup (hoặc ô apiKey trong mục models của tệp openclaw.json ở thư mục dự án).
- 3
Kết nối nhà cung cấp
Vào mục Providers, chọn nhà cung cấp và kết nối bằng API key hoặc đăng nhập tài khoản. Không chọn Antigravity khi đăng nhập kiểu OAuth: có nguy cơ tài khoản Google bị khoá.
- 4
Tạo combo smart-route
Vào mục Combos, tạo combo đặt tên đúng là smart-route và thêm các model muốn dùng. Model đầu hết hạn mức thì model sau nhận việc.
smart-route
- 1
Chương 4
Tạo bot
Mỗi bot có tên, vai trò, phong cách và tài liệu riêng. Một máy chạy được nhiều bot.
- 1
Chọn kênh
Telegram, Zalo cá nhân, Zalo Bot API hoặc Facebook (Messenger, Instagram). Cách kết nối từng kênh ở chương 5.
- 2
Điền thông tin bot
Tên bot, ID bot (viết liền, không dấu), Vai trò của bot, Phong cách trả lời, Tên chủ bot và Về chủ bot.
- 3
Đính kèm tài liệu
Tối đa 10 tệp, mỗi tệp tới 4 MB, cùng các đường dẫn: bảng giá, chính sách, câu hỏi thường gặp. Tài liệu càng rõ, bot càng ít trả lời sai.
- 4
Bấm Tạo bot và nhắn thử
Khởi động lại bot nếu được nhắc, rồi nhắn một câu để kiểm tra.
- 1
Chương 5
Kết nối kênh nhắn tin
Làm phần tương ứng với kênh bạn chọn ở chương 4.
- 1
Telegram
Nhắn @BotFather trên Telegram, gõ /newbot, đặt tên, nhận token và dán vào ô Token. Có thêm ô Tên gọi trong nhóm và Reaction xác nhận cho bot trong nhóm.
/newbot - 2
Zalo cá nhân
Chọn Zalo cá nhân; OpenClaw Setup cài plugin Zalo Connect và hiện mã QR. Trên điện thoại mở Zalo bằng tài khoản phụ, vào Trang cá nhân, biểu tượng QR, Quét mã QR. Phiên đăng nhập hết hạn thì quét lại. Đây là kết nối không chính thức, có nguy cơ tài khoản bị hạn chế.
- 3
Zalo Bot API
Tạo bot trên nền tảng Zalo Bot (bot.zaloplatforms.com), lấy token và dán vào ô Token. Khác với Zalo OA.
- 4
Facebook Messenger và Instagram
Bấm Kết nối Trang Facebook, chọn Tiếp tục với Facebook, đăng nhập bằng tài khoản quản trị Trang và chọn Trang. Kết nối đi qua MonkeyTech Connect nên máy chạy bot không cần mã truy cập Trang hay địa chỉ web công khai. Instagram cần là tài khoản doanh nghiệp gắn với Trang.
- 1
Chương 6
Quản lý nhóm Zalo với Zalo Mod
Zalo Mod thêm bảng điều khiển quản lý nhóm, danh bạ khách hàng, lịch báo cáo và bảng công việc. Cần Zalo Connect đã đăng nhập.
- 1
Cài plugin
Cài Zalo Mod từ thẻ plugin trong OpenClaw Setup. Cài mới được dùng thử bản Pro 30 ngày.
- 2
Mở bảng điều khiển
Bảng điều khiển chạy ở cổng của gateway cộng 1, thường là địa chỉ dưới.
http://127.0.0.1:18790 - 3
Nhận quyền chủ bot
Lấy mã thiết bị (Device ID) trong mục Cài đặt của bảng điều khiển, rồi nhắn riêng cho bot câu dưới.
im owner <DEVICE_ID> - 4
Thêm nhóm và dùng lệnh
Lệnh bắt đầu bằng / và tiền tố theo tên bot, ví dụ bot Williams dùng /williams-menu. Chủ bot gõ lệnh dưới trong một nhóm để thêm mọi nhóm bot đang ở. Mặc định bot chỉ trả lời khi được gắn thẻ hoặc gọi tên.
/<tiền-tố>-rules groupid-add-all - 5
Đặt lịch báo cáo
Trong mục Nhật ký, Lịch báo cáo: chọn báo cáo nhóm, bản tổng hợp hoặc việc còn treo, gửi vào nhóm hoặc tin nhắn riêng của chủ.
- 1
Chương 7
Trí nhớ và lịch nhắc
Biến bot thành trợ lý biết nhớ và biết nhắc.
- 1
Cài Learning Memory
Cài plugin Learning Memory từ OpenClaw Setup để bot nhớ quy định và thông tin cả khi trả lời trong nhóm, không chỉ khi trò chuyện riêng với chủ.
- 2
Dặn bot ghi nhớ
Nhắn: "nhớ giúp: ...". Bot ghi vào tệp trí nhớ trên máy; bạn mở thư mục dự án để xem, sửa được.
- 3
Tạo lịch nhắc
Chủ bot nhắn bằng lời thường, ví dụ "mỗi thứ Hai 8 giờ nhắc nhóm kho kiểm hàng". Chỉ chủ bot được tạo và xoá lịch.
- 1
Chương 8
Cài trên máy chủ VPS
Bảng điều khiển chỉ mở bên trong máy chủ (127.0.0.1). Bạn vào từ máy tính của mình qua đường hầm SSH.
- 1
Cài như chương 2
Đăng nhập VPS và chạy npx create-openclaw-bot. Mỗi người dùng Linux chạy một dự án.
- 2
Mở đường hầm SSH
Trên máy của bạn chạy lệnh dưới, giữ cửa sổ đó mở, rồi vào http://localhost:51789. Lệnh có sẵn ở khung "Mở từ máy khác (VPS/server)" trong tab Bot.
ssh -L 51789:127.0.0.1:51789 -L 18789:127.0.0.1:18789 -L 18790:127.0.0.1:18790 -L 20128:127.0.0.1:20128 <user>@<server> - 3
Giữ bot chạy khi đóng SSH
Nếu bot dừng khi bạn thoát SSH hoặc không tự chạy lại sau khi khởi động máy chủ, chạy lệnh dưới.
sudo loginctl enable-linger <user>
- 1
Chương 9
Cập nhật và sao lưu
Cập nhật bằng nút bấm, nhưng sao lưu trước.
- 1
Sao lưu trước khi cập nhật
Chép thư mục dự án và thư mục ~/.openclaw sang nơi khác. Từ bản OpenClaw 2026.9.5, định dạng dữ liệu đã thay đổi.
- 2
Bấm Cập nhật
Nút Cập nhật ở góc trên bên phải OpenClaw Setup; OpenClaw và từng plugin có nút cập nhật riêng.
- 3
Bot cũ chạy Docker
Bấm Chuyển sang Native để chuyển bot cũ sang chạy trực tiếp trên máy, mất khoảng 5 đến 15 phút. Container cũ chỉ được dừng, không bị xoá.
- 1
Khắc phục sự cố
Lỗi thường gặp
Gateway restart failed after 13s- Thường là báo động giả từ bản 5.15.4: lần khởi động đầu đang chuyển đổi dữ liệu. Chờ một chút rồi kiểm tra bot.
Unsupported channel "zalo-connect"- Plugin chưa được cài. Cập nhật OpenClaw Setup hoặc bấm Cập nhật trên thẻ OpenClaw Zalo Connect.
authentication failed- Bot vẫn dùng key tạm lúc dựng dự án. Dán API key của 9Router (chương 3), cập nhật OpenClaw Setup lên bản mới rồi khởi động lại bot.
Bot dừng khi đóng SSH- Chạy sudo loginctl enable-linger <user> trên VPS.
Bảng điều khiển Zalo Mod trắng trang- Đường hầm SSH chưa mở cổng của Zalo Mod (cổng gateway cộng 1, thường 18790).
Config warnings … plugin not found- Cấu hình khai báo plugin chưa cài. Cài plugin đó, hoặc chạy openclaw doctor --fix để xoá khai báo cũ.
bind: Address already in use- Máy bạn đang chạy một dự án OpenClaw khác dùng cùng cổng. Tắt dự án đó trước khi mở đường hầm.
Cần triển khai OpenClaw đúng quy trình doanh nghiệp?
Tự cài theo hướng dẫn này hoàn toàn miễn phí. Nếu cần chúng tôi thiết kế bot theo quy trình chăm sóc khách hàng, nhóm nội bộ của doanh nghiệp, xem trang OpenClaw cho doanh nghiệp.