create-openclaw-bot 5.4.1 → 5.5.0

package/setup/data/skills.js

@@ -0,0 +1,169 @@
+// @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 Skills (ClawHub registry — agent capabilities) ==========
+  const SKILLS = [
+    {
+      id: 'browser',
+      name: 'Browser Automation ⭐(Khuyên dùng)',
+      icon: '🌐',
+      descVi: 'Tự động thao tác trình duyệt (Playwright)', descEn: 'Automated browser control (Playwright)',
+      slug: 'browser-automation',
+      noteVi: 'Cần bật Chrome Debug Mode trên máy host', noteEn: 'Requires Chrome Debug Mode on host',
+    },
+    {
+      id: 'memory',
+      name: 'Long-term Memory ⭐(Khuyên dùng)',
+      icon: '🧠',
+      descVi: 'Nhớ hội thoại xuyên phiên, context dài hạn', descEn: 'Cross-session memory, long-term context',
+      slug: 'memory',
+    },
+    {
+      id: 'scheduler',
+      name: 'Native Cron Scheduler ⭐(Khuyên dùng)',
+      icon: '⏰',
+      descVi: 'Gọi Cron gốc trên nền tảng (không tải qua HUB)', descEn: 'Native Cron background jobs (No skill download)',
+    },
+    {
+      id: 'rag',
+      name: 'RAG / Knowledge Base',
+      icon: '📚',
+      descVi: 'Chat với tài liệu, file PDF, codebase', descEn: 'Chat with docs, PDFs, codebase',
+      slug: 'rag',
+      noteVi: 'Đặt file vào thư mục .openclaw/docs/', noteEn: 'Put files in .openclaw/docs/ folder',
+    },
+    {
+      id: 'image-gen',
+      name: 'Image Generation',
+      icon: '🎨',
+      descVi: 'Tạo ảnh bằng AI (DALL·E, Flux, Midjourney...)', descEn: 'Generate images via AI (DALL-E, Flux, Midjourney...)',
+      slug: 'image-gen',
+      noteVi: 'Dùng chung OPENAI_API_KEY (DALL-E) hoặc thêm FLUX_API_KEY', noteEn: 'Uses OPENAI_API_KEY (DALL-E) or FLUX_API_KEY',
+      envVars: ['# FLUX_API_KEY=<your_flux_key>  # chỉ cần nếu dùng Flux'],
+    },
+    {
+      id: 'code-interpreter',
+      name: 'Code Interpreter',
+      icon: '💻',
+      descVi: 'Chạy code Python/JS trong sandbox', descEn: 'Run Python/JS code in sandbox',
+      slug: 'code-interpreter',
+    },
+    {
+      id: 'email',
+      name: 'Email Assistant',
+      icon: '📧',
+      descVi: 'Quản lý, soạn, tóm tắt email (Gmail, Outlook...)', descEn: 'Manage, compose, summarize emails (Gmail, Outlook...)',
+      slug: 'email-assistant',
+      noteVi: 'Cần cấu hình SMTP trong .env', noteEn: 'Requires SMTP configuration in .env',
+      envVars: ['SMTP_HOST=smtp.gmail.com', 'SMTP_PORT=587', 'SMTP_USER=<your_email>', 'SMTP_PASS=<your_app_password>'],
+    },
+    {
+      id: 'web-search',
+      name: 'Web Search',
+      icon: '🔍',
+      descVi: 'Tìm kiếm web thời gian thực (DuckDuckGo) — không cần API key', descEn: 'Real-time web search (DuckDuckGo) — no API key needed',
+      slug: 'web-search',
+    },
+    {
+      id: 'notion',
+      name: 'Notion',
+      icon: '📓',
+      descVi: 'Tạo, chỉnh sửa trang và database Notion', descEn: 'Create and edit Notion pages and databases',
+      slug: 'notion',
+      noteVi: 'Cần Notion Integration Token', noteEn: 'Requires Notion Integration Token',
+      envVars: ['NOTION_API_KEY=<your_notion_integration_token>'],
+    },
+    {
+      id: 'slack',
+      name: 'Slack',
+      icon: '🗨️',
+      descVi: 'Gửi tin, react, ghim tin nhắn trong Slack', descEn: 'Send messages, react, pin items in Slack',
+      slug: 'slack',
+      noteVi: 'Cần Slack Bot Token', noteEn: 'Requires Slack Bot Token',
+      envVars: ['SLACK_BOT_TOKEN=<your_slack_bot_token>'],
+    },
+  ];
+
+  function providerSupportsMemoryEmbeddings(providerKey) {
+    const provider = PROVIDERS[providerKey];
+    if (!provider) return false;
+    return !!provider.supportsEmbeddings;
+  }
+
+  function getSkillDisplayName(skill, providerKey, lang) {
+    const normalizedName = String(skill.name || '')
+      .replace(/\s*[⭐🌟]\s*\((Khuyên dùng|Recommended)\)\s*/gi, '')
+      .replace(/\s*[⭐🌟]\s*(Khuyên dùng|Recommended)\s*/gi, '')
+      .trim();
+    if (skill.id === 'memory') {
+      return 'Long-term Memory';
+    }
+    return normalizedName;
+  }
+
+  function getSkillBadge(skill, providerKey, lang) {
+    const isVi = lang !== 'en';
+    if (skill.id === 'memory' && providerSupportsMemoryEmbeddings(providerKey)) {
+      return {
+        text: isVi ? 'Khuyên dùng' : 'Recommended',
+        className: 'plugin-card__badge plugin-card__badge--recommended'
+      };
+    }
+    if (skill.id === 'browser' || skill.id === 'scheduler') {
+      return {
+        text: isVi ? 'Khuyên dùng' : 'Recommended',
+        className: 'plugin-card__badge plugin-card__badge--recommended'
+      };
+    }
+    return null;
+  }
+
+  function getSkillExtraNote(skill, providerKey, lang) {
+    const isVi = lang !== 'en';
+    const baseNote = isVi ? (skill.noteVi || skill.note || '') : (skill.noteEn || skill.note || '');
+    if (skill.id !== 'memory' || providerSupportsMemoryEmbeddings(providerKey)) {
+      return baseNote;
+    }
+    const providerName = PROVIDERS[providerKey]?.name || providerKey;
+    const memoryNote = isVi
+      ? `Provider hiện tại (${providerName}) chưa có đường embeddings được xác nhận trong wizard, nên memory search sẽ không được gắn khuyên dùng.`
+      : `The current provider (${providerName}) does not have a confirmed embeddings path in the wizard, so memory search is not marked recommended.`;
+    return baseNote ? `${baseNote} ${memoryNote}` : memoryNote;
+  }
+
+  function escapeHtml(text) {
+    return String(text || '')
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#39;');
+  }
+
+  function getSkillTooltipContent(skill, providerKey, lang) {
+    const desc = lang === 'vi' ? (skill.descVi || skill.desc || '') : (skill.descEn || skill.desc || '');
+    const note = getSkillExtraNote(skill, providerKey, lang);
+    return [desc, note].filter(Boolean).join('\n\n');
+  }
+
+  function getPluginTooltipContent(plugin, lang) {
+    return lang === 'vi' ? (plugin.descVi || plugin.desc || '') : (plugin.descEn || plugin.desc || '');
+  }
+

