create-openclaw-bot 5.16.6 → 5.16.8

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.16.6-0EA5E9?style=for-the-badge" alt="Version 5.16.6" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.16.8-0EA5E9?style=for-the-badge" alt="Version 5.16.8" /></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,7 +37,7 @@
 
 ---
 
-## 🆕 What's New in v5.16.6
+## 🆕 What's New in v5.16.8
 
 - 🩹 **Native installs on OpenClaw 2026.8 are smooth from the first run** - this wave patches the remaining chain of issues measured on fresh customer machines: generated configs pass the new strict checks 100%, install steps run in the right order, and restarts/plugin installs no longer get blocked midway.
 - 🔑 **9Router login works on Docker**: the new 9Router blocks the default password for "remote" access - and inside Docker every request counts as remote, so 123456 could never log in. It works now (still change the password once you're in).

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.16.6-0EA5E9?style=for-the-badge" alt="Version 5.16.6" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.16.8-0EA5E9?style=for-the-badge" alt="Version 5.16.8" /></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,7 +37,7 @@
 
 ---
 
-## 🆕 Có gì mới trong v5.16.6
+## 🆕 Có gì mới trong v5.16.8
 
 - 🩹 **Cài native trên OpenClaw 2026.8 mượt từ phát đầu** - đợt này vá nốt chuỗi lỗi đo được khi dựng máy khách mới: cấu hình sinh ra sạch 100% với bộ soát khắt khe của OpenClaw mới, các bước cài tự chạy đúng thứ tự, và mọi thao tác khởi động lại/cài plugin không còn bị chặn giữa chừng.
 - 🔑 **Đăng nhập 9Router hoạt động trên Docker**: bản 9Router mới chặn mật khẩu mặc định với truy cập "từ xa" - mà trong Docker thì mọi truy cập đều bị tính là từ xa, nên trước đây không cách nào vào được bằng 123456. Giờ đăng nhập bình thường (vào rồi vẫn nên đổi mật khẩu).

package/dist/cli.js

@@ -8,6 +8,40 @@ import { spawn } from 'child_process';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+// `--version` / `--help` phải TRẢ LỜI RỒI THOÁT, đứng trước mọi thứ khác.
+//
+// Trước đây CLI không biết hai cờ này: gõ `create-openclaw-bot --version` là nó lờ đi rồi chạy
+// tiếp như thường — tạo thư mục project, dựng Setup UI, **chiếm cổng 51789 và treo vĩnh viễn**.
+// Đo trên vps_minh-thu 07/09: hai tiến trình `cli.js --version` nằm đó từ 02/09 giữ cổng, nên
+// systemd relaunch bản mới xong không bind được cổng — bấm "Cập nhật" thành công mà giao diện
+// vẫn là bản cũ, không ai hiểu vì sao.
+{
+  const rawArgs = process.argv.slice(2);
+  if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
+    let v = '0.0.0';
+    try {
+      v = JSON.parse(fs.readFileSync(path.resolve(__dirname, '../package.json'), 'utf8')).version || v;
+    } catch {}
+    console.log(v);
+    process.exit(0);
+  }
+  if (rawArgs.includes('--help') || rawArgs.includes('-h')) {
+    console.log([
+      'create-openclaw-bot — trình cài đặt OpenClaw Bot',
+      '',
+      'Cách dùng: create-openclaw-bot [tuỳ chọn]',
+      '',
+      '  --host=<địa chỉ>      Địa chỉ Setup UI lắng nghe (mặc định 127.0.0.1)',
+      '  --port=<cổng>         Cổng Setup UI (mặc định 51789)',
+      '  --project-dir=<đường> Thư mục project',
+      '  --no-open             Không tự mở trình duyệt',
+      '  -v, --version         In phiên bản rồi thoát',
+      '  -h, --help            In trợ giúp này rồi thoát',
+    ].join('\n'));
+    process.exit(0);
+  }
+}
+
 const runCmd = (cmd, cmdArgs, opts = {}) => {
   return new Promise((resolve, reject) => {
     const child = spawn(cmd, cmdArgs, { 

package/dist/server/local-server.js

@@ -3030,9 +3030,30 @@ async function runNativeConfigMigrations(projectDir) {
     shell: false,
   });
   if (res.code !== 0) sendLog(`[native] config migrations skipped: ${String(res.stderr || res.stdout || '').trim().slice(0, 200)}`);
+  await runOpenclawDoctorFixIfNeeded(projectDir);
   return res.code === 0;
 }
 
+/**
+ * OpenClaw 2026.9 từ chối khởi động khi workspace còn ở dạng cũ:
+ *   "Gateway failed to start: Legacy workspace setup state requires migration for
+ *    …/workspace-<agent>; run openclaw doctor --fix."
+ * Đo trên vps_thuy-le 07/09 — bot chết cho tới khi chạy tay `doctor --fix`. Việc dọn này chỉ
+ * OpenClaw biết cách làm, nên gọi thẳng nó trước mỗi lần (re)start thay vì tự đoán rồi sửa mò.
+ * Chỉ chạy trên 2026.9+ (bản cũ không có phép migrate đó), và lỗi ở đây KHÔNG chặn boot —
+ * gateway vẫn được thử khởi động, cùng lắm là báo đúng lỗi cũ.
+ */
+async function runOpenclawDoctorFixIfNeeded(projectDir) {
+  try {
+    const ver = await hostOpenclawMajorMinor();
+    if (!ver || ver < 202609) return;
+    sendLog('[native] openclaw doctor --fix (2026.9 yêu cầu migrate workspace trước khi boot)…');
+    await run('openclaw', ['doctor', '--fix'], { cwd: projectDir, env: openclawProjectEnv(projectDir) });
+  } catch (err) {
+    sendLog(`[native] doctor --fix bỏ qua: ${err?.message || String(err)}`);
+  }
+}
+
 async function restartNativeRuntime(projectDir) {
   // Every restart is a chance to repair a project installed before these fixes existed — the
   // calls are no-ops once the service env is complete, stray files are adopted, and the config
@@ -6962,8 +6983,18 @@ async function handler(req, res, rootProjectDir) {
           } else if (isGlobalNpm) {
             // Pull the latest from npm in place, then exit — the service manager (or the
             // respawn path for a hand-run UI) relaunches onto the freshly installed dist.
-            sendLog('[update-setup] Global npm install detected — npm i -g create-openclaw-bot@latest…');
-            await run('npm', ['i', '-g', 'create-openclaw-bot@latest', '--no-audit', '--no-fund'], { cwd: installerDir });
+            // Cài vào ĐÚNG prefix của bản đang chạy, không phải prefix mà `npm` trong PATH
+            // của service trỏ tới. Máy khách hay có HAI npm global (nvm + npm hệ thống): đo trên
+            // vps_thuy-le 07/09 — bản đang chạy ở `/usr/lib/node_modules` (5.16.5) mà `npm i -g`
+            // lại cài vào `/root/.nvm/versions/node/v24.20.0/lib/node_modules` (5.16.7). Log báo
+            // "updated successfully", service restart, mà giao diện vẫn bản cũ — không ai hiểu nổi.
+            // installerDir = <prefix>/lib/node_modules/create-openclaw-bot ⇒ lùi 3 cấp là prefix.
+            const npmPrefix = resolve(installerDir, '..', '..', '..');
+            const prefixArgs = /[\\/]lib[\\/]node_modules[\\/]create-openclaw-bot[\\/]?$/.test(installerDir)
+              ? ['--prefix', npmPrefix]
+              : [];
+            sendLog(`[update-setup] Global npm install detected — npm i -g create-openclaw-bot@latest${prefixArgs.length ? ` (prefix ${npmPrefix})` : ''}…`);
+            await run('npm', ['i', '-g', 'create-openclaw-bot@latest', '--no-audit', '--no-fund', ...prefixArgs], { cwd: installerDir });
           } else {
             // Ephemeral `npx github:…` install: nothing to pull in place — the relaunch
             // re-runs `npx github:…`, which fetches the latest from GitHub.

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

@@ -149,6 +149,26 @@
           // we use. This is the turn budget — a DIFFERENT layer from 9router's per-request
           // timeout, so raising it does not conflict with / overrun 9router.
           timeoutSeconds: 900,
+          // Đổi model trong Control UI KHÔNG được ghi vào config. OpenClaw mặc định "dính" lựa
+          // chọn model vào `agents.defaults.model` ([agents/sticky-model-selection] … target=defaults),
+          // nên một lần bấm nhầm là bot rời 9router vĩnh viễn, restart cũng không về. "session"
+          // giữ lựa chọn trong phiên đang chat. Khoá có từ OpenClaw 2026.8 (setup cài 2026.8.1).
+          modelSelectionScope: 'session',
+          // Nhiều agent mà không khai chủ thì OpenClaw TẮT heartbeat và chỉ ghi một dòng log:
+          // "[heartbeat] disabled — multi-agent config has no ambient heartbeat owner". Bot mất
+          // nhịp tự kiểm tra mà không ai hay. Chủ là bot THẬT đầu tiên, không phải agent `main`.
+          // Roster nhiều agent mà không khai chủ thì hỏng ba chỗ, đo được từng cái trên máy thật:
+          //   • [heartbeat] disabled — bot mất nhịp tự kiểm tra, không báo gì
+          //   • cron.list ✗ "Agent-less cron job has no resolvable owner" — VỠ CẢ TRANG Automations
+          //     trong Control UI, vì job hệ thống (memory-dreaming…) không gắn agent nào
+          //   • talk.catalog ✗ "Talk session ownership has no explicit owner"
+          // Chủ là bot THẬT đầu tiên, không phải agent `main` của gateway chat.
+          ...(agentMetas.length > 1 && agentMetas[0]?.agentId
+            ? {
+                heartbeat: { agentId: agentMetas[0].agentId },
+                systemAgent: { agentId: agentMetas[0].agentId },
+              }
+            : {}),
           ...(isLocal ? { llm: { idleTimeoutSeconds: 300 } } : {}),
         },
         list: agentsList,
@@ -204,7 +224,10 @@
     // reacts to messages that address the bot, since non-addressed ones are buffered as
     // passive context before the reaction step.
     if (isZaloPersonal(channelKey)) {
-      cfg.messages = { ackReaction: '/-heart', ackReactionScope: 'all', removeAckAfterReply: false };
+      // KHÔNG khai `removeAckAfterReply`: OpenClaw 2026.9 bỏ khoá này và schema chặt từ chối
+      // khoá lạ — máy nâng lên 2026.9.2 sẽ chết với "messages: Unrecognized key" (đo trên
+      // vps_thuy-le 07/09, gateway không khởi động được cho tới khi gỡ khoá ra).
+      cfg.messages = { ackReaction: '/-heart', ackReactionScope: 'all' };
     }
 
     // ── commands ──────────────────────────────────────────────────────────────
@@ -236,7 +259,15 @@
     }
 
     // ── tools ────────────────────────────────────────────────────────────────
-    cfg.tools = { profile: 'full', exec: { host: 'gateway', security: 'full', ask: 'off' } };
+    cfg.tools = {
+      profile: 'full',
+      exec: { host: 'gateway', security: 'full', ask: 'off' },
+      // Mặc định của OpenClaw là "all" — nguyên văn schema: "any session on the Gateway, including
+      // other agents and users". Máy khách hay chạy nhiều bot cho nhiều người, để nguyên là bot này
+      // đọc được hội thoại của bot kia qua sessions_history/sessions_search. "agent" giới hạn trong
+      // đúng agent của mình. (Khoá có ở cả 2026.7 lẫn 2026.8.)
+      sessions: { visibility: 'agent' },
+    };
     const alsoAllow = [];
     if (selectedSkills.includes('scheduler') || selectedSkills.includes('cron')) {
       alsoAllow.push('group:automation');
@@ -291,6 +322,13 @@
     // `osChoice === 'vps'` clause predates native mode; keep native on loopback and reach it through
     // an SSH tunnel, which is what docker-on-a-VPS effectively does too.
     const openGatewayBind = deployMode === 'docker' || (osChoice === 'vps' && deployMode !== 'native');
+    // Talk (thoại) cũng cần chủ khi có nhiều agent: "Multiple agents are configured, but Talk
+    // session ownership has no explicit owner. Set talk.agentId…" — không khai là talk.catalog
+    // lỗi ngay lúc mở Control UI.
+    if (agentMetas.length > 1 && agentMetas[0]?.agentId) {
+      cfg.talk = { ...(cfg.talk || {}), agentId: agentMetas[0].agentId };
+    }
+
     cfg.gateway = {
       port: gatewayPort,
       mode: 'local',

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

@@ -5,7 +5,7 @@
   // migration, va bot khach chet ngay sau mot lan bam rebuild vo hai (ca that 103.98.149.154,
   // 31/08/2026: rebuild keo 2026.7.1-2 → 2026.8.1, gateway tu choi boot, 66 lan restart).
   // Nang version = doi spec nay MOT CACH CO Y trong mot ban phat hanh setup, kem kiem chung.
-  const OPENCLAW_NPM_SPEC = 'openclaw@2026.8.1';
+  const OPENCLAW_NPM_SPEC = 'openclaw@2026.9.2';
   const OPENCLAW_RUNTIME_PACKAGES = 'grammy @grammyjs/runner @grammyjs/transformer-throttler @buape/carbon @larksuiteoapi/node-sdk @slack/web-api';
   const NINE_ROUTER_NPM_SPEC = '9router@latest';
   const NINE_ROUTER_PORT = 20128;

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

@@ -207,7 +207,7 @@ if(touched){console.log('[patch-9router] Applied Codex compatibility patch.');}e
   // Gio gate theo version openclaw THAT trong container: <2026.8 thi backfill nhu cu, ≥2026.8 thi
   // GO key neu con (tu chua cac project da nhiem). Khong doc duoc version thi KHONG dong nao chay
   // — tha thieu mot default con hon gieo key lam gateway tu choi boot.
-  const contextDefaultsScript = `const fs=require('fs'),path=require('path');const p=path.join(process.cwd(),'.openclaw','openclaw.json');if(fs.existsSync(p)){const c=JSON.parse(fs.readFileSync(p,'utf8'));let ch=false;c.skills=c.skills||{};c.skills.workshop=c.skills.workshop||{};if(!c.skills.workshop.approvalPolicy){c.skills.workshop.approvalPolicy='auto';ch=true;}if(c.browser&&c.browser.enabled!==false){c.tools=c.tools||{};const dn=Array.isArray(c.tools.deny)?c.tools.deny:[];if(!dn.includes('browser')){dn.push('browser');c.tools.deny=dn;ch=true;}}let ocMajorMinor=0;try{const v=String(require('child_process').execSync('openclaw --version',{stdio:['ignore','pipe','ignore']})).match(/(\\d{4})\\.(\\d+)/);if(v)ocMajorMinor=Number(v[1])*100+Number(v[2]);}catch(e){}const d=(c.agents&&c.agents.defaults)?c.agents.defaults:null;if(d){if(d.imageMaxDimensionPx===undefined){d.imageMaxDimensionPx=1024;ch=true;}if(d.imageQuality===undefined){d.imageQuality='efficient';ch=true;}if(ocMajorMinor&&ocMajorMinor<202608){d.contextLimits=d.contextLimits||{};if(d.contextLimits.toolResultMaxChars===undefined){d.contextLimits.toolResultMaxChars=12000;ch=true;}}else if(ocMajorMinor>=202608&&d.contextLimits&&d.contextLimits.toolResultMaxChars!==undefined){delete d.contextLimits.toolResultMaxChars;ch=true;}}if(ocMajorMinor>=202608){const ag=c.agents||{};const nEntries=(Array.isArray(ag.list)?ag.list.length:0)+(ag.entries&&typeof ag.entries==='object'?Object.keys(ag.entries).length:0);if(nEntries>1&&ag.ownership!=='explicit'){ag.ownership='explicit';c.agents=ag;ch=true;}try{const agRoot=path.join(process.cwd(),'.openclaw','agents');for(const id of fs.readdirSync(agRoot)){const sf=path.join(agRoot,id,'sessions','sessions.json');if(fs.existsSync(sf)){fs.renameSync(sf,sf+'.bak-legacy-'+Date.now());console.log('[migrate] parked legacy session store '+sf);}}}catch(e){}if(c.commands&&c.commands.ownerDisplay!==undefined){delete c.commands.ownerDisplay;ch=true;}if(c.plugins&&c.plugins.bundledDiscovery!==undefined){delete c.plugins.bundledDiscovery;ch=true;}if(Array.isArray(ag.list)){ag.entries=(ag.entries&&typeof ag.entries==='object'&&!Array.isArray(ag.entries))?ag.entries:{};for(const a of ag.list){if(a&&a.id&&!ag.entries[a.id]){const{id:_aid,...rest}=a;ag.entries[_aid]=rest;}}delete ag.list;c.agents=ag;ch=true;console.log('[migrate] moved agents.list into agents.entries');}try{const ea=path.join(process.cwd(),'.openclaw','exec-approvals.json');if(fs.existsSync(ea)){fs.renameSync(ea,ea+'.bak-legacy-'+Date.now());console.log('[migrate] parked legacy exec approvals '+ea);}}catch(e){}}const pr=c.models&&c.models.providers&&c.models.providers['9router'];if(pr&&Array.isArray(pr.models)){for(const m of pr.models){if(m&&m.id==='smart-route'&&(m.contextWindow===200000||m.contextWindow===131072)){m.contextWindow=1048576;ch=true;}}}if(ch)fs.writeFileSync(p,JSON.stringify(c,null,2));}`;
+  const contextDefaultsScript = `const fs=require('fs'),path=require('path');const p=path.join(process.cwd(),'.openclaw','openclaw.json');if(fs.existsSync(p)){const c=JSON.parse(fs.readFileSync(p,'utf8'));let ch=false;c.skills=c.skills||{};c.skills.workshop=c.skills.workshop||{};if(!c.skills.workshop.approvalPolicy){c.skills.workshop.approvalPolicy='auto';ch=true;}if(c.browser&&c.browser.enabled!==false){c.tools=c.tools||{};const dn=Array.isArray(c.tools.deny)?c.tools.deny:[];if(!dn.includes('browser')){dn.push('browser');c.tools.deny=dn;ch=true;}}let ocMajorMinor=0;try{const v=String(require('child_process').execSync('openclaw --version',{stdio:['ignore','pipe','ignore']})).match(/(\\d{4})\\.(\\d+)/);if(v)ocMajorMinor=Number(v[1])*100+Number(v[2]);}catch(e){}const d=(c.agents&&c.agents.defaults)?c.agents.defaults:null;if(d){if(d.imageMaxDimensionPx===undefined){d.imageMaxDimensionPx=1024;ch=true;}if(d.imageQuality===undefined){d.imageQuality='efficient';ch=true;}if(ocMajorMinor&&ocMajorMinor<202608){d.contextLimits=d.contextLimits||{};if(d.contextLimits.toolResultMaxChars===undefined){d.contextLimits.toolResultMaxChars=12000;ch=true;}}else if(ocMajorMinor>=202608&&d.contextLimits&&d.contextLimits.toolResultMaxChars!==undefined){delete d.contextLimits.toolResultMaxChars;ch=true;}}if(ocMajorMinor>=202609){if(c.messages&&c.messages.removeAckAfterReply!==undefined){delete c.messages.removeAckAfterReply;ch=true;console.log('[migrate] go messages.removeAckAfterReply (2026.9 khong con nhan khoa nay)');}if(c.meta&&c.meta.lastTouchedAt!==undefined){delete c.meta.lastTouchedAt;ch=true;console.log('[migrate] go meta.lastTouchedAt (2026.9 khong con nhan khoa nay)');}}c.gateway=(c.gateway&&typeof c.gateway==='object')?c.gateway:{};if(c.gateway.mode===undefined){c.gateway.mode='local';ch=true;console.log('[migrate] gateway.mode=local (2026.9 tu choi chay neu thieu)');}c.tools=c.tools||{};c.tools.sessions=(c.tools.sessions&&typeof c.tools.sessions==='object')?c.tools.sessions:{};if(c.tools.sessions.visibility===undefined){c.tools.sessions.visibility='agent';ch=true;console.log('[migrate] tools.sessions.visibility=agent (khong cho bot doc phien cua bot khac)');}if(ocMajorMinor>=202608&&d&&d.modelSelectionScope===undefined){d.modelSelectionScope='session';ch=true;console.log('[migrate] agents.defaults.modelSelectionScope=session (khong ghi de model trong config)');}if(ocMajorMinor>=202608){const ag=c.agents||{};const nEntries=(Array.isArray(ag.list)?ag.list.length:0)+(ag.entries&&typeof ag.entries==='object'?Object.keys(ag.entries).length:0);if(nEntries>1&&ag.ownership!=='explicit'){ag.ownership='explicit';c.agents=ag;ch=true;}try{const agRoot=path.join(process.cwd(),'.openclaw','agents');for(const id of fs.readdirSync(agRoot)){const sf=path.join(agRoot,id,'sessions','sessions.json');if(fs.existsSync(sf)){fs.renameSync(sf,sf+'.bak-legacy-'+Date.now());console.log('[migrate] parked legacy session store '+sf);}}}catch(e){}if(c.commands&&c.commands.ownerDisplay!==undefined){delete c.commands.ownerDisplay;ch=true;}if(c.plugins&&c.plugins.bundledDiscovery!==undefined){delete c.plugins.bundledDiscovery;ch=true;}if(Array.isArray(ag.list)){ag.entries=(ag.entries&&typeof ag.entries==='object'&&!Array.isArray(ag.entries))?ag.entries:{};for(const a of ag.list){if(a&&a.id&&!ag.entries[a.id]){const{id:_aid,...rest}=a;ag.entries[_aid]=rest;}}delete ag.list;c.agents=ag;ch=true;console.log('[migrate] moved agents.list into agents.entries');}try{const ea=path.join(process.cwd(),'.openclaw','exec-approvals.json');if(fs.existsSync(ea)){fs.renameSync(ea,ea+'.bak-legacy-'+Date.now());console.log('[migrate] parked legacy exec approvals '+ea);}}catch(e){}try{const ag2=c.agents||{};const ids=(ag2.entries&&typeof ag2.entries==='object')?Object.keys(ag2.entries):(Array.isArray(ag2.list)?ag2.list.map(function(a){return a&&a.id;}).filter(Boolean):[]);if(ids.length>1&&d){if(!(d.heartbeat&&d.heartbeat.agentId)){d.heartbeat=(d.heartbeat&&typeof d.heartbeat==='object')?d.heartbeat:{};d.heartbeat.agentId=ids[0];ch=true;console.log('[migrate] agents.defaults.heartbeat.agentId='+ids[0]+' (khong thi heartbeat tat cam)');}if(!(d.systemAgent&&d.systemAgent.agentId)){d.systemAgent=(d.systemAgent&&typeof d.systemAgent==='object')?d.systemAgent:{};d.systemAgent.agentId=ids[0];ch=true;console.log('[migrate] agents.defaults.systemAgent.agentId='+ids[0]+' (khong thi cron.list vo ca trang Automations)');}const tk=(c.talk&&typeof c.talk==='object')?c.talk:{};if(!tk.agentId){tk.agentId=ids[0];c.talk=tk;ch=true;console.log('[migrate] talk.agentId='+ids[0]+' (khong thi talk.catalog loi khi mo Control UI)');}}}catch(e){}}const pr=c.models&&c.models.providers&&c.models.providers['9router'];if(pr&&Array.isArray(pr.models)){for(const m of pr.models){if(m&&m.id==='smart-route'&&(m.contextWindow===200000||m.contextWindow===131072)){m.contextWindow=1048576;ch=true;}}}if(ch)fs.writeFileSync(p,JSON.stringify(c,null,2));}`;
 
   function buildDockerArtifacts(options) {
     const {

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

@@ -865,7 +865,7 @@ Skills cung cấp công cụ cho bạn. Cần cái nào, đọc \`SKILL.md\` c
 
 Khi nhận heartbeat poll, đừng chỉ trả \`HEARTBEAT_OK\` mọi lần. Dùng heartbeat có ích!
 
-Bạn được tự do sửa \`HEARTBEAT.md\` với checklist/ghi chú ngắn. Giữ nó nhỏ để tiết kiệm token.
+Muốn nhớ việc gì giữa các nhịp, ghi checklist ngắn vào phần ghi chú (scratch) của chính automation đó — \`openclaw cron scratch\`. Giữ nó nhỏ để tiết kiệm token.
 
 ### Heartbeat vs Cron: dùng cái nào
 
@@ -873,7 +873,7 @@ Bạn được tự do sửa \`HEARTBEAT.md\` với checklist/ghi chú ngắn. G
 
 **Cron khi:** cần giờ chính xác ("9:00 sáng thứ Hai"); task cần tách khỏi lịch sử main session; muốn model/thinking khác; nhắc một lần ("nhắc sau 20 phút"); kết quả gửi thẳng vào channel.
 
-**Mẹo:** Gộp các check định kỳ tương tự vào \`HEARTBEAT.md\` thay vì tạo nhiều cron job.
+**Mẹo:** Gộp các check định kỳ tương tự vào MỘT automation thay vì tạo nhiều cron job.
 
 **Nên check (xoay vòng, 2-4 lần/ngày):** email khẩn, lịch 24-48h tới, mentions, thời tiết (nếu chủ sắp ra ngoài).
 
@@ -911,8 +911,7 @@ Mục tiêu: hữu ích mà không phiền. Check vài lần một ngày, làm v
 - 👤 **USER.md** — Thông tin và bối cảnh về User
 - 💭 **MEMORY.md** — Bộ nhớ dài hạn
 - ✨ **DREAMS.md** — Tự tổng hợp hoạt động trong ngày
-- 💓 **HEARTBEAT.md** — Nhịp kiểm tra định kỳ
-- 🚀 **BOOTSTRAP.md** — Khởi động và thiết lập
+- 🚀 **BOOTSTRAP.md** — Khởi động và thiết lập${otherAgents.length > 0 ? '\n- 👥 **TEAMS.md** — Các trợ lý khác cùng máy và cách gọi nhau' : ''}
 
 ## Make It Yours
 
@@ -1075,7 +1074,7 @@ Skills provide your tools. When you need one, check its \`SKILL.md\`. Keep local
 
 When you receive a heartbeat poll, don't just reply \`HEARTBEAT_OK\` every time. Use heartbeats productively!
 
-You are free to edit \`HEARTBEAT.md\` with a short checklist or reminders. Keep it small to limit token burn.
+To remember things between beats, keep a short checklist in the automation's own scratch (\`openclaw cron scratch\`). Keep it small to limit token burn.
 
 ### Heartbeat vs Cron: When to Use Each
 
@@ -1083,7 +1082,7 @@ You are free to edit \`HEARTBEAT.md\` with a short checklist or reminders. Keep
 
 **Use cron when:** exact timing matters ("9:00 AM sharp every Monday"); task needs isolation from main session history; you want a different model or thinking level; one-shot reminders ("remind me in 20 minutes"); output should deliver directly to a channel.
 
-**Tip:** Batch similar periodic checks into \`HEARTBEAT.md\` instead of creating multiple cron jobs.
+**Tip:** Batch similar periodic checks into ONE automation instead of creating multiple cron jobs.
 
 **Things to check (rotate, 2-4 times per day):** urgent emails, calendar next 24-48h, mentions, weather (if your human might go out).
 
@@ -1121,8 +1120,7 @@ The goal: Be helpful without being annoying. Check in a few times a day, do usef
 - 👤 **USER.md** — User info and context
 - 💭 **MEMORY.md** — Long-term memory
 - ✨ **DREAMS.md** — Daily activity self-summarization
-- 💓 **HEARTBEAT.md** — Periodic check rhythm
-- 🚀 **BOOTSTRAP.md** — Startup instructions
+- 🚀 **BOOTSTRAP.md** — Startup instructions${otherAgents.length > 0 ? '\n- 👥 **TEAMS.md** — Other assistants on this machine and how to reach them' : ''}
 
 ## Make It Yours
 
@@ -1425,7 +1423,10 @@ Add whatever helps you do your job. This is your cheat sheet.
         isVi, skillListStr, workspacePath, variant, agentWorkspaceDir, hasBrowser, hasScheduler, hasZaloMod, browserDocVariant,
       }),
       'MEMORY.md': buildMemoryDoc({ isVi, variant: memoryVariant }),
-      'HEARTBEAT.md': buildHeartbeatDoc({ isVi }),
+      // KHÔNG sinh HEARTBEAT.md nữa: từ OpenClaw 2026.8, nhịp kiểm tra định kỳ nằm trong scratch
+      // của chính cron job, và doctor `core/doctor/heartbeat-scratch-migration` dời nội dung file
+      // này sang đó rồi XOÁ file (`LEGACY_HEARTBEAT_FILENAME`). Setup mà cứ sinh lại thì mỗi lần
+      // dựng workspace là một lần tái nhiễm — đúng vết xe của `toolResultMaxChars` hồi 5.16.1.
       'BOOTSTRAP.md': buildBootstrapDoc({ isVi, botName }),
       'DREAMS.md': buildDreamsDoc({ isVi }),
     };

package/dist/web/app.js

@@ -455,9 +455,9 @@ function topbarActionsHtml() {
       <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;">
+    <button class="topbar__btn seg__btn" data-update-setup title="${t('Đang dùng', 'Currently on')} ${setupVer} — ${t('bấm để lên', 'click to upgrade to')} ${latestSetupVer}" 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>
+      <span>${t('Cập nhật', 'Update')} ${latestSetupVer}</span>
     </button>
     ` : ''}
   `;

package/package.json

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