🦞 OpenClaw Setup

Một giao diện Web để tạo, triển khai & vận hành trợ lý AI đa bot miễn phí — không cần gõ terminal

Chạy một lệnh → mở dashboard → bot lên sóng. Windows · macOS · Linux · VPS — chạy trên Docker, tự cài giúp bạn.

Tiếng Việt · English

🇻🇳 Mã nguồn mở & miễn phí. Dashboard tự động hóa 100% việc tạo dự án, triển khai và quản lý bot AI trên Telegram · Zalo · Facebook Messenger (Discord & Lark sắp ra mắt) — cài trong vài phút, không cần biết code.

🆕 Có gì mới trong v5.16.0

• 🖥️ "Điều khiển máy" — cho bot mở Chrome & ứng dụng trên máy bạn: nút mới trên thẻ mỗi bot, bật lên là bot mở được Chrome hoặc app trong danh sách cho phép (TeamViewer, Zalo, …) trên máy đang chạy bot. Mặc định TẮT, cần token, chỉ giới hạn danh sách bạn khai, chỉ dùng trên máy có màn hình.
• 🌐 Duyệt web chạy ngay trên mọi hệ điều hành: máy để bàn thì bot dùng Chrome thật (profile đã đăng nhập, web ít nghi là bot), server thì tự mở Chromium headless — hết cảnh "không có trình duyệt" chỉ vì chưa mở Chrome.

• 🦞 Bot Zalo thả reaction báo đã nhận tin: một icon xuất hiện ngay trên tin bạn vừa gửi, nên bạn biết bot đã nhận trong khi nó còn đang viết trả lời. Chạy ở tầng kênh chat nên không tốn token. Bật mặc định cho bot Zalo mới; đổi icon hay tắt thì sửa messages.ackReaction trong openclaw.json. Cần Zalo Connect 3.0.15+.

• 🛠️ Bot tự tạo skill cho chính nó: nhờ bot làm một kỹ năng dùng lại ("tạo cho anh skill X") là nó viết xong và dùng được ngay trong cùng câu trả lời — không còn bước chờ duyệt, không phải sửa cấu hình. Skill lưu vào skills/<tên>/SKILL.md trong workspace của bot và tự nạp. Bot cũ tự nhận khi cập nhật.

• 🧠 Trí nhớ always-on cho mọi bot (learning-memory): plugin context-engine mới nạp MEMORY.md + USER.md đã chắt lọc vào MỌI lượt — kể cả trong nhóm (điều recall mặc định bỏ qua). Bot hết quên ngữ cảnh/quy tắc theo thời gian: không còn "nói leo" khi không ai gọi, không hỏi lại điều bạn đã dặn. Tự cài cho bot mới + có card 1-chạm trên dashboard.
• 🧹 Bỏ TencentDB Agent Memory, thay bằng engine always-on ở trên (không cần dịch vụ ngoài). Bot cũ tự migrate khi cập nhật — skill learning-memory cũ và plugin TencentDB được gỡ tự động.

• ⚙️ Trang Cài đặt mới: chọn giao diện (nút gạt Sáng/Tối), ngôn ngữ (VI/EN) và múi giờ ngay trong dashboard — có ở cả sidebar lẫn thanh điều hướng mobile.
• 🕒 Lịch & cron chạy đúng giờ địa phương: bot tạo mới nhận múi giờ rõ ràng, nên nhắc hẹn/cron không còn lệch 1 ngày quanh nửa đêm (lỗi UTC-vs-local có thể đặt lịch vào quá khứ). Đã siết hướng dẫn lập lịch toàn diện (giờ local + múi giờ, nơi gửi rõ ràng, ID nhóm dạng thô).

• 🟢 Trạng thái Zalo trực tiếp trên từng thẻ bot: mỗi bot Zalo cá nhân hiển thị riêng trạng thái kết nối và đăng nhập, kèm badge xanh gọn khi đã sẵn sàng.
• 👥 Nhận diện đa tài khoản chính xác: Setup đọc runtime Zalo Connect theo từng tài khoản thật, nên project có nhiều bot Zalo không còn bị gom thành một trạng thái “chưa rõ”.
• ✨ Khu điều khiển Zalo gọn hơn: Làm mới và Đăng nhập lại nằm cùng hàng phía trên danh sách bot; phiên bản Zalo Connect và Zalo Mod được đưa sang cột trạng thái chung.

