create-openclaw-bot 5.13.3 → 5.13.4

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.4-0EA5E9?style=for-the-badge" alt="Version 5.13.4" /></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.4
+
+- ⚙️ **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.4-0EA5E9?style=for-the-badge" alt="Version 5.13.4" /></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.4
+
+- ⚙️ **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') {
@@ -3781,6 +3789,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 +3819,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 +4202,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.

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,29 @@ 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"\`.
+- **\`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\`: Nội dung tin nhắn nhắc nhở.
-- **\`delivery\`**:
+  - \`message\`: **NỘI DUNG Y NGUYÊN bot sẽ nói ra** (câu khẳng định), vd \`"Chúc cả nhà ngủ ngon 🌙"\`. ⚠️ KHÔNG viết kiểu mệnh lệnh ("gửi lời chúc tới group ..."). Khi job chạy, \`delivery.announce\` sẽ TỰ gửi nội dung này tới \`to\`. **TUYỆT ĐỐI KHÔNG để job tự gọi tool gửi tin (message/send) — announce đã lo, tự gọi sẽ gây lỗi \`Unknown target\` và "Cron failed".**
+- **\`delivery\`** — 🚨 **BẮT BUỘC điền ĐỦ cả \`channel\` VÀ \`to\`.** Nếu thiếu (hoặc để \`channel: "last"\`), job vẫn tạo được nhưng khi tới giờ sẽ **FAIL lúc giao** với lỗi \`Refusing implicit isolated cron delivery\` → tin KHÔNG tới nhóm:
   - \`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.
+  - \`channel\`: \`"${zaloDeliveryChannel}"\` (KHÔNG để \`"last"\`).
+  - \`to\`: nơi nhận = **ID THÔ (threadId), KHÔNG thêm tiền tố gì**. Group Zalo → dùng thẳng groupId (vd \`"1925989252066183028"\`). DM cá nhân → dùng userId. ⚠️ **TUYỆT ĐỐI KHÔNG thêm \`g:\`** — nếu thêm, zalo-connect báo \`Unknown target "g:..."\` và tin KHÔNG gửi được.
+
+### 📦 Ví dụ job ĐẦY ĐỦ (một lần, giờ địa phương) — tạo RIÊNG 1 job cho MỖI group:
+\`\`\`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.
@@ -1304,6 +1315,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,7 +1342,7 @@ 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);
     }
 
     if (hasImageGen) {

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: {}, 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 || {};
@@ -1126,8 +1180,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 +1455,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 +1492,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;

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.4",
   "description": "Interactive CLI installer for OpenClaw Bot",
   "main": "dist/cli.js",
   "bin": {