create-openclaw-bot 5.4.1 → 5.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-openclaw-bot",
-  "version": "5.4.1",
+  "version": "5.5.0",
   "description": "Interactive CLI installer for OpenClaw Bot",
   "main": "cli.js",
   "bin": {

package/setup/data/channels.js

@@ -0,0 +1,164 @@
+// @ts-nocheck
+/* eslint-disable no-undef, no-unused-vars */
+/**
+ * @fileoverview Part of the OpenClaw Setup Wizard IIFE bundle.
+ * This file is concatenated (not imported) — globals are shared via setup.js IIFE scope.
+ * Do NOT add import/export statements. Edit, then run: node build.mjs
+ *
+ * @global {object}  state       - Wizard UI state
+ * @global {object}  PROVIDERS   - AI provider registry
+ * @global {Array}   SKILLS      - Available skills
+ * @global {Array}   PLUGINS     - Available plugins
+ * @global {object}  CHANNELS    - Channel definitions
+ * @global {boolean} isVi        - Vietnamese language mode
+ * @global {object}  provider    - Current primary provider config
+ * @global {boolean} isMultiBot  - Multi-bot mode flag
+ * @global {boolean} hasBrowser  - Browser plugin selected
+ * @global {boolean} is9Router   - 9Router proxy mode
+ * @global {string}  projectDir  - Output project directory path
+ * @global {Function} getGatewayAllowedOrigins
+ */
+  // ========== Channel definitions ==========
+  const CHANNELS = {
+    telegram: {
+      name: 'Telegram',
+      envKeys: [],
+      envExtra: 'TELEGRAM_BOT_TOKEN=<your_bot_token>',
+      credSteps: [
+        { textVi: 'Mở Telegram → tìm <a href="https://t.me/BotFather" target="_blank">@BotFather</a> → gửi <code>/newbot</code> → đặt tên bot → copy token', textEn: 'Open Telegram → find <a href="https://t.me/BotFather" target="_blank">@BotFather</a> → send <code>/newbot</code> → name bot → copy token' },
+      ],
+      channelConfig: {
+        telegram: {
+          enabled: true,
+          dmPolicy: 'open',
+          allowFrom: ['*'],
+          groupPolicy: 'allowlist',
+          streaming: 'partial',
+        },
+      },
+      pluginInstall: '',
+    },
+    'zalo-bot': {
+      name: 'Zalo Bot API',
+      envKeys: [],
+      envExtra: 'ZALO_BOT_TOKEN=<your_zalo_bot_token>',
+      credSteps: [
+        { textVi: '<span style="color: #fbbf24; font-weight: 500;">⚠️ LƯU Ý: Bot OA Zalo đòi hỏi bạn phải thiết lập Webhook Public (qua VPS/ngrok có HTTPS). Hãy cân nhắc dùng Zalo Personal nếu bạn chưa có Webhook.</span>', textEn: '<span style="color: #fbbf24; font-weight: 500;">⚠️ NOTE: Zalo OA Bot requires setting up a Public Webhook (using VPS/ngrok with HTTPS). Consider using Zalo Personal if you do not have a webhook.</span>' },
+        { textVi: 'Vào <a href="https://developers.zalo.me" target="_blank">Zalo Bot Platform</a> → Tạo bot mới → copy Bot Token', textEn: 'Go to <a href="https://developers.zalo.me" target="_blank">Zalo Bot Platform</a> → Create new bot → copy Bot Token' },
+      ],
+      channelConfig: {
+        zalo: {
+          enabled: true,
+        },
+      },
+      pluginInstall: '',
+    },
+    // 'telegram+zalo-personal' — Combo mode tạm ngưng, nghiên cứu thêm.
+    'zalo-personal': {
+      name: 'Zalo Personal',
+      envKeys: [],
+      envExtra: '',
+      credSteps: [
+        { textVi: '⚠️ Zalo Personal dùng <strong>unofficial API (zca-js)</strong> — chỉ nên dùng tài khoản phụ', textEn: '⚠️ Zalo Personal uses <strong>unofficial API (zca-js)</strong> — use an alternate account' },
+        { textVi: 'Native setup sẽ tự chạy login và copy QR về thư mục project. Nếu cần chạy lại thủ công, dùng <code>openclaw channels login --channel zalouser --verbose</code>.', textEn: 'Native setup now auto-runs the login flow and copies the QR into the project folder. If needed, rerun it manually with <code>openclaw channels login --channel zalouser --verbose</code>.' },
+      ],
+      channelConfig: {
+        zalouser: {
+          enabled: true,
+          accounts: {
+            default: {
+              dmPolicy: 'open',
+              allowFrom: ['*'],
+              groupPolicy: 'allowlist',
+            },
+          },
+          dmPolicy: 'open',
+          groupPolicy: 'allowlist',
+        },
+      },
+      pluginInstall: '@openclaw/zalouser',
+    },
+  };
+
+  // ========== Default system prompts ==========
+  const DEFAULT_PROMPTS = {
+    vi: `Bạn là {BOT_NAME}, {BOT_DESC}.
+
+## Tính cách
+- Thân thiện, hữu ích
+- Trả lời bằng tiếng Việt
+- Giọng văn tự nhiên, gần gũi
+
+## Quy tắc
+- Trả lời ngắn gọn, súc tích
+- Hỏi lại khi chưa rõ yêu cầu`,
+    en: `You are {BOT_NAME}, {BOT_DESC}.
+
+## Personality
+- Friendly and helpful
+- Reply in English
+- Natural, conversational tone
+
+## Rules
+- Keep answers concise
+- Ask for clarification when needed`,
+  };
+
+  // ========== Default Security Rules ==========
+  const DEFAULT_SECURITY_RULES = {
+    vi: `## 🔐 Quy Tắc Bảo Mật — BẮT BUỘC
+
+### File & thư mục hệ thống
+- ❌ KHÔNG đọc, sao chép, hoặc truy cập bất kỳ file nào ngoài thư mục project
+- ❌ KHÔNG quét hoặc liệt kê các thư mục hệ thống: Documents, Desktop, Downloads, AppData
+- ❌ KHÔNG truy cập registry, system32, hoặc Program Files
+- ❌ KHÔNG cài đặt phần mềm, driver, hoặc service ngoài Docker
+- ✅ CHỈ làm việc trong thư mục project
+
+### API key & credentials
+- ❌ KHÔNG BAO GIỜ hiển thị API key, token, hoặc mật khẩu trong chat
+- ❌ KHÔNG viết API key trực tiếp vào mã nguồn
+- ❌ KHÔNG commit file credentials lên Git
+- ✅ LUÔN lưu credentials trong file .env riêng
+- ✅ LUÔN dùng biến môi trường thay vì hardcode
+
+### Ví crypto & tài sản số
+- ❌ TUYỆT ĐỐI KHÔNG truy cập, đọc, hoặc quét các thư mục ví crypto
+- ❌ KHÔNG quét clipboard (có thể chứa seed phrases)
+- ❌ KHÔNG truy cập browser profile, cookie, hoặc mật khẩu đã lưu
+- ❌ KHÔNG cài đặt npm package lạ (chỉ openclaw và plugin chính thức)
+
+### Docker
+- ✅ Chỉ mount đúng thư mục cần thiết (config + workspace)
+- ❌ KHÔNG mount nguyên ổ đĩa (C:/ hoặc D:/)
+- ❌ KHÔNG chạy container với --privileged
+- ✅ Giới hạn port expose (chỉ 38789)`,
+    en: `## 🔐 Security Rules — MANDATORY
+
+### System files & directories
+- ❌ DO NOT read, copy, or access any file outside the project folder
+- ❌ DO NOT scan or list system directories: Documents, Desktop, Downloads, AppData
+- ❌ DO NOT access the registry, system32, or Program Files
+- ❌ DO NOT install software, drivers, or services outside Docker
+- ✅ ONLY work within the project folder
+
+### API keys & credentials
+- ❌ NEVER display API keys, tokens, or passwords in chat
+- ❌ DO NOT write API keys directly into source code
+- ❌ DO NOT commit credential files to Git
+- ✅ ALWAYS store credentials in a separate .env file
+- ✅ ALWAYS use environment variables instead of hardcoding
+
+### Crypto wallets & digital assets
+- ❌ ABSOLUTELY DO NOT access, read, or scan crypto wallet directories
+- ❌ DO NOT scan the clipboard (may contain seed phrases)
+- ❌ DO NOT access browser profiles, cookies, or saved passwords
+- ❌ DO NOT install unknown npm packages (only openclaw and official plugins)
+
+### Docker
+- ✅ Only mount required directories (config + workspace)
+- ❌ DO NOT mount entire drives (C:/ or D:/)
+- ❌ DO NOT run containers with --privileged
+- ✅ Limit exposed ports (only 38789)`,
+  };
+

package/setup/data/header.js

@@ -0,0 +1,80 @@
+// @ts-nocheck
+/* eslint-disable no-undef, no-unused-vars */
+/**
+ * @fileoverview Part of the OpenClaw Setup Wizard IIFE bundle.
+ * This file is concatenated (not imported) — globals are shared via setup.js IIFE scope.
+ * Do NOT add import/export statements. Edit, then run: node build.mjs
+ *
+ * @global {object}  state       - Wizard UI state
+ * @global {object}  PROVIDERS   - AI provider registry
+ * @global {Array}   SKILLS      - Available skills
+ * @global {Array}   PLUGINS     - Available plugins
+ * @global {object}  CHANNELS    - Channel definitions
+ * @global {boolean} isVi        - Vietnamese language mode
+ * @global {object}  provider    - Current primary provider config
+ * @global {boolean} isMultiBot  - Multi-bot mode flag
+ * @global {boolean} hasBrowser  - Browser plugin selected
+ * @global {boolean} is9Router   - 9Router proxy mode
+ * @global {string}  projectDir  - Output project directory path
+ * @global {Function} getGatewayAllowedOrigins
+ */
+  // ========== CDN Logo URLs (thesvg.org) ==========
+  const SVG_CDN = 'https://thesvg.org/icons';
+  const LOGO = {
+    gemini: `${SVG_CDN}/google-gemini/default.svg`,
+    anthropic: `${SVG_CDN}/anthropic/light.svg`,
+    openai: `${SVG_CDN}/openai/light.svg`,
+    openrouter: `${SVG_CDN}/openrouter/light.svg`,
+    ollama: `${SVG_CDN}/ollama/light.svg`,
+    '9router': null, // Uses emoji icon 🔀 instead of SVG
+  };
+
+  // Language flag icons (inline SVG circles with flag colors)
+  const FLAG_ICONS = {
+    vi: `<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><circle cx="10" cy="10" r="10" fill="#DA251D"/><polygon points="10,4 11.5,8.5 16,8.5 12.3,11.2 13.8,15.7 10,13 6.2,15.7 7.7,11.2 4,8.5 8.5,8.5" fill="#FFFF00"/></svg>`,
+    en: `<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><circle cx="10" cy="10" r="10" fill="#012169"/><path d="M0 0L20 20M20 0L0 20" stroke="white" stroke-width="3"/><path d="M0 0L20 20M20 0L0 20" stroke="#C8102E" stroke-width="1.5"/><path d="M10 0V20M0 10H20" stroke="white" stroke-width="5"/><path d="M10 0V20M0 10H20" stroke="#C8102E" stroke-width="3"/></svg>`,
+  };
+
+  // ========== State ==========
+  const state = {
+    currentStep: 1,
+    totalSteps: 5,
+    channel: null,
+    deployMode: 'docker', // 'docker' | 'native'
+    nativeOs: 'win',     // 'win' | 'linux' | 'vps' | 'linux-desktop'
+    config: {
+      botName: '',
+      description: '',
+      emoji: '🤖',
+      provider: 'google',
+      model: 'google/gemini-2.5-flash',
+      language: 'vi',
+      systemPrompt: '',
+      userInfo: '',
+      securityRules: '',
+      plugins: [],
+      skills: [],
+      // Persisted credential inputs (Bug 1+2 fix)
+      botToken: '',
+      apiKey: '',
+      projectPath: '',
+    },
+  };
+
+  // Runtime packages installed alongside openclaw in native and Docker flows.
+  const openClawRuntimePackages = globalThis.__openclawCommon?.OPENCLAW_RUNTIME_PACKAGES
+    || 'grammy @grammyjs/runner @grammyjs/transformer-throttler @buape/carbon @larksuiteoapi/node-sdk @slack/web-api';
+
+  function getGatewayAllowedOrigins(port) {
+    const normalizedPort = Number(port) || 18791;
+    const origins = new Set([
+      `http://localhost:${normalizedPort}`,
+      `http://127.0.0.1:${normalizedPort}`,
+      `http://0.0.0.0:${normalizedPort}`,
+    ]);
+    const currentHost = (window.location && window.location.hostname) ? window.location.hostname.trim() : '';
+    if (currentHost) {
+      origins.add(`http://${currentHost}:${normalizedPort}`);
+    }
+    return Array.from(origins);
+  }

package/setup/data/index.js

@@ -0,0 +1,73 @@
+// @ts-nocheck
+/**
+ * setup/data/index.js — Shared data for CLI + Wizard
+ *
+ * Provides CLI-compatible views of PROVIDERS, SKILLS, CHANNELS, and OLLAMA_MODELS.
+ * The wizard uses these via IIFE concatenation (providers.js, skills.js, channels.js).
+ * The CLI imports this file directly via createRequire.
+ *
+ * Structure deliberately kept flat & forward-compatible:
+ *   - PROVIDERS: { [key]: { name, icon, envKey?, isProxy?, isLocal? } }
+ *   - SKILLS:    [{ value, name, slug? }]
+ *   - CHANNELS:  { [key]: { name, type, icon } }
+ *   - OLLAMA_MODELS: [{ id, name, reasoning, input, cost, contextWindow, maxTokens }]
+ */
+(function (root) {
+  // ── CLI-facing PROVIDERS (display + config metadata) ──────────────────────────
+  // Keep in sync with setup/data/providers.js model IDs
+  const PROVIDERS = {
+    '9router':   { name: '9Router Proxy (Khuyên dùng)',  icon: '🔀', isProxy: true },
+    'openai':    { name: 'OpenAI (ChatGPT)',              icon: '🧠', envKey: 'OPENAI_API_KEY' },
+    'ollama':    { name: 'Local Ollama',                  icon: '🏠', isLocal: true },
+    'google':    { name: 'Google (Gemini)',               icon: '⚡', envKey: 'GEMINI_API_KEY' },
+    'anthropic': { name: 'Anthropic (Claude)',            icon: '🦄', envKey: 'ANTHROPIC_API_KEY' },
+    'xai':       { name: 'xAI (Grok)',                   icon: '✖️', envKey: 'XAI_API_KEY' },
+    'groq':      { name: 'Groq (LPU)',                   icon: '🏎️', envKey: 'GROQ_API_KEY' },
+    'openrouter':{ name: 'OpenRouter',                   icon: '🌐', envKey: 'OPENROUTER_API_KEY' },
+  };
+
+  // ── CLI-facing SKILLS (value = selection key, slug = ClawHub package name) ────
+  // Keep in sync with setup/data/skills.js skill IDs
+  const SKILLS = [
+    { value: 'browser',          name: '🌐 Browser Automation (Playwright) (⭐ Khuyên dùng)', slug: null },
+    { value: 'memory',           name: '🧠 Long-term Memory (⭐ Khuyên dùng)',                 slug: 'memory' },
+    { value: 'scheduler',        name: '⏰ Native Cron Scheduler (⭐ Khuyên dùng)',             slug: null },
+    { value: 'rag',              name: '📚 RAG / Knowledge Base',                              slug: 'rag' },
+    { value: 'image-gen',        name: '🎨 Image Generation (DALL·E / Flux)',                  slug: 'image-gen' },
+    { value: 'code-interpreter', name: '💻 Code Interpreter (Python/JS)',                      slug: 'code-interpreter' },
+    { value: 'email',            name: '📧 Email Assistant',                                   slug: 'email-assistant' },
+    { value: 'tts',              name: '🔊 Text-To-Speech (OpenAI/ElevenLabs)',                slug: 'tts' },
+    { value: 'web-search',       name: '🔍 Web Search',                                        slug: 'web-search' },
+  ];
+
+  // ── CLI-facing CHANNELS ───────────────────────────────────────────────────────
+  // Keep in sync with setup/data/channels.js channel keys
+  const CHANNELS = {
+    'telegram':           { name: 'Telegram',                     type: 'telegram',           icon: '🤖' },
+    'zalo-bot':           { name: 'Zalo OA (Bot Platform)',        type: 'zalo-bot',           icon: '🔑' },
+    'zalo-personal':      { name: 'Zalo Personal (Quét QR)',       type: 'zalo-personal',      icon: '📱' },
+  };
+
+  // ── Ollama model definitions (single source of truth for all config JSON writes) ──
+  // Used in: models.json per-agent, openclaw.json models.providers.ollama
+  const OLLAMA_MODELS = [
+    { id: 'gemma4:e2b',     name: 'Gemma 4 E2B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma4:e4b',     name: 'Gemma 4 E4B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma4:26b',     name: 'Gemma 4 26B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma4:31b',     name: 'Gemma 4 31B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'qwen3:8b',       name: 'Qwen 3 8B',      reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'deepseek-r1:8b', name: 'DeepSeek R1 8B', reasoning: true,  input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 64000,  maxTokens: 8192 },
+    { id: 'llama3.3:8b',    name: 'Llama 3.3 8B',   reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+    { id: 'gemma3:12b',     name: 'Gemma 3 12B',    reasoning: false, input: ['text'], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 },
+  ];
+
+  // ── Node.js export (for CLI via createRequire) ────────────────────────────────
+  if (typeof module !== 'undefined' && module.exports) {
+    module.exports = { PROVIDERS, SKILLS, CHANNELS, OLLAMA_MODELS };
+  }
+
+  // ── Browser global (future use if wizard imports this directly) ───────────────
+  if (typeof root !== 'undefined') {
+    root.__openclawData = { PROVIDERS, SKILLS, CHANNELS, OLLAMA_MODELS };
+  }
+})(typeof globalThis !== 'undefined' ? globalThis : (typeof window !== 'undefined' ? window : {}));

package/setup/data/plugins.js

@@ -0,0 +1,60 @@
+// @ts-nocheck
+/* eslint-disable no-undef, no-unused-vars */
+/**
+ * @fileoverview Part of the OpenClaw Setup Wizard IIFE bundle.
+ * This file is concatenated (not imported) — globals are shared via setup.js IIFE scope.
+ * Do NOT add import/export statements. Edit, then run: node build.mjs
+ *
+ * @global {object}  state       - Wizard UI state
+ * @global {object}  PROVIDERS   - AI provider registry
+ * @global {Array}   SKILLS      - Available skills
+ * @global {Array}   PLUGINS     - Available plugins
+ * @global {object}  CHANNELS    - Channel definitions
+ * @global {boolean} isVi        - Vietnamese language mode
+ * @global {object}  provider    - Current primary provider config
+ * @global {boolean} isMultiBot  - Multi-bot mode flag
+ * @global {boolean} hasBrowser  - Browser plugin selected
+ * @global {boolean} is9Router   - 9Router proxy mode
+ * @global {string}  projectDir  - Output project directory path
+ * @global {Function} getGatewayAllowedOrigins
+ */
+  // ========== Available Plugins (npm packages — runtime/channel extensions) ==========
+  const PLUGINS = [
+    {
+      id: 'telegram-multibot-relay',
+      name: 'Telegram Multi-Bot Relay',
+      icon: '🤝',
+      descVi: 'Điều phối nhiều bot Telegram trong cùng group — tự động khi chọn nhiều bot', descEn: 'Coordinate multiple Telegram bots in one group — auto-selected with multi-bot',
+      package: 'openclaw-telegram-multibot-relay',
+      hidden: true, // hidden in UI, auto-selected programmatically
+    },
+    {
+      id: 'voice-call',
+      name: 'Voice Call',
+      icon: '📞',
+      descVi: 'Gọi thoại AI qua điện thoại', descEn: 'AI voice calls via phone',
+      package: '@openclaw/voice-call',
+    },
+    {
+      id: 'matrix',
+      name: 'Matrix Chat',
+      icon: '💬',
+      descVi: 'Kết nối thêm kênh Matrix/Element', descEn: 'Connect to Matrix/Element channels',
+      package: '@openclaw/matrix',
+    },
+    {
+      id: 'msteams',
+      name: 'MS Teams',
+      icon: '🏢',
+      descVi: 'Kết nối Microsoft Teams', descEn: 'Connect Microsoft Teams',
+      package: '@openclaw/msteams',
+    },
+    {
+      id: 'nostr',
+      name: 'Nostr',
+      icon: '🟣',
+      descVi: 'Kết nối mạng xã hội Nostr', descEn: 'Connect Nostr social network',
+      package: '@openclaw/nostr',
+    },
+  ];
+

package/setup/data/providers.js

@@ -0,0 +1,121 @@
+// @ts-nocheck
+/* eslint-disable no-undef, no-unused-vars */
+/**
+ * @fileoverview Part of the OpenClaw Setup Wizard IIFE bundle.
+ * This file is concatenated (not imported) — globals are shared via setup.js IIFE scope.
+ * Do NOT add import/export statements. Edit, then run: node build.mjs
+ *
+ * @global {object}  state       - Wizard UI state
+ * @global {object}  PROVIDERS   - AI provider registry
+ * @global {Array}   SKILLS      - Available skills
+ * @global {Array}   PLUGINS     - Available plugins
+ * @global {object}  CHANNELS    - Channel definitions
+ * @global {boolean} isVi        - Vietnamese language mode
+ * @global {object}  provider    - Current primary provider config
+ * @global {boolean} isMultiBot  - Multi-bot mode flag
+ * @global {boolean} hasBrowser  - Browser plugin selected
+ * @global {boolean} is9Router   - 9Router proxy mode
+ * @global {string}  projectDir  - Output project directory path
+ * @global {Function} getGatewayAllowedOrigins
+ */
+  // ========== AI Providers & Models ==========
+  const PROVIDERS = {
+    google: {
+      name: 'Google Gemini',
+      logo: LOGO.gemini,
+      supportsEmbeddings: true,
+      envKey: 'GOOGLE_API_KEY',
+      envLabel: 'Google AI API Key',
+      envLink: 'https://aistudio.google.com/apikey',
+      envInstructionsVi: 'Vào <a href="https://aistudio.google.com/apikey" target="_blank">aistudio.google.com/apikey</a> → Create API Key → Copy', envInstructionsEn: 'Go to <a href="https://aistudio.google.com/apikey" target="_blank">aistudio.google.com/apikey</a> → Create API Key → Copy',
+      free: true,
+      models: [
+        { id: 'google/gemini-2.5-flash', name: 'Gemini 2.5 Flash', descVi: 'Nhanh, miễn phí, đa năng', descEn: 'Fast, free, versatile', badge: '🆓 Free' },
+        { id: 'google/gemini-2.5-pro', name: 'Gemini 2.5 Pro', descVi: 'Thông minh hơn, phân tích sâu', descEn: 'Smarter, deeper analysis', badge: '🆓 Free' },
+        { id: 'google/gemini-3-flash', name: 'Gemini 3 Flash', descVi: 'Thế hệ mới, cực nhanh', descEn: 'Next gen, extremely fast', badge: '🆓 Free' },
+      ],
+    },
+    anthropic: {
+      name: 'Anthropic Claude',
+      logo: LOGO.anthropic,
+      supportsEmbeddings: false,
+      envKey: 'ANTHROPIC_API_KEY',
+      envLabel: 'Anthropic API Key',
+      envLink: 'https://console.anthropic.com/settings/keys',
+      envInstructionsVi: 'Vào <a href="https://console.anthropic.com/settings/keys" target="_blank">console.anthropic.com</a> → Create Key → Copy', envInstructionsEn: 'Go to <a href="https://console.anthropic.com/settings/keys" target="_blank">console.anthropic.com/settings/keys</a> → Create Key → Copy',
+      free: false,
+      models: [
+        { id: 'anthropic/claude-sonnet-4', name: 'Claude Sonnet 4', descVi: 'Cân bằng tốc độ & chất lượng', descEn: 'Balanced speed & quality', badge: '💰 Paid' },
+        { id: 'anthropic/claude-opus-4', name: 'Claude Opus 4', descVi: 'Mạnh nhất, suy luận sâu', descEn: 'Strongest, deep reasoning', badge: '💰 Paid' },
+        { id: 'anthropic/claude-haiku-3.5', name: 'Claude Haiku 3.5', descVi: 'Nhanh, rẻ nhất', descEn: 'Fastest, cheapest', badge: '💰 Paid' },
+      ],
+    },
+    openai: {
+      name: 'OpenAI / Codex',
+      logo: LOGO.openai,
+      supportsEmbeddings: true,
+      envKey: 'OPENAI_API_KEY',
+      envLabel: 'OpenAI API Key',
+      envLink: 'https://platform.openai.com/api-keys',
+      envInstructionsVi: 'Vào <a href="https://platform.openai.com/api-keys" target="_blank">platform.openai.com/api-keys</a> → Create new secret key → Copy. <br><strong>Lưu ý:</strong> Codex models cũng dùng chung API key này.', envInstructionsEn: 'Go to <a href="https://platform.openai.com/api-keys" target="_blank">platform.openai.com/api-keys</a> → Create new secret key → Copy. <br><strong>Note:</strong> Codex models also use this key.',
+      free: false,
+      models: [
+        { id: 'openai/gpt-4o', name: 'GPT-4o', descVi: 'Đa năng, nhanh', descEn: 'Versatile, rapid', badge: '💰 Paid' },
+        { id: 'openai/gpt-4o-mini', name: 'GPT-4o Mini', descVi: 'Rẻ, phù hợp chat', descEn: 'Cheap, good for chat', badge: '💰 Paid' },
+        { id: 'openai/o3', name: 'o3', descVi: 'Suy luận mạnh nhất', descEn: 'Strongest reasoning', badge: '💰 Paid' },
+        { id: 'openai/codex-mini', name: 'Codex Mini', descVi: 'Chuyên code, agent', descEn: 'Optimized for code/agents', badge: '💰 Paid' },
+      ],
+    },
+    openrouter: {
+      name: 'OpenRouter',
+      logo: LOGO.openrouter,
+      supportsEmbeddings: false,
+      envKey: 'OPENROUTER_API_KEY',
+      envLabel: 'OpenRouter API Key',
+      envLink: 'https://openrouter.ai/keys',
+      envInstructionsVi: 'Vào <a href="https://openrouter.ai/keys" target="_blank">openrouter.ai/keys</a> → Create Key → Copy. OpenRouter hỗ trợ nhiều model miễn phí!', envInstructionsEn: 'Go to <a href="https://openrouter.ai/keys" target="_blank">openrouter.ai/keys</a> → Create Key → Copy. OpenRouter provides many free models!',
+      free: true,
+      models: [
+        { id: 'openrouter/google/gemma-3-12b-it:free', name: 'Gemma 3 12B', descVi: 'Google, miễn phí', descEn: 'Google, free', badge: '🆓 Free' },
+        { id: 'openrouter/nvidia/nemotron-nano-9b-v2:free', name: 'Nemotron Nano 9B', descVi: 'NVIDIA, miễn phí', descEn: 'NVIDIA, free', badge: '🆓 Free' },
+        { id: 'openrouter/qwen/qwen3-coder:free', name: 'Qwen 3 Coder', descVi: 'Alibaba, code, miễn phí', descEn: 'Alibaba, code, free', badge: '🆓 Free' },
+      ],
+    },
+    ollama: {
+      name: 'Ollama (Local)',
+      logo: LOGO.ollama,
+      supportsEmbeddings: true,
+      envKey: 'OLLAMA_HOST',
+      envLabel: 'Ollama Host URL',
+      envLink: 'https://ollama.com',
+      envInstructionsVi: 'Cài <a href="https://ollama.com" target="_blank">Ollama</a> → chạy <code>ollama serve</code> → model chạy offline trên máy bạn.', envInstructionsEn: 'Install <a href="https://ollama.com" target="_blank">Ollama</a> → run <code>ollama serve</code> → model will run offline on your machine.',
+      free: true,
+      isLocal: true,
+      models: [
+        { id: 'ollama/gemma4:e2b', name: 'Gemma 4 E2B',   descVi: '🟢 Nhẹ nhất (~4-6 GB RAM) — Edge, laptop, test nhanh', descEn: '🟢 Lightest (~4-6 GB RAM) — Edge, laptop, fastest startup', badge: '🆕 Apr 2 2026' },
+        { id: 'ollama/gemma4:e4b', name: 'Gemma 4 E4B',   descVi: '🟡 Cân bằng (~8-10 GB RAM) — Khuyên dùng', descEn: '🟡 Balanced (~8-10 GB RAM) — Recommended', badge: '🆕 Apr 2 2026' },
+        { id: 'ollama/gemma4:26b', name: 'Gemma 4 26B',   descVi: '🟠 Mạnh (~18-24 GB RAM/VRAM) — Máy mạnh', descEn: '🟠 Powerful (~18-24 GB RAM/VRAM) — High-end machine', badge: '🆕 Apr 2 2026' },
+        { id: 'ollama/gemma4:31b', name: 'Gemma 4 31B',   descVi: '🔴 Mạnh nhất (~24+ GB RAM/VRAM) — Workstation/GPU', descEn: '🔴 Most powerful (~24+ GB RAM/VRAM) — Workstation/GPU', badge: '🆕 Apr 2 2026' },
+        { id: 'ollama/qwen3:8b', name: 'Qwen 3 8B', descVi: 'Đa ngôn ngữ, nhẹ', descEn: 'Multi-lingual, lightweight', badge: '🏠 Local' },
+        { id: 'ollama/deepseek-r1:8b', name: 'DeepSeek R1 8B', descVi: 'Suy luận, code', descEn: 'Reasoning, code', badge: '🏠 Local' },
+        { id: 'ollama/llama3.3:8b', name: 'Llama 3.3 8B', descVi: 'Meta, đa năng', descEn: 'Meta, versatile', badge: '🏠 Local' },
+        { id: 'ollama/gemma3:12b', name: 'Gemma 3 12B', descVi: 'Google, tiếng Việt tốt', descEn: 'Google, great logic', badge: '🏠 Local' },
+      ],
+    },
+    '9router': {
+      name: '9Router (Proxy)',
+      logo: null,
+      logoEmoji: '🔀',
+      supportsEmbeddings: false,
+      envKey: null,
+      envLabel: null,
+      envLink: 'https://github.com/decolua/9router',
+      envInstructionsVi: '9Router chạy cùng Docker — <strong>không cần API key</strong>. Sau khi <code>docker compose up</code>, mở <a href="http://localhost:20128/dashboard" target="_blank">localhost:20128/dashboard</a> → đăng nhập OAuth.<br>✅ <b>Mới v0.3.75:</b> Claude Code, Codex, Gemini CLI và Antigravity có thể dùng 9Router làm endpoint trực tiếp.<br><span style="color:var(--danger)">⚠️ <b>CẢNH BÁO:</b> TUYỆT ĐỐI KHÔNG chọn Provider <b>Antigravity</b> khi đăng nhập OAuth trên dashboard 9Router (nguy cơ bị ban Google Account vĩnh viễn).</span>', envInstructionsEn: '9Router runs with Docker — <strong>no API key needed</strong>. After <code>docker compose up</code>, open <a href="http://localhost:20128/dashboard" target="_blank">localhost:20128/dashboard</a> and OAuth login.<br>✅ <b>New in v0.3.75:</b> Claude Code, Codex, Gemini CLI, and Antigravity can use 9Router as their endpoint directly.<br><span style="color:var(--danger)">⚠️ <b>WARNING:</b> Do NOT select <b>Antigravity</b> as your OAuth Provider when logging into the 9Router dashboard (high risk of permanent Google Account ban).</span>',
+      free: true,
+      isProxy: true,
+      models: [
+        { id: '9router/smart-route', name: 'Smart Proxy (Auto Route)', descVi: 'Tự động luân chuyển FREE models — không tốn xu', descEn: 'Auto-routing across FREE providers — zero cost', badgeVi: '🌟 Khuyên dùng', badgeEn: '🌟 Recommended' }
+      ],
+    },
+  };
+