• 💬 OpenClaw Zalo Connect, sẵn sàng trong một chạm: tạo bot Zalo cá nhân hoặc bấm Đăng nhập Zalo, Setup tự chuẩn bị channel rồi mở luồng quét QR ngay trên dashboard.
• ⚡ Cài một lần, kết nối lại nhanh hơn: nếu Zalo Connect đã có, Setup dùng lại bản hiện tại thay vì tải lại mỗi lần đăng nhập hay restart.
• ✨ Trải nghiệm Zalo native gọn hơn: mention nhóm, reaction và quản trị dùng chung một Zalo runtime được duy trì; luồng tích hợp cũ và tiện ích Sticker đã được gỡ khỏi Setup.

• 📄 Workspace mặc định dựng lại theo bộ file chuẩn OpenClaw: bot tạo mới nhận đủ 7 file workspace gốc (AGENTS/BOOTSTRAP/HEARTBEAT/IDENTITY/SOUL/TOOLS/USER.md) làm khung, quy tắc riêng của dự án gắn thành mục bổ sung đánh dấu rõ — đủ VI + EN, mọi kiểu bot.
• 🗄️ Hết lỗi SQLite "disk I/O error" trên Docker Desktop: .openclaw/state chuyển sang named volume trên macOS/Windows (khóa WAL không sống nổi qua virtiofs); Linux/VPS vẫn bind mount như cũ.

• 🚀 Facebook Messenger, cài 1 chạm: plugin fb-messenger giờ đã public trên ClawHub và cài ngay trên dashboard — tạo bot Messenger, mở Bot → Plugins, bấm Cài ở thẻ openclaw-fb-messenger. Webhook + Graph API, tự đổi User→Page token, xác minh HMAC.
• 🐳 Chỉ còn Docker, cực ổn định: loại bỏ kiểu cài native (không Docker) để tập trung cho luồng Docker chạy hoàn hảo & ổn định trên Windows / macOS / Linux / VPS, kèm tự cài Docker đa hệ điều hành.
• 🖥️ Chrome-debug trên VPS headless: relay Chrome-debug của browser-automation giờ chạy được trên VPS headless (giới hạn theo bridge-IP, tự mở ufw); trình sửa file bot cũng lưu được file text không phải .md.

• 🔧 Sửa lỗi Docker: update plugin giữ nguyên port dashboard zalo-mod, và ổ đĩa/thư mục đã cấp quyền (kể cả nguyên ổ Windows như D:\) không còn bị mất sau khi rebuild.
• 🔄 Tự khởi động lại tiến trình (native): cài native giờ đăng ký gateway + 9router thành service hệ điều hành (macOS launchd, Linux systemd, Windows detached), tự chạy lại khi crash/reboot — như restart: always của Docker. Best-effort, lỗi thì fallback chạy detached.
• 🔐 Sync 9router lần đầu — đã sửa: không còn tắt vĩnh viễn "Require login". sync.js đăng nhập bằng mật khẩu mặc định 123456, tạo combo smart-route từ provider đang active một lần rồi dừng. Require login giữ ON (đổi mật khẩu sau); model-call /v1 không bị ảnh hưởng.
• 📁 Đường dẫn workspace native — đã sửa: workspace của agent giờ là tương đối, persona/memory/skills nằm đúng chỗ khi cài native (trước là đường dẫn tuyệt đối kiểu container → trỏ sai trên host).
• 🧩 Không ghi đè khối meta trong config: generator ngừng seed meta để OpenClaw tự quản — tránh lỗi parse config do lastTouchedVersion là dải version.
• 💅 UI dashboard gọn hơn: nút tắt Bot/Cài đặt ở hero, badge version plugin, layout toggle tính năng, responsive/mobile, bỏ tiêu đề trùng ở tab dashboard.

