create-openclaw-bot 4.0.1 → 4.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tuan Minh Hole (Kent)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,28 +2,45 @@
 
 # 🦞 OpenClaw Setup
 
-**Create your own free AI Bot on Telegram or Zalo in minutes.**
+<p align="center">
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v4.0.1-0EA5E9?style=for-the-badge" alt="Version 4.0.1" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup?tab=MIT-1-ov-file"><img src="https://img.shields.io/badge/LICENSE-MIT-success?style=for-the-badge" alt="MIT License" /></a>
+  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/v/create-openclaw-bot?style=for-the-badge&label=CLI&color=2563EB&logo=npm&logoColor=white" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/dm/create-openclaw-bot?style=for-the-badge&color=22c55e" alt="NPM Downloads" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&color=eab308&logo=github&logoColor=white" alt="GitHub Stars" /></a>
+</p>
 
-[![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)
+An interactive <strong>CLI tool</strong> and <strong>Setup Wizard</strong> to deploy your own free AI Bot on Telegram or Zalo in minutes.
 
-<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)
+<a href="https://github.com/tuanminhhole/openclaw-setup">
+  <img src="docs/preview.png" alt="OpenClaw Setup Hero Image" width="100%" style="border-radius: 8px; margin: 16px 0; border: 1px solid #333;" />
+</a>
+
+<p style="margin-top: 16px;">
+  <img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18" style="vertical-align: sub;"> <strong>English</strong> · 
+  <img src="https://flagcdn.com/24x18/vn.png" alt="Tiếng Việt" width="24" height="18" style="vertical-align: sub;"> <a href="README.vi.md">Tiếng Việt</a>
+</p>
 
 </div>
 
 ---
 
+## 🆕 What's new in v4.0.1
+- 🪄 **Fully Automated Setup**: Say goodbye to downloading ZIP files and manually copying configs. Everything is now fully automated with a single action.
+- ⚡ **One-Command Install (`npx create-openclaw-bot`)**: Extremely convenient for VPS/SSH users — the script automatically creates the project directory, sets up the environment, and triggers `docker compose up -d` instantly.
+- 🚀 **Zero-Restart Deployment**: Details like API Keys and Bot Tokens (which you input during setup) are automatically injected into `.env` before the bot boots for the first time. No restarts required!
+- 🌐 **Browser Automation Setup**: Updated Windows Task Scheduler and Debug Mode scripts for smoother interaction with Web Apps.
+
+---
+
 ## ✨ 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
+- 🔀 **9Router Proxy** — Auto-route your bot's traffic effectively!
+- 🧙 **Setup Wizard** — Beautiful interactive shell (CLI) or dark-themed Web UI
 - 🆓 **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
@@ -71,7 +88,20 @@ You need **3 things** (all free):
 
 ## 🚀 Quick Start
 
