create-openclaw-bot 5.12.0 → 5.13.0

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.12.0-0EA5E9?style=for-the-badge" alt="Version 5.12.0" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.13.0-0EA5E9?style=for-the-badge" alt="Version 5.13.0" /></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>
@@ -27,12 +27,31 @@
 
 ---
 
-## 🆕 What's New in v5.12.0
+<div align="center">
+  <a href="https://www.youtube.com/watch?v=hPusYX-5Pmw">
+    <img src="https://img.youtube.com/vi/hPusYX-5Pmw/maxresdefault.jpg" alt="Watch the OpenClaw setup video" width="820" />
+  </a>
+  <br />
+  <strong>▶ Watch the OpenClaw + Zalo setup video on YouTube</strong>
+</div>
+
+---
+
+## 🆕 What's New in v5.13.0
+
+- 🟢 **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>
+<summary><b>Previous: What's new in v5.13.0</b></summary>
 
 - 💬 **OpenClaw Zalo Connect, ready in one click**: create a personal Zalo bot or press **Zalo Login** and Setup prepares the channel automatically, then opens the QR flow in the dashboard.
 - ⚡ **Install once, reconnect faster**: an existing Zalo Connect installation is reused instead of being downloaded again on every login or restart.
 - ✨ **Cleaner native Zalo experience**: group mentions, reactions and moderation now run through one maintained Zalo runtime; the retired integration and Sticker add-on are gone from Setup.
 
+</details>
+
 <details>
 <summary><b>Previous: What's new in v5.11.1</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.12.0-0EA5E9?style=for-the-badge" alt="Version 5.12.0" /></a>
+  <a href="https://github.com/tuanminhhole/openclaw-setup/releases"><img src="https://img.shields.io/badge/RELEASE-v5.13.0-0EA5E9?style=for-the-badge" alt="Version 5.13.0" /></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>
@@ -27,12 +27,31 @@
 
 ---
 
-## 🆕 Có gì mới trong v5.12.0
+<div align="center">
+  <a href="https://www.youtube.com/watch?v=hPusYX-5Pmw">
+    <img src="https://img.youtube.com/vi/hPusYX-5Pmw/maxresdefault.jpg" alt="Xem video hướng dẫn cài OpenClaw" width="820" />
+  </a>
+  <br />
+  <strong>▶ Xem video hướng dẫn cài OpenClaw + Zalo trên YouTube</strong>
+</div>
+
+---
+
+## 🆕 Có gì mới trong v5.13.0
+
+- 🟢 **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>
+<summary><b>Trước đó: Có gì mới trong v5.13.0</b></summary>
 
 - 💬 **OpenClaw Zalo Connect, sẵn sàng trong một chạm**: tạo bot Zalo cá nhân hoặc bấm **Đăng nhập Zalo**, Setup tự chuẩn bị channel rồi mở luồng quét QR ngay trên dashboard.
 - ⚡ **Cài một lần, kết nối lại nhanh hơn**: nếu Zalo Connect đã có, Setup dùng lại bản hiện tại thay vì tải lại mỗi lần đăng nhập hay restart.
 - ✨ **Trải nghiệm Zalo native gọn hơn**: mention nhóm, reaction và quản trị dùng chung một Zalo runtime được duy trì; luồng tích hợp cũ và tiện ích Sticker đã được gỡ khỏi Setup.
 
+</details>
+
 <details>
 <summary><b>Trước đó: Có gì mới trong v5.11.1</b></summary>
 

package/dist/server/local-server.js

@@ -1221,6 +1221,12 @@ function mapAgentChannels(agent, cfg) {
   return enabled.length === 1 ? enabled : [mapAgentChannel(agent, cfg)];
 }
 
