create-openclaw-bot 5.16.6 → 5.16.7

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.7-0EA5E9?style=for-the-badge" alt="Version 5.16.7" /></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.7
 
 - 🩹 **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.7-0EA5E9?style=for-the-badge" alt="Version 5.16.7" /></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.7
 
 - 🩹 **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/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,
@@ -236,7 +256,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 +319,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/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;}}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/package.json

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