package/setup/shared/common-gen.js

@@ -0,0 +1,223 @@
+// @ts-nocheck
+(function (root) {
+  const OPENCLAW_NPM_SPEC = 'openclaw@2026.4.14';
+  const OPENCLAW_RUNTIME_PACKAGES = 'grammy @grammyjs/runner @grammyjs/transformer-throttler @buape/carbon @larksuiteoapi/node-sdk @slack/web-api';
+  const TELEGRAM_RELAY_PLUGIN_SPEC = 'openclaw-telegram-multibot-relay';
+
+  function buildRelayPluginInstallCommand(prefix = 'openclaw') {
+    return `${prefix} plugins install ${TELEGRAM_RELAY_PLUGIN_SPEC} 2>/dev/null || true`;
+  }
+
+  function buildRelayPluginInstallCommandWin(prefix = 'openclaw') {
+    return `${prefix} plugins install ${TELEGRAM_RELAY_PLUGIN_SPEC} || exit /b 0`;
+  }
+
+  function buildTelegramPostInstallChecklist(options = {}) {
+    const {
+      isVi = true,
+      bots = [],
+      groupId = '',
+      relayPluginSpec = TELEGRAM_RELAY_PLUGIN_SPEC,
+      includeTokenPreview = false,
+    } = options;
+    const botList = bots.map((bot, idx) => {
+      const name = bot?.name || `Bot ${idx + 1}`;
+      if (includeTokenPreview) {
+        return `- **${name}** — token: ${String(bot?.token || '').slice(0, 10)}...`;
+      }
+      return `- **${name}**`;
+    }).join('\n');
+
+    if (isVi) {
+      return `# Telegram Post-Install Checklist
+
+Bot da duoc cai dat. Thuc hien cac buoc sau de hoat dong trong group.
+
+## Group ID
+- ${groupId ? `Group ID: ${groupId}` : 'Chua nhap Group ID - bot se hoat dong o moi group.'}
+
+## Danh sach bot
+${botList}
+
+---
+
+## Buoc 1 -- Tat Privacy Mode tren BotFather (bat buoc, lam truoc)
+
+Mac dinh bot chi doc tin nhan bat dau bang /. Phai tat Privacy Mode thi bot moi doc duoc tat ca tin nhan trong group.
+
+Lam lan luot cho TUNG BOT:
+1. Mo Telegram, tim @BotFather
+2. Gui: /mybots
+3. Chon bot can sua
+4. Chon: Bot Settings
+5. Chon: Group Privacy
+6. Chon: Turn off
+7. BotFather se bao: "Privacy mode is disabled for ..."
+
+!!! QUAN TRONG: Phai lam buoc nay TRUOC khi add bot vao group. Neu bot da o trong group roi thi phai Remove bot ra, sau do Add lai.
+
+## Buoc 2 -- Add bot vao group
+
+Sau khi tat Privacy Mode cho ALL bot:
+1. Mo group Telegram cua ban
+2. Vao Settings -> Members -> Add Members
+3. Tim ten tung bot theo username (VD: @TenCuaBot) va add vao
+4. Sau khi add, vao Settings -> Administrators
+5. Promote tung bot len Admin (can quyen phan hoi, co the de mac dinh)
+
+Lay username that cua bot: vao @BotFather -> /mybots -> chon bot -> username la chu sau @.
+
+## Buoc 3 -- Lay Group ID (neu chua co)
+
+1. Them @userinfobot vao group nhu admin
+2. Go /start hoac forward bat ky tin nhan trong group cho @userinfobot
+3. Bot tra ve Chat ID bat dau bang -100...
+4. Dat gia tri do vao TELEGRAM_GROUP_ID trong file .env
+
+## Buoc 4 -- Cai plugin (neu chua cai duoc tu dong)
+
+Neu trong qua trinh setup bao loi cai plugin, sau khi bot dang chay hay chay:
+
+  openclaw plugins install ${relayPluginSpec}
+
+## Buoc 5 -- Test
+
+1. Gui tin nhan trong group, mention bot: @TenCuaBot xin chao
+2. Bot se phan hoi
+3. Neu khong phan hoi: kiem tra lai Buoc 1 (Privacy Mode) va Buoc 2 (add lai sau khi tat privacy)
+
+---
+*Generated by OpenClaw Setup*
+`;
+    }
+
+    return `# Telegram Post-Install Checklist
+
+Bots are installed. Complete the steps below to activate them in a group.
+
+## Group ID
+- ${groupId ? `Group ID: ${groupId}` : 'No Group ID - bots will respond in any group.'}
+
+## Bot list
+${botList}
+
+---
+
+## Step 1 -- Disable Privacy Mode on BotFather (required, do this first)
+
+By default bots only read messages starting with /. You must disable Privacy Mode so bots can read all group messages.
+
+Do this for EACH BOT:
+1. Open Telegram, find @BotFather
+2. Send: /mybots
+3. Select the bot
+4. Choose: Bot Settings
+5. Choose: Group Privacy
+6. Choose: Turn off
+7. BotFather confirms: "Privacy mode is disabled for ..."
+
+!!! IMPORTANT: Do this BEFORE adding the bot to the group. If the bot is already in the group, remove it first then re-add it.
+
+## Step 2 -- Add bots to the group
+
+After disabling Privacy Mode for ALL bots:
+1. Open your Telegram group
+2. Go to Settings -> Members -> Add Members
+3. Search each bot by username (e.g. @YourBotUsername) and add it
+4. Go to Settings -> Administrators
+5. Promote each bot to Admin
+
+To get each bot's real username: open @BotFather -> /mybots -> select bot -> username after @.
+
+## Step 3 -- Get Group ID (if not already set)
+
+1. Add @userinfobot to the group as admin
+2. Send /start or forward any group message to @userinfobot
+3. It returns a Chat ID starting with -100...
+4. Set that value as TELEGRAM_GROUP_ID in your .env file
+
+## Step 4 -- Install plugin (if auto-install failed)
+
+If setup reported a plugin install error, run this after the bot is running:
+
+  openclaw plugins install ${relayPluginSpec}
+
+## Step 5 -- Test
+
+1. Send a message in the group mentioning the bot: @YourBotUsername hello
+2. The bot should respond
+3. No response? Re-check Step 1 (Privacy Mode) and Step 2 (re-add bot after disabling privacy)
+
+---
+*Generated by OpenClaw Setup*
+`;
+  }
+
+  function buildAuthProfilesJson(options = {}) {
+    const {
+      providerKey = '',
+      provider = {},
+      apiKey = '',
+      isProxy = false,
+      isLocal = false,
+      localUrl = 'http://ollama:11434',
+      proxyKey = 'sk-no-key',
+    } = options;
+
+    if (isLocal) {
+      return {
+        version: 1,
+        profiles: {
+          'ollama:default': {
+            provider: 'ollama',
+            type: 'api_key',
+            key: 'ollama-local',
+            url: localUrl,
+          },
+        },
+        order: { ollama: ['ollama:default'] },
+      };
+    }
+
+    const authProviderName = isProxy ? '9router' : providerKey;
+    const authProfileId = isProxy ? '9router-proxy' : `${authProviderName}:default`;
+    const authKeyValue = isProxy
+      ? proxyKey
+      : (apiKey || `<your_${(provider.envKey || 'API_KEY').toLowerCase()}>`);
+    const json = {
+      version: 1,
+      profiles: {
+        [authProfileId]: {
+          provider: authProviderName,
+          type: 'api_key',
+          key: authKeyValue,
+        },
+      },
+      order: { [authProviderName]: [authProfileId] },
+    };
+
+    if (!isProxy && providerKey !== 'openai' && provider.baseURL) {
+      json.profiles[authProfileId].url = provider.baseURL;
+    }
+    return json;
+  }
+
+  function buildAuthProfilesString(options = {}) {
+    return JSON.stringify(buildAuthProfilesJson(options), null, 2);
+  }
+
+  root.__openclawCommon = {
+    OPENCLAW_NPM_SPEC,
+    OPENCLAW_RUNTIME_PACKAGES,
+    TELEGRAM_RELAY_PLUGIN_SPEC,
+    buildRelayPluginInstallCommand,
+    buildRelayPluginInstallCommandWin,
+    buildTelegramPostInstallChecklist,
+    buildAuthProfilesJson,
+    buildAuthProfilesString,
+  };
+
+})(typeof globalThis !== 'undefined' ? globalThis : {});
+if (typeof exports !== 'undefined' && typeof globalThis !== 'undefined' && globalThis.__openclawCommon) {
+  Object.assign(exports, globalThis.__openclawCommon);
+}