+function bindingChannelId(channel = '') {
+  if (channel === 'zalo-personal') return 'zalo-connect';
+  if (channel === 'zalo-bot') return 'zalo';
+  return channel;
+}
+
 async function listConfiguredBots(projectDir) {
   const cfgPath = join(projectDir || '', '.openclaw', 'openclaw.json');
   if (!projectDir || !existsSync(cfgPath)) return [];
@@ -1234,11 +1240,14 @@ async function listConfiguredBots(projectDir) {
     const env = await readProjectEnv(projectDir);
     const hasOwnWorkspace = !!agent.workspace;
     const identityName = usableIdentityName(identity.name);
-    return mapAgentChannels(agent, cfg).map((channel) => ({
+    return mapAgentChannels(agent, cfg).map((channel) => {
+      const binding = (cfg.bindings || []).find((b) => b.agentId === agent.id && b.match?.channel === bindingChannelId(channel));
+      return ({
       id: agent.id,
       name: (hasOwnWorkspace ? identityName : agent.name) || agent.name || identityName || agent.id,
       role: identity.role || meta.role || agent.role || agent.desc || agent.description || '',
       channel,
+      accountId: binding?.match?.accountId || 'default',
       workspace: agent.workspace || `.openclaw/${workspaceRelForAgent(agent, cfg, projectDir)}`,
       agentDir: agent.agentDir,
       persona: meta.persona || '',
@@ -1250,7 +1259,8 @@ async function listConfiguredBots(projectDir) {
       pageAccessToken: channel === 'fb-messenger' ? (env.FB_MESSENGER_PAGE_ACCESS_TOKEN || '') : '',
       appSecret: channel === 'fb-messenger' ? (env.FB_MESSENGER_APP_SECRET || '') : '',
       verifyToken: channel === 'fb-messenger' ? (env.FB_MESSENGER_VERIFY_TOKEN || '') : '',
-    }));
+      });
+    });
   }));
   return rows.flat();
 }