• 🧠 TencentDB Agent Memory — cài 1 chạm: Plugin bộ nhớ mới ngay trên UI. Bộ nhớ phân tầng 4 lớp (L0–L3) + nén ngữ cảnh, giữ session dài mạch lạc và tiết kiệm tới ~61% token. Chạy local hoàn toàn (SQLite), không cần API key, sẵn sàng cho Docker.
• ⚡ Cấu hình tiết kiệm token mặc định cho mọi bot mới: Tự có context pruning (cache-TTL) + compaction safeguard — hội thoại dài rẻ hơn & sắc nét hơn, không cần chỉnh tay.
• 🎯 Skills/Plugins theo từng bot & từng kênh: Cài/bật/tắt skill chỉ cho đúng 1 bot (không lan sang bot khác); bảng chỉ hiện thứ phù hợp với kênh (Zalo / Telegram / Messenger).
• 📤 Gửi file ổn định trên Zalo & Telegram: Bot đã biết quy trình gửi đúng (media/outbound + tool message) và dùng định dạng hiện đại như .xlsx — hết cảnh "không gửi được file".
• 🐳 Nút điều khiển Docker 1 chạm: Restart / Rebuild container bot và cấp quyền ổ đĩa (mount thư mục host bất kỳ vào /mnt/<tên>, đa OS) ngay trên dashboard — khởi động lại bot mà không cần gõ lệnh.
• ⚡ Trang Dashboard & Bot load nhanh hơn: Việc dò runtime/version giờ chỉ chạy một lần rồi cache thay vì lặp lại mỗi lần tải trang — bot status giảm từ ~4s xuống ~3ms ở các lần tải sau. Cache tự xoá khi update/rebuild/restart/cài đặt.

• Sửa lỗi: Lệch phiên bản cache Launcher: Tự động phát hiện nếu launcher đang chạy (tải qua npx) có phiên bản mới hơn hoặc khác với bản đang cache trong ~/.openclaw-setup và tự nâng cấp tương ứng.

• Mới: Siêu Trí Nhớ Dài Hạn & Tự Đóng Gói Kỹ Năng (learning-memory): Tích hợp sẵn skill tự học và tự tiến hóa kỹ năng mới cho Agent.
  • Tự động ghi nhận thông tin, kiến thức và chỉ dẫn mới từ người dùng vào file MEMORY.md để ghi nhớ lâu dài.
  • Cho phép Agent tự đóng gói các quy trình làm việc hoặc logic mới học được thành mã nguồn .js và file hướng dẫn SKILL.md trực tiếp vào thư mục ./skills/, giúp bot tự phát triển kỹ năng mà không cần lập trình viên can thiệp.
  • Hỗ trợ chạy tự động script cài đặt (postinstall) mượt mà trên mọi nền tảng (Docker, Windows, macOS, Linux) ngay sau khi cài từ ClawHub.
• Mới: Quản lý Skill trên UI: Thêm nút bật/tắt và quản lý cài đặt skill "Siêu Trí Nhớ Dài Hạn" trực tiếp trên giao diện quản trị Web UI Setup.

• Hỗ trợ Skill Tạo ảnh Infographic chuyên nghiệp: Tích hợp hoàn toàn công cụ tạo ảnh infographic, poster tự động thông qua API của 9Router. Tự động sinh mã nguồn script image-generator.js đồng bộ API credentials từ openclaw.json và hướng dẫn SKILL.md cụ thể giúp Agent nắm vững cấu trúc prompt, font chữ tiếng Việt, layout và quy tắc thiết kế ảnh.
• Tối ưu hóa: Đơn giản hóa sinh file TOOLS.md: Điều chỉnh generator của TOOLS.md để sinh ra nội dung tĩnh gọn gàng, tập trung định hướng Agent đọc chi tiết các tài liệu hướng dẫn skill tương ứng.
• Tối ưu hóa: Chuẩn hóa danh sách Tài liệu tham chiếu trong AGENTS.md: Cập nhật danh sách tài liệu tham chiếu được tạo trong file AGENTS.md (cho cả 2 chế độ single/relay và cả tiếng Việt/tiếng Anh) để khớp chính xác cấu trúc mới gồm đúng 9 tài liệu cốt lõi, loại bỏ các file không còn phù hợp (TEAMS.md cho single-bot, BROWSER.md) và chuẩn hóa phần mô tả.

✨ Tính năng nổi bật

