create-openclaw-bot 5.8.1 → 5.8.3

package/dist/setup/shared/docker-gen.js

@@ -204,6 +204,7 @@ if(touched){console.log('[patch-9router] Applied Codex compatibility patch.');}e
       is9Router,
       isLocal,
       isMultiBot,
+      hasBrowser = false,
       selectedModel,
       agentId,
       allSkills = [],
@@ -321,6 +322,10 @@ if(touched){console.log('[patch-9router] Applied Codex compatibility patch.');}e
     ].join('\n'));
     runtimeParts.push('openclaw gateway run');
     const runtimeScript = ['#!/bin/sh', 'set -e', ...runtimeParts].join('\n');
+    let browserInstall = '';
+    if (hasBrowser) {
+      browserInstall = '\n# Install browser and system dependencies for Playwright\nRUN npx playwright install-deps chromium && npx playwright install chromium\n';
+    }
     const dockerfile = `FROM node:22-slim
 
 RUN apt-get update && apt-get install -y git curl python3 && rm -rf /var/lib/apt/lists/*
@@ -328,7 +333,7 @@ RUN apt-get update && apt-get install -y git curl python3 && rm -rf /var/lib/apt
 ARG OPENCLAW_VER="${openClawNpmSpec}"
 ARG CACHE_BUST=""
 RUN echo "CACHE_BUST=$CACHE_BUST" && npm install -g $OPENCLAW_VER ${openClawRuntimePackages}${skillLines}${pluginLines}
-${patchLine}
+${patchLine}${browserInstall}
 
 COPY entrypoint.sh /usr/local/bin/openclaw-entrypoint.sh
 RUN chmod +x /usr/local/bin/openclaw-entrypoint.sh

package/dist/setup/shared/workspace-gen.js

@@ -628,9 +628,13 @@ node ${btPath} close_tab 2`;
       ? (isVi
         ? `\n\n## \u23F0 Cron / Lên lịch nhắc nhở (tool: \`cron\`)
 - **Tên tool chính xác:** Tên công cụ là \`cron\` (tuyệt đối không nhầm là \`native\` hay command line bên ngoài).
+- **⛔ TUYỆT ĐỐI KHÔNG sửa trực tiếp file JSON** như \`jobs.json\`, \`jobs-state.json\` trong thư mục \`.openclaw/cron/\`. Dữ liệu cron được lưu trong SQLite database, file JSON chỉ là legacy format đã ngưng hỗ trợ. Mọi thao tác PHẢI thông qua tool \`cron\`.
 - **Khi tạo cronjob mới (action \`add\`):**
   - **TUYỆT ĐỐI KHÔNG điền trường \`agentId\`** trong object \`job\` (hãy bỏ qua/omitted trường này). Hệ thống OpenClaw sẽ tự động gán chính xác ID của bạn vào job đó.
   - Tuyệt đối **không tự điền** \`agentId\` là \`"bot"\` hay \`"main"\`, vì làm vậy sẽ khiến cronjob thuộc về agent khác và bạn sẽ mất quyền kiểm soát/xóa nó sau này.
+  - **Session:** Luôn dùng \`sessionTarget: "isolated"\` cho các job chạy nền (báo cáo, nhắc nhở, gửi tin nhắn tự động). Chỉ dùng \`"main"\` cho system event/reminder ngắn.
+  - **Timezone:** Luôn chỉ định timezone rõ ràng bằng trường \`tz\` (ví dụ: \`"Asia/Ho_Chi_Minh"\`). Nếu không chỉ định, hệ thống sẽ dùng timezone của Gateway host (thường là UTC) và job sẽ chạy sai giờ.
+  - **Delivery:** Đối với job cần gửi kết quả ra chat, set \`delivery.mode: "announce"\` kèm \`delivery.channel\` và \`delivery.to\`.
 - **Khi user yêu cầu tắt/bật/xóa cronjob:**
   1. **Bước 1 (Tìm kiếm):** Gọi tool \`cron\` với action \`list\` (và \`includeDisabled: true\`) để xem danh sách tất cả cronjob đang chạy trên hệ thống và tìm đúng \`jobId\` phù hợp với yêu cầu.
   2. **Bước 2 (Xử lý):**
@@ -640,13 +644,18 @@ node ${btPath} close_tab 2`;
   3. **Tuyên bố trung thực:** Tuyệt đối không bao giờ trả lời "đã xóa" hay "không có" dựa trên suy đoán của bản thân mà chưa gọi tool \`cron\` để kiểm tra thực tế.
 - Khi user yêu cầu tạo nhắc nhở / lệnh tự động định kỳ, bạn hãy TỰ ĐỘNG dùng tool \`cron\` (action \`add\`) để tạo. **Tuyệt đối không** bắt user dùng crontab hay Task Scheduler chạy tay trên host.
 - Khi thao tác tool cho cron/scheduler, **không điền \`current\` vào thư mục Session**.
-- **QUAN TRỌNG VỀ TARGETING GROUP CHAT**: Khi tạo hoặc cấu hình cron job gửi tin nhắn thông báo (announce mode) đến một Group Chat, giá trị của trường \`delivery.to\` **bắt buộc** phải sử dụng tiền tố \`group:\` trước ID của group (ví dụ: \`group:3815464776067464419\` hoặc \`group:xxxx\`). Tuyệt đối không được chỉ điền ID thuần túy vì hệ thống sẽ hiểu nhầm đó là một DM chat cá nhân (direct message) và gửi sai địa chỉ.
+- **QUAN TRỌNG VỀ TARGETING GROUP CHAT**: Khi tạo hoặc cấu hình cron job gửi tin nhắn thông báo (announce mode) đến một Group Chat, giá trị của trường \`delivery.to\` **bắt buộc** phải sử dụng tiền tố thích hợp trước ID của group. Với kênh Telegram/Matrix/Discord/Slack, dùng tiền tố \`group:\` (ví dụ: \`group:123456\`). RIÊNG với kênh Zalo (\`zalouser\`), **bắt buộc** phải sử dụng tiền tố \`g:\` (ví dụ: \`g:3815464776067464419\`) để tránh bị OpenClaw core lược bỏ tiền tố và gửi nhầm vào DM chat cá nhân.
+- **One-shot job:** Dùng schedule kind \`"at"\` với ISO 8601 timestamp. Job sẽ tự xóa sau khi chạy thành công trừ khi set \`deleteAfterRun: false\`.
 - Bỏ qua việc tra cứu docs nội bộ như \`cron-jobs.mdx\`; tin tưởng khả năng dùng tool hiện có để hoàn thành yêu cầu.`
         : `\n\n## \u23F0 Cron / Scheduled Tasks (tool: \`cron\`)
 - **Exact tool name:** The tool name is \`cron\` (never mistake it for \`native\` or external command lines).
+- **⛔ NEVER edit JSON files directly** such as \`jobs.json\` or \`jobs-state.json\` in \`.openclaw/cron/\`. Cron data is stored in SQLite database; JSON files are legacy format no longer supported. All operations MUST go through the \`cron\` tool.
 - **When creating a new cronjob (action \`add\`):**
   - **ABSOLUTELY DO NOT specify the \`agentId\` field** in the \`job\` object (leave this field omitted). The OpenClaw system will automatically assign your correct agent ID to that job.
   - Never manually specify \`agentId\` as \`"bot"\` or \`"main"\`, as this will cause the cronjob to belong to another agent and you will lose control to manage/delete it later.
+  - **Session:** Always use \`sessionTarget: "isolated"\` for background jobs (reports, reminders, automated messages). Only use \`"main"\` for short system events/reminders.
+  - **Timezone:** Always specify timezone explicitly via the \`tz\` field (e.g., \`"Asia/Ho_Chi_Minh"\`). If omitted, the system uses the Gateway host timezone (often UTC) and the job will run at the wrong time.
+  - **Delivery:** For jobs that should send results to chat, set \`delivery.mode: "announce"\` with \`delivery.channel\` and \`delivery.to\`.
 - **When the user requests to disable/enable/delete a cronjob:**
   1. **Step 1 (Search):** Call the \`cron\` tool with action \`list\` (and \`includeDisabled: true\`) to view all cron jobs on the system and find the matching \`jobId\`.
   2. **Step 2 (Processing):**
@@ -656,7 +665,8 @@ node ${btPath} close_tab 2`;
   3. **Honest statement:** Never claim a job is "deleted" or "not found" based on guessing without calling the \`cron\` tool to verify the actual state.
 - When the user asks to schedule tasks or reminders, use the built-in \`cron\` tool (action \`add\`) automatically. Do NOT ask users to run crontab or Task Scheduler manually on the host.
 - When operating cron/scheduler tools, do **not** put \`current\` into the Session directory.
-- **IMPORTANT ABOUT GROUP CHAT TARGETING**: When creating or configuring a cron job to send messages (announce mode) to a Group Chat, the value of the \`delivery.to\` field **must** use the \`group:\` prefix before the group ID (e.g., \`group:3815464776067464419\` or \`group:xxxx\`). Never specify just the numeric ID, as the system will interpret it as a private DM and deliver to the wrong destination.
+- **IMPORTANT ABOUT GROUP CHAT TARGETING**: When creating or configuring a cron job to send messages (announce mode) to a Group Chat, the value of the \`delivery.to\` field **must** use the appropriate prefix before the group ID. For Telegram/Matrix/Discord/Slack, use the \`group:\` prefix (e.g., \`group:123456\`). ESPECIALLY for Zalo (\`zalouser\`), you **must** use the \`g:\` prefix (e.g., \`g:3815464776067464419\`) to prevent the OpenClaw core from stripping the prefix and misrouting the message to a private DM.
+- **One-shot jobs:** Use schedule kind \`"at"\` with an ISO 8601 timestamp. The job auto-deletes after successful run unless \`deleteAfterRun: false\` is set.
 - Skip internal doc lookups such as \`cron-jobs.mdx\`; rely on the available tools and complete the scheduling task directly.`)
       : '';
 