@@ -1726,7 +1736,7 @@ async function startZaloConnectLogin(projectDir, accountId = 'default') {
         sendLog(`[zalo-connect] Plugin missing — installing pinned ${ZALO_CONNECT_PLUGIN_SPEC}...`);
         const repo = String(ZALO_CONNECT_PLUGIN_SPEC).split('#')[0];
         const ref = String(ZALO_CONNECT_PLUGIN_SPEC).split('#')[1] || ZALO_CONNECT_VERSION;
-        const installCmd = `tmp=/tmp/openclaw-plugin-zalo-connect-${ref}; rm -rf "$tmp"; git clone --depth 1 --branch "${ref}" "${repo}" "$tmp" && cd /home/node/project && openclaw plugins install "$tmp" 2>&1`;
+        const installCmd = `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" 2>&1`;
         const inst = await runCapture('docker', ['exec', botContainer, 'sh', '-lc', installCmd], { cwd: projectDir, shell: false });
         const instOut = `${inst.stdout}\n${inst.stderr}`;
         for (const line of instOut.split(/\r?\n/).filter(Boolean)) sendLog(`[zalo-connect] ${line}`);
@@ -1823,72 +1833,146 @@ function cancelZaloLogin() {
   return { ok: true, cancelled: false };
 }
 
-// ── Zalo health snapshot for the dashboard card ─────────────────────────────────
-// One cheap, non-throwing aggregate: backend, pinned vs installed version, channel
-// status (parsed from `openclaw channels status`), QR/session presence, Zalo Mod
-// presence. Everything degrades to null/'unknown' instead of failing the request.
+function buildZaloHealthSnapshot(cfg = {}, statusJson = null, credentialNames = null, options = {}) {
+  const containerRunning = options.containerRunning !== false;
+  const textStatus = String(options.textStatus || '');
+  const agents = new Map((cfg.agents?.list || []).map((agent) => [String(agent.id), agent]));
+  const bindings = (cfg.bindings || []).filter((binding) => binding.match?.channel === 'zalo-connect');
+  const runtimeAccounts = Array.isArray(statusJson?.channelAccounts?.['zalo-connect'])
+    ? statusJson.channelAccounts['zalo-connect']
+    : [];
+  const expected = [];
+  const seen = new Set();
+  for (const binding of bindings) {
+    const accountId = String(binding.match?.accountId || 'default');
+    if (seen.has(accountId)) continue;
+    seen.add(accountId);
+    expected.push({ accountId, agentId: String(binding.agentId || '') });
+  }
+  for (const runtime of runtimeAccounts) {
+    const accountId = String(runtime?.accountId || 'default');
+    if (seen.has(accountId)) continue;
+    seen.add(accountId);
+    expected.push({ accountId, agentId: '' });
+  }
+
+  const credentialSet = Array.isArray(credentialNames)
+    ? new Set(credentialNames.map((name) => String(name || '').toLowerCase()))
+    : null;
+  const fallbackLines = textStatus.split(/\r?\n/).filter((line) => /zalo[- ]connect/i.test(line));
+  const accounts = expected.map(({ accountId, agentId }) => {
+    const runtime = runtimeAccounts.find((item) => String(item?.accountId || 'default') === accountId) || null;
+    const line = fallbackLines.find((item) => accountId === 'default'
+      ? /\bdefault\b/i.test(item) || fallbackLines.length === 1
+      : item.toLowerCase().includes(accountId.toLowerCase())) || '';
+    const fallbackRunning = /running|connected|ready|\bok\b/i.test(line);
+    const fallbackFailed = /stopped|disconnected|error|failed/i.test(line);
+    const configured = runtime ? runtime.configured === true : !!line && !fallbackFailed;
+    const running = runtime ? runtime.running === true : fallbackRunning;
+    const lastError = runtime?.lastError || (fallbackFailed ? line.trim() : null);
+    const credentialFile = accountId === 'default'
+      ? 'zalo-connect-credentials.json'
+      : `zalo-connect-credentials-${accountId}.json`;
+    const fileSaved = credentialSet ? credentialSet.has(credentialFile.toLowerCase()) : false;
+    const agent = agents.get(agentId);
+    return {
+      accountId,
+      agentId,
+      name: agent?.name || agentId || accountId,
+      configured,
+      running,
+      lastError,
+      sessionSaved: fileSaved || runtime?.configured === true,
+    };
+  });
+
+  const total = accounts.length;
+  const running = accounts.filter((account) => account.running).length;
+  const configured = accounts.filter((account) => account.configured).length;
+  const failed = accounts.filter((account) => account.lastError || (!account.running && account.configured)).length;
+  let channelStatus = 'unknown';
+  if (!containerRunning) channelStatus = 'container-stopped';
+  else if (total > 0 && running === total) channelStatus = 'connected';
+  else if (running > 0) channelStatus = 'partial';
+  else if (total > 0 && (failed > 0 || configured > 0)) channelStatus = 'disconnected';
+  else if (statusJson || fallbackLines.length) channelStatus = 'starting';
+
+  return {
+    backend: cfg.channels?.['zalo-connect']?.enabled ? 'zalo-connect' : '',
+    containerRunning,
+    channelStatus,
+    channelStatusLine: fallbackLines.join(' | '),
+    summary: { total, running, configured, failed },
+    accounts,
+  };
+}
+
+// ── Zalo health snapshot for the dashboard ──────────────────────────────────────
+// Runtime JSON is authoritative and account-aware. Text parsing remains only as a
+// compatibility fallback for older OpenClaw builds.
 async function getZaloHealth(projectDir) {
-  const out = {
-    backend: '',
+  const meta = {
     supportedVersion: ZALO_CONNECT_VERSION,
     installedVersion: null,
-    containerRunning: false,
-    channelStatus: 'unknown',
-    channelStatusLine: '',
-    sessionSaved: false,
     zaloModInstalled: false,
-    accountId: 'default',
+    zaloModVersion: null,
   };
-  if (!projectDir) return out;
+  if (!projectDir) return { ...buildZaloHealthSnapshot({}, null, null, { containerRunning: false }), ...meta };
   let cfg = null;
   try { cfg = JSON.parse(await fsp.readFile(join(projectDir, '.openclaw', 'openclaw.json'), 'utf8')); } catch {}
-  if (!cfg) return out;
-  if (cfg.channels?.['zalo-connect']?.enabled) out.backend = 'zalo-connect';
-  if (!out.backend) return out;
-  const binding = (cfg.bindings || []).find((b) => b.match?.channel === out.backend);
-  if (binding?.match?.accountId) out.accountId = binding.match.accountId;
-  out.zaloModInstalled = !!(cfg.plugins?.entries?.['zalo-mod'] || cfg.plugins?.entries?.['openclaw-zalo-mod'])
+  if (!cfg) return { ...buildZaloHealthSnapshot({}, null, null, { containerRunning: false }), ...meta };
+  meta.zaloModInstalled = !!(cfg.plugins?.entries?.['zalo-mod'] || cfg.plugins?.entries?.['openclaw-zalo-mod'])
     || existsSync(join(projectDir, '.openclaw', 'extensions', 'zalo-mod'));
+  meta.zaloModVersion = await getInstalledPluginVersion(projectDir, ['zalo-mod', 'openclaw-zalo-mod']) || null;
+  if (meta.zaloModVersion) meta.zaloModInstalled = true;
 
-  // Installed zalo-connect version — extensions/ is bind-mounted on macOS/Linux; fall back
-  // to reading inside the container (Windows keeps extensions on a named volume).
   const botContainer = getBotContainerName(projectDir);
-  if (out.backend === 'zalo-connect') {
+  if (cfg.channels?.['zalo-connect']?.enabled) {
     const manifestHost = join(projectDir, '.openclaw', 'extensions', 'zalo-connect', 'openclaw.plugin.json');
     try {
-      out.installedVersion = JSON.parse(await fsp.readFile(manifestHost, 'utf8')).version || null;
+      meta.installedVersion = JSON.parse(await fsp.readFile(manifestHost, 'utf8')).version || null;
     } catch {
       try {
         const r = await runCapture('docker', ['exec', botContainer, 'sh', '-lc', 'cat "${OPENCLAW_HOME:-/home/node/project/.openclaw}/extensions/zalo-connect/openclaw.plugin.json" 2>/dev/null'], { cwd: projectDir, shell: false, timeout: 8000 });
-        out.installedVersion = JSON.parse(String(r.stdout || '{}')).version || null;
+        meta.installedVersion = JSON.parse(String(r.stdout || '{}')).version || null;
       } catch {}
     }
-    // QR session/credentials saved? (zalo-connect stores its credential file under the state dir)
-    try {
-      const credRoot = join(projectDir, '.openclaw', 'credentials');
-      const names = existsSync(credRoot) ? await fsp.readdir(credRoot) : [];
-      out.sessionSaved = names.some((n) => n.toLowerCase().includes('zalo-connect'));
-    } catch {}
   }
 
+  let containerRunning = false;
   try {
     const r = await runCapture('docker', ['inspect', '-f', '{{.State.Running}}', botContainer], { shell: false, timeout: 8000 });
-    out.containerRunning = String(r.stdout || '').trim() === 'true';
+    containerRunning = String(r.stdout || '').trim() === 'true';
   } catch {}
-  if (out.containerRunning) {
+  let statusJson = null;
+  let textStatus = '';
+  let credentialNames = null;
+  if (containerRunning) {
     try {
-      const r = await runCapture('docker', ['exec', botContainer, 'sh', '-lc', 'openclaw channels status 2>&1 || true'], { cwd: projectDir, shell: false, timeout: 20000 });
-      const needle = out.backend === 'zalo-connect' ? 'zalo-connect' : 'zalo';
-      const line = String(r.stdout || '').split(/\r?\n/).find((l) => l.toLowerCase().includes(needle)) || '';
-      out.channelStatusLine = line.trim();
-      if (/running|connected|ready|ok/i.test(line)) out.channelStatus = 'connected';
-      else if (/stopped|disconnected|error|failed/i.test(line)) out.channelStatus = 'disconnected';
-      else if (line) out.channelStatus = 'starting';
+      const r = await runCapture('docker', ['exec', botContainer, 'openclaw', 'channels', 'status', '--json'], { cwd: projectDir, shell: false, timeout: 20000 });
+      statusJson = parseJsonText(String(r.stdout || '').trim(), null);
+    } catch {}
+    if (!statusJson) {
+      try {
+        const r = await runCapture('docker', ['exec', botContainer, 'sh', '-lc', 'openclaw channels status 2>&1 || true'], { cwd: projectDir, shell: false, timeout: 20000 });
+        textStatus = String(r.stdout || '');
+      } catch {}
+    }
+    try {
+      const script = "const fs=require('fs'),path=require('path'),os=require('os');const d=path.join(os.homedir(),'.openclaw');let a=[];try{a=fs.readdirSync(d).filter(n=>/^zalo-connect-credentials(?:-[^.]+)?\\.json$/i.test(n))}catch{}process.stdout.write(JSON.stringify(a))";
+      const r = await runCapture('docker', ['exec', botContainer, 'node', '-e', script], { cwd: projectDir, shell: false, timeout: 8000 });
+      credentialNames = parseJsonText(String(r.stdout || '[]').trim(), []);
+    } catch {}
+    try {
+      const versions = await getContainerExtensionVersions(projectDir);
+      const zaloModVersion = versions['zalo-mod'] || versions['openclaw-zalo-mod'] || '';
+      if (zaloModVersion) {
+        meta.zaloModInstalled = true;
+        meta.zaloModVersion = zaloModVersion;
+      }
     } catch {}
-  } else {
-    out.channelStatus = 'container-stopped';
   }
-  return out;
+  return { ...buildZaloHealthSnapshot(cfg, statusJson, credentialNames, { containerRunning, textStatus }), ...meta };
 }
 
 function getBotServiceName(projectDir) {
@@ -2239,7 +2323,10 @@ async function writeCoreProject({ projectDir, osChoice, mode, gatewayPort = 1878
   const agentMetas = [];
   const common = { channelKey: 'telegram', providerKey: '9router', model: DEFAULT_MODEL, deployMode: mode, osChoice, selectedSkills, skills: dataExport.SKILLS || [], agentMetas, gatewayPort, routerPort };
   const cfg = buildOpenclawJson(common);
-  const env = buildEnvFileContent({ ...common, apiKey: '', botToken: '' });
+  // 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
+  // emit a misleading "plugin not enabled" warning before the user has created any bot.
+  const env = buildEnvFileContent({ ...common, apiKey: '', botToken: '', isSharedEnv: true });
   await fsp.writeFile(join(openclawHome, 'openclaw.json'), JSON.stringify(cfg, null, 2), 'utf8');
   await fsp.writeFile(join(projectDir, '.env'), env, 'utf8');
   await syncExecApprovals(projectDir, cfg);
@@ -2486,12 +2573,16 @@ async function installCore({ osChoice, mode, projectDir, gatewayPort = 18789, ro
       await fsp.mkdir(dockerDir, { recursive: true });
       const envContent = existsSync(rootEnvPath)
         ? await fsp.readFile(rootEnvPath, 'utf8')
-        : buildEnvFileContent({ channelKey: 'telegram', providerKey: '9router', deployMode: mode, osChoice, selectedSkills: ['memory', 'web-search', 'scheduler'], skills: dataExport.SKILLS || [], agentMetas: [], apiKey: '', botToken: '' });
+        : buildEnvFileContent({ channelKey: 'telegram', providerKey: '9router', deployMode: mode, osChoice, selectedSkills: ['memory', 'web-search', 'scheduler'], skills: dataExport.SKILLS || [], agentMetas: [], apiKey: '', botToken: '', isSharedEnv: true });
       await fsp.writeFile(dockerEnvPath, envContent, 'utf8');
       sendLog(`Docker env ready: ${dockerEnvPath}`);
       await run('docker', ['compose', 'up', '-d', '--build'], { cwd: dockerDir });
       await applyResolved9RouterApiKey(projectDir).catch(() => {});
-      await recreateDockerBot(projectDir).catch(() => {});
+      // The full compose start already created the bot container. Recreating it here used to
+      // interrupt OpenClaw's first-boot state migration and leave its five-minute lease behind,
+      // making a brand-new project appear to crash-loop until the lease expired. The config is
+      // bind-mounted, so the resolved 9Router key does not require an immediate second recreate.
+      probeCacheClear();
     }
     state.installed = true;
     sendLog('✅ Install completed');
@@ -3226,6 +3317,10 @@ async function installFeature(projectDir, agentId, kind, id) {
   }
 
   if (kind === 'plugin') {
+    const installSpec = pluginInstallSpec(id);
+    const installArgs = ['plugins', 'install', installSpec, '--force'];
+    if (installSpec.startsWith('clawhub:')) installArgs.push('--acknowledge-clawhub-risk');
+
     let composeDir = null;
     if (existsSync(join(projectDir, 'docker-compose.yml'))) {
       composeDir = projectDir;
@@ -3235,9 +3330,9 @@ async function installFeature(projectDir, agentId, kind, id) {
 
     if (composeDir) {
       const botContainer = getBotContainerName(projectDir);
-      sendLog(`[plugin] Installing/updating ${pluginInstallSpec(id)} inside container ${botContainer}...`);
+      sendLog(`[plugin] Installing/updating ${installSpec} inside container ${botContainer}...`);
       
-      const cmd = `cd /home/node/project && openclaw plugins install ${pluginInstallSpec(id)} --force`;
+      const cmd = `cd /home/node/project && openclaw ${installArgs.join(' ')}`;
       const cmdOut = await runCapture('docker', ['exec', botContainer, 'sh', '-lc', cmd], { cwd: projectDir, shell: false });
       
       if (cmdOut) {
@@ -3329,10 +3424,10 @@ async function installFeature(projectDir, agentId, kind, id) {
     } else {
       // Fix any legacy config issues first
       await run('openclaw', ['doctor', '--fix'], { cwd: projectDir, env: openclawProjectEnv(projectDir) }).catch((err) => sendLog(`[plugin] doctor --fix skipped: ${err.message}`));
-      sendLog(`[plugin] Installing ${pluginInstallSpec(id)}...`);
+      sendLog(`[plugin] Installing ${installSpec}...`);
 
       let installSuccess = true;
-      await run('openclaw', ['plugins', 'install', pluginInstallSpec(id), '--force'], {
+      await run('openclaw', installArgs, {
         cwd: projectDir,
         env: openclawProjectEnv(projectDir),
         resolveOnPattern: /Installed plugin:/
@@ -4115,4 +4210,4 @@ export async function startLocalInstaller({ host = '127.0.0.1', preferredPort =
   printRemoteAccessHint(port).catch(() => {});
 }
 
-export { createBotInProject, updateBotInProject, deleteBotInProject, validateOpenclawConfig, startZaloLogin, readBotCredentials, resolveProject9RouterApiKey, installCore, deleteProjectFolder };
+export { createBotInProject, updateBotInProject, deleteBotInProject, validateOpenclawConfig, startZaloLogin, readBotCredentials, resolveProject9RouterApiKey, installCore, deleteProjectFolder, buildZaloHealthSnapshot };

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

@@ -197,7 +197,7 @@ if(touched){console.log('[patch-9router] Applied Codex compatibility patch.');}e
   function buildDockerArtifacts(options) {
     const {
       openClawNpmSpec,
-      openClawRuntimePackages,
+      openClawRuntimePackages = '',
       is9Router,
       isLocal,
       isMultiBot,
@@ -287,6 +287,9 @@ if(touched){console.log('[patch-9router] Applied Codex compatibility patch.');}e
       '      tmp="/tmp/openclaw-plugin-$id-$ref"',
       '      rm -rf "$tmp"',
       '      if git clone --depth 1 --branch "$ref" "$repo" "$tmp" 2>/dev/null; then',
+      '        # Docker Desktop bind mounts can reject chmod on packed .git objects (EACCES).',
+      '        # OpenClaw only needs the plugin payload, never the clone metadata.',
+      '        rm -rf "$tmp/.git"',
       '        openclaw plugins install "$tmp" 2>/dev/null || echo "[entrypoint] warning: failed to install cloned plugin $id"',
       '      else',
       '        echo "[entrypoint] warning: failed to clone plugin $spec"',

package/dist/web/app.js

@@ -799,14 +799,13 @@ function botView() {
         <div class="bot-main-content" style="margin-top: 14px;">
           <div class="card-head" style="margin-bottom: 14px; display: flex; justify-content: space-between; align-items: center;">
             <h3 style="margin: 0; font-size: 16px;">${t('Danh sách bot','Bot list')}</h3>
-            ${(ch === 'zalo-personal' && channelBots.length > 0) ? `<button class="secondary btn-inline" data-zalo-login-trigger type="button" style="min-height: 36px; padding: 6px 12px; font-size: 13px;">🔑 ${t('Đăng nhập Zalo','Zalo Login')}</button>` : ''}
+            ${(ch === 'zalo-personal' && channelBots.length > 0) ? zaloToolbar(channelBots) : ''}
           </div>
           <div class="channel-tabs" style="margin-bottom: 16px;">${BOT_CHANNELS.map(c => c.comingSoon
             ? `<button class="is-coming-soon" disabled title="${t('Sắp ra mắt','Coming soon')}"><img src="${c.icon}" onerror="this.style.display='none'"/>${c.title}<span>${t('Sắp','Soon')}</span></button>`
             : `<button class="${ch===c.id?'active':''}" data-bot-channel="${c.id}"><img src="${c.icon}" onerror="this.style.display='none'"/>${c.title}<span>${bots.filter(b=>b.channel===c.id).length}</span></button>`
           ).join('')}</div>
           ${botListPanel(channelBots)}
-          ${ch === 'zalo-personal' ? zaloHealthCard(channelBots) : ''}
         </div>
       </section>
       <div class="bot-side-col">
@@ -826,6 +825,8 @@ function botView() {
         <div class="dash-version-list" style="margin-top: 18px;">
           <div><span>OpenClaw</span><b>${escapeHtml(openclawVer || '-')}</b></div>
           <div><span>9Router</span><b>${escapeHtml(routerVer || '-')}</b></div>
+          ${ch === 'zalo-personal' ? `<div><span>Zalo Connect</span><b>${escapeHtml(state.zaloHealth?.installedVersion || '-')}</b></div>
+          <div><span>Zalo Mod</span><b>${state.zaloHealth ? escapeHtml(state.zaloHealth.zaloModVersion || (state.zaloHealth.zaloModInstalled ? '-' : t('Chưa cài','Not installed'))) : '…'}</b></div>` : ''}
         </div>
       </section>
       </div>
@@ -896,7 +897,14 @@ function botCreateModal() {
 function botListPanel(bots) {
   const listItems = bots.map(b => {
     const role = (b.role || b.desc || b.description || '').trim() || t('Tr\u1ee3 l\u00fd OpenClaw','OpenClaw assistant');
-    return `<article class="bot-item ${state.activeBotId===b.id?'active':''}" data-bot-id="${escapeHtml(b.id)}"><div class="bot-item-actions"><button class="bot-edit" data-edit-bot="${escapeHtml(b.id)}" title="${t('Sửa bot','Edit bot')}" aria-label="${t('Sửa bot','Edit bot')}">${actionIcon('edit')}</button><button class="bot-delete" data-delete-bot="${escapeHtml(b.id)}" title="${t('X\u00f3a bot','Delete bot')}" aria-label="${t('X\u00f3a bot','Delete bot')}">&times;</button></div><b>${escapeHtml(b.name)}</b><small title="${escapeHtml(role)}">${escapeHtml(role)}</small></article>`;
+    const isZalo = b.channel === 'zalo-personal';
+    const health = isZalo ? zaloAccountHealth(b) : null;
+    const quickBadge = health?.running ? `<span class="zalo-quick-badge">${t('Đã kết nối','Connected')}</span>` : '';
+    const connection = !health ? t('Chưa rõ','Unknown') : health.running ? t('Hoạt động','Active') : health.lastError ? t('Mất kết nối','Disconnected') : t('Đang kết nối','Connecting');
+    const login = !health ? t('Chưa rõ','Unknown') : health.sessionSaved ? t('Đã đăng nhập','Logged in') : t('Chưa đăng nhập','Not logged in');
+    const connectionTone = health?.running ? 'ok' : health?.lastError ? 'bad' : 'warn';
+    const loginTone = health?.sessionSaved ? 'ok' : health ? 'bad' : 'warn';
+    return `<article class="bot-item ${state.activeBotId===b.id?'active':''}" data-bot-id="${escapeHtml(b.id)}"><div class="bot-item-actions"><button class="bot-edit" data-edit-bot="${escapeHtml(b.id)}" title="${t('Sửa bot','Edit bot')}" aria-label="${t('Sửa bot','Edit bot')}">${actionIcon('edit')}</button><button class="bot-delete" data-delete-bot="${escapeHtml(b.id)}" title="${t('X\u00f3a bot','Delete bot')}" aria-label="${t('X\u00f3a bot','Delete bot')}">&times;</button></div><div class="bot-item-title"><b>${escapeHtml(b.name)}</b>${quickBadge}</div><small title="${escapeHtml(role)}">${escapeHtml(role)}</small>${isZalo ? `<div class="zalo-bot-health"><div><span>${t('Kết nối','Connection')}</span><em class="${connectionTone}">${connection}</em></div><div><span>${t('Đăng nhập','Login')}</span><em class="${loginTone}">${login}</em></div></div>` : ''}</article>`;
   });
   listItems.push(`
     <article class="bot-item bot-create-card" data-bot-modal="open">
@@ -1511,33 +1519,17 @@ async function loadFiles(silent=false){
   if (!silent) render();
 }
 async function loadCatalog(silent=false){ state.catalog = await api('/api/catalog'); if (!silent) render(); }
-function zaloHealthCard(channelBots = []) {
-  if (state.zaloBackend !== 'zalo-connect' || !channelBots.length) return '';
-  const h = state.zaloHealth;
-  const chip = (label, tone) => `<span class="runtime-badge ${tone}" style="font-size:11px;">${label}</span>`;
-  let statusChip = chip(t('Chưa rõ','Unknown'), 'warn');
-  if (h) {
-    if (h.channelStatus === 'connected') statusChip = chip(t('Đã kết nối','Connected'), 'ok');
-    else if (h.channelStatus === 'container-stopped') statusChip = chip(t('Container tắt','Container stopped'), 'bad');
-    else if (h.channelStatus === 'disconnected') statusChip = chip(t('Mất kết nối','Disconnected'), 'bad');
-    else if (h.channelStatus === 'starting') statusChip = chip(t('Đang khởi động','Starting'), 'warn');
-  }
-  const ver = h?.installedVersion ? `${h.installedVersion}${h.supportedVersion && h.installedVersion !== h.supportedVersion ? ` → ${h.supportedVersion}` : ''}` : (h ? t('chưa cài','not installed') : '…');
-  return `<div class="card zalo-health-card" style="margin-top:14px; padding:14px;">
-    <div class="card-head" style="margin-bottom:10px; display:flex; justify-content:space-between; align-items:center;">
-      <h3 style="margin:0; font-size:14px;">🩺 Zalo (ZaloConnect)</h3>${statusChip}
-    </div>
-    <div class="dash-version-list" style="margin-top:0;">
-      <div><span>ZaloConnect</span><b>${escapeHtml(ver)}</b></div>
-      <div><span>${t('Phiên QR','QR session')}</span><b>${h ? (h.sessionSaved ? t('Đã lưu','Saved') : t('Chưa đăng nhập','Not logged in')) : '…'}</b></div>
-      <div><span>Zalo Mod</span><b>${h ? (h.zaloModInstalled ? t('Đã cài','Installed') : t('Chưa cài','Not installed')) : '…'}</b></div>
-      ${h?.channelStatusLine ? `<div><span>${t('Kênh','Channel')}</span><b style="font-weight:500; font-size:11px; opacity:.8;">${escapeHtml(h.channelStatusLine.slice(0, 60))}</b></div>` : ''}
-    </div>
-    <div style="display:flex; gap:8px; margin-top:12px;">
-      <button class="secondary icon-btn2" data-zalo-health-refresh type="button" style="flex:1; justify-content:center; font-size:12px; height:32px; border-width:1px;">🔄 ${t('Làm mới','Refresh')}</button>
-      <button class="secondary icon-btn2" data-zalo-login-trigger type="button" style="flex:1; justify-content:center; font-size:12px; height:32px; border-width:1px;">🔑 ${t('Kết nối lại','Reconnect')}</button>
-    </div>
-  </div>`;
+function zaloAccountHealth(bot) {
+  const accounts = state.zaloHealth?.accounts || [];
+  return accounts.find((account) => account.agentId === bot?.id)
+    || accounts.find((account) => account.accountId === (bot?.accountId || 'default'))
+    || null;
+}
+function zaloToolbar(channelBots = []) {
+  const active = channelBots.find((bot) => bot.id === state.activeBotId) || channelBots[0];
+  const health = zaloAccountHealth(active);
+  const loginLabel = health?.sessionSaved ? t('Đăng nhập lại','Log in again') : t('Đăng nhập Zalo','Zalo Login');
+  return `<div class="zalo-toolbar"><button class="secondary btn-inline" data-zalo-health-refresh type="button">${actionIcon('refresh')}<span>${t('Làm mới','Refresh')}</span></button><button class="secondary btn-inline" data-zalo-login-trigger type="button">🔑 <span>${loginLabel}</span></button></div>`;
 }
 async function loadZaloHealth(silent=false){
   if (!activeProjectDir()) { state.zaloHealth = null; return; }
@@ -1553,7 +1545,7 @@ async function loadFeatureFlags(silent=false){
     state.featureInstalled = data.installed || {};
     state.featureVersions = data.versions || {};
     state.zaloBackend = data.zaloBackend || '';
-    if (state.zaloBackend === 'zalo-connect') loadZaloHealth(true).catch(() => {});
+    if (state.zaloBackend === 'zalo-connect') await loadZaloHealth(true).catch(() => {});
   } catch (_) {
     state.featureFlags = {};
     state.featureInstalled = {};

package/dist/web/styles.css

@@ -1790,6 +1790,9 @@ html[data-theme="light"] .bottom .nav.active {
   text-align: right !important;
 }
 
+/* Compact per-account Zalo health — shared versions stay in the right status column. */
+.zalo-toolbar{display:flex;gap:8px;align-items:center}.zalo-toolbar .btn-inline{min-height:36px;padding:6px 12px;font-size:13px}.zalo-toolbar svg{width:14px;height:14px}.bot-item-title{display:flex;align-items:center;gap:8px;min-width:0;padding-right:58px}.bot-item-title b{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.zalo-quick-badge{display:inline-flex;align-items:center;padding:2px 7px;border-radius:999px;border:1px solid rgba(24,194,156,.35);background:rgba(24,194,156,.12);color:#25d6ad;font-size:10px;font-weight:800;white-space:nowrap}.zalo-bot-health{display:grid;gap:6px;margin-top:4px;padding-top:10px;border-top:1px solid rgba(255,255,255,.07)}.zalo-bot-health>div{display:flex;align-items:center;justify-content:space-between;gap:10px}.zalo-bot-health span{color:var(--muted);font-size:11px;font-weight:700}.zalo-bot-health em{font-size:11px;font-style:normal;font-weight:800;text-align:right}.zalo-bot-health em.ok{color:#25d6ad}.zalo-bot-health em.warn{color:#f7bf48}.zalo-bot-health em.bad{color:#ff6574}html[data-theme="light"] .zalo-bot-health{border-top-color:rgba(15,23,42,.08)}@media(max-width:640px){.zalo-toolbar{display:grid;grid-template-columns:1fr 1fr;width:100%}.zalo-toolbar .btn-inline{justify-content:center;padding:6px 8px}.bot-item-title{padding-right:54px}}
+
 /* Ensure bottom navigation bar is visible on tablet and mobile (under 1180px) */
 @media (max-width: 1180px) {
   .bottom {

package/package.json

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