create-openclaw-bot 4.0.1

package/CHANGELOG.md

@@ -0,0 +1,121 @@
+# Changelog (English)
+
+All notable changes to this project will be documented in this file.
+
+## [4.0.1] — 2026-03-31
+
+### ✨ Automation (Auto-create install dir) & NPM CLI
+- **One-Command Install (npx)**: The `create-openclaw-bot` CLI package is now published to NPM. Windows, Linux, and Mac users can simply run `npx create-openclaw-bot` to setup everything via an interactive terminal flow.
+- **Auto Setup & Docker Start**: The deployment script (`.bat` / CLI) is completely overhauled. Once configured, Docker compose automatically builds and spins up the Bot instance seamlessly.
+- **Improved UI Setup**: Cleaned up the Step 4 file previews. Revamped the Zalo Bot API channel UI card to use the official vector SVG (popping blue colors over the frosted glass background).
+- **Safety First**: Removed Antigravity (AG) models from the 9router Proxy Models option to prevent permanent Google AI Ultra abuse bans. Added bright red warnings on the Setup GUI. Updated crediting for thesvg.org.
+
+## [4.0.0] — 2026-03-30
+
+### ✨ New Features & Updates
+- **Full English Localization** — Completed all English translations for the Setup Wizard (Buttons, Labels, Step 4 Output).
+- **Language Toggle Relocation** — Moved the language toggle (VI/EN) to a more visible and accessible location.
+- **Setup UI/UX Fixes** — Improved the Setup Wizard UI for Browser Automation and resolved display issues (such as the undefined model badge).
+- **Reference Error Fixes** — Fixed several Reference Errors during the setup execution.
+
+## [3.0.2] — 2026-03-29
+
+### ✨ 9Router Smart Proxy Expansion
+- **9Router db.json Stability** — Updated the `db.json` injection logic for 9Router via entrypoint to prevent "No such file or directory, lstat db.json" errors.
+- **Flagship Fallback Proxy** — Configured "Smart Proxy" with a rotating list of the most powerful flagship LLMs from Codex, Antigravity, Claude Code, and Github Copilot.
+- **Setup Wizard Customization** — The wizard now displays a complete list of providers/models, setting the Smart Proxy as the preferred default to automatically resolve "404 No Active Credentials" errors.
+
+## [3.0.1] — 2026-03-29
+
+### ✨ New Features
+- **Wizard UI Redesign (Step 2)** — Brought AI Provider/Model selection to the top, followed by Identity, Personality, Security Rules, and Extensions.
+- **User Info Textarea** — Users can input information about themselves → injected into `USER.md` for bot personalization.
+- **Editable Security Rules** — Displays default security rules, users can edit them → injected into `AGENTS.md`.
+- **Section Dividers** — Added icon dividers between config groups (🤖 🔐 🧩).
+
+### 🐛 Bug Fixes
+- **Skills Auto-enable** — Selecting a skill now automatically registers it in `openclaw.json` → `skills.entries` (enabled: true). Previously, it only set up the Dockerfile without registering, making the bot ignore the skill.
+- **Skills Env Injection** — Skills requiring API keys (Tavily, SMTP…) now automatically inject env vars into `skills.entries`.
+
+### 🎨 UI/UX
+- Identity grid changed to 3 columns (Name, Role, Emoji) — removed Vibe (merged into System Prompt).
+- Emoji input fix: assigned `form-input--emoji` class, matching the height of other inputs.
+- System Prompt label changed to "Personality, Vibe & Response Rules".
+- Responsive mobile: Name is full width, Role + Emoji are side-by-side.
+- Security textarea is readonly by default, equipped with a "✏️ Edit" / "🔒 Lock" toggle button.
+
+### 🔧 Technical
+- `state.config.userInfo` — new field, saved from the `cfg-user-info` textarea.
+- `state.config.securityRules` — editable, defaults per language (vi/en).
+- `DEFAULT_SECURITY_RULES` constant established with vi/en templates.
+- `clawConfig.skills.entries` generated dynamically from selected skills.
+- Language toggle now updates both the system prompt and security rules dynamically.
+
+---
+
+## [3.0.0] — 2026-03-28
+
+### ✨ New Features
+- **9Router Integration** — AI proxy, no API key required, multi-container Docker (`docker-compose.yml` 2 services).
+- **Skills System (ClawHub)** — 8 agent capabilities: Web Search, Browser Automation, Memory, RAG, Image Gen, Bot Scheduler, Code Interpreter, Email Assistant.
+- **Plugins System (npm)** — 4 runtime extensions: Voice Call, Matrix, MS Teams, Nostr.
+- **Browser Automation** — Full Chrome Debug Mode support (socat proxy, agent-browser, Playwright engine).
+- **Task Scheduler** — Windows Scheduled Task auto-starts Chrome Debug mode on logon (10s delay).
+- **Skill-aware .env** — `.env` template automatically includes env vars for skills requiring API keys (Tavily, SMTP, Flux...).
+- **Post-setup Management** — Added guide for adding/removing skills/plugins post-setup via `docker exec`.
+
+### 🎨 UI/UX
+- Separated Skills (4-column grid) from Plugins — clearer interface layout.
+- Skill cards now show notes (⚙️) for skills that require extra setup.
+- Added Browser Automation notice card in Step 4 featuring `.bat` + `.ps1` scripts.
+- Management guide card (🔧) featuring `docker exec` commands.
+
+### 📚 Documentation
+- `docs/browser-automation-guide.md` — Included Browser Automation usage guide for users.
+- `docs/skills-plugins-guide.md` — Synthesized all skills/plugins + setup steps + list of required env vars.
+- README.md / README.vi.md — Updated with 9Router, Skills/Plugins, and new FAQs.
+
+### 🔧 Technical
+- `state.config.skills[]` + `state.config.plugins[]` are managed independently.
+- `openclaw.json` dynamically injects `browser` config when Browser skill is selected.
+- Dockerfile conditional logic: socat, agent-browser included only when necessary.
+- docker-compose: added `extra_hosts` block for both 9Router and non-9Router setups.
+
+---
+
+## [2.0.0] — 2026-03-27
+
+### ✨ New Features
+- **Setup Wizard UI** — Interactive web wizard (`index.html`) to configure OpenClaw bots visually.
+- **Multi-Channel Support** — Added support for Telegram, Zalo Bot API, and Zalo Personal channels.
+- **Multi-Provider AI** — Support for Google Gemini, Anthropic Claude, OpenAI/Codex, OpenRouter, and Ollama (local).
+- **Plugin System** — Modular plugin grid supporting Browser Automation, Scheduler, Memory, Web Search, RAG, and Image Gen.
+- **Config Generation** — Automatically generates `openclaw.json`, `agent.yaml`, `Dockerfile`, and `docker-compose.yml`.
+- **Language Toggle** — VI/EN toggle switch utilizing SVG flag icons.
+- **Brand Logos** — Implemented high-quality SVG logos from [thesvg.org](https://thesvg.org) for all providers and channels.
+
+### 🎨 Design
+- Dark-themed glassmorphism UI overlaid with animated multi-layer gradients.
+- Provider cards designed with unique colored icon backgrounds (Gemini purple, Claude orange, OpenAI green, OpenRouter violet, Ollama cyan).
+- Auto-expanding System Prompt textarea without internal scroll.
+- Developed a shimmer animation on the title and glow effects on selected cards.
+
+### 📚 Documentation
+- `README.md` / `README.vi.md` — Authored full bilingual docs, including a multi-provider comparison table.
+- `SETUP.md` / `SETUP.vi.md` — Provided a technical setup guide specifically intended for AI agents.
+- Security directive notice: Clarified that System Prompt determines personality only, while the framework enforces security rules.
+
+### 🔒 Security
+- Enforced a No-credentials-in-UI policy — instructing users to create `.env` files locally.
+- Dynamic credential instructions presented conditionally per provider and channel.
+- OpenClaw framework automatically enforces default system security rules.
+
+---
+
+## [1.0.0] — 2026-03-26
+
+### Initial Release
+- Published basic OpenClaw setup guide.
+- Configured Telegram-only support.
+- Configured Google Gemini single provider support.
+- Included manual configuration file setup instructions.

package/CHANGELOG.vi.md

@@ -0,0 +1,116 @@
+# Changelog (Tiếng Việt)
+
+Tất cả những thay đổi nổi bật của dự án sẽ được ghi chép trong file này.
+
+## [4.0.1] — 2026-03-31
+
+### ✨ Tự Động Hoá (Tự tạo thư mục cài đặt gốc) & NPM CLI
+- **One-Command Install (npx)**: Gói CLI `create-openclaw-bot` được tải lên NPM. Người dùng Windows, Linux, Mac chỉ cần mở Terminal gõ lệnh `npx create-openclaw-bot` để setup tự động từ A-Z qua giao diện tương tác.
+- **Tự động Setup & Khởi động Docker**: Quy trình tạo `.bat`/CLI được viết lại, thiết lập xong sẽ mở Docker compose tự động tải và kích hoạt Bot ngay.
+- **Improved UI Setup**: Gọn gàng hoá file preview, đổi layout UI cho Zalo Bot API để dùng official vector SVG, nổi màu xanh chủ đạo Zalo thay vì logo trong suốt.
+- **Safety First**: Lược bỏ tuỳ chọn mô hình Antigravity (AG) khỏi 9router Proxy Models và thêm cảnh báo đỏ trên UI để tránh rủi ro người dùng bị khoá account Google AI Ultra do lạm dụng quá mức. Cập nhật icon credit cho thesvg.org.
+
+## [4.0.0] — 2026-03-30
+
+### ✨ New Features & Updates
+- **Full English Localization** — Đã hoàn thiện toàn bộ bản dịch tiếng Anh cho Setup Wizard (Button, Label, Step 4 Output).
+- **Language Toggle Relocation** — Di chuyển công tắc ngôn ngữ (VI/EN) sang vị trí dễ nhìn và thao tác hơn.
+- **Setup UI/UX fixes** — Cải thiện giao diện Setup Wizard cho Browser Automation và sửa các lỗi hiển thị (như undefined model badge).
+- **Reference Error Fixes** — Khắc phục một số lỗi Reference Error trong quá trình chạy setup.
+
+## [3.0.2] — 2026-03-29
+
+### ✨ 9Router Smart Proxy Expansion
+- **9Router db.json Stability** — Cập nhật logic inject db.json của 9router qua entrypoint để tránh lỗi báo mất file "No such file or directory, lstat db.json".
+- **Flagship Fallback Proxy** — Cấu hình "Smart Proxy" để có danh sách luân chuyển các LLMs Flagship mạnh mẽ nhất hiện tại của Codex, Antigravity, Claude Code, và Github Copilot.
+- **Tùy chỉnh Setup Wizard** — Khi cài đặt hiện tại sẽ thấy danh sách provider/model hoàn chỉnh, và Smart Proxy được đặt làm chuẩn ưu tiên để tự fix lỗi "404 No Active Credentials".
+
+## [3.0.1] — 2026-03-29
+
+### ✨ New Features
+- **Wizard UI Redesign (Step 2)** — AI Provider/Model lên đầu, sau đó Identity, Personality, Security Rules, Extensions
+- **User Info textarea** — User tự nhập thông tin về mình → sinh vào `USER.md` để bot cá nhân hóa
+- **Editable Security Rules** — Hiển thị quy tắc bảo mật mặc định, user có thể sửa → inject vào `AGENTS.md`
+- **Section dividers** — Icon dividers giữa các nhóm config (🤖 🔐 🧩)
+
+### 🐛 Bug Fixes
+- **Skills auto-enable** — Khi chọn skill, giờ tự động khai báo trong `openclaw.json` → `skills.entries` (enabled: true). Trước đây chỉ cài Dockerfile nhưng không register → bot không nhận skill
+- **Skills env injection** — Skills cần API key (Tavily, SMTP…) tự động inject env vars vào `skills.entries`
+
+### 🎨 UI/UX
+- Identity grid 3 cột (Tên, Vai trò, Emoji) — bỏ Vibe (gộp vào System Prompt)
+- Emoji input fix: `form-input--emoji` class, cùng height với input khác
+- Label System Prompt → "Tính cách, Vibe & Quy tắc trả lời"
+- Responsive mobile: Name full width, Role + Emoji side-by-side
+- Security textarea readonly mặc định, nút "✏️ Sửa" / "🔒 Khóa" toggle
+
+### 🔧 Technical
+- `state.config.userInfo` — new field, saved from `cfg-user-info` textarea
+- `state.config.securityRules` — editable, defaults per language (vi/en)
+- `DEFAULT_SECURITY_RULES` constant with vi/en templates
+- `clawConfig.skills.entries` generated from selected skills
+- Language toggle updates both prompt and security rules
+
+---
+
+## [3.0.0] — 2026-03-28
+
+### ✨ New Features
+- **9Router Integration** — AI proxy, không cần API key, multi-container Docker (`docker-compose.yml` 2 service)
+- **Skills System (ClawHub)** — 8 agent capabilities: Web Search, Browser Automation, Memory, RAG, Image Gen, Bot Scheduler, Code Interpreter, Email Assistant
+- **Plugins System (npm)** — 4 runtime extensions: Voice Call, Matrix, MS Teams, Nostr
+- **Browser Automation** — Full Chrome Debug Mode support (socat proxy, agent-browser, Playwright engine)
+- **Task Scheduler** — Windows Scheduled Task auto-starts Chrome Debug khi logon (delay 10s)
+- **Skill-aware .env** — `.env` template tự động thêm env vars cho skills cần API key (Tavily, SMTP, Flux...)
+- **Post-setup Management** — Hướng dẫn thêm/bỏ skills/plugins sau khi setup qua `docker exec`
+
+### 🎨 UI/UX
+- Tách Skills (4-column grid) và Plugins (riêng biệt) — rõ ràng hơn
+- Skill cards hiện notes (⚙️) cho skills cần setup thêm
+- Browser Automation notice card ở Step 4 với `.bat` + `.ps1` scripts
+- Management guide card (🔧) với `docker exec` commands
+
+### 📚 Documentation
+- `docs/browser-automation-guide.md` — Hướng dẫn sử dụng Browser Automation cho user
+- `docs/skills-plugins-guide.md` — Tổng hợp toàn bộ skills/plugins + setup + env vars
+- README.md / README.vi.md — Thêm 9Router, Skills/Plugins, FAQs mới
+
+### 🔧 Technical
+- `state.config.skills[]` + `state.config.plugins[]` quản lý độc lập
+- `openclaw.json` inject `browser` config khi Browser skill selected
+- Dockerfile conditional: socat, agent-browser chỉ khi cần
+- docker-compose: `extra_hosts` cho cả 9Router lẫn non-9Router
+
+---
+
+## [2.0.0] — 2026-03-27
+
+### ✨ New Features
+- **Setup Wizard UI** — Interactive web wizard (`index.html`) to configure OpenClaw bots visually
+- **Multi-Channel Support** — Telegram, Zalo Bot API, Zalo Personal channel selection
+- **Multi-Provider AI** — Google Gemini, Anthropic Claude, OpenAI/Codex, OpenRouter, Ollama (local)
+- **Plugin System** — Modular plugin grid: Browser Automation, Scheduler, Memory, Web Search, RAG, Image Gen
+- **Config Generation** — Auto-generates `openclaw.json`, `agent.yaml`, `Dockerfile`, `docker-compose.yml`
+- **Language Toggle** — VI/EN toggle switch with SVG flag icons
+- **Brand Logos** — Real SVG logos from [thesvg.org](https://thesvg.org) for all providers and channels
+
+### 🎨 Design
+- Dark-themed glassmorphism UI with animated multi-layer gradients
+- Provider cards with unique colored icon backgrounds (Gemini purple, Claude orange, OpenAI green, OpenRouter violet, Ollama cyan)
+- Auto-expanding System Prompt textarea (no internal scroll)
+- Shimmer animation on title, glow effects on selected cards
+
+### 📚 Documentation
+- `README.md` / `README.vi.md` — Full bilingual docs with multi-provider table
+- `SETUP.md` / `SETUP.vi.md` — Technical setup guide for AI agents
+- Security notice: System Prompt = personality only, framework enforces security rules
+
+---
+
+## [1.0.0] — 2026-03-26
+
+### Initial Release
+- Basic OpenClaw setup guide
+- Telegram-only configuration
+- Google Gemini single provider support
+- Manual config file instructions

package/README.md

@@ -0,0 +1,211 @@
+<div align="center">
+
+# 🦞 OpenClaw Setup
+
+**Create your own free AI Bot on Telegram or Zalo in minutes.**
+
+[![Version](https://img.shields.io/badge/Version-4.0.0-FF6B35?style=for-the-badge)](CHANGELOG.md)
+[![OpenClaw](https://img.shields.io/badge/OpenClaw-Gateway-FF6B35?style=for-the-badge&logo=npm)](https://openclaw.ai)
+[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge&logo=docker&logoColor=white)](https://www.docker.com/)
+[![Telegram](https://img.shields.io/badge/Telegram-Bot-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/BotFather)
+[![Zalo](https://img.shields.io/badge/Zalo-Bot-0068FF?style=for-the-badge)](#supported-channels)
+
+<img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18"> **English** · <img src="https://flagcdn.com/24x18/vn.png" alt="Tiếng Việt" width="24" height="18"> [Tiếng Việt](README.vi.md)
+
+</div>
+
+---
+
+## ✨ Features
+
+- 🤖 **Multi-channel** — Telegram, Zalo Bot API, or Zalo Personal
+- 🧠 **Multi-provider AI** — Google Gemini, Claude, GPT-4o/Codex, OpenRouter, Ollama, 9Router
+- 🧩 **Skills** — Web Search, Browser Automation, Memory, RAG, Code Interpreter, Image Gen...
+- 🔌 **Plugins** — Voice Call, Matrix, MS Teams, Nostr
+- 🔀 **9Router Proxy** — No API key needed! OAuth login via dashboard
+- 🧙 **Setup Wizard** — Beautiful dark-themed web UI with SVG brand logos
+- 🆓 **100% Free** — Google Gemini API free tier + Docker
+- 🔒 **Secure** — API keys stay on your machine, never exposed
+- ⚡ **3 minutes** — From zero to working AI bot
+
+---
+
+## 📋 Prerequisites
+
+You need **3 things** (all free):
+
+| # | What | How to get |
+|---|------|------------|
+| 1 | **Docker Desktop** | Download → [docker.com](https://www.docker.com/products/docker-desktop/) |
+| 2 | **AI API Key** | See [Supported Providers](#-supported-providers) — Gemini is free! |
+| 3 | **Bot Token** | See [Supported Channels](#-supported-channels) below |
+
+---
+
+## 🧠 Supported Providers
+
+| Provider | Models | Price | Get API Key |
+|----------|--------|-------|-------------|
+| **Google Gemini** | Gemini 2.5 Flash/Pro, 3.0 Flash | 🆓 Free | [aistudio.google.com/apikey](https://aistudio.google.com/apikey) |
+| **Anthropic Claude** | Claude Sonnet 4, Opus 4, Haiku 3.5 | 💰 Paid | [console.anthropic.com](https://console.anthropic.com/settings/keys) |
+| **OpenAI / Codex** | GPT-4o, o3, Codex Mini | 💰 Paid | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) |
+| **OpenRouter** | Many free & paid models | 🆓/💰 | [openrouter.ai/keys](https://openrouter.ai/keys) |
+| **Ollama** | Qwen 3, DeepSeek, Llama, Gemma... | 🏠 Local | Install [ollama.com](https://ollama.com) |
+| **9Router** | Auto-route to best provider | 🔀 Proxy | No API key — [github.com/decolua/9router](https://github.com/decolua/9router) |
+
+> 🔀 **9Router** runs alongside OpenClaw in Docker. After `docker compose up`, open `localhost:20128/dashboard` to login via OAuth. No API keys needed!
+
+---
+
+## 🔌 Supported Channels
+
+| Channel | Type | How to get token |
+|---------|------|-----------------|
+| **Telegram** | ✅ Official Bot API | Open Telegram → Search **@BotFather** → `/newbot` → Copy token |
+| **Zalo Bot API** | ✅ Official Bot API | Go to [developers.zalo.me](https://developers.zalo.me) → Create bot → Copy token |
+| **Zalo Personal** | ⚠️ Unofficial | Login via QR code after setup (no token needed) |
+
+> ⚠️ **Zalo Personal** uses an unofficial API. Your account may be restricted. Use a secondary account.
+
+---
+
+## 🚀 Quick Start
+
+### Option A — Setup Wizard (Recommended)
+
+1. **Clone this repo:**
+   ```bash
+   git clone https://github.com/tuanminhhole/openclaw-setup.git
+   cd openclaw-setup
+   ```
+
+2. **Open `index.html`** in your browser — the Setup Wizard will guide you through:
+   - Choose your channel (Telegram / Zalo)
+   - Configure bot name, personality, AI model
+   - Get credential instructions
+   - Generate all config files
+
+3. **Create your `.env` file** (as instructed by the wizard)
+
+4. **Build & Run:**
+   ```bash
+   cd docker/openclaw
+   docker compose build
+   docker compose up -d
+   ```
+
+5. **Test your bot** — send a message on Telegram or Zalo! 🎉
+
+### Option B — AI Agent (Antigravity)
+
+1. Open [Antigravity IDE](https://antigravity.dev/)
+2. Open this repo as workspace
+3. Create `docker/openclaw/.env` with your keys
+4. Paste into chat:
+   ```
+   Read SETUP.md in this repo and set up OpenClaw for me.
+   I already created the .env file with my API key and Bot token.
+   My project folder: <YOUR_PATH>
+   ```
+
+---
+
+## 📁 Repo Structure
+
+```
+index.html       ← Setup Wizard UI
+style.css        ← Wizard styles
+setup.js         ← Wizard logic
+CHANGELOG.md     ← Version history
+README.md        ← You're here (English)
+README.vi.md     ← Hướng dẫn tiếng Việt
+SETUP.md         ← Technical guide for AI (English)
+SETUP.vi.md      ← Hướng dẫn kỹ thuật cho AI (Tiếng Việt)
+```
+
+---
+
+## ❓ FAQ
+
+<details>
+<summary><b>Is it really free?</b></summary>
+Yes. Docker, Google Gemini API (free tier), and Telegram/Zalo bots are all free.
+</details>
+
+<details>
+<summary><b>Where does the bot run?</b></summary>
+On your computer inside a Docker container. When your PC is off, the bot is off.
+</details>
+
+<details>
+<summary><b>How do I stop/restart?</b></summary>
+
+```bash
+docker compose down      # Stop
+docker compose up -d     # Start
+```
+</details>
+
+<details>
+<summary><b>Can I customize the bot?</b></summary>
+Yes! Use the Setup Wizard to configure name, personality, and language. Or edit the YAML files directly.
+</details>
+
+<details>
+<summary><b>Is it safe?</b></summary>
+Your API keys stay on your machine only. SETUP.md includes strict security rules that the AI must follow.
+</details>
+
+<details>
+<summary><b>Can I switch channels later?</b></summary>
+Yes! Re-run the Setup Wizard or manually edit <code>.openclaw/openclaw.json</code> to change the channel config.
+</details>
+
+<details>
+<summary><b>What is 9Router?</b></summary>
+9Router is a community open-source AI proxy that runs in Docker alongside your bot. Instead of API keys, you login via OAuth on the 9Router dashboard (<code>localhost:20128</code>). It auto-routes requests to the best available AI provider.
+</details>
+
+<details>
+<summary><b>What's the difference between Skills and Plugins?</b></summary>
+<strong>Skills</strong> add agent capabilities (Web Search, Browser, Memory, etc.) — installed via <code>openclaw skills install</code> from ClawHub.<br>
+<strong>Plugins</strong> add channels or runtime extensions (Voice Call, Matrix, etc.) — installed via <code>openclaw plugins install</code> from npm.
+</details>
+
+---
+
+## 🔗 Links
+
+- [OpenClaw Docs](https://openclaw.ai/docs)
+- [Google AI Studio](https://aistudio.google.com/)
+- [Telegram BotFather](https://t.me/BotFather)
+- [Zalo Bot Platform](https://developers.zalo.me)
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
+
+---
+
+## 📈 Star History
+
+<div align="center">
+
+[![Star History Chart](https://api.star-history.com/svg?repos=tuanminhhole/openclaw-setup&type=Date)](https://star-history.com/#tuanminhhole/openclaw-setup&Date)
+
+</div>
+
+---
+
+## 🙏 Acknowledgments
+
+- [OpenClaw](https://openclaw.ai) — AI Gateway framework
+- [9Router](https://github.com/decolua/9router) — Open-source AI proxy (OAuth-based, no API keys)
+- [Playwright](https://playwright.dev) — Browser automation engine
+- [ClawHub](https://clawhub.com) — Skills registry
+- [TheSVG](https://thesvg.org) — High-quality SVG brand icons
+
+---
+
+<div align="center">
+
+Made with 🦞 by [Kent](https://github.com/tuanminhhole)
+
+</div>

package/README.vi.md

@@ -0,0 +1,215 @@
+<div align="center">
+
+# 🦞 OpenClaw Setup
+
+**Tạo AI Bot miễn phí trên Telegram hoặc Zalo chỉ trong vài phút.**
+
+[![Version](https://img.shields.io/badge/Phi%C3%AAn%20b%E1%BA%A3n-4.0.0-FF6B35?style=for-the-badge)](CHANGELOG.vi.md)
+[![OpenClaw](https://img.shields.io/badge/OpenClaw-Gateway-FF6B35?style=for-the-badge&logo=npm)](https://openclaw.ai)
+[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge&logo=docker&logoColor=white)](https://www.docker.com/)
+[![Telegram](https://img.shields.io/badge/Telegram-Bot-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/BotFather)
+[![Zalo](https://img.shields.io/badge/Zalo-Bot-0068FF?style=for-the-badge)](#kênh-hỗ-trợ)
+
+<img src="https://flagcdn.com/24x18/vn.png" alt="Tiếng Việt" width="24" height="18"> **Tiếng Việt** · <img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18"> [English](README.md)
+
+</div>
+
+---
+
+## ✨ Tính năng
+
+- 🤖 **Đa kênh** — Telegram, Zalo Bot API, hoặc Zalo Cá nhân
+- 🧠 **Đa model AI** — Google Gemini, Claude, GPT-4o, Ollama, OpenRouter, 9Router
+- 🧩 **Skills** — Web Search, Browser Automation, Memory, RAG, Code Interpreter, Image Gen...
+- 🔌 **Plugins** — Voice Call, Matrix, MS Teams, Nostr
+- 🔀 **9Router Proxy** — Không cần API key! Đăng nhập OAuth qua dashboard
+- 🧙 **Setup Wizard** — Giao diện web đẹp, cấu hình mọi thứ trong 4 bước
+- 🆓 **100% Miễn phí** — Google Gemini API free tier + Docker
+- 🔒 **An toàn** — API key lưu trên máy bạn, không bao giờ bị lộ
+
+---
+
+## 📋 Chuẩn bị
+
+Bạn cần **3 thứ** (miễn phí hết):
+
+| # | Cần gì | Cách lấy |
+|---|--------|----------|
+| 1 | **Docker Desktop** | Tải tại [docker.com](https://www.docker.com/products/docker-desktop/) |
+| 2 | **API Key AI** | Tùy model — xem [Nhà cung cấp AI](#-nhà-cung-cấp-ai) bên dưới |
+| 3 | **Bot Token** | Xem [Kênh hỗ trợ](#-kênh-hỗ-trợ) bên dưới |
+
+---
+
+## 🧠 Nhà cung cấp AI
+
+| Nhà cung cấp | Models | Giá | Cách lấy API Key |
+|--------------|--------|-----|-------------------|
+| **Google Gemini** | Gemini 2.5 Flash/Pro, 3.0 Flash | 🆓 Miễn phí | [aistudio.google.com/apikey](https://aistudio.google.com/apikey) |
+| **Anthropic Claude** | Claude Sonnet 4, Opus 4, Haiku 3.5 | 💰 Trả phí | [console.anthropic.com](https://console.anthropic.com/settings/keys) |
+| **OpenAI / Codex** | GPT-4o, o3, Codex Mini | 💰 Trả phí (cần Plus/Pro) | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) |
+| **OpenRouter** | Rất nhiều model miễn phí & trả phí | 🆓/💰 | [openrouter.ai/keys](https://openrouter.ai/keys) |
+| **Ollama** | Qwen 3, DeepSeek, Llama, Gemma... | 🏠 Local (miễn phí) | Cài [ollama.com](https://ollama.com) |
+| **9Router** | Tự động route tới provider tốt nhất | 🔀 Proxy | Không cần API key — [github.com/decolua/9router](https://github.com/decolua/9router) |
+
+> 🔀 **9Router** chạy cùng OpenClaw trong Docker. Sau khi `docker compose up`, mở `localhost:20128/dashboard` để đăng nhập OAuth. Không cần API key!
+
+---
+
+## 🔌 Kênh hỗ trợ
+
+| Kênh | Loại | Cách lấy token |
+|------|------|----------------|
+| **Telegram** | ✅ Bot API chính thức | Mở Telegram → Tìm **@BotFather** → `/newbot` → Copy token |
+| **Zalo Bot API** | ✅ Bot API chính thức | Vào [developers.zalo.me](https://developers.zalo.me) → Tạo bot → Copy token |
+| **Zalo Cá nhân** | ⚠️ Unofficial | Login bằng QR code sau khi setup (không cần token) |
+
+> ⚠️ **Zalo Cá nhân** dùng unofficial API. Tài khoản Zalo có thể bị hạn chế. Chỉ nên dùng tài khoản phụ.
+
+---
+
+## 🚀 Bắt đầu nhanh
+
+### Cách A — Setup Wizard (Khuyến nghị)
+
+1. **Clone repo:**
+   ```bash
+   git clone https://github.com/tuanminhhole/openclaw-setup.git
+   cd openclaw-setup
+   ```
+
+2. **Mở `index.html`** trên trình duyệt — Setup Wizard sẽ hướng dẫn bạn:
+   - Chọn kênh (Telegram / Zalo)
+   - Chọn AI model và plugins
+   - Cấu hình tên bot, tính cách
+   - Lấy hướng dẫn tạo API key
+   - Tự động generate tất cả config files
+
+3. **Tạo file `.env`** (làm theo hướng dẫn trong wizard)
+
+4. **Build & Chạy:**
+   ```bash
+   cd docker/openclaw
+   docker compose build
+   docker compose up -d
+   ```
+
+5. **Test bot** — gửi tin nhắn trên Telegram hoặc Zalo! 🎉
+
+### Cách B — Dùng AI Agent (Antigravity)
+
+1. Mở [Antigravity IDE](https://antigravity.dev/)
+2. Mở repo này làm workspace
+3. Tạo `docker/openclaw/.env` với API key của bạn
+4. Paste vào chat:
+   ```
+   Read SETUP.md in this repo and set up OpenClaw for me.
+   I already created the .env file with my API key and Bot token.
+   My project folder: <THƯ_MỤC_CỦA_BẠN>
+   ```
+
+---
+
+## 📁 Cấu trúc repo
+
+```
+index.html       ← Setup Wizard UI
+style.css        ← Giao diện wizard
+setup.js         ← Logic wizard
+CHANGELOG.md     ← Lịch sử phiên bản
+README.md        ← Hướng dẫn (English)
+README.vi.md     ← Hướng dẫn (Tiếng Việt) — Bạn đang đọc file này
+SETUP.md         ← Hướng dẫn kỹ thuật cho AI Agent
+SETUP.vi.md      ← Hướng dẫn kỹ thuật cho AI Agent (Tiếng Việt)
+```
+
+---
+
+## ❓ Câu hỏi thường gặp
+
+<details>
+<summary><b>Thật sự miễn phí?</b></summary>
+Đúng. Docker, Google Gemini API (free tier), và Telegram/Zalo bot đều miễn phí. Nếu bạn muốn dùng Claude hoặc GPT-4o thì cần trả phí riêng cho nhà cung cấp AI đó.
+</details>
+
+<details>
+<summary><b>Bot chạy ở đâu?</b></summary>
+Trên máy tính của bạn trong Docker container. Khi tắt máy, bot cũng tắt.
+</details>
+
+<details>
+<summary><b>Làm sao tắt/khởi động lại?</b></summary>
+
+```bash
+docker compose down      # Tắt
+docker compose up -d     # Bật
+```
+</details>
+
+<details>
+<summary><b>Có thể đổi model AI sau không?</b></summary>
+Có! Chỉ cần sửa <code>.openclaw/openclaw.json</code> → đổi trường <code>model.primary</code> → <code>docker compose restart</code>.
+</details>
+
+<details>
+<summary><b>Có thể đổi kênh chat sau không?</b></summary>
+Có! Chạy lại Setup Wizard hoặc sửa <code>.openclaw/openclaw.json</code> → phần <code>channels</code>.
+</details>
+
+<details>
+<summary><b>An toàn không?</b></summary>
+API key chỉ lưu trên máy bạn. SETUP.md có các quy tắc bảo mật nghiêm ngặt mà AI Agent phải tuân thủ (không xóa file, không truy cập thư mục nhạy cảm, không lộ key...).
+</details>
+
+<details>
+<summary><b>9Router là gì?</b></summary>
+9Router là AI proxy mã nguồn mở chạy cùng Docker với bot. Thay vì dùng API key, bạn đăng nhập OAuth trên dashboard 9Router (<code>localhost:20128</code>). Nó tự động route request tới AI provider tốt nhất.
+</details>
+
+<details>
+<summary><b>Skills và Plugins khác nhau thế nào?</b></summary>
+<strong>Skills</strong> thêm kỹ năng cho bot (Web Search, Browser, Memory...) — cài qua <code>openclaw skills install</code> từ ClawHub.<br>
+<strong>Plugins</strong> thêm kênh chat hoặc tính năng runtime (Voice Call, Matrix...) — cài qua <code>openclaw plugins install</code> từ npm.
+</details>
+
+---
+
+## 🔗 Link hữu ích
+
+- [OpenClaw Docs](https://openclaw.ai/docs)
+- [Google AI Studio](https://aistudio.google.com/)
+- [Telegram BotFather](https://t.me/BotFather)
+- [Zalo Bot Platform](https://developers.zalo.me)
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
+- [Ollama](https://ollama.com)
+- [OpenRouter](https://openrouter.ai)
+- [9Router](https://github.com/decolua/9router)
+- [ClawHub (Skills)](https://clawhub.com)
+
+---
+
+## 📈 Lịch sử Star
+
+<div align="center">
+
+[![Star History Chart](https://api.star-history.com/svg?repos=tuanminhhole/openclaw-setup&type=Date)](https://star-history.com/#tuanminhhole/openclaw-setup&Date)
+
+</div>
+
+---
+
+## 🙏 Ghi công
+
+- [OpenClaw](https://openclaw.ai) — AI Gateway framework
+- [9Router](https://github.com/decolua/9router) — AI proxy mã nguồn mở (OAuth, không cần API key)
+- [Playwright](https://playwright.dev) — Engine trình duyệt tự động
+- [ClawHub](https://clawhub.com) — Skills registry
+- [TheSVG](https://thesvg.org) — Bộ icon SVG vector chất lượng cao (miễn phí)
+
+---
+
+<div align="center">
+
+Made with 🦞 by [Kent](https://github.com/tuanminhhole)
+
+</div>