• 🤖 Đa kênh — Telegram (1 hoặc nhiều bot), Zalo Bot API, Zalo Personal (Cá nhân), và Facebook Messenger (Discord & Lark sắp ra mắt).
• 🧑‍🤝‍🧑 Đội bot (Multi-bot Team) — Chạy đồng thời nhiều bot Telegram/Zalo, tự động đồng bộ hóa tài liệu và phối hợp làm việc theo nhóm.
• 🧠 Đa nhà cung cấp AI qua 9Router — Dễ dàng định tuyến đến Google Gemini, Claude, GPT-4o, OpenRouter, Ollama (chạy local offline).
• 🧩 Kỹ năng (Skills) — Web Search, Browser Automation (Chrome CDP thực tế), Cron/Scheduler lập lịch.
• 🔌 Plugin tích hợp — Cài đặt nhanh các plugin nâng cao (openclaw-zalo-mod, Facebook Crawler...) chỉ bằng 1 nút nhấn trên UI.
• 🔀 9Router tích hợp — Cầu nối AI proxy miễn phí không cần API key thông qua đăng nhập OAuth.
• 🔒 An toàn & Riêng tư — Toàn bộ cấu hình và API key chỉ lưu trên thiết bị của bạn.

🗺️ Cách cài đặt nhanh nhất

1️⃣ Cách 1 — Cài nhanh (Khuyên dùng)

Mở terminal và chạy đúng một lệnh (chạy trên macOS, Linux & Windows — cần Node.js 24 LTS):

npx create-openclaw-bot

Lệnh này tự tải wizard, chạy server và mở giao diện Setup trên trình duyệt tại http://127.0.0.1:51789.

2️⃣ Cách 2 — Chạy mã mới nhất trực tiếp từ GitHub

Dùng cách này nếu bạn muốn lấy code mới nhất trực tiếp từ GitHub:

npx github:tuanminhhole/openclaw-setup

Cách này bắt buộc máy phải cài Git. Hãy cài Git và kiểm tra lệnh git chạy được trong terminal trước; nếu thiếu Git, npm không thể tải repository từ GitHub.

3️⃣ Cách 3 — Clone thủ công (dành cho developer)

Dành cho người muốn lấy full source. Chạy lần lượt từng dòng:

git clone https://github.com/tuanminhhole/openclaw-setup.git
cd openclaw-setup
npm install
npm start

Sau đó mở http://127.0.0.1:51789 nếu trình duyệt không tự bật.

⚠️ npm install / npm start chỉ chạy được khi bạn đang ở trong thư mục openclaw-setup đã clone. Nếu dùng một trong hai cách npx, lần sau chỉ cần chạy lại đúng lệnh npx đó để mở Setup.

🔁 Mở lại giao diện sau này

Chạy lại lệnh khuyên dùng. Setup sẽ tự nhận diện và mở project hiện có:

npx create-openclaw-bot

⬆️ Cập nhật lên phiên bản mới

Bấm nút Cập nhật ở góc trên bên phải giao diện Setup. Hệ thống tự tải phiên bản mới và khởi động lại UI; tab đang mở sẽ tự kết nối lại.

📋 Yêu cầu hệ thống

• Node.js 24 LTS (bắt buộc) — wizard Setup chạy bằng Node, nên cần cho cả chế độ Docker lẫn Native. Tải Node.js.
• Git: Đã cài đặt và có trong biến môi trường PATH.
• Docker Desktop (khuyên dùng, để chạy bot): hỗ trợ Docker Compose V2. Tải Docker.

🚀 Hướng dẫn cài đặt từng bước

Lần đầu dùng? Làm lần lượt theo thứ tự — không cần gõ terminal ngoài bước mở giao diện.

1. Mở giao diện Setup — chạy lệnh cài ở trên, dashboard sẽ mở trên trình duyệt.

2. Chọn Hệ điều hành & Chế độ chạy — cài Node.js 24 LTS trước (wizard chạy bằng Node — cần cho cả 2 chế độ). Rồi vào tab Cài đặt, chọn hệ điều hành và chế độ chạy:

• Docker (khuyên dùng) — chạy cách ly và tạo được nhiều project/bot. Cài thêm Docker Desktop.
• Native — nhẹ hơn, chạy bot thẳng trên máy (không cần Docker).

3. Nhập đường dẫn & tên project — nhập đường dẫn thư mục và tên project (ví dụ tên: bot), rồi bấm Cài đặt. Ví dụ đường dẫn:

• Windows: D:\bot
• macOS: /Users/<tên-bạn>/bot
• Linux: /home/<tên-bạn>/bot

4. Đăng nhập 9Router — bấm nút Mở website 9Router, đăng nhập bằng mật khẩu mặc định 123456.

