create-openclaw-bot 5.13.3 → 5.13.5

package/README.md

@@ -7,7 +7,7 @@
 *Run one command → open the dashboard → your bot is live. Windows · macOS · Linux · VPS — Docker-powered, auto-installed for you.*
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.13.3-0EA5E9?style=for-the-badge" alt="Version 5.13.3" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.13.5-0EA5E9?style=for-the-badge" alt="Version 5.13.5" /></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>
@@ -37,12 +37,20 @@
 
 ---
 
-## 🆕 What's New in v5.13.0
+## 🆕 What's New in v5.13.5
+
+- ⚙️ **New Settings page**: pick your theme (light/dark toggle), language (VI/EN) and timezone right from the dashboard — available in both the sidebar and the mobile nav bar.
+- 🕒 **Schedules & cron run in the correct local time**: newly created bots carry an explicit timezone, so reminders/cron no longer drift a day off around midnight (a UTC-vs-local bug that could schedule into the past). Scheduling guidance was hardened end-to-end (local time + timezone, explicit delivery target, raw group id).
+
+<details>
+<summary><b>Previous: What's new in v5.13.0</b></summary>
 
 - 🟢 **Live Zalo status on every bot card**: each personal Zalo bot now shows its own connection and login state, with a compact green badge when it is ready.
 - 👥 **Accurate multi-account visibility**: Setup reads the real Zalo Connect runtime per account, so projects with several Zalo bots no longer collapse into an ambiguous shared status.
 - ✨ **A cleaner Zalo control area**: Refresh and Login Again sit together above the bot list, while shared Zalo Connect and Zalo Mod versions move into the main status column.
 
+</details>
+
 <details>
 <summary><b>Previous: What's new in v5.12.0</b></summary>
 

package/README.vi.md

@@ -7,7 +7,7 @@
 *Chạy một lệnh → mở dashboard → bot lên sóng. Windows · macOS · Linux · VPS — chạy trên Docker, tự cài giúp bạn.*
 
 <p align="center">
-  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.13.3-0EA5E9?style=for-the-badge" alt="Version 5.13.3" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.13.5-0EA5E9?style=for-the-badge" alt="Version 5.13.5" /></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>
@@ -37,12 +37,20 @@
 
 ---
 
-## 🆕 Có gì mới trong v5.13.0
+## 🆕 Có gì mới trong v5.13.5
+
+- ⚙️ **Trang Cài đặt mới**: chọn giao diện (nút gạt Sáng/Tối), ngôn ngữ (VI/EN) và múi giờ ngay trong dashboard — có ở cả sidebar lẫn thanh điều hướng mobile.
+- 🕒 **Lịch & cron chạy đúng giờ địa phương**: bot tạo mới nhận múi giờ rõ ràng, nên nhắc hẹn/cron không còn lệch 1 ngày quanh nửa đêm (lỗi UTC-vs-local có thể đặt lịch vào quá khứ). Đã siết hướng dẫn lập lịch toàn diện (giờ local + múi giờ, nơi gửi rõ ràng, ID nhóm dạng thô).
+
+<details>
+<summary><b>Trước đó: Có gì mới trong v5.13.0</b></summary>
 
 - 🟢 **Trạng thái Zalo trực tiếp trên từng thẻ bot**: mỗi bot Zalo cá nhân hiển thị riêng trạng thái kết nối và đăng nhập, kèm badge xanh gọn khi đã sẵn sàng.
 - 👥 **Nhận diện đa tài khoản chính xác**: Setup đọc runtime Zalo Connect theo từng tài khoản thật, nên project có nhiều bot Zalo không còn bị gom thành một trạng thái “chưa rõ”.
 - ✨ **Khu điều khiển Zalo gọn hơn**: Làm mới và Đăng nhập lại nằm cùng hàng phía trên danh sách bot; phiên bản Zalo Connect và Zalo Mod được đưa sang cột trạng thái chung.
 
+</details>
+
 <details>
 <summary><b>Trước đó: Có gì mới trong v5.12.0</b></summary>
 

package/dist/server/local-server.js

@@ -1409,6 +1409,10 @@ async function createBotInProject(projectDir, body = {}, runtime = {}) {
   const userDesc = String(body.userDescription || body.userDesc || '').trim();
   const userInfo = [userName ? `- **Tên:** ${userName}` : '', userDesc ? `- **Mô tả:** ${userDesc}` : ''].filter(Boolean).join('\n');
 
+  // Múi giờ người dùng chọn ở UI Cài đặt (mặc định VN). Với project đã có sẵn, ưu tiên tz đã lưu
+  // trong config để bot mới đồng bộ với các bot cũ.
+  const bodyTz = String(body.userTimezone || '').trim() || 'Asia/Ho_Chi_Minh';
+
   const openclawHome = join(projectDir, '.openclaw');
   await fsp.mkdir(openclawHome, { recursive: true });
   const cfgPath = join(openclawHome, 'openclaw.json');
@@ -1421,7 +1425,9 @@ async function createBotInProject(projectDir, body = {}, runtime = {}) {
     selectedSkills: ['memory', 'web-search', 'scheduler'],
     skills: dataExport.SKILLS || [],
     agentMetas: [],
+    userTimezone: bodyTz,
   }));
+  const userTimezone = cfg.agents?.defaults?.userTimezone || bodyTz;
 
   const used = new Set(cfg.agents.list.map((a) => a.id));
   const botName = uniqueDisplayName(requestedBotName, new Set(cfg.agents.list.map((a) => a.name || a.id)));