-### Option A — Setup Wizard (Recommended)
+### 1️⃣ Option A — Interactive CLI (`npx`) [Recommended]
+
+The fastest way to install OpenClaw is using the interactive NPM package.
+
+1. **Open your Terminal (or Command Prompt).**
+2. **Run the command:**
+   ```bash
+   npx create-openclaw-bot
+   ```
+3. **Follow the interactive prompts** to configure your bot, keys, and paths!
+
+<details>
+<summary><b>2️⃣ Option B — GUI Setup Wizard (Web UI)</b></summary>
+<br>
 
 1. **Clone this repo:**
    ```bash
@@ -82,21 +112,11 @@ You need **3 things** (all free):
 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
+   - Generate all config files and `setup-openclaw.bat`
 
-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! 🎉
+</details>
 
-### Option B — AI Agent (Antigravity)
+### 3️⃣ Option C — AI Agent (Antigravity)
 
 1. Open [Antigravity IDE](https://antigravity.dev/)
 2. Open this repo as workspace

package/README.vi.md

@@ -2,30 +2,48 @@
 
 # 🦞 OpenClaw Setup
 
-**Tạo AI Bot miễn phí trên Telegram hoặc Zalo chỉ trong vài phút.**
+<p align="center">
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v4.0.1-0EA5E9?style=for-the-badge" alt="Version 4.0.1" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup?tab=MIT-1-ov-file"><img src="https://img.shields.io/badge/LICENSE-MIT-success?style=for-the-badge" alt="MIT License" /></a>
+  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/v/create-openclaw-bot?style=for-the-badge&label=CLI&color=2563EB&logo=npm&logoColor=white" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/create-openclaw-bot"><img src="https://img.shields.io/npm/dm/create-openclaw-bot?style=for-the-badge&color=22c55e" alt="NPM Downloads" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/stargazers"><img src="https://img.shields.io/github/stars/tuanminhhole/openclaw-setup?style=for-the-badge&color=eab308&logo=github&logoColor=white" alt="GitHub Stars" /></a>
+</p>
 
-[![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ợ)
+Một công cụ trực quan <strong>Setup Wizard (UI)</strong> & <strong>CLI</strong> để tự tay build Bot AI trên Telegram và Zalo chỉ trong vài phút.
 
-<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)
+<a href="https://github.com/tuanminhhole/openclaw-setup">
+  <img src="docs/preview.png" alt="OpenClaw Setup Hero Image" width="100%" style="border-radius: 8px; margin: 16px 0; border: 1px solid #333;" />
+</a>
+
+<p style="margin-top: 16px;">
+  <img src="https://flagcdn.com/24x18/vn.png" alt="Tiếng Việt" width="24" height="18" style="vertical-align: sub;"> <strong>Tiếng Việt</strong> · 
+  <img src="https://flagcdn.com/24x18/gb.png" alt="English" width="24" height="18" style="vertical-align: sub;"> <a href="README.md">English</a>
+</p>
 
 </div>
 
 ---
 
+## 🆕 Có gì mới ở bản 4.0.1
+- 🪄 **Tự động hóa hoàn toàn**: Tạm biệt việc tải file ZIP và copy config thủ công! Giờ đây mọi thứ diễn ra tự động chỉ với 1 lượt click.
+- ⚡ **Chỉ 1 lệnh duy nhất (`npx create-openclaw-bot`)**: Cực kỳ tiện lợi cho ae cài qua VPS/SSH — script sẽ tự động tạo thư mục, khởi tạo môi trường và tự động kích hoạt `docker compose up -d` ngay sau khi nhập xong.
+- 🚀 **Zero-Restart Deployment**: API Keys và config được inject trực tiếp vào thư mục (bạn vẫn cần nhập từ Terminal, máy sẽ tự sinh vào file `.env` trước khi bot chạy lần đầu). Không cần phải restart lại container mất thời gian nữa.
+- 🌐 **Browser Automation Setup**: Cập nhật tự động sinh file chạy Windows Task Scheduler và bật file thiết lập Debug mode tự động. Mở Zalo Mini app ngon lành.
+
+---
+
 ## ✨ 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
+- 🔀 **9Router Proxy** — Hệ thống Auto-route điều phối Bot tuyệt vời.
+- 🧙 **Setup Wizard** — Chạy thẳng qua Terminal CLI hoặc giao diện web Web UI 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ộ
+- 🔒 **An toàn** — API key không bao giờ bị lộ ra ngoài
+- ⚡ **Siêu tốc** — Build thành công trong 3 phút
 
 ---
 
@@ -70,7 +88,20 @@ Bạn cần **3 thứ** (miễn phí hết):
 
 ## 🚀 Bắt đầu nhanh
 
-### Cách A — Setup Wizard (Khuyến nghị)
+### 1️⃣ Cách A — Cài đặt bằng Terminal CLI (`npx`) [Tốt nhất]
+
+Dùng NPX là cách cài chuẩn nhất:
+
+1. **Mở Terminal (hoặc Command Prompt).**
+2. **Gõ lệnh sau:**
+   ```bash
+   npx create-openclaw-bot
+   ```
+3. **Làm theo các bước gợi ý trên Terminal** để đặt tên cho bot, setup tokens và nơi chứa file thư mục của bot.
+
+<details>
+<summary><b>2️⃣ Cách B — Cài đặt bằng Giao diện Setup Web (Web UI)</b></summary>
+<br>
 
 1. **Clone repo:**
    ```bash
@@ -82,21 +113,12 @@ Bạn cần **3 thứ** (miễn phí hết):
    - 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)
+   - Tự động generate tất cả config files về file `setup-openclaw.bat`
 