package/dist/setup.js

@@ -1,13 +1,13 @@
 /* ============================================
-   OpenClaw Setup Wizard — Logic v2
+   OpenClaw Setup Wizard — Logic v2
    Multi-model, Multi-plugin, Multi-channel
    ============================================ */
-// AUTO-GENERATED by build.mjs — edit files in src/setup/ instead
+// AUTO-GENERATED by build.mjs — edit files in src/setup/ instead
 
 (function () {
   'use strict';
 
-  // ── Globals: CDN logos, state, shared utils (setup/data/header.js) ─
+  // ── ── Globals: CDN logos, state, shared utils (setup/data/header.js) ──
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -89,7 +89,7 @@
     return Array.from(origins);
   }
 
-  // ── PROVIDERS object (setup/data/providers.js) ─────────────────────
+  // ── ── PROVIDERS object (setup/data/providers.js) ──────────────────────────────────────────
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -212,7 +212,7 @@
   };
 
 
-  // ── CHANNELS, system prompts, security rules (setup/data/channels.js) 
+  // ── ── CHANNELS, system prompts, security rules (setup/data/channels.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -383,7 +383,7 @@
 - ✅ Limit exposed ports (only 38789)`,
   };
 
-  // ── PLUGINS list (setup/data/plugins.js) ───────────────────────────
+  // ── ── PLUGINS list (setup/data/plugins.js) ──────────────────────────────────────────────────────
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -452,7 +452,7 @@
   ];
 
 
-  // ── SKILLS list (setup/data/skills.js) ─────────────────────────────
+  // ── ── SKILLS list (setup/data/skills.js) ──────────────────────────────────────────────────────────
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -615,7 +615,7 @@
   }
 
 
-  // ── Shared runtime constants, relay helpers, auth profile builders (setup/shared/common-gen.js) 
+  // ── ── Shared runtime constants, relay helpers, auth profile builders (setup/shared/common-gen.js) 
 // @ts-nocheck
 (function (root) {
   const OPENCLAW_NPM_SPEC = 'openclaw@latest';
@@ -930,7 +930,7 @@ if (typeof exports !== 'undefined' && typeof globalThis !== 'undefined' && globa
   Object.assign(exports, globalThis.__openclawCommon);
 }
 
-  // ── Shared workspace file builders (IDENTITY, SOUL, AGENTS, TOOLS, TEAMS...) (setup/shared/workspace-gen.js) 
+  // ── ── Shared workspace file builders (IDENTITY, SOUL, AGENTS, TOOLS, TEAMS...) (setup/shared/workspace-gen.js) 
 /** @typedef {typeof globalThis & { __openclawWorkspace?: Record<string, Function> }} OpenClawWorkspaceRoot */
 
 const workspaceRoot = /** @type {OpenClawWorkspaceRoot} */ (
@@ -1561,9 +1561,13 @@ node ${btPath} close_tab 2`;
       ? (isVi
         ? `\n\n## \u23F0 Cron / Lên lịch nhắc nhở (tool: \`cron\`)
 - **Tên tool chính xác:** Tên công cụ là \`cron\` (tuyệt đối không nhầm là \`native\` hay command line bên ngoài).
+- **⛔ TUYỆT ĐỐI KHÔNG sửa trực tiếp file JSON** như \`jobs.json\`, \`jobs-state.json\` trong thư mục \`.openclaw/cron/\`. Dữ liệu cron được lưu trong SQLite database, file JSON chỉ là legacy format đã ngưng hỗ trợ. Mọi thao tác PHẢI thông qua tool \`cron\`.
 - **Khi tạo cronjob mới (action \`add\`):**
   - **TUYỆT ĐỐI KHÔNG điền trường \`agentId\`** trong object \`job\` (hãy bỏ qua/omitted trường này). Hệ thống OpenClaw sẽ tự động gán chính xác ID của bạn vào job đó.
   - Tuyệt đối **không tự điền** \`agentId\` là \`"bot"\` hay \`"main"\`, vì làm vậy sẽ khiến cronjob thuộc về agent khác và bạn sẽ mất quyền kiểm soát/xóa nó sau này.
+  - **Session:** Luôn dùng \`sessionTarget: "isolated"\` cho các job chạy nền (báo cáo, nhắc nhở, gửi tin nhắn tự động). Chỉ dùng \`"main"\` cho system event/reminder ngắn.
+  - **Timezone:** Luôn chỉ định timezone rõ ràng bằng trường \`tz\` (ví dụ: \`"Asia/Ho_Chi_Minh"\`). Nếu không chỉ định, hệ thống sẽ dùng timezone của Gateway host (thường là UTC) và job sẽ chạy sai giờ.
+  - **Delivery:** Đối với job cần gửi kết quả ra chat, set \`delivery.mode: "announce"\` kèm \`delivery.channel\` và \`delivery.to\`.
 - **Khi user yêu cầu tắt/bật/xóa cronjob:**
   1. **Bước 1 (Tìm kiếm):** Gọi tool \`cron\` với action \`list\` (và \`includeDisabled: true\`) để xem danh sách tất cả cronjob đang chạy trên hệ thống và tìm đúng \`jobId\` phù hợp với yêu cầu.
   2. **Bước 2 (Xử lý):**
@@ -1573,13 +1577,18 @@ node ${btPath} close_tab 2`;
   3. **Tuyên bố trung thực:** Tuyệt đối không bao giờ trả lời "đã xóa" hay "không có" dựa trên suy đoán của bản thân mà chưa gọi tool \`cron\` để kiểm tra thực tế.
 - Khi user yêu cầu tạo nhắc nhở / lệnh tự động định kỳ, bạn hãy TỰ ĐỘNG dùng tool \`cron\` (action \`add\`) để tạo. **Tuyệt đối không** bắt user dùng crontab hay Task Scheduler chạy tay trên host.
 - Khi thao tác tool cho cron/scheduler, **không điền \`current\` vào thư mục Session**.
-- **QUAN TRỌNG VỀ TARGETING GROUP CHAT**: Khi tạo hoặc cấu hình cron job gửi tin nhắn thông báo (announce mode) đến một Group Chat, giá trị của trường \`delivery.to\` **bắt buộc** phải sử dụng tiền tố \`group:\` trước ID của group (ví dụ: \`group:3815464776067464419\` hoặc \`group:xxxx\`). Tuyệt đối không được chỉ điền ID thuần túy vì hệ thống sẽ hiểu nhầm đó là một DM chat cá nhân (direct message) và gửi sai địa chỉ.
+- **QUAN TRỌNG VỀ TARGETING GROUP CHAT**: Khi tạo hoặc cấu hình cron job gửi tin nhắn thông báo (announce mode) đến một Group Chat, giá trị của trường \`delivery.to\` **bắt buộc** phải sử dụng tiền tố thích hợp trước ID của group. Với kênh Telegram/Matrix/Discord/Slack, dùng tiền tố \`group:\` (ví dụ: \`group:123456\`). RIÊNG với kênh Zalo (\`zalouser\`), **bắt buộc** phải sử dụng tiền tố \`g:\` (ví dụ: \`g:3815464776067464419\`) để tránh bị OpenClaw core lược bỏ tiền tố và gửi nhầm vào DM chat cá nhân.
+- **One-shot job:** Dùng schedule kind \`"at"\` với ISO 8601 timestamp. Job sẽ tự xóa sau khi chạy thành công trừ khi set \`deleteAfterRun: false\`.
 - Bỏ qua việc tra cứu docs nội bộ như \`cron-jobs.mdx\`; tin tưởng khả năng dùng tool hiện có để hoàn thành yêu cầu.`
         : `\n\n## \u23F0 Cron / Scheduled Tasks (tool: \`cron\`)
 - **Exact tool name:** The tool name is \`cron\` (never mistake it for \`native\` or external command lines).
+- **⛔ NEVER edit JSON files directly** such as \`jobs.json\` or \`jobs-state.json\` in \`.openclaw/cron/\`. Cron data is stored in SQLite database; JSON files are legacy format no longer supported. All operations MUST go through the \`cron\` tool.
 - **When creating a new cronjob (action \`add\`):**
   - **ABSOLUTELY DO NOT specify the \`agentId\` field** in the \`job\` object (leave this field omitted). The OpenClaw system will automatically assign your correct agent ID to that job.
   - Never manually specify \`agentId\` as \`"bot"\` or \`"main"\`, as this will cause the cronjob to belong to another agent and you will lose control to manage/delete it later.
+  - **Session:** Always use \`sessionTarget: "isolated"\` for background jobs (reports, reminders, automated messages). Only use \`"main"\` for short system events/reminders.
+  - **Timezone:** Always specify timezone explicitly via the \`tz\` field (e.g., \`"Asia/Ho_Chi_Minh"\`). If omitted, the system uses the Gateway host timezone (often UTC) and the job will run at the wrong time.
+  - **Delivery:** For jobs that should send results to chat, set \`delivery.mode: "announce"\` with \`delivery.channel\` and \`delivery.to\`.
 - **When the user requests to disable/enable/delete a cronjob:**
   1. **Step 1 (Search):** Call the \`cron\` tool with action \`list\` (and \`includeDisabled: true\`) to view all cron jobs on the system and find the matching \`jobId\`.
   2. **Step 2 (Processing):**
@@ -1589,7 +1598,8 @@ node ${btPath} close_tab 2`;
   3. **Honest statement:** Never claim a job is "deleted" or "not found" based on guessing without calling the \`cron\` tool to verify the actual state.
 - When the user asks to schedule tasks or reminders, use the built-in \`cron\` tool (action \`add\`) automatically. Do NOT ask users to run crontab or Task Scheduler manually on the host.
 - When operating cron/scheduler tools, do **not** put \`current\` into the Session directory.
-- **IMPORTANT ABOUT GROUP CHAT TARGETING**: When creating or configuring a cron job to send messages (announce mode) to a Group Chat, the value of the \`delivery.to\` field **must** use the \`group:\` prefix before the group ID (e.g., \`group:3815464776067464419\` or \`group:xxxx\`). Never specify just the numeric ID, as the system will interpret it as a private DM and deliver to the wrong destination.
+- **IMPORTANT ABOUT GROUP CHAT TARGETING**: When creating or configuring a cron job to send messages (announce mode) to a Group Chat, the value of the \`delivery.to\` field **must** use the appropriate prefix before the group ID. For Telegram/Matrix/Discord/Slack, use the \`group:\` prefix (e.g., \`group:123456\`). ESPECIALLY for Zalo (\`zalouser\`), you **must** use the \`g:\` prefix (e.g., \`g:3815464776067464419\`) to prevent the OpenClaw core from stripping the prefix and misrouting the message to a private DM.
+- **One-shot jobs:** Use schedule kind \`"at"\` with an ISO 8601 timestamp. The job auto-deletes after successful run unless \`deleteAfterRun: false\` is set.
 - Skip internal doc lookups such as \`cron-jobs.mdx\`; rely on the available tools and complete the scheduling task directly.`)
       : '';
 
