create-openclaw-bot 5.8.8 → 5.8.10

package/README.md

@@ -3,7 +3,7 @@
 # 🦞 OpenClaw Setup
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.8.8-0EA5E9?style=for-the-badge" alt="Version 5.8.8" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.8.10-0EA5E9?style=for-the-badge" alt="Version 5.8.10" /></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://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>
@@ -23,12 +23,18 @@ A next-generation **Web UI Setup** and management dashboard that automates 100%
 
 ---
 
-## 🆕 What's New in v5.8.8
+## 🆕 What's New in v5.8.10
 
-- 🔄 **Smart Header Update Button**: Instantly upgrades the setup wizard from the UI! The button queries the npm registry dynamically and only reveals itself when a newer release is published.
-- 📡 **Live Log-Streaming Upgrade**: Kicking off the update automatically executes the migration (running `git pull && npm install && npm run build` for Git clones, or `npm install -g create-openclaw-bot` for NPM installs) while streaming standard outputs in real-time straight to the dashboard's Logs terminal.
-- 🧹 **Restructured Dev/Test Environment**: Relocated all noisy build scripts (`build.mjs`, `bump-version.mjs`) and the test suite into the `.gitignore`'d `docs_dev/tests/` directory to preserve clean production builds.
-- ⚙️ **Robust Failure Rollback & Docker Fixes**: Strengthened installation crash recovery by inspecting process exit codes, and resolved dynamic Playwright browser bundle appending inside Dockerfiles.
+### 🚀 New Features: Deep Integration of Infographic Image Generator, Zalo Sticker & Auto-Tag Skills, and Workspace Docs Optimization
+
+- **New: Infographic Poster Generator Skill**: Integrates automatic infographic and poster generation via 9Router API. Automatically generates the helper script `image-generator.js` (synchronizing API credentials from `openclaw.json`) and a comprehensive `SKILL.md` guiding agents on styling rules, Vietnamese font support, layouts, and image generation syntax.
+- **New: Zalo Sticker & Auto-Tag Skill**:
+  - Automatically mentions the active sender in group chats (Agent doesn't need to manually prefix with `@Name` anymore, the system handles it).
+  - Enables agents to dynamically send Zalo stickers by appending `[Sticker: <keyword>]` at the end of their text responses.
+  - Automatically maps emotional keywords (such as `love`, `haha`, `ca khia`, `angry`, `thank you`, etc.) to actual Zalo sticker IDs.
+  - Generates the patch script `mentions.js` and a dedicated `SKILL.md` inside the agent's workspace.
+- **Polish: Simplified TOOLS.md generation**: Streamlined the `TOOLS.md` generator to output a concise, static guide focusing on general principles and referencing the `./skills/` directory, rather than generating dynamic lists based on installed plugins.
+- **Polish: Standardized Reference Docs list in AGENTS.md**: Updated the reference docs list in the generated `AGENTS.md` (for both single and relay variants in Vietnamese and English) to match the new structure, removing obsolete files (`TEAMS.md` for single-bot, `BROWSER.md`) and standardizing descriptions to keep exactly 9 core documents.
 
 <details>
 <summary><b>Previous: What's new in v5.8.0 (Major Release)</b></summary>
@@ -60,14 +66,19 @@ A next-generation **Web UI Setup** and management dashboard that automates 100%
 ## 🗺️ Quick Start
 
 ### 1️⃣ Method 1: Using NPX (Recommended)
+
 Open your terminal and run this single command:
+
 ```bash
 npx create-openclaw-bot
 ```
-*The bootstrapper will automatically download package files, launch the local backend server, and open the Setup UI in your browser.*
+
+_The bootstrapper will automatically download package files, launch the local backend server, and open the Setup UI in your browser._
 
 ### 2️⃣ Method 2: Manual Clone
+
 If you downloaded or cloned the repository files locally:
+
 ```bash
 npm install
 npm start

package/README.vi.md

@@ -3,7 +3,7 @@
 # 🦞 OpenClaw Setup
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.8.8-0EA5E9?style=for-the-badge" alt="Version 5.8.8" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.8.10-0EA5E9?style=for-the-badge" alt="Version 5.8.10" /></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://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>
@@ -23,12 +23,18 @@ Trình cài đặt và quản trị **Web UI Setup** thế hệ mới giúp tự
 
 ---
 
-## 🆕 Có gì mới trong v5.8.8
+## 🆕 Có gì mới trong v5.8.10
 
-- 🔄 **Nút cập nhật Header thông minh**: Nâng cấp trực tiếp setup wizard từ giao diện! Nút cập nhật tự truy vấn npm registry và chỉ hiển thị khi có phiên bản mới hơn.
-- 📡 **Nâng cấp Stream Log trực tiếp**: Khởi chạy cập nhật sẽ tự động nâng cấp (chạy `git pull && npm install && npm run build` cho bản Git, hoặc `npm install -g create-openclaw-bot` cho bản NPM) và đẩy dòng log theo thời gian thực về tab Logs.
-- 🧹 **Tái cấu trúc thư mục Dev/Test**: Di chuyển các file script build (`build.mjs`, `bump-version.mjs`) và thư mục `tests` vào đường dẫn ẩn `.gitignore` là `docs_dev/tests/` giúp bản build gọn gàng hơn.
-- ⚙️ **Tối ưu hóa Rollback lỗi & Docker**: Gia cố xử lý rollback khi cài đặt thất bại thông qua kiểm tra exit code của command, đồng thời sửa lỗi đóng gói thư viện browser trong Dockerfile.
+### 🚀 Tính năng mới: Tích hợp sâu Skill Tạo ảnh Infographic, Skill Sticker & Auto-Tag (Zalo) cùng Tối ưu hóa Workspace Docs
+
+- **Mới: 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.
+- **Mới: Hỗ trợ Skill Sticker & Auto-Tag (Zalo)**:
+  - Tự động tag tên người gửi tin nhắn gần nhất trong group chat Zalo (Agent không cần tự điền `@Tên` ở đầu câu trả lời nữa, hệ thống sẽ tự làm).
+  - Cho phép Agent gửi kèm Sticker Zalo trực tiếp trong câu trả lời thông qua thẻ `[Sticker: <từ_khóa>]` đặt ở cuối tin nhắn.
+  - Tích hợp bộ giải nghĩa từ khóa cảm xúc thông minh (như `love`, `haha`, `ca khia`, `angry`, `thank you`,...) để tự động map sang sticker Zalo phù hợp.
+  - Tự động sinh script vá logic `mentions.js` và tài liệu hướng dẫn `SKILL.md` trong workspace.
+- **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 nằm trong thư mục `./skills/`, loại bỏ các logic sinh danh sách động dựa trên plugin cũ.
+- **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ả.
 
 <details>
 <summary><b>Trước đó: Có gì mới trong v5.8.0 (Bản nâng cấp lớn)</b></summary>

package/dist/server/local-server.js

@@ -19,6 +19,31 @@ const { buildDockerArtifacts } = loadSharedModule('../setup/shared/docker-gen.js
 const { OPENCLAW_NPM_SPEC, NINE_ROUTER_NPM_SPEC, build9RouterProviderConfig, get9RouterBaseUrl } = loadSharedModule('../setup/shared/common-gen.js', '__openclawCommon');
 const dataExport = loadSharedModule('../setup/data/index.js', '__openclawData');
 
+async function syncExecApprovals(projectDir, cfg) {
+  const openclawHome = join(projectDir, '.openclaw');
+  const agentMetas = (cfg.agents?.list || []).map((a) => ({ agentId: a.id }));
+  const approvals = buildExecApprovalsJson({ agentMetas });
+
+  const path1 = join(openclawHome, 'exec-approvals.json');
+  const nestedDir = join(openclawHome, '.openclaw');
+  const path2 = join(nestedDir, 'exec-approvals.json');
+
+  await fsp.mkdir(openclawHome, { recursive: true }).catch(() => {});
+  await fsp.writeFile(path1, JSON.stringify(approvals, null, 2), 'utf8');
+
+  await fsp.mkdir(nestedDir, { recursive: true }).catch(() => {});
+  let existing = {};
+  if (existsSync(path2)) {
+    try {
+      existing = JSON.parse(await fsp.readFile(path2, 'utf8'));
+    } catch (e) {}
+  }
+  if (existing.socket) {
+    approvals.socket = existing.socket;
+  }
+  await fsp.writeFile(path2, JSON.stringify(approvals, null, 2), 'utf8');
+}
+
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const WEB_DIR = resolve(__dirname, '../web');
 const SETUP_VERSION = (() => { try { return JSON.parse(fs.readFileSync(resolve(__dirname, '../../package.json'), 'utf8')).version || '0.0.0'; } catch { return '0.0.0'; } })();
@@ -153,7 +178,9 @@ function recommendedMode(osChoice) {
 function commandExists(cmd, args = ['--version']) {
   return new Promise((resolve) => {
     const shell = process.platform === 'win32';
-    execFile(resolveBinPath(cmd), args, { windowsHide: true, timeout: 5000, shell }, (err, stdout, stderr) => {
+    const rawBin = resolveBinPath(cmd);
+    const bin = shell && rawBin.includes(' ') && !rawBin.startsWith('"') ? `"${rawBin}"` : rawBin;
+    execFile(bin, args, { windowsHide: true, timeout: 5000, shell }, (err, stdout, stderr) => {
       resolve({ ok: !err, output: String(stdout || stderr || '').trim() });
     });
   });
@@ -162,7 +189,10 @@ function commandExists(cmd, args = ['--version']) {
 function run(cmd, args, opts = {}) {
   return new Promise((resolve, reject) => {
     sendLog(`$ ${cmd} ${args.join(' ')}`);
-    const child = spawn(resolveBinPath(cmd), args, { cwd: opts.cwd, shell: process.platform === 'win32', env: { ...process.env, ...(opts.env || {}) } });
+    const shell = process.platform === 'win32';
+    const rawBin = resolveBinPath(cmd);
+    const bin = shell && rawBin.includes(' ') && !rawBin.startsWith('"') ? `"${rawBin}"` : rawBin;
+    const child = spawn(bin, args, { cwd: opts.cwd, shell, env: { ...process.env, ...(opts.env || {}) } });
     let stdout = '';
     let resolved = false;
     child.stdout.on('data', (d) => {
@@ -192,9 +222,12 @@ function run(cmd, args, opts = {}) {
 
 function startDetached(cmd, args, opts = {}) {
   sendLog(`$ ${cmd} ${args.join(' ')} &`);
-  const child = spawn(resolveBinPath(cmd), args, {
+  const shell = process.platform === 'win32';
+  const rawBin = resolveBinPath(cmd);
+  const bin = shell && rawBin.includes(' ') && !rawBin.startsWith('"') ? `"${rawBin}"` : rawBin;
+  const child = spawn(bin, args, {
     cwd: opts.cwd,
-    shell: process.platform === 'win32',
+    shell,
     detached: true,
     stdio: 'ignore',
     windowsHide: opts.windowsHide ?? true,
@@ -253,9 +286,12 @@ async function resolveProjectRuntimeVersions(projectDir, mode = state.mode || 'd
 
 function runStreamed(cmd, args, opts = {}) {
   sendLog(`$ ${cmd} ${args.join(' ')}`);
-  const child = spawn(cmd, args, {
+  const shell = opts.shell ?? process.platform === 'win32';
+  const rawBin = resolveBinPath(cmd);
+  const bin = shell && rawBin.includes(' ') && !rawBin.startsWith('"') ? `"${rawBin}"` : rawBin;
+  const child = spawn(bin, args, {
     cwd: opts.cwd,
-    shell: opts.shell ?? process.platform === 'win32',
+    shell,
     windowsHide: opts.windowsHide ?? true,
     env: { ...process.env, ...(opts.env || {}) },
   });
@@ -268,9 +304,12 @@ function runStreamed(cmd, args, opts = {}) {
 
 function runStreamedToLogFile(cmd, args, logFile, opts = {}) {
   sendLog(`$ ${cmd} ${args.join(' ')}`);
-  const child = spawn(cmd, args, {
+  const shell = opts.shell ?? process.platform === 'win32';
+  const rawBin = resolveBinPath(cmd);
+  const bin = shell && rawBin.includes(' ') && !rawBin.startsWith('"') ? `"${rawBin}"` : rawBin;
+  const child = spawn(bin, args, {
     cwd: opts.cwd,
-    shell: opts.shell ?? process.platform === 'win32',
+    shell,
     windowsHide: opts.windowsHide ?? true,
     env: { ...process.env, ...(opts.env || {}) },
   });
@@ -293,9 +332,12 @@ function runCapture(cmd, args, opts = {}) {
   return new Promise((resolve) => {
     let stdout = '';
     let stderr = '';
-    const child = spawn(resolveBinPath(cmd), args, {
+    const shell = opts.shell ?? process.platform === 'win32';
+    const rawBin = resolveBinPath(cmd);
+    const bin = shell && rawBin.includes(' ') && !rawBin.startsWith('"') ? `"${rawBin}"` : rawBin;
+    const child = spawn(bin, args, {
       cwd: opts.cwd,
-      shell: opts.shell ?? process.platform === 'win32',
+      shell,
       windowsHide: opts.windowsHide ?? true,
       env: { ...process.env, ...(opts.env || {}) },
     });
@@ -947,6 +989,7 @@ async function deleteBotInProject(projectDir, agentId) {
 
   if (existsSync(cfgPath)) await fsp.copyFile(cfgPath, `${cfgPath}.bak`);
   await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
+  await syncExecApprovals(projectDir, cfg);
 
   // Also clear bot tokens in .env files if deleting the primary bot
   if (agentId === 'bot') {
@@ -1098,6 +1141,7 @@ async function createBotInProject(projectDir, body = {}, runtime = {}) {
   validateOpenclawConfig(cfg);
   if (existsSync(cfgPath)) await fsp.copyFile(cfgPath, `${cfgPath}.bak`);
   await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
+  await syncExecApprovals(projectDir, cfg);
 
   const hasScheduler = !!(cfg.tools?.alsoAllow || []).includes('group:automation');
   const hasImageGen = !!(cfg.skills?.entries?.['image-gen']?.enabled);
@@ -1109,7 +1153,7 @@ async function createBotInProject(projectDir, body = {}, runtime = {}) {
     emoji,
     userInfo,
     agentWorkspaceDir: workspaceDir,
-    workspacePath: `.openclaw/${workspaceDir}`,
+    workspacePath: `/home/node/project/.openclaw/${workspaceDir}`,
     channel,
     hasZaloMod: channel === 'zalo-personal',
     hasZaloSticker: channel === 'zalo-personal',
@@ -1175,6 +1219,7 @@ async function updateBotInProject(projectDir, agentId, body = {}, runtime = {})
   validateOpenclawConfig(cfg);
   if (existsSync(cfgPath)) await fsp.copyFile(cfgPath, `${cfgPath}.bak`);
   await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
+  await syncExecApprovals(projectDir, cfg);
 
   // Synchronize the token to .env files for the primary bot to ensure Docker picks it up
   if (agentId === 'bot') {
@@ -1213,7 +1258,7 @@ async function updateBotInProject(projectDir, agentId, body = {}, runtime = {})
     emoji,
     userInfo,
     agentWorkspaceDir: workspaceDir,
-    workspacePath: `.openclaw/${workspaceDir}`,
+    workspacePath: `/home/node/project/.openclaw/${workspaceDir}`,
     channel,
     hasZaloMod: channel === 'zalo-personal',
     hasZaloSticker: channel === 'zalo-personal',
@@ -1731,11 +1776,9 @@ async function writeCoreProject({ projectDir, osChoice, mode, gatewayPort = 1878
   const common = { channelKey: 'telegram', providerKey: '9router', model: DEFAULT_MODEL, deployMode: mode, osChoice, selectedSkills, skills: dataExport.SKILLS || [], agentMetas, gatewayPort, routerPort };
   const cfg = buildOpenclawJson(common);
   const env = buildEnvFileContent({ ...common, apiKey: '', botToken: '' });
-  const approvals = buildExecApprovalsJson({ agentMetas });
-
   await fsp.writeFile(join(openclawHome, 'openclaw.json'), JSON.stringify(cfg, null, 2), 'utf8');
   await fsp.writeFile(join(projectDir, '.env'), env, 'utf8');
-  await fsp.writeFile(join(openclawHome, 'exec-approvals.json'), JSON.stringify(approvals, null, 2), 'utf8');
+  await syncExecApprovals(projectDir, cfg);
 
   if (mode === 'docker') {
     const projectName = slugify(basename(projectDir)) || 'bot';
@@ -2996,10 +3039,13 @@ function restartInstaller() {
         args.push('--no-open');
       }
       
-      const child = spawn(process.argv[0], [entryFile, ...args], {
+      const shell = process.platform === 'win32';
+      const rawBin = process.argv[0];
+      const bin = shell && rawBin.includes(' ') && !rawBin.startsWith('"') ? `"${rawBin}"` : rawBin;
+      const child = spawn(bin, [entryFile, ...args], {
         detached: true,
         stdio: 'inherit',
-        shell: process.platform === 'win32'
+        shell
       });
       child.unref();
       
@@ -3020,7 +3066,7 @@ export async function startLocalInstaller({ host = '127.0.0.1', preferredPort =
   if (openBrowser) openUrl(url);
 }
 
-export { createBotInProject, deleteBotInProject, validateOpenclawConfig, startZaloUserLogin, readBotCredentials, resolveProject9RouterApiKey };
+export { createBotInProject, updateBotInProject, deleteBotInProject, validateOpenclawConfig, startZaloUserLogin, readBotCredentials, resolveProject9RouterApiKey };