5. Tạo API key (9Router) — vào mục Endpoints, tạo một API key mới. Sau đó mở thư mục project → file openclaw.json → kéo xuống mục models → dán key vào ô apiKey còn trống rồi lưu.

6. Kết nối Provider (9Router) — vào mục Providers, chọn provider bạn muốn; hệ thống tự kết nối.

7. Tạo Combo định tuyến (9Router) — vào mục Combos, tạo combo đặt tên đúng là smart-route và thêm các models cần dùng.

8. Tạo bot — quay lại giao diện Setup, chọn kênh, nhập thông tin bot + thông tin cá nhân, rồi bấm Tạo bot.

9. Restart & test — khởi động lại container bot, rồi nhắn tin cho bot để kiểm tra. 🎉

🧠 Các Provider AI được hỗ trợ (Thông qua 9Router)

• 9Router GitHub

🔌 Kênh trò chuyện hỗ trợ

• Telegram: Lấy token bot chính thức từ @BotFather.
• Zalo Bot API: Lấy thông tin kết nối chính thức từ developers.zalo.me.
• Zalo Cá nhân (Zalo Personal): Kích hoạt cực nhanh bằng cách quét mã QR hiển thị ngay trên Dashboard OpenClaw.
• Facebook Messenger: Qua plugin fb-messenger (public trên ClawHub, cài ngay trên giao diện Setup) — chỉ cần dùng Page token.
• Discord: Sắp ra mắt.
• Lark: Sắp ra mắt.

📁 Cấu trúc thư mục dự án

openclaw-setup/
|-- README.md                ← Tài liệu tiếng Anh
|-- README.vi.md             ← Hướng dẫn tiếng Việt (Bạn đang đọc)
|-- package.json             ← Điểm cấu hình NPM và scripts khởi chạy
|-- dist/                    ← Mã nguồn đã biên dịch của Web UI và CLI
`-- src/                     ← Mã nguồn gốc (giao diện, máy chủ cục bộ API, script build)

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

🔗 Liên kết hữu ích

• OpenClaw Docs
• 9Router GitHub
• Google AI Studio
• Telegram BotFather
• Zalo Developer Platform
• Docker Desktop
• ClawHub (Skills)

⭐ Sao của repository

🙏 Lời cảm ơn

• OpenClaw — AI Gateway framework
• 9Router — Open-source AI proxy (OAuth-based, no API keys)
• ClawHub — Kho đăng ký các kỹ năng của bot
• TheSVG — Kho biểu tượng nhãn hiệu SVG chất lượng cao

🙌 Tác giả & Đóng góp

Làm bởi tuanminhhole (Kent) như một món quà mở cho cộng đồng. Mọi góp ý / PR cải tiến đều được hoan nghênh. Nếu thấy hữu ích, hãy ⭐ repo để nhiều người biết tới nhé!

🦞 Hệ sinh thái OpenClaw (cùng tác giả)

Các repo đi kèm để bạn dựng một trợ lý AI "tự vận hành" hoàn chỉnh:

🚀 Cài đặt & khung nền

• openclaw-setup — (repo này) Setup bot AI miễn phí bằng OpenClaw + 9Router (Telegram/Zalo/Messenger, Docker)
• vietbrain — Bộ khung "Bộ Não Thứ Hai" tiếng Việt cho Obsidian (sẵn sàng AI)

🔌 Plugin (runtime)

• openclaw-fb-messenger — Kênh Facebook Messenger (webhook + Graph API), cài ngay trên giao diện Setup
• openclaw-telegram-multibot-relay — Multibot Telegram relay, delegation & cron nhắc lịch native
• openclaw-zalo-connect — Channel/runtime Zalo cá nhân với đăng nhập QR, mention native và thao tác nhóm
• openclaw-zalo-mod — Quản lý nhóm Zalo zero-token (slash command, anti-spam, warn, memory)
• openclaw-browser-automation — Smart Search & Browser Automation
• openclaw-facebook-crawler — Crawl dữ liệu Facebook
• openclaw-n8n-facebook-poster — Tự động đăng Facebook qua n8n

🧩 Skill

• openclaw-learning-memory — Context engine trí nhớ always-on (nạp MEMORY.md + USER.md vào mọi lượt, kể cả nhóm)
• openclaw-skill-infographic — Tạo infographic