@@ -1745,7 +1755,7 @@ if (typeof exports !== 'undefined' && workspaceRoot.__openclawWorkspace) {
   Object.assign(exports, workspaceRoot.__openclawWorkspace);
 }
 
-  // ── Centralized bot config builders (openclaw.json, exec-approvals, .env) (setup/shared/bot-config-gen.js) 
+  // ── ── Centralized bot config builders (openclaw.json, exec-approvals, .env) (setup/shared/bot-config-gen.js) 
 // @ts-nocheck
 /**
  * @fileoverview Centralized bot configuration builders — single source of truth.
@@ -2216,7 +2226,7 @@ if (typeof exports !== 'undefined' && typeof globalThis !== 'undefined' && globa
   Object.assign(exports, globalThis.__openclawBotConfig);
 }
 
-  // ── Shared install artifacts: Chrome debug, uninstall, skill catalog (setup/shared/install-gen.js) 
+  // ── ── Shared install artifacts: Chrome debug, uninstall, skill catalog (setup/shared/install-gen.js) 
 // @ts-nocheck
 // install-gen.js — Build install/runtime artifacts (Chrome debug, uninstall, skill catalog)
 // Workspace .md files are in workspace-gen.js (single source of truth).
@@ -2784,7 +2794,7 @@ if (typeof exports !== 'undefined' && typeof globalThis !== 'undefined' && globa
   Object.assign(exports, globalThis.__openclawInstall);
 }
 
-  // ── Shared Docker artifact helpers for wizard + CLI (setup/shared/docker-gen.js) 
+  // ── ── Shared Docker artifact helpers for wizard + CLI (setup/shared/docker-gen.js) 
 // @ts-nocheck
 (function (root) {
   const common = (typeof globalThis !== 'undefined' && globalThis.__openclawCommon) || {};
@@ -2991,6 +3001,7 @@ if(touched){console.log('[patch-9router] Applied Codex compatibility patch.');}e
       is9Router,
       isLocal,
       isMultiBot,
+      hasBrowser = false,
       selectedModel,
       agentId,
       allSkills = [],
@@ -3108,6 +3119,10 @@ if(touched){console.log('[patch-9router] Applied Codex compatibility patch.');}e
     ].join('\n'));
     runtimeParts.push('openclaw gateway run');
     const runtimeScript = ['#!/bin/sh', 'set -e', ...runtimeParts].join('\n');
+    let browserInstall = '';
+    if (hasBrowser) {
+      browserInstall = '\n# Install browser and system dependencies for Playwright\nRUN npx playwright install-deps chromium && npx playwright install chromium\n';
+    }
     const dockerfile = `FROM node:22-slim
 
 RUN apt-get update && apt-get install -y git curl python3 && rm -rf /var/lib/apt/lists/*
@@ -3115,7 +3130,7 @@ RUN apt-get update && apt-get install -y git curl python3 && rm -rf /var/lib/apt
 ARG OPENCLAW_VER="${openClawNpmSpec}"
 ARG CACHE_BUST=""
 RUN echo "CACHE_BUST=$CACHE_BUST" && npm install -g $OPENCLAW_VER ${openClawRuntimePackages}${skillLines}${pluginLines}
-${patchLine}
+${patchLine}${browserInstall}
 
 COPY entrypoint.sh /usr/local/bin/openclaw-entrypoint.sh
 RUN chmod +x /usr/local/bin/openclaw-entrypoint.sh
@@ -3357,7 +3372,7 @@ if (typeof exports !== 'undefined' && typeof globalThis !== 'undefined' && globa
 
 
 
-  // ── buildNativeScriptCtx and shared native runtime helpers (setup/generators/native-helpers-gen.js) 
+  // ── ── buildNativeScriptCtx and shared native runtime helpers (setup/generators/native-helpers-gen.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -3772,7 +3787,7 @@ setInterval(sync, INTERVAL);`;
   };
 }
 
-  // ── botEnvContent, botConfigContent, botWorkspaceFiles, botFiles, helpers (setup/generators/config-gen.js) 
+  // ── ── botEnvContent, botConfigContent, botWorkspaceFiles, botFiles, helpers (setup/generators/config-gen.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4001,7 +4016,7 @@ setInterval(sync, INTERVAL);`;
       }));
     }
 
-  // ── generateZaloLoginBat, generateZaloLoginSh (unified) (setup/generators/zalo-login-gen.js) 
+  // ── ── generateZaloLoginBat, generateZaloLoginSh (unified) (setup/generators/zalo-login-gen.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4114,7 +4129,7 @@ function generateZaloLoginSh(opts) {
   ];
 }
 
-  // ── generateStartScript wizard wrapper (delegates to install-gen) (setup/generators/gateway-start-gen.js) 
+  // ── ── generateStartScript wizard wrapper (delegates to install-gen) (setup/generators/gateway-start-gen.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4161,7 +4176,7 @@ function generateStartScript() {
   return null;
 }
 
-  // ── generateUninstallScript, setup script download helpers (setup/generators/download-gen.js) 
+  // ── ── generateUninstallScript, setup script download helpers (setup/generators/download-gen.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4418,7 +4433,7 @@ window.__downloadGen = {
   updateDockerDlLabel,
 };
 
-  // ── Windows .bat — if (state.nativeOs === "win") block (setup/os/win-bat.js) 
+  // ── ── Windows .bat — if (state.nativeOs === "win") block (setup/os/win-bat.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4558,7 +4573,7 @@ function generateWinBat(ctx) {
   return { scriptName, scriptContent };
 }
 
-  // ── macOS .sh — if (state.nativeOs === "macos") block (setup/os/macos-sh.js) 
+  // ── ── macOS .sh — if (state.nativeOs === "macos") block (setup/os/macos-sh.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4676,7 +4691,7 @@ function generateMacOsSh(ctx) {
   return { scriptName, scriptContent };
 }
 
-  // ── VPS/PM2 .sh — if (state.nativeOs === "vps") block (setup/os/vps-sh.js) 
+  // ── ── VPS/PM2 .sh — if (state.nativeOs === "vps") block (setup/os/vps-sh.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4801,7 +4816,7 @@ GWEOF`);
   return { scriptName, scriptContent };
 }
 
-  // ── Linux Desktop .sh — if (state.nativeOs === "linux-desktop") block (setup/os/linux-sh.js) 
+  // ── ── Linux Desktop .sh — if (state.nativeOs === "linux-desktop") block (setup/os/linux-sh.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -4864,7 +4879,7 @@ function generateLinuxSh(ctx) {
   return { scriptName, scriptContent };
 }
 
-  // ── UI init, language/channel/deploy controllers, form rendering (setup/ui/controller.js) 
+  // ── ── UI init, language/channel/deploy controllers, form rendering (setup/ui/controller.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -5513,7 +5528,7 @@ function generateLinuxSh(ctx) {
     envContent.textContent = lines.join('\n');
   }
 
-  // ── Multi-bot state + UI (setup/ui/multi-bot.js) ───────────────────
+  // ── ── Multi-bot state + UI (setup/ui/multi-bot.js) ──────────────────────────────────────
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -5862,7 +5877,7 @@ function generateLinuxSh(ctx) {
 
   // ========== Step 1: Deploy Mode + OS ==========
 
-  // ── Step navigation, validation (setup/ui/steps.js) ────────────────
+  // ── ── Step navigation, validation (setup/ui/steps.js) ────────────────────────────────
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**
@@ -6022,7 +6037,7 @@ function generateLinuxSh(ctx) {
 
   // ========== Step 2: Bot Config ==========
 
-  // ── generateOutput + generateNativeScript + clipboard (setup/ui/output.js) 
+  // ── ── generateOutput + generateNativeScript + clipboard (setup/ui/output.js) 
 // @ts-nocheck
 /* eslint-disable no-undef, no-unused-vars */
 /**

package/dist/web/app.js

@@ -272,6 +272,37 @@ async function pickFolderPathShared() {
   return null;
 }
 
+function topbarActionsHtml() {
+  const setupVer = state.system?.versions?.setup;
+  const latestSetupVer = state.system?.versions?.latestSetup;
+  const hasNewVersion = setupVer && latestSetupVer && setupVer !== latestSetupVer;
+  return `
+    <div class="seg" role="group" aria-label="theme">
+      <button class="seg__btn ${state.theme==='light'?'is-active':''}" data-pref="theme" data-value="light" style="display: inline-flex; align-items: center; gap: 6px;">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" style="width:14px; height:14px;"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="4.22" x2="19.78" y2="5.64"/></svg>
+        <span>${ui('light')}</span>
+      </button>
+      <button class="seg__btn ${state.theme==='dark'?'is-active':''}" data-pref="theme" data-value="dark" style="display: inline-flex; align-items: center; gap: 6px;">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" style="width:14px; height:14px;"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
+        <span>${ui('dark')}</span>
+      </button>
+    </div>
+    <div class="seg" role="group" aria-label="lang" style="display: inline-flex; align-items: center; gap: 4px;">
+      <span style="display: inline-flex; align-items: center; justify-content: center; padding: 0 4px; color: var(--muted);">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" style="width:15px; height:15px;"><circle cx="12" cy="12" r="10"/><path d="M2 12h20"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>
+      </span>
+      <button class="seg__btn ${state.lang==='vi'?'is-active':''}" data-pref="lang" data-value="vi">VI</button>
+      <button class="seg__btn ${state.lang==='en'?'is-active':''}" data-pref="lang" data-value="en">EN</button>
+    </div>
+    ${hasNewVersion ? `
+    <button class="topbar__btn seg__btn" data-update-setup style="display: inline-flex; align-items: center; gap: 6px; padding: 6px 14px; border-radius: 6px; border: 1px solid var(--ok); background: rgba(46, 230, 166, 0.08); color: var(--ok); font-weight: 600; cursor: pointer; transition: background 0.2s;">
+      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" style="width:14px; height:14px;"><polyline points="23 4 23 10 17 10"></polyline><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"></path></svg>
+      <span>${t('Cập nhật', 'Update')}</span>
+    </button>
+    ` : ''}
+  `;
+}
+
 function render() {
   applyPrefs();
   const tabs = [['dashboard',t('Dashboard','Dashboard')],['setup',ui('setup')],['bot',ui('bot')],['logs',ui('logs')]];
@@ -280,7 +311,7 @@ function render() {
   if (!mainContainer) {
     $('#app').innerHTML = `
       <aside class="sidebar">
-        <div class="brand"><img src="/openclaw-logo.svg" onerror="this.src='/openclaw-logo.png'" alt="OpenClaw"/><div style="display: flex; flex-direction: column; align-items: center; text-align: center;"><b>OpenClaw Setup</b><span style="display: block; width: 100%; text-align: center; font-size: 13.5px; font-weight: 600; margin-top: 6px; color: var(--muted);">v${state.system?.versions?.setup || '5.8.0'}</span></div></div>
+        <div class="brand"><img src="/openclaw-logo.svg" onerror="this.src='/openclaw-logo.png'" alt="OpenClaw"/><div style="display: flex; flex-direction: column; align-items: center; text-align: center;"><b>OpenClaw Setup</b><span id="sidebar-version" style="display: block; width: 100%; text-align: center; font-size: 13.5px; font-weight: 600; margin-top: 6px; color: var(--muted);">v${state.system?.versions?.setup || '...'}</span></div></div>
         <nav class="sidebar-nav">${tabs.map(([id,label]) => `<button class="nav ${state.tab===id?'active':''}" data-tab="${id}">${icon(id)}<span>${label}</span></button>`).join('')}</nav>
         ${sidebarExtras()}
       </aside>
@@ -291,23 +322,7 @@ function render() {
             <input aria-label="Search" placeholder="${t('T\u00ecm nhanh...', 'Quick search...')}" />
           </div>
           <div class="topbar__actions">
-            <div class="seg" role="group" aria-label="theme">
-              <button class="seg__btn ${state.theme==='light'?'is-active':''}" data-pref="theme" data-value="light" style="display: inline-flex; align-items: center; gap: 6px;">
-                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" style="width:14px; height:14px;"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="4.22" x2="19.78" y2="5.64"/></svg>
-                <span>${ui('light')}</span>
-              </button>
-              <button class="seg__btn ${state.theme==='dark'?'is-active':''}" data-pref="theme" data-value="dark" style="display: inline-flex; align-items: center; gap: 6px;">
-                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" style="width:14px; height:14px;"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
-                <span>${ui('dark')}</span>
-              </button>
-            </div>
-            <div class="seg" role="group" aria-label="lang" style="display: inline-flex; align-items: center; gap: 4px;">
-              <span style="display: inline-flex; align-items: center; justify-content: center; padding: 0 4px; color: var(--muted);">
-                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" style="width:15px; height:15px;"><circle cx="12" cy="12" r="10"/><path d="M2 12h20"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg>
-              </span>
-              <button class="seg__btn ${state.lang==='vi'?'is-active':''}" data-pref="lang" data-value="vi">VI</button>
-              <button class="seg__btn ${state.lang==='en'?'is-active':''}" data-pref="lang" data-value="en">EN</button>
-            </div>
+            ${topbarActionsHtml()}
           </div>
         </header>
         <header class="top"><div><p class="eyebrow">${ui('installer')}</p><h1 id="app-page-title">${title()}</h1></div></header>
@@ -331,9 +346,15 @@ function render() {
     const titleEl = $('#app-page-title');
     if (titleEl) titleEl.innerHTML = title();
 
+    const sidebarVerEl = $('#sidebar-version');
+    if (sidebarVerEl) sidebarVerEl.textContent = `v${state.system?.versions?.setup || '...'}`;
+
     const panelEl = $('.panel');
     if (panelEl) panelEl.innerHTML = content();
 
+    const actionsEl = $('.topbar__actions');
+    if (actionsEl) actionsEl.innerHTML = topbarActionsHtml();
+
     document.querySelectorAll('.sidebar-nav button, .bottom-nav button').forEach(btn => {
       const active = btn.dataset.tab === state.tab;
       btn.classList.toggle('active', active);
@@ -759,7 +780,7 @@ function filesView() { return `<div class="files">${state.files.map(f=>`<article
 function botSkillsPanel() {
   const flags = state.featureFlags || {};
   const skills = [
-    { id: 'cron', title: 'Cron', desc: 'Cron guide in TOOLS.md' },
+    { id: 'cron', title: 'Cron', desc: 'Native scheduler (SQLite) — cron guide in TOOLS.md' },
   ];
   const plugins = [
     { id: 'openclaw-browser-automation', title: 'openclaw-browser-automation', desc: 'Smart Search + Browser (headless & Chrome thật)' },
@@ -915,7 +936,18 @@ document.querySelectorAll('[data-project-pick-folder]').forEach(btn => btn.oncli
     showToast(t('Lỗi kết nối', 'Connection error'), err.message, 'error');
     render();
   }));
-    document.querySelectorAll('[data-update-app]').forEach(btn => btn.onclick = () => withButtonLoading(btn, async () => {
+  document.querySelectorAll('[data-update-setup]').forEach(btn => btn.onclick = () => withButtonLoading(btn, async () => {
+    state.tab = 'logs';
+    render();
+    try {
+      showToast(t('Đang cập nhật...', 'Updating...'), t('Đang tiến hành cập nhật Setup Wizard.', 'Updating Setup Wizard now.'), 'info');
+      await api('/api/setup/update', { method: 'POST' });
+      showToast(t('Khởi động cập nhật', 'Update started'), t('Đang kéo code mới và nâng cấp trong nền.', 'Pulling new code and upgrading in the background.'), 'success');
+    } catch (err) {
+      showToast(t('Cập nhật thất bại', 'Update failed'), err.message, 'error');
+    }
+  }));
+  document.querySelectorAll('[data-update-app]').forEach(btn => btn.onclick = () => withButtonLoading(btn, async () => {
     await api('/api/runtime/update', { method: 'POST', body: { target: 'openclaw' } });
     await loadSystem();
     await loadStatus();

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "create-openclaw-bot",
-  "version": "5.8.1",
-  "description": "Interactive CLI installer for OpenClaw Bot",
-  "main": "dist/cli.js",
-  "bin": {
-    "create-openclaw-bot": "./dist/cli.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "node src/build.mjs --deploy",
-    "dev": "node src/build.mjs --deploy --watch",
-    "start": "node dist/cli.js",
-    "test": "node src/tests/smoke-cli-logic.mjs && node src/tests/test-generation.mjs && node src/tests/test-matrix.mjs && node src/tests/test-local-server.mjs",
-    "bump": "node src/bump-version.mjs"
-  },
-  "keywords": [
-    "openclaw",
-    "cli",
-    "bot",
-    "zalo",
-    "telegram",
-    "ai"
-  ],
-  "author": "tuanminhhole",
-  "license": "MIT",
-  "dependencies": {
-    "@inquirer/prompts": "^4.3.1",
-    "chalk": "^5.3.0",
-    "fs-extra": "^11.2.0"
-  },
-  "bundleDependencies": [
-    "@inquirer/prompts",
-    "chalk",
-    "fs-extra"
-  ],
-  "type": "module"
-}
+{
+  "name": "create-openclaw-bot",
+  "version": "5.8.3",
+  "description": "Interactive CLI installer for OpenClaw Bot",
+  "main": "dist/cli.js",
+  "bin": {
+    "create-openclaw-bot": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "node docs_dev/tests/build.mjs --deploy",
+    "dev": "node docs_dev/tests/build.mjs --deploy --watch",
+    "start": "node dist/cli.js",
+    "test": "node docs_dev/tests/smoke-cli-logic.mjs && node docs_dev/tests/test-generation.mjs && node docs_dev/tests/test-matrix.mjs && node docs_dev/tests/test-local-server.mjs",
+    "bump": "node docs_dev/tests/bump-version.mjs"
+  },
+  "keywords": [
+    "openclaw",
+    "cli",
+    "bot",
+    "zalo",
+    "telegram",
+    "ai"
+  ],
+  "author": "tuanminhhole",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^4.3.1",
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0"
+  },
+  "bundleDependencies": [
+    "@inquirer/prompts",
+    "chalk",
+    "fs-extra"
+  ],
+  "type": "module"
+}