-4. **Build & Chạy:**
-   ```bash
-   cd docker/openclaw
-   docker compose build
-   docker compose up -d
-   ```
+</details>
 
-5. **Test bot** — gửi tin nhắn trên Telegram hoặc Zalo! 🎉
 
-### Cách B — Dùng AI Agent (Antigravity)
+### 3️⃣ Cách C — Dùng AI Agent (Antigravity)
 
 1. Mở [Antigravity IDE](https://antigravity.dev/)
 2. Mở repo này làm workspace

package/cli.js

@@ -142,47 +142,115 @@ async function main() {
   }
   await fs.writeFile(path.join(projectDir, 'docker', 'openclaw', '.env'), envContent);
   
-  const dockerfile = `FROM ghcr.io/williamskyze/openclaw:latest
-${selectedSkills.includes('browser') ? 'RUN apt-get update && apt-get install -y chromium xvfb dbus socat' : '# (No browser config needed)'}`;
+  const dockerfile = `FROM node:22-slim
+
+RUN apt-get update && apt-get install -y git curl${selectedSkills.includes('browser') ? ' socat' : ''} && rm -rf /var/lib/apt/lists/*
+
+RUN npm install -g openclaw@latest
+${selectedSkills.includes('browser') ? 'RUN npm install -g agent-browser playwright && npx playwright install chromium --with-deps && ln -f -s /root/.cache/ms-playwright/chromium-*/chrome-linux*/chrome /usr/bin/google-chrome\\n' : ''}
+WORKDIR /root/.openclaw
+
+EXPOSE 18791
+
+CMD sh -c "node -e \\\\"const fs=require('fs'),p='/root/.openclaw/openclaw.json';if(fs.existsSync(p)){const c=JSON.parse(fs.readFileSync(p,'utf8'));c.tools=Object.assign({},c.tools,{profile:'full'});c.gateway=Object.assign({},c.gateway,{port:18791,bind:'0.0.0.0'});fs.writeFileSync(p,JSON.stringify(c,null,2));}\\\\" && ${selectedSkills.includes('browser') ? 'socat TCP-LISTEN:9222,fork,reuseaddr TCP:host.docker.internal:9222 & ' : ''}(sleep 5 && openclaw devices approve --latest 2>/dev/null || true) & openclaw gateway run"`;
+  
   await fs.writeFile(path.join(projectDir, 'docker', 'openclaw', 'Dockerfile'), dockerfile);
 
-  const compose = `services:
-  openclaw:
+  let compose = '';
+  if (providerKey === '9router') {
+    compose = `services:
+  ai-bot:
     build: .
+    container_name: openclaw-bot
     restart: always
-    env_file: .env
+    env_file:
+      - .env
+    depends_on:
+      - 9router
+${selectedSkills.includes('browser') ? `    extra_hosts:
+      - "host.docker.internal:host-gateway"
+` : ''}    volumes:
+      - ../../.openclaw:/root/.openclaw
+    ports:
+      - "18789:18789"
+
+  9router:
+    image: node:22-slim
+    container_name: 9router
+    restart: always
+    entrypoint: >
+      /bin/sh -c "npm install -g 9router && [ ! -f /root/.9router/db.json ] && echo '{\\"combos\\":[{\\"id\\":\\"smart-route\\",\\"name\\":\\"smart-route\\",\\"alias\\":\\"smart-route\\",\\"models\\":[\\"cx/gpt-5.4\\",\\"ag/claude-opus-4-6-thinking\\",\\"cc/claude-opus-4-6\\",\\"gh/gpt-5.4\\",\\"ag/gemini-3.1-pro-high\\",\\"cc/claude-sonnet-4-6\\",\\"gh/claude-opus-4.6\\"]}]}' > /root/.9router/db.json; 9router"
+    environment:
+      - NINEROUTER_PORT=18789
+      - NINEROUTER_SECURE=false
     volumes:
-      - ../../.openclaw:/app/.openclaw
-      - ../../auth-profiles.json:/app/auth-profiles.json
+      - ../../.9router:/root/.9router`;
+  } else {
+    compose = `services:
+  ai-bot:
+    build: .
+    container_name: openclaw-bot
+    restart: always
+    env_file: .env
 ${selectedSkills.includes('browser') ? `    extra_hosts:
       - "host.docker.internal:host-gateway"
-` : ''}`;
+` : ''}    volumes:
+      - ../../.openclaw:/root/.openclaw`;
+  }
+  
   await fs.writeFile(path.join(projectDir, 'docker', 'openclaw', 'docker-compose.yml'), compose);
 
-  await fs.writeFile(path.join(projectDir, 'auth-profiles.json'), '{}');
+  const authProfileObj = {};
+  if (providerKey && !provider.isLocal) {
+    const authProviderName = providerKey === '9router' ? '9router' : 'openai';
+    authProfileObj[authProviderName] = [{
+      type: "api_key",
+      field: "key",
+      order: 1,
+      value: providerKey === '9router' ? "9r-dummy" : providerKeyVal
+    }];
+    if (providerKey !== '9router' && providerKey !== 'openai' && provider.baseURL) {
+      authProfileObj[authProviderName][0].url = provider.baseURL;
+    }
+  }
+
+  const agentId = botName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/-$/, '') || 'chat';
+  const modelsPrimary = providerKey === '9router' ? '9router/smart-route' : (providerKey === 'google' ? 'google/gemini-2.5-flash' : 'openai/gpt-4o');
+
+  await fs.ensureDir(path.join(projectDir, '.openclaw', 'agents', agentId, 'agent'));
+  await fs.writeJson(path.join(projectDir, '.openclaw', 'auth-profiles.json'), authProfileObj, { spaces: 2 });
+  await fs.writeJson(path.join(projectDir, '.openclaw', 'agents', agentId, 'agent', 'auth-profiles.json'), authProfileObj, { spaces: 2 });
 
   const botConfig = {
-    meta: { version: '1.0' },
+    meta: { lastTouchedVersion: '2026.3.24' },
     agents: {
       defaults: {
-        model: { primary: providerKey === 'openai' ? 'gpt-4o' : (providerKey === 'google' ? 'google/gemini-2.5-flash' : 'smart-route'), fallbacks: [] },
-        identity: {
-          name: botName,
-          description: botDesc,
-          system_prompt: isVi ? "Bạn là một trợ lý AI hữu ích." : "You are a helpful AI assistant."
-        },
-        skills: selectedSkills
-      }
+        model: { primary: modelsPrimary, fallbacks: [] },
+        compaction: { mode: 'safeguard' }
+      },
+      list: [{
+        id: agentId,
+        model: { primary: modelsPrimary, fallbacks: [] }
+      }]
     },
-    channels: {}
+    commands: { native: 'auto', nativeSkills: 'auto', restart: true, ownerDisplay: 'raw' },
+    channels: {},
+    tools: { profile: 'full' },
+    gateway: {
+      port: 18791, mode: 'local', bind: '0.0.0.0',
+      auth: { mode: 'token', token: 'cli-dummy-token-xyz123' }
+    }
   };
+
+  const identityContent = `# ${botName}\n\n${botDesc}\n\n${isVi ? 'Bạn là một trợ lý AI phân tích và tự động hóa do Kent đào tạo và cấu hình.' : 'You are an AI assistant configured by Kent.'}`;
+  await fs.writeFile(path.join(projectDir, '.openclaw', 'agents', agentId, 'agent', 'IDENTITY.md'), identityContent);
   
   if (channelKey === 'telegram') {
-    botConfig.channels['telegram'] = { enabled: true };
+    botConfig.channels['telegram'] = { enabled: true, mode: 'polling' };
   } else if (channelKey === 'zalo-personal') {
-    botConfig.channels['zalo-personal'] = { enabled: true, autoReply: true };
+    botConfig.channels['zalo'] = { enabled: true, provider: 'client', autoReply: true };
   } else if (channelKey === 'zalo-bot') {
-    botConfig.channels['zalo-bot'] = { enabled: true };
+    botConfig.channels['zalo'] = { enabled: true, provider: 'official_account' };
   }
 
   await fs.writeJson(path.join(projectDir, '.openclaw', 'openclaw.json'), botConfig, { spaces: 2 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-openclaw-bot",
-  "version": "4.0.1",
-  "description": "Interactive CLI for setting up OpenClaw bot autonomously",
+  "version": "4.0.2",
+  "description": "Interactive CLI installer for OpenClaw Bot",
   "main": "cli.js",
   "bin": {
     "create-openclaw-bot": "./cli.js"