@@ -1509,6 +1515,7 @@ async function createBotInProject(projectDir, body = {}, runtime = {}) {
     zaloBackend: zaloBackendForConfig(cfg),
     hasScheduler,
     hasImageGen,
+    userTimezone,
   });
   const wsRoot = join(openclawHome, workspaceDir);
   for (const [name, content] of Object.entries(files)) {
@@ -1631,6 +1638,7 @@ async function updateBotInProject(projectDir, agentId, body = {}, runtime = {})
     zaloBackend: zaloBackendForConfig(cfg),
     hasScheduler,
     hasImageGen,
+    userTimezone: cfg.agents?.defaults?.userTimezone || 'Asia/Ho_Chi_Minh',
   });
   const wsRoot = join(projectDir, '.openclaw', workspaceDir);
   for (const [name, content] of Object.entries(files)) {
@@ -2326,7 +2334,7 @@ function json(res, data, status = 200) {
   res.end(body);
 }
 
-async function writeCoreProject({ projectDir, osChoice, mode, gatewayPort = 18789, routerPort = 20128 }) {
+async function writeCoreProject({ projectDir, osChoice, mode, gatewayPort = 18789, routerPort = 20128, userTimezone = 'Asia/Ho_Chi_Minh' }) {
   await fsp.mkdir(projectDir, { recursive: true });
   const openclawHome = join(projectDir, '.openclaw');
   await fsp.mkdir(openclawHome, { recursive: true });
@@ -2334,7 +2342,7 @@ async function writeCoreProject({ projectDir, osChoice, mode, gatewayPort = 1878
 
   const selectedSkills = ['memory', 'web-search', 'scheduler'];
   const agentMetas = [];
-  const common = { channelKey: 'telegram', providerKey: '9router', model: DEFAULT_MODEL, deployMode: mode, osChoice, selectedSkills, skills: dataExport.SKILLS || [], agentMetas, gatewayPort, routerPort };
+  const common = { channelKey: 'telegram', providerKey: '9router', model: DEFAULT_MODEL, deployMode: mode, osChoice, selectedSkills, skills: dataExport.SKILLS || [], agentMetas, gatewayPort, routerPort, userTimezone };
   const cfg = buildOpenclawJson(common);
   // A core project has no channel account yet. Keep its environment shared/credential-free;
   // writing the literal <your_bot_token> placeholder makes OpenClaw auto-detect Telegram and
@@ -2562,7 +2570,7 @@ async function ensureDockerInstalled(osChoice) {
   throw httpError(400, 'Hệ điều hành không được hỗ trợ tự cài Docker. Hãy cài Docker thủ công rồi thử lại.');
 }
 
-async function installCore({ osChoice, mode, projectDir, gatewayPort = 18789, routerPort = 20128 }) {
+async function installCore({ osChoice, mode, projectDir, gatewayPort = 18789, routerPort = 20128, userTimezone = 'Asia/Ho_Chi_Minh' }) {
   state.installing = true;
   state.installed = false;
   state.lastError = null;
@@ -2576,7 +2584,7 @@ async function installCore({ osChoice, mode, projectDir, gatewayPort = 18789, ro
     // Make sure Docker is present (auto-install on Linux/VPS) before doing any work — fail fast
     // with a clear message rather than deep inside `docker compose up`.
     await ensureDockerInstalled(osChoice);
-    await writeCoreProject({ projectDir, osChoice, mode, gatewayPort, routerPort });
+    await writeCoreProject({ projectDir, osChoice, mode, gatewayPort, routerPort, userTimezone });
     await run('npm', ['install', '-g', OPENCLAW_NPM_SPEC]);
     await run('npm', ['install', '-g', NINE_ROUTER_NPM_SPEC]);
     if (mode === 'docker') {
@@ -3065,7 +3073,12 @@ async function applyFeatureToggle(projectDir, agentId, kind, id, enabled) {
 
   const k = `${kind}:${id}`;
 
-
+  // zalo-connect is required by any Zalo bot — refuse to disable it while a Zalo binding exists
+  // (the UI also locks the toggle; this is the backend guard).
+  if (kind === 'plugin' && (id === 'zalo-connect' || id === 'openclaw-zalo-connect') && !enabled) {
+    const hasZaloBot = (cfg.bindings || []).some((b) => b?.match?.channel === 'zalo-connect');
+    if (hasZaloBot) throw httpError(400, 'Không thể tắt Zalo Connect khi vẫn còn bot Zalo.');
+  }
 
   if (kind === 'skill' && id === 'cron') {
     cfg.skills = cfg.skills || { entries: {} };
@@ -3330,6 +3343,41 @@ async function installFeature(projectDir, agentId, kind, id) {
   }
 
   if (kind === 'plugin') {
+    // zalo-connect is a GIT-pinned fork (not a ClawHub package) — install/update it by cloning the
+    // pinned tag inside the container (same as first-boot/login). Powers the dashboard "Update"
+    // button so existing Zalo bots can upgrade to the pinned version (bump the pin in common-gen.js).
+    if (id === 'zalo-connect' || id === 'openclaw-zalo-connect') {
+      let composeDir = null;
+      if (existsSync(join(projectDir, 'docker-compose.yml'))) composeDir = projectDir;
+      else if (existsSync(join(projectDir, 'docker', 'openclaw', 'docker-compose.yml'))) composeDir = join(projectDir, 'docker', 'openclaw');
+      const repo = String(ZALO_CONNECT_PLUGIN_SPEC).split('#')[0];
+      const ref = String(ZALO_CONNECT_PLUGIN_SPEC).split('#')[1] || ZALO_CONNECT_VERSION;
+      if (composeDir) {
+        const botContainer = getBotContainerName(projectDir);
+        sendLog(`[zalo-connect] Installing/updating pinned ${ref} inside ${botContainer}...`);
+        const cmd = `tmp=/tmp/openclaw-plugin-zalo-connect-${ref}; rm -rf "$tmp"; git clone --depth 1 --branch "${ref}" "${repo}" "$tmp" && rm -rf "$tmp/.git" && cd /home/node/project && openclaw plugins install "$tmp" --force 2>&1`;
+        const out = await runCapture('docker', ['exec', botContainer, 'sh', '-lc', cmd], { cwd: projectDir, shell: false });
+        if (out) for (const line of `${out.stdout}\n${out.stderr}`.split(/\r?\n/).filter(Boolean)) sendLog(`[zalo-connect] ${line}`);
+        const okDir = existsSync(join(projectDir, '.openclaw', 'extensions', 'zalo-connect'));
+        if (out.code !== 0 && !okDir) throw new Error(out.stderr || out.stdout || 'Failed to install zalo-connect.');
+      }
+      const cfgPath = join(projectDir, '.openclaw', 'openclaw.json');
+      if (existsSync(cfgPath)) {
+        const cfg = ensureConfigShape(JSON.parse(await fsp.readFile(cfgPath, 'utf8')));
+        cfg.plugins = cfg.plugins || { entries: {}, allow: [] };
+        cfg.plugins.entries = cfg.plugins.entries || {};
+        cfg.plugins.entries['zalo-connect'] = cfg.plugins.entries['zalo-connect'] || {};
+        cfg.plugins.entries['zalo-connect'].enabled = true;
+        cfg.plugins.allow = cfg.plugins.allow || [];
+        if (!cfg.plugins.allow.includes('zalo-connect')) cfg.plugins.allow.push('zalo-connect');
+        await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
+      }
+      if (composeDir) {
+        sendLog('[zalo-connect] Restarting container to apply...');
+        await run('docker', ['restart', getBotContainerName(projectDir)], { shell: false }).catch(() => {});
+      }
+      return { ok: true, id: 'zalo-connect' };
+    }
     const installSpec = pluginInstallSpec(id);
     const installArgs = ['plugins', 'install', installSpec, '--force'];
     if (installSpec.startsWith('clawhub:')) installArgs.push('--acknowledge-clawhub-risk');
@@ -3632,6 +3680,7 @@ async function getFeatureFlags(projectDir, agentId = '') {
     poster: ['openclaw-n8n-facebook-poster', 'openclaw-facebook-poster', 'facebook-poster'],
     fbMessenger: ['openclaw-fb-messenger', 'fb-messenger'],
     tencentMemory: ['memory-tencentdb'],
+    zaloConnect: ['zalo-connect', 'openclaw-zalo-connect'],
   };
   const flags = {
     'skill:browser': browserOn,
@@ -3645,6 +3694,7 @@ async function getFeatureFlags(projectDir, agentId = '') {
     'plugin:openclaw-n8n-facebook-poster': isEnabled(aliases.poster),
     'plugin:openclaw-fb-messenger': isEnabled(aliases.fbMessenger),
     'plugin:memory-tencentdb': isEnabled(aliases.tencentMemory),
+    'plugin:zalo-connect': isEnabled(aliases.zaloConnect),
   };
   const extensionsDir = join(projectDir || '', '.openclaw', 'extensions');
   const extensionDirExists = (aliases = []) =>
@@ -3663,6 +3713,7 @@ async function getFeatureFlags(projectDir, agentId = '') {
     'plugin:openclaw-fb-messenger': extensionDirExists(aliases.fbMessenger)
       || aliases.fbMessenger.some((a) => installedKeys.has(a) || Array.from(installedSpecs).some((spec) => spec.includes(a))),
     'plugin:memory-tencentdb': isActuallyInstalled(aliases.tencentMemory),
+    'plugin:zalo-connect': isActuallyInstalled(aliases.zaloConnect),
   };
   const versions = {
     'skill:image-gen': await getInstalledSkillVersion(projectDir, aid, 'infographic-generator', cfg),
@@ -3673,6 +3724,7 @@ async function getFeatureFlags(projectDir, agentId = '') {
     'plugin:openclaw-n8n-facebook-poster': await getInstalledPluginVersion(projectDir, aliases.poster),
     'plugin:openclaw-fb-messenger': await getInstalledPluginVersion(projectDir, aliases.fbMessenger),
     'plugin:memory-tencentdb': await getInstalledPluginVersion(projectDir, aliases.tencentMemory),
+    'plugin:zalo-connect': await getInstalledPluginVersion(projectDir, aliases.zaloConnect),
   };
   // Docker: fill any plugin version still empty from the container's extensions volume
   // (e.g. bundled/clawhub plugins like zalo-mod that aren't on the host). One docker exec.
@@ -3685,9 +3737,14 @@ async function getFeatureFlags(projectDir, agentId = '') {
     fillVer('plugin:openclaw-n8n-facebook-poster', aliases.poster);
     fillVer('plugin:openclaw-fb-messenger', aliases.fbMessenger);
     fillVer('plugin:memory-tencentdb', aliases.tencentMemory);
+    fillVer('plugin:zalo-connect', aliases.zaloConnect);
   }
   const zaloBackend = fresh.channels?.['zalo-connect']?.enabled ? 'zalo-connect' : '';
-  return { flags, installed, versions, zaloBackend };
+  // zalo-connect is REQUIRED by any Zalo bot → lock its toggle (checked, can't disable)
+  // whenever a Zalo binding exists.
+  const hasZaloBot = (fresh.bindings || []).some((b) => b?.match?.channel === 'zalo-connect');
+  const locked = { 'plugin:zalo-connect': hasZaloBot };
+  return { flags, installed, versions, zaloBackend, locked };
 }
 
 async function serveStatic(req, res) {
@@ -3781,6 +3838,7 @@ async function handler(req, res, rootProjectDir) {
       const body = await readJson(req);
       const osChoice = body.os || detectOs();
       const mode = body.mode || recommendedMode(osChoice);
+      const userTimezone = String(body.userTimezone || '').trim() || 'Asia/Ho_Chi_Minh';
       const projectDir = body.projectDir ? resolve(String(body.projectDir)) : resolve(rootProjectDir, body.projectName || DEFAULT_PROJECT_NAME);
 
       // Auto-allocate unique, free ports to avoid collision (reserving gatewayPort + 1 for Zalo-mod UI)
@@ -3810,7 +3868,7 @@ async function handler(req, res, rootProjectDir) {
       state.gatewayUrl = `http://127.0.0.1:${gatewayPort}`;
       state.routerUrl = `http://127.0.0.1:${routerPort}`;
 
-      installCore({ osChoice, mode, projectDir, gatewayPort, routerPort }).catch(() => {});
+      installCore({ osChoice, mode, projectDir, gatewayPort, routerPort, userTimezone }).catch(() => {});
       state.projectDir = projectDir;
       state.mode = mode;
       state.os = osChoice;
@@ -4193,18 +4251,39 @@ function sshUserName() { try { return os.userInfo().username || 'root'; } catch
 function isHeadlessServer() {
   return process.platform === 'linux' && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY;
 }
+// Kiểm tra nhanh 1 port có đang listen trên host không (tránh forward port chết).
+function isLocalPortListening(port, host = '127.0.0.1', timeout = 400) {
+  return new Promise((resolve) => {
+    const sock = net.connect({ port, host });
+    let settled = false;
+    const done = (v) => { if (!settled) { settled = true; try { sock.destroy(); } catch {} resolve(v); } };
+    sock.setTimeout(timeout);
+    sock.once('connect', () => done(true));
+    sock.once('timeout', () => done(false));
+    sock.once('error', () => done(false));
+  });
+}
 // On a headless server there's no local browser — print an SSH-tunnel command so the
 // operator can reach the dashboard AND the Open-web UIs from their own machine. This is
 // the discoverable answer for ANY user on a VPS (no manual ssh-config knowledge needed).
+// CHỈ forward những port đang THỰC SỰ listen trên host — gateway (18789) / 9Router (20128)
+// thường nằm trong Docker, không bind ra host, nên nếu forward cứng sẽ đẻ ra hàng loạt
+// "channel: open failed: connect failed: Connection refused" vô nghĩa ở phía client.
 async function printRemoteAccessHint(uiPort) {
   if (!isHeadlessServer()) return;
   const ip = (await getPublicIp()) || '<your-server-ip>';
-  const fwd = [uiPort, 18789, 20128, 18790].map((p) => `-L ${p}:127.0.0.1:${p}`).join(' ');
+  // uiPort vừa bind xong nên chắc chắn mở; các port phụ chỉ thêm nếu đang listen.
+  const extras = [];
+  for (const p of [18789, 20128, 18790]) {
+    if (p !== uiPort && await isLocalPortListening(p)) extras.push(p);
+  }
+  const ports = [uiPort, ...extras];
+  const fwd = ports.map((p) => `-L ${p}:127.0.0.1:${p}`).join(' ');
   console.log('');
   console.log('🌐 No local browser detected (server/VPS). Open the UI from YOUR computer:');
   console.log(`   ssh ${fwd} ${sshUserName()}@${ip}`);
   console.log(`   then open:  http://localhost:${uiPort}`);
-  console.log('   (forwards the dashboard + OpenClaw gateway + 9Router + zalo-mod web UIs)');
+  console.log(`   (forwards ${ports.length} live port${ports.length > 1 ? 's' : ''}: ${ports.join(', ')})`);
   console.log('');
 }
 

package/dist/setup/shared/bot-config-gen.js

@@ -75,6 +75,7 @@
       osChoice = '',
       selectedModel = '',
       routerPort,
+      userTimezone = 'Asia/Ho_Chi_Minh',
     } = opts;
 
     const common = _common;
@@ -108,6 +109,10 @@
       agents: {
         defaults: {
           model: { primary: model, fallbacks: [] },
+          // Giờ địa phương agent nhìn thấy trong prompt ("Current time: … (tz)"). Nếu để trống,
+          // OpenClaw fallback UTC → agent hiểu "hôm nay/tối nay" theo ngày UTC, lệch 1 ngày quanh
+          // nửa đêm và đặt cron/lịch vào quá khứ. Lấy tz người dùng chọn ở UI Cài đặt (mặc định VN).
+          userTimezone,
           compaction: { mode: 'safeguard' },
           // Trim stale tool results before Anthropic's prompt-cache TTL expires so the
           // re-cache write stays small → lower token cost on long sessions, zero downside.
@@ -233,6 +238,8 @@
 
     // ── skills ───────────────────────────────────────────────────────────────
     const skillEntries = buildSkillsEntries(skills, selectedSkills);
+    // NOTE: the "zalo-actions" skill was removed — its guidance now lives in the `zalo-connect`
+    // tool description itself (fork ≥ v3.0.2), so no per-bot skill entry is needed anymore.
     if (Object.keys(skillEntries).length > 0) {
       cfg.skills = { entries: skillEntries };
     }

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

@@ -44,8 +44,8 @@
   // Pin the maintained fork tag so setup never falls back to upstream/ClawHub.
   const ZALO_CHANNEL_ID = 'zalo-connect';
   const ZALO_PLUGIN_ID = 'zalo-connect';
-  const ZALO_CONNECT_VERSION = '3.0.1';
-  const ZALO_CONNECT_PLUGIN_SPEC = 'https://github.com/tuanminhhole/openclaw-zalo-connect.git#v3.0.1';
+  const ZALO_CONNECT_VERSION = '3.0.2';
+  const ZALO_CONNECT_PLUGIN_SPEC = 'https://github.com/tuanminhhole/openclaw-zalo-connect.git#v3.0.2';
 
   function buildRelayPluginInstallCommand(prefix = 'openclaw') {
     return `if [ ! -d "$OPENCLAW_STATE_DIR/extensions/${TELEGRAM_RELAY_PLUGIN_ID}" ]; then ${prefix} plugins install ${TELEGRAM_RELAY_PLUGIN_SPEC} 2>/dev/null || true; fi`;

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

@@ -547,7 +547,7 @@ _Good luck out there. Make it count._
 - [Operating Manual](./AGENTS.md)`;
   }
 
-  function buildCronjobSkillMd(isVi = true, zaloDeliveryChannel = 'zalo-connect') {
+  function buildCronjobSkillMd(isVi = true, zaloDeliveryChannel = 'zalo-connect', tz = 'Asia/Ho_Chi_Minh') {
     return `---
 name: cronjob
 description: Lên lịch tác vụ định kỳ sử dụng công cụ cron.
@@ -562,18 +562,40 @@ Truyền tham số \`job\` (object) gồm:
 - **\`agentId\`**: Bỏ qua (không truyền). Hệ thống tự gán.
 - **\`sessionTarget\`**: \`"isolated"\` (cho chạy nền) hoặc \`"main"\`.
 - **\`wakeMode\`**: \`"now"\`.
-- **\`schedule\`**:
-  - \`kind\`: \`"cron"\` (lặp lại) hoặc \`"at"\` (một lần).
-  - \`expr\`: Biểu thức cron (ví dụ: \`"0 7 * * *"\`).
-  - \`tz\`: Bắt buộc điền múi giờ, ví dụ: \`"Asia/Ho_Chi_Minh"\`.
-- **\`payload\`**:
-  - \`kind\`: \`"agentTurn"\`.
-  - \`message\`: Nội dung tin nhắn nhắc nhở.
-- **\`delivery\`**:
-  - \`mode\`: \`"announce"\`.
-  - \`channel\`: \`"${zaloDeliveryChannel}"\`.
-  - \`to\`: ID người nhận hoặc ID nhóm.
-    - ⚠️ **QUAN TRỌNG:** Nếu gửi tới Group Zalo, ID nhóm bắt buộc phải thêm tiền tố **\`g:\`** ở đầu (Ví dụ: \`g:1925989252066183028\`). Nếu thiếu \`g:\`, tin nhắn sẽ bị gửi nhầm thành tin cá nhân (DM) hoặc lỗi.
+- **\`schedule\`** — chọn 1 trong 2 loại:
+  - **Lặp lại:** \`kind: "cron"\`, \`expr\`: biểu thức cron 5 trường (ví dụ \`"30 7 * * *"\` = 7h30 mỗi ngày), \`tz\`: múi giờ (BẮT BUỘC, ví dụ \`"${tz}"\`).
+  - **Một lần:** \`kind: "at"\`, \`at\`: giờ địa phương + \`tz\` (khuyên dùng), ví dụ \`"at": "2026-07-22T00:30:00", "tz": "${tz}"\`. Cũng có thể dùng \`+duration\` (vd \`"+30m"\`). **KHÔNG tự quy đổi & ghi \`...Z\` (UTC)** — dễ sai ngày.
+    - 🕒 **XÁC ĐỊNH ĐÚNG NGÀY:** "Current time" trong ngữ cảnh đã theo giờ địa phương (\`${tz}\`). Cứ dùng NGÀY đang thấy để suy "hôm nay / tối nay / sáng mai". (Nếu vô tình thấy giờ dạng \`...Z\` UTC thì phải đổi sang \`${tz}\` trước khi suy ngày.)
+    - ✅ Nếu tool báo \`schedule.at is in the past\` → tính sai ngày (thường thiếu 1 ngày). Cộng thêm 1 ngày rồi thử lại; đừng báo lỗi khi chưa tự sửa.
+- **\`payload\`**: \`{ "kind": "agentTurn", "message": "<chỉ dẫn/nội dung>" }\`.
+  - \`message\` là chỉ dẫn để agent **SINH RA nội dung sẽ gửi** — có thể là câu cố định (\`"Chúc cả nhà ngủ ngon 🌙"\`) hoặc yêu cầu tạo mới mỗi lần (\`"Viết một lời chúc buổi sáng mới, tích cực, không lặp lại"\`). **Phần trả lời của agent CHÍNH LÀ tin được gửi.**
+  - ⛔ **KHÔNG** viết kiểu mệnh lệnh gửi ("dùng tool ... gửi tới group ...", "gửi tin tới groupId ..."). ⛔ **KHÔNG** để job tự gọi tool gửi tin (message/send/zalo-connect). Việc gửi là do \`delivery.announce\` lo — tự gọi sẽ lỗi \`Unknown target\` / "Cron failed".
+- **\`delivery\`** — 🚨 **BẮT BUỘC** cho tin gửi tới người/nhóm. Isolated job reset routing mỗi lần chạy, nên phải ghi rõ \`channel\` + \`to\`; thiếu → lỗi \`Refusing implicit isolated cron delivery\` (không gửi được):
+  - \`mode\`: \`"announce"\`. ⛔ **KHÔNG dùng \`"none"\`** — job vẫn chạy "ok" nhưng KHÔNG gửi gì (đây là bẫy thường gặp).
+  - \`channel\`: \`"${zaloDeliveryChannel}"\` (KHÔNG để \`"last"\`).
+  - \`to\`: **ID THÔ, KHÔNG tiền tố**. Group Zalo → groupId thẳng (vd \`"1925989252066183028"\`); DM → userId. ⚠️ **KHÔNG thêm \`g:\`** (sẽ lỗi \`Unknown target "g:..."\`).
+
+### 📦 Ví dụ A — LẶP LẠI (chúc buổi sáng 9:05 mỗi ngày cho 1 nhóm):
+\`\`\`json
+{
+  "sessionTarget": "isolated",
+  "wakeMode": "now",
+  "schedule": { "kind": "cron", "expr": "5 9 * * *", "tz": "${tz}" },
+  "payload": { "kind": "agentTurn", "message": "Viết MỘT lời chúc buổi sáng MỚI mỗi ngày, tích cực, ấm áp, lịch sự, không lặp lại. Chỉ trả về đúng nội dung lời chúc." },
+  "delivery": { "mode": "announce", "channel": "${zaloDeliveryChannel}", "to": "1228185345777623323" }
+}
+\`\`\`
+
+### 📦 Ví dụ B — MỘT LẦN (giờ địa phương) — mỗi group 1 job riêng:
+\`\`\`json
+{
+  "sessionTarget": "isolated",
+  "wakeMode": "now",
+  "schedule": { "kind": "at", "at": "2026-07-22T00:30:00", "tz": "${tz}" },
+  "payload": { "kind": "agentTurn", "message": "Chúc cả nhà ngủ ngon 🌙" },
+  "delivery": { "mode": "announce", "channel": "${zaloDeliveryChannel}", "to": "1925989252066183028" }
+}
+\`\`\`
 
 ## 2. Tìm kiếm, Tắt, Bật, Xóa Lịch
 - **Xem danh sách:** Gọi \`cron\` với action \`list\` (kèm \`includeDisabled: true\`). Tìm \`id\` phù hợp.
@@ -586,6 +608,54 @@ Truyền tham số \`job\` (object) gồm:
   \`openclaw cron run <job_id> --wait\` (hoặc gọi tool \`cron\` với action \`run\` kèm \`id\`).`;
   }
 
+  // DEPRECATED (unused): guidance moved into the `zalo-connect` tool description (fork ≥ v3.0.2).
+  // Kept only for reference; no longer wired into buildWorkspaceFileMap.
+  function buildZaloActionsSkillMd(isVi = true, zaloDeliveryChannel = 'zalo-connect') {
+    return `---
+name: zalo-actions
+description: Hành động Zalo phong phú qua tool ${zaloDeliveryChannel} — sticker, thả cảm xúc, bình chọn, ghi chú, nhắc hẹn, media, quản trị nhóm.
+---
+
+# 💬 Hành động Zalo (tool: \`${zaloDeliveryChannel}\`)
+
+Ngoài gửi text, tool \`${zaloDeliveryChannel}\` có ~149 action. Gọi bằng: tool \`${zaloDeliveryChannel}\` với \`{ "action": "<tên>", ... }\`. Cứ chủ động dùng khi phù hợp (user xin sticker, cần bình chọn, nhắc hẹn, ghim ghi chú...).
+
+## Quy tắc chung
+- **\`threadId\`** = nơi gửi. Trong GROUP hiện tại → dùng **groupId THÔ** (KHÔNG tiền tố \`g:\`) kèm **\`isGroup: true\`**. DM cá nhân → \`threadId\` = userId, \`isGroup: false\`.
+- Làm xong thì trả lời ngắn gọn cho user, KHÔNG dán JSON/kết quả thô.
+
+## 🎨 Sticker — \`send-sticker\`
+- Dễ nhất (theo từ khoá, tool tự tìm & gửi): \`{ "action": "send-sticker", "threadId": "<groupId>", "isGroup": true, "keyword": "chào buổi sáng" }\`.
+- Chỉ định cụ thể: thêm \`"stickerId"\` + \`"stickerCateId"\` (thay cho \`keyword\`).
+
+## 😀 Thả cảm xúc — \`add-reaction\`
+- \`{ "action": "add-reaction", "msgId": "<id tin nhắn>", "icon": "heart" }\` — \`icon\`: heart / like / haha / wow / cry / angry.
+
+## 📊 Bình chọn — \`create-poll\`
+- \`{ "action": "create-poll", "threadId": "<groupId>", "isGroup": true, "title": "Câu hỏi?", "options": ["A","B"], "allowMultiChoices": false }\`.
+
+## 📌 Ghi chú ghim — \`create-note\`
+- \`{ "action": "create-note", "threadId": "<groupId>", "isGroup": true, "title": "Nội dung ghi chú" }\`.
+
+## ⏰ Nhắc hẹn nhóm — \`create-reminder\`
+- \`{ "action": "create-reminder", "threadId": "<groupId>", "isGroup": true, "title": "...", "startTime": <epoch ms>, "repeat": 0 }\` (repeat: 0 không lặp / 1 ngày / 2 tuần / 3 tháng). Lịch định kỳ kiểu cron → dùng skill \`cronjob\`.
+
+## 🖼️ Media
+- Ảnh: \`send-image\` \`{threadId,isGroup,url}\` · Video: \`send-video\` \`{threadId,isGroup,url,thumbnailUrl?}\` · Voice: \`send-voice\` \`{threadId,isGroup,voiceUrl}\` · File: \`send-file\` \`{threadId,isGroup,filePath}\` · Link preview: \`send-link\` \`{threadId,isGroup,url}\`.
+
+## ↪️ Chuyển tiếp / thu hồi / xoá
+- \`forward-message\` \`{msgId, threadIds:["<đích>"]}\` · \`delete-message\` \`{msgId, threadId, onlyMe?}\`.
+- **Thu hồi tin của CHÍNH bot** (\`undo-message\`): khi user bảo "thu hồi/gỡ tin vừa nãy", gọi \`undo-message\` \`{threadId:"<groupId/userId hiện tại>"}\` — **KHÔNG cần msgId**, hệ thống tự lấy tin gần nhất bot đã gửi trong luồng đó. ⏳ Chỉ thu hồi được tin bot gửi **trong 5 phút** gần nhất; tin cũ hơn (hoặc tin của người khác) thì báo lại là không gỡ được. Muốn nhắm tin cụ thể thì truyền thêm \`{msgId}\`.
+
+## 🛠️ Quản trị nhóm (bot phải là admin)
+- \`add-group-admin\` / \`remove-group-admin\` \`{groupId,userId}\` · \`rename-group\` \`{groupId,groupName}\` · \`change-group-owner\` \`{groupId,userId}\` · \`invite-to-groups\` \`{userId, groupIds:[...]}\` · \`update-group-settings\` \`{groupId, groupSettings:{...}}\` · link nhóm: \`enable-group-link\`/\`disable-group-link\`/\`get-group-link\` \`{groupId}\`.
+
+## 📎 Hội thoại
+- Ghim: \`pin-conversation\` \`{threadId}\` · Tắt báo: \`mute-conversation\` \`{threadId, duration:-1}\` (giây, -1 = mãi) · Đang gõ "…": \`send-typing\` \`{threadId,isGroup}\`.
+
+> Còn nhiều action khác (tìm bạn, QR, catalog/sản phẩm, auto-reply, quick message, poll nâng cao, mã hoá tin tự huỷ...). Xem mô tả từng \`action\` + tham số ngay trong schema của tool \`${zaloDeliveryChannel}\`.`;
+  }
+
   function buildInfographicGeneratorSkillMd(botName = 'Williams') {
     return '';
   }
@@ -1304,6 +1374,7 @@ Add whatever helps you do your job. This is your cheat sheet.
       hasImageGen = false,
       hasZaloMod = false,
       zaloBackend = 'zalo-connect',
+      userTimezone = 'Asia/Ho_Chi_Minh',
     } = opts;
 
     const isMultiBot = variant === 'relay';
@@ -1330,9 +1401,13 @@ Add whatever helps you do your job. This is your cheat sheet.
     }
 
     if (hasScheduler) {
-      files['skills/cronjob/SKILL.md'] = buildCronjobSkillMd(isVi, 'zalo-connect');
+      files['skills/cronjob/SKILL.md'] = buildCronjobSkillMd(isVi, 'zalo-connect', userTimezone);
     }
 
+    // NOTE: the old `zalo-actions` agent skill was removed — its guidance (Zalo conventions +
+    // action recipes) now lives directly in the `zalo-connect` tool description (fork ≥ v3.0.2),
+    // so every zalo-connect bot gets it automatically without a generated per-bot skill.
+
     if (hasImageGen) {
       files['skills/infographic-generator/SKILL.md'] = buildInfographicGeneratorSkillMd(botName);
       files['skills/infographic-generator/image-generator.js'] = buildInfographicGeneratorJs();

package/dist/web/app.js

@@ -1,5 +1,5 @@
 const $ = (sel) => document.querySelector(sel);
-const state = { tab: 'dashboard', system: null, install: null, files: [], catalog: { skills: [], plugins: [] }, logs: [], zaloLoginOpen: false, zaloLoginLines: [], zaloQrDataUrl: '', lang: localStorage.getItem('openclaw-lang') || 'vi', theme: localStorage.getItem('openclaw-theme') || 'dark', navCollapsed: localStorage.getItem('openclaw-nav')==='1', os: null, mode: null, donateOpen: false, botModalOpen: false, botEditId: '', installModalOpen: false, fbPluginModalOpen: false, installTab: 'docker', installDraft: null, pathModal: null, confirmModal: null, botChannel: 'telegram', botPane: 'list', activeBotId: '', selectedFile: '', botMessage: '', projectConnectMessage: '', pendingProjectDir: '', selectedProjectDir: '', featureFlags: {}, featureInstalled: {}, featureLoading: {}, zaloBackend: '', zaloHealth: null, openDirs: {} };
+const state = { tab: 'dashboard', system: null, install: null, files: [], catalog: { skills: [], plugins: [] }, logs: [], zaloLoginOpen: false, zaloLoginLines: [], zaloQrDataUrl: '', lang: localStorage.getItem('openclaw-lang') || 'vi', theme: localStorage.getItem('openclaw-theme') || 'dark', tz: localStorage.getItem('openclaw-tz') || 'Asia/Ho_Chi_Minh', navCollapsed: localStorage.getItem('openclaw-nav')==='1', os: null, mode: null, donateOpen: false, botModalOpen: false, botEditId: '', installModalOpen: false, fbPluginModalOpen: false, installTab: 'docker', installDraft: null, pathModal: null, confirmModal: null, botChannel: 'telegram', botPane: 'list', activeBotId: '', selectedFile: '', botMessage: '', projectConnectMessage: '', pendingProjectDir: '', selectedProjectDir: '', featureFlags: {}, featureInstalled: {}, featureLoading: {}, featureLocked: {}, zaloBackend: '', zaloHealth: null, openDirs: {} };
 const SVG_CDN = 'https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons';
 const OS_OPTIONS = [
   { id: 'win', title: 'Windows', subtitle: 'Auto-detected desktop', icon: `${SVG_CDN}/windows/default.svg`, badge: 'Desktop' },
@@ -86,7 +86,8 @@ function icon(name) {
     bot: 'M7 8h10v8H7z M9 4h6v4H9z M9 11h.01M15 11h.01M10 16h4',
     files: 'M6 3h8l4 4v14H6z M14 3v5h5 M9 13h6 M9 17h6',
     skills: 'M12 2l2.4 6.8H22l-6 4.4 2.3 6.8-6.3-4.2L5.7 20 8 13.2 2 8.8h7.6z',
-    logs: 'M4 6h16M4 12h16M4 18h10'
+    logs: 'M4 6h16M4 12h16M4 18h10',
+    settings: 'M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6Z M19.4 13a1.7 1.7 0 0 0 .3 1.9l.1.1a2 2 0 1 1-2.8 2.8l-.1-.1a1.7 1.7 0 0 0-2.9 1.2V21a2 2 0 1 1-4 0v-.1A1.7 1.7 0 0 0 7 19.3l-.1.1a2 2 0 1 1-2.8-2.8l.1-.1a1.7 1.7 0 0 0-1.2-2.9H3a2 2 0 1 1 0-4h.1A1.7 1.7 0 0 0 4.7 7l-.1-.1a2 2 0 1 1 2.8-2.8l.1.1a1.7 1.7 0 0 0 1.9.3H9.5A1.7 1.7 0 0 0 10.5 3V3a2 2 0 1 1 4 0v.1a1.7 1.7 0 0 0 2.9 1.2l.1-.1a2 2 0 1 1 2.8 2.8l-.1.1a1.7 1.7 0 0 0-.3 1.9v.1a1.7 1.7 0 0 0 1.6 1H21a2 2 0 1 1 0 4h-.1a1.7 1.7 0 0 0-1.5 1Z'
   };
   return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="${paths[name]}"/></svg>`;
 }
@@ -247,7 +248,10 @@ function ui(key) {
     next:['Ti\u1ebfp theo','Next'], nextDesc:['S\u1eeda file nh\u1eadn di\u1ec7n, sau \u0111\u00f3 c\u00e0i k\u1ef9 n\u0103ng/plugin.','Edit identity files, then install skills/plugins.'], openFiles:['M\u1edf t\u1ec7p','Open files'],
     save:['L\u01b0u','Save'], saved:['\u0110\u00e3 l\u01b0u','Saved'], noFiles:['Ch\u01b0a c\u00f3 file markdown. H\u00e3y ch\u1ea1y c\u00e0i \u0111\u1eb7t tr\u01b0\u1edbc.','No markdown files yet. Run install first.'],
     nativeCap:['N\u0103ng l\u1ef1c native','native capability'], plugins:['Plugins','Plugins'], installVerb:['C\u00e0i \u0111\u1eb7t','Install'],
-    desktop:['M\u00e1y b\u00e0n','Desktop'], server:['M\u00e1y ch\u1ee7','Server'], recommended:['Khuy\u00ean d\u00f9ng','Recommended'], advanced:['N\u00e2ng cao','Advanced']
+    desktop:['M\u00e1y b\u00e0n','Desktop'], server:['M\u00e1y ch\u1ee7','Server'], recommended:['Khuy\u00ean d\u00f9ng','Recommended'], advanced:['N\u00e2ng cao','Advanced'],
+    settings:['T\u00f9y ch\u1ec9nh','Settings'], appearance:['Giao di\u1ec7n','Appearance'], darkMode:['Ch\u1ebf \u0111\u1ed9 t\u1ed1i','Dark mode'], language:['Ng\u00f4n ng\u1eef','Language'], timezone:['M\u00fai gi\u1edd','Timezone'],
+    settingsDesc:['T\u00f9y ch\u1ec9nh giao di\u1ec7n, ng\u00f4n ng\u1eef v\u00e0 m\u00fai gi\u1edd. M\u00fai gi\u1edd \u0111\u01b0\u1ee3c d\u00f9ng cho bot t\u1ea1o m\u1edbi (l\u1ecbch/cron ch\u1ea1y \u0111\u00fang gi\u1edd \u0111\u1ecba ph\u01b0\u01a1ng).','Customize appearance, language and timezone. The timezone is applied to newly created bots (so schedules/cron run in local time).'],
+    tzHint:['\u00c1p d\u1ee5ng cho bot t\u1ea1o m\u1edbi','Applied to newly created bots']
   }[key] || [key,key];
   return t(m[0], m[1]);
 }
@@ -408,7 +412,7 @@ function render() {
   // Expose the active tab on <body> so CSS can drop the redundant page-title header on the
   // dashboard (the dashboard hero already carries its own title).
   document.body.dataset.activeTab = state.tab;
-  const tabs = [['dashboard',t('Dashboard','Dashboard')],['setup',ui('setup')],['bot',ui('bot')],['logs',ui('logs')]];
+  const tabs = [['dashboard',t('Dashboard','Dashboard')],['setup',ui('setup')],['bot',ui('bot')],['logs',ui('logs')],['settings',ui('settings')]];
   
   let mainContainer = $('#app-main-content');
   if (!mainContainer) {
@@ -595,16 +599,66 @@ function wireSkillsHandlers(scope = document) {
 }
 
 function title() {
-  return { dashboard: t('Dashboard vận hành','Operations dashboard'), setup: t('C\u00e0i OpenClaw trong v\u00e0i ph\u00fat', 'Install OpenClaw in minutes'), bot: t('B\u1ea3ng \u0111i\u1ec1u khi\u1ec3n bot','Bot dashboard'), skills: t('K\u1ef9 n\u0103ng & plugins','Skills & plugins'), logs: t('Nh\u1eadt k\u00fd c\u00e0i \u0111\u1eb7t','Install logs') }[state.tab];
+  return { dashboard: t('Dashboard vận hành','Operations dashboard'), setup: t('C\u00e0i OpenClaw trong v\u00e0i ph\u00fat', 'Install OpenClaw in minutes'), bot: t('B\u1ea3ng \u0111i\u1ec1u khi\u1ec3n bot','Bot dashboard'), skills: t('K\u1ef9 n\u0103ng & plugins','Skills & plugins'), logs: t('Nh\u1eadt k\u00fd c\u00e0i \u0111\u1eb7t','Install logs'), settings: ui('settings') }[state.tab] || '';
 }
 
 function content() {
   if (state.tab === 'dashboard') return dashboardView();
   if (state.tab === 'setup') return setupView();
   if (state.tab === 'bot') return botView();
+  if (state.tab === 'settings') return settingsView();
     return `<div class="log-toolbar"><button class="copy-log" data-copy-log type="button" aria-label="Copy logs">${copyIcon()} ${t('Copy log','Copy log')}</button></div><div class="terminal big">${state.logs.map(l=>`<p>${escapeHtml(l)}</p>`).join('')}</div>`;
 }
 
+// Danh sách múi giờ phổ biến (IANA) cho dropdown pill. Gọn — đủ dùng cho khu vực chính.
+const TZ_OPTIONS = [
+  ['Asia/Ho_Chi_Minh', 'Việt Nam (UTC+7)'],
+  ['Asia/Bangkok', 'Bangkok (UTC+7)'],
+  ['Asia/Jakarta', 'Jakarta (UTC+7)'],
+  ['Asia/Singapore', 'Singapore (UTC+8)'],
+  ['Asia/Kuala_Lumpur', 'Kuala Lumpur (UTC+8)'],
+  ['Asia/Manila', 'Manila (UTC+8)'],
+  ['Asia/Shanghai', 'Trung Quốc (UTC+8)'],
+  ['Asia/Tokyo', 'Tokyo (UTC+9)'],
+  ['Asia/Seoul', 'Seoul (UTC+9)'],
+  ['Asia/Kolkata', 'Ấn Độ (UTC+5:30)'],
+  ['Asia/Dubai', 'Dubai (UTC+4)'],
+  ['Australia/Sydney', 'Sydney (UTC+10/+11)'],
+  ['Europe/London', 'London (UTC+0/+1)'],
+  ['Europe/Paris', 'Paris (UTC+1/+2)'],
+  ['America/New_York', 'New York (UTC-5/-4)'],
+  ['America/Los_Angeles', 'Los Angeles (UTC-8/-7)'],
+  ['UTC', 'UTC'],
+];
+
+function settingsView() {
+  const tzKnown = TZ_OPTIONS.some(([id]) => id === state.tz);
+  const tzOpts = (tzKnown ? TZ_OPTIONS : [[state.tz, state.tz], ...TZ_OPTIONS])
+    .map(([id, label]) => `<option value="${id}" ${state.tz === id ? 'selected' : ''}>${escapeHtml(label)}</option>`).join('');
+  return `<div class="panel settings-panel">
+    <p class="lead" style="margin-bottom:22px">${ui('settingsDesc')}</p>
+    <div class="grid" style="max-width:640px">
+      <div class="card set-row">
+        <div class="set-row__label"><b>${ui('appearance')}</b><span>${t('Bật để dùng nền tối','Toggle for dark background')}</span></div>
+        <label class="switch" title="${ui('darkMode')}">
+          <input type="checkbox" data-pref-switch="theme" ${state.theme === 'dark' ? 'checked' : ''} aria-label="${ui('darkMode')}">
+          <span class="switch__track"><span class="switch__knob"></span></span>
+        </label>
+      </div>
+      <div class="card set-row">
+        <div class="set-row__label"><b>${ui('language')}</b><span>${t('Ngôn ngữ hiển thị của trình cài đặt','Installer display language')}</span></div>
+        ${toggleGroup('lang', state.lang, [['vi','VI'],['en','EN']])}
+      </div>
+      <div class="card set-row">
+        <div class="set-row__label"><b>${ui('timezone')}</b><span>${ui('tzHint')}</span></div>
+        <div class="tz-select"><select id="tz-select" aria-label="${ui('timezone')}">${tzOpts}</select>
+          <svg class="tz-select__chevron" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9"/></svg>
+        </div>
+      </div>
+    </div>
+  </div>`;
+}
+
 function dashboardView() {
   const s = state.install || {};
   const sys = state.system || {};
@@ -1010,6 +1064,7 @@ function botSkillsPanel() {
     { id: 'learning-memory', title: 'Siêu Trí Nhớ Dài Hạn (learning-memory)', desc: 'Tự động ghi nhớ bài học vào MEMORY.md, tự đóng gói và tiến hóa kỹ năng mới vào skills/' },
   ];
   const plugins = [
+    { id: 'zalo-connect', title: 'OpenClaw Zalo Connect', desc: t('Kênh Zalo cá nhân (zca-js) — BẮT BUỘC cho bot Zalo. Tự cài khi tạo bot Zalo đầu tiên; bấm Cập nhật để lên bản mới nhất.', 'Personal Zalo channel (zca-js) — REQUIRED for Zalo bots. Auto-installed with your first Zalo bot; click Update for the latest version.'), channels: ['zalo-personal'] },
     { id: 'memory-tencentdb', title: 'TencentDB Agent Memory', desc: 'Bộ nhớ phân tầng L0–L3 + nén ngữ cảnh: nhớ tốt session dài, tiết kiệm ~61% token (local SQLite, không cần API)' },
     { id: 'openclaw-browser-automation', title: 'openclaw-browser-automation', desc: 'Smart Search + Browser (headless & Chrome thật)' },
     { id: 'openclaw-zalo-mod', title: 'openclaw-zalo-mod', desc: 'Zalo group helpers', channels: ['zalo-personal'], openWebPort: 18790, openWebPath: '/dashboard' },
@@ -1029,8 +1084,9 @@ function botSkillsPanel() {
   const row = (item, group) => {
     const key = `${group}:${item.id}`;
     const loading = !!state.featureLoading[key];
+    const locked = !!state.featureLocked?.[key];
     const requiresInstall = group === 'plugin' || (group === 'skill' && (item.id === 'image-gen' || item.id === 'learning-memory'));
-    const isInstalled = !requiresInstall || !!state.featureInstalled?.[key];
+    const isInstalled = !requiresInstall || !!state.featureInstalled?.[key] || locked;
     
     const version = requiresInstall && isInstalled ? (state.featureVersions?.[key] || '') : '';
     const versionBadge = version ? `<span class="plugin-version-badge" style="display:inline-block; font-size: 11px; background: rgba(66, 133, 244, 0.15); color: #4285F4; padding: 2px 6px; border-radius: 4px; font-weight: 600; border: 1px solid rgba(66,133,244,0.25); flex:0 0 auto;">v${escapeHtml(version)}</span>` : '';
@@ -1040,7 +1096,7 @@ function botSkillsPanel() {
     let toggleHtml = '';
     const secs = [];
     if (isInstalled) {
-      toggleHtml = `<label class="feature-switch"><input type="checkbox" data-feature-toggle="${key}" ${flags[key] ? 'checked' : ''} ${loading ? 'disabled' : ''}/><span></span></label>`;
+      toggleHtml = `<label class="feature-switch" title="${locked ? t('Bắt buộc cho bot Zalo — không thể tắt','Required for Zalo bots — cannot be disabled') : ''}"><input type="checkbox" data-feature-toggle="${key}" ${(flags[key] || locked) ? 'checked' : ''} ${(loading || locked) ? 'disabled' : ''}/><span></span></label>${locked ? `<span title="${t('Đã khoá','Locked')}" style="margin-left:6px;opacity:.55;font-size:12px;">🔒</span>` : ''}`;
       if (item.openWebPort) {
         secs.push(`<a class="secondary icon-btn2" href="${sameHostUrl('', item.openWebPort)}${item.openWebPath || ''}" target="_blank" rel="noopener" title="${t('Mở dashboard của plugin','Open the plugin dashboard')}" style="padding: 4px 8px; font-size: 11px; height: 28px; border-width: 1px;">${actionIcon('link')}<span>${t('Mở web','Open')}</span></a>`);
       }
@@ -1126,8 +1182,16 @@ function wireTab() {
     localStorage.setItem('openclaw-'+btn.dataset.pref, btn.dataset.value); 
     const main = $('#app-main-content');
     if (main) main.remove();
-    render(); 
+    render();
+  });
+  document.querySelectorAll('[data-pref-switch]').forEach(sw => sw.onchange = () => {
+    const pref = sw.dataset.prefSwitch;
+    const val = pref === 'theme' ? (sw.checked ? 'dark' : 'light') : (sw.checked ? 'on' : 'off');
+    state[pref] = val;
+    localStorage.setItem('openclaw-' + pref, val);
+    applyPrefs();
   });
+  { const tzSel = $('#tz-select'); if (tzSel) tzSel.onchange = () => { state.tz = tzSel.value; localStorage.setItem('openclaw-tz', tzSel.value); }; }
   document.querySelectorAll('[data-tab-jump]').forEach(btn => btn.onclick = () => { state.tab = btn.dataset.tabJump; render(); });
   document.querySelectorAll('input[name=os]').forEach(i => i.onchange = () => { state.os = i.value; document.querySelectorAll('input[name=os]').forEach(x => x.closest('.choice-card')?.classList.toggle('is-selected', x.checked)); });
   document.querySelectorAll('input[name=mode]').forEach(i => i.onchange = () => { state.mode = i.value; document.querySelectorAll('input[name=mode]').forEach(x => x.closest('.choice-card')?.classList.toggle('is-selected', x.checked)); });
@@ -1393,6 +1457,7 @@ document.querySelectorAll('[data-project-pick-folder]').forEach(btn => btn.oncli
         os: form.querySelector('[name="os"]')?.value || state.installDraft?.os || state.os,
         mode: form.querySelector('[name="mode"]')?.value || state.installTab || state.installDraft?.mode || state.mode,
         projectDir: form.querySelector('[name=\"projectDir\"]')?.value || '',
+        userTimezone: state.tz,
       };
       if (!body.projectDir) throw new Error(t('Chưa có đường dẫn project','Missing project path'));
       await api('/api/install', { method: 'POST', body });
@@ -1429,6 +1494,7 @@ document.querySelectorAll('[data-project-pick-folder]').forEach(btn => btn.oncli
     const body = Object.fromEntries(fd.entries());
     body.projectDir = activeProjectDir();
     body.channel = state.botChannel || 'telegram';
+    body.userTimezone = state.tz;
     if (body.channel === 'zalo-personal') {
       state.botModalOpen = false;
       state.zaloLoginOpen = true;
@@ -1543,6 +1609,7 @@ async function loadFeatureFlags(silent=false){
     state.featureFlags = data.flags || {};
     state.featureInstalled = data.installed || {};
     state.featureVersions = data.versions || {};
+    state.featureLocked = data.locked || {};
     state.zaloBackend = data.zaloBackend || '';
     if (state.zaloBackend === 'zalo-connect') await loadZaloHealth(true).catch(() => {});
   } catch (_) {

package/dist/web/styles.css

@@ -112,6 +112,27 @@ html[data-theme="light"] .install-tab{background:#fff;border-color:#e7d9dd;color
 html[data-theme="light"] .install-tab.is-active{background:linear-gradient(135deg,rgba(255,36,54,.12),rgba(255,90,102,.05));border-color:rgba(255,36,54,.55)}
 html[data-theme="light"] .pill-choice{background:#fff;border-color:#e7d9dd;color:#1f1114}
 html[data-theme="light"] .pill-choice.is-active{background:linear-gradient(135deg,rgba(255,36,54,.12),rgba(255,90,102,.05));border-color:rgba(255,36,54,.55)}
+/* ── Settings panel: rows + toggle switch + pill timezone dropdown ── */
+.settings-panel .set-row{display:flex;align-items:center;justify-content:space-between;gap:16px;padding:16px 18px}
+.set-row__label{display:flex;flex-direction:column;gap:3px;min-width:0}
+.set-row__label b{font-size:14px}
+.set-row__label span{color:var(--muted);font-size:12px}
+.switch{position:relative;display:inline-flex;align-items:center;cursor:pointer;flex:none}
+.switch input{position:absolute;opacity:0;width:0;height:0}
+.switch__track{width:46px;height:26px;border-radius:999px;background:var(--surface2);border:1px solid var(--hair);transition:background .2s,border-color .2s;display:inline-flex;align-items:center;padding:2px}
+.switch__knob{width:20px;height:20px;border-radius:50%;background:var(--muted);transition:transform .2s,background .2s;transform:translateX(0)}
+.switch input:checked + .switch__track{background:linear-gradient(135deg,var(--primary),var(--soft));border-color:var(--primary)}
+.switch input:checked + .switch__track .switch__knob{transform:translateX(20px);background:#fff}
+.switch input:focus-visible + .switch__track{box-shadow:0 0 0 3px rgba(255,36,54,.3)}
+.tz-select{position:relative;display:inline-flex;align-items:center;flex:none}
+.tz-select select{appearance:none;-webkit-appearance:none;border:1px solid var(--hair);background:var(--surface2);color:var(--ink);border-radius:999px;padding:9px 38px 9px 16px;font-size:13px;font-weight:600;cursor:pointer;min-width:210px;transition:border-color .2s,box-shadow .2s}
+.tz-select select:hover{border-color:var(--soft)}
+.tz-select select:focus{outline:0;border-color:var(--primary);box-shadow:0 0 0 3px rgba(255,36,54,.18)}
+.tz-select__chevron{position:absolute;right:13px;width:16px;height:16px;pointer-events:none;color:var(--muted)}
+html[data-theme="light"] .tz-select select{background:#fff;border-color:#e7d9dd;color:#1f1114}
+html[data-theme="light"] .switch__track{background:#ece3e5;border-color:#e0d2d5}
+html[data-theme="light"] .switch__knob{background:#b9adb0}
+@media(max-width:760px){.settings-panel .set-row{gap:12px}.tz-select select{min-width:150px}}
 @media(max-width:1180px){.sidebar-extra{display:none}}@media(max-width:720px){.donate-grid{grid-template-columns:1fr}.donate-modal{padding:16px;border-radius:18px}.donate-head h2{font-size:26px}}
 
 
@@ -1913,8 +1934,8 @@ main{transition:margin .2s}
 .channel-tabs button.is-coming-soon{opacity:.5;cursor:not-allowed}
 .channel-tabs::-webkit-scrollbar{height:6px}
 .channel-tabs::-webkit-scrollbar-thumb{background:rgba(255,255,255,.14);border-radius:999px}
-/* Bottom "native" nav bar: center the 4 items (overrides an earlier repeat(5,1fr) !important rule) */
-.bottom{grid-template-columns:repeat(4,1fr)!important}
+/* Bottom "native" nav bar: 5 items (Dashboard, Cài đặt, Bot, Nhật ký, Tùy chỉnh) */
+.bottom{grid-template-columns:repeat(5,1fr)!important}
 /* Tablet/mobile bot page: stop horizontal overflow so .channel-tabs scrolls instead of stretching the layout */
 .bot-page,.bot-top-row,.bot-main,.bot-main-content,.bot-projects-and-bots,.bot-side-col,.bot-list{min-width:0}
 @media(max-width:1180px){.bot-top-row{grid-template-columns:minmax(0,1fr)}}

package/package.json

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