create-openclaw-bot 5.1.14 → 5.2.0

package/style.css

@@ -788,15 +788,17 @@ body::after {
 /* ============ Plugin Grid ============ */
 .plugin-grid {
   display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 12px;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 10px;
+  align-items: stretch;
+  width: 100%;
 }
 
 .plugin-card {
   display: flex;
-  align-items: flex-start;
-  gap: 12px;
-  padding: 16px;
+  align-items: stretch;
+  gap: 0;
+  padding: 12px;
   background: var(--bg-glass);
   backdrop-filter: blur(12px);
   -webkit-backdrop-filter: blur(12px);
@@ -805,11 +807,16 @@ body::after {
   cursor: pointer;
   transition: all var(--duration-normal) var(--ease-out);
   position: relative;
+  min-height: 88px;
+  height: 100%;
+  min-width: 0;
+  overflow: visible;
 }
 
 .plugin-card:hover {
   background: var(--bg-card-hover);
   border-color: rgba(255, 255, 255, 0.15);
+  z-index: 5;
 }
 
 .plugin-card--selected {
@@ -824,59 +831,183 @@ body::after {
   height: 0;
 }
 
-.plugin-card__icon {
-  font-size: 22px;
-  flex-shrink: 0;
-  margin-top: 2px;
+.plugin-card__info {
+  width: 100%;
+  min-width: 0;
+  min-height: 62px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
 }
 
-.plugin-card__info {
-  flex: 1;
+.plugin-card__topline {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+}
+
+.plugin-card__titleline {
+  display: flex;
+  align-items: center;
+  gap: 10px;
   min-width: 0;
+  flex: 1;
+}
+
+.plugin-card__icon {
+  font-size: 20px;
+  flex-shrink: 0;
+  width: 24px;
+  text-align: center;
 }
 
 .plugin-card__name {
   font-size: 13px;
   font-weight: 600;
   color: var(--text-primary);
-  margin-bottom: 4px;
+  line-height: 1.35;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+  margin-bottom: 0;
+  padding-right: 0;
+  min-width: 0;
 }
 
-.plugin-card__desc {
-  font-size: 11px;
-  color: var(--text-muted);
-  line-height: 1.4;
+.plugin-card__subline {
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+  padding-left: 5px;
+  gap: 10px;
+  min-height: 22px;
 }
 
-.plugin-card__note {
-  font-size: 10px;
-  color: rgba(255, 193, 7, 0.7);
-  line-height: 1.3;
-  margin-top: 3px;
+.plugin-card__badge-slot {
+  width: auto;
+  min-width: 0;
+  display: flex;
+  justify-content: flex-end;
+  align-items: center;
 }
 
-.plugin-card__check {
-  position: absolute;
-  top: 8px;
-  right: 10px;
-  width: 20px;
-  height: 20px;
-  border-radius: 50%;
-  background: rgba(255, 255, 255, 0.06);
-  border: 1px solid rgba(255, 255, 255, 0.12);
+.plugin-card__badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 3px 8px;
+  border-radius: 999px;
+  font-size: 9px;
+  font-weight: 700;
+  white-space: nowrap;
+  flex-shrink: 0;
+  letter-spacing: 0.01em;
+}
+
+.plugin-card__badge--placeholder {
+  visibility: hidden;
+}
+
+.plugin-card__badge--recommended {
+  background: rgba(255, 107, 53, 0.14);
+  color: #ffd3bf;
+  border: 1px solid rgba(255, 107, 53, 0.34);
+  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05);
+}
+
+.plugin-card__hint-slot {
   display: flex;
+  justify-content: flex-start;
+  align-items: center;
+}
+
+.plugin-card__hint {
+  position: relative;
+  display: inline-flex;
   align-items: center;
   justify-content: center;
-  font-size: 11px;
-  color: transparent;
+  width: 22px;
+  height: 22px;
+  border-radius: 50%;
+  background: rgba(255, 255, 255, 0.08);
+  border: 1px solid rgba(255, 255, 255, 0.14);
+  color: rgba(255, 255, 255, 0.88);
+  font-size: 10px;
+  font-weight: 700;
   transition: all var(--duration-fast) var(--ease-out);
+  box-shadow: 0 6px 16px rgba(0, 0, 0, 0.2);
 }
 
-.plugin-card--selected .plugin-card__check {
-  background: var(--claw-coral);
-  border-color: var(--claw-coral);
-  color: white;
-  box-shadow: 0 0 10px rgba(255, 107, 53, 0.3);
+.plugin-card__hint--placeholder {
+  visibility: hidden;
+}
+
+.plugin-card__hint:hover,
+.plugin-card__hint:focus-visible {
+  background: rgba(255, 107, 53, 0.18);
+  border-color: rgba(255, 107, 53, 0.38);
+  color: #fff4ee;
+  box-shadow: 0 10px 24px rgba(255, 107, 53, 0.18);
+}
+
+.plugin-card__tooltip {
+  position: absolute;
+  left: 0;
+  top: calc(100% + 10px);
+  width: 240px;
+  padding: 11px 13px;
+  border-radius: 14px;
+  background: linear-gradient(180deg, rgba(30, 22, 22, 0.98), rgba(20, 20, 30, 0.98));
+  border: 1px solid rgba(255, 145, 96, 0.22);
+  box-shadow: 0 22px 48px rgba(0, 0, 0, 0.42);
+  color: #f3dde0;
+  font-size: 11px;
+  line-height: 1.5;
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(6px);
+  transition: opacity var(--duration-fast) var(--ease-out), transform var(--duration-fast) var(--ease-out), visibility var(--duration-fast) var(--ease-out);
+  pointer-events: none;
+  z-index: 20;
+  white-space: normal;
+}
+
+.plugin-card__tooltip::before {
+  content: '';
+  position: absolute;
+  top: -6px;
+  left: 8px;
+  width: 12px;
+  height: 12px;
+  background: rgba(27, 21, 28, 0.98);
+  border-left: 1px solid rgba(255, 145, 96, 0.22);
+  border-top: 1px solid rgba(255, 145, 96, 0.22);
+  transform: rotate(45deg);
+}
+
+.plugin-card__hint:hover .plugin-card__tooltip,
+.plugin-card__hint:focus-visible .plugin-card__tooltip {
+  opacity: 1;
+  visibility: visible;
+  transform: translateY(0);
+}
+
+.plugin-card__hint:hover,
+.plugin-card__hint:focus-visible {
+  z-index: 8;
+}
+
+.plugin-card__switch {
+  pointer-events: none;
+  flex-shrink: 0;
+}
+
+.plugin-card--selected .plugin-card__badge--recommended {
+  background: rgba(255, 107, 53, 0.2);
+  border-color: rgba(255, 107, 53, 0.38);
+  color: #ffd1bc;
 }
 
 /* ============ Prompt Notice ============ */

package/tests/smoke-cli-logic.mjs

@@ -86,6 +86,16 @@ checks.push(() => expectMatch(
   'Native 9Router flow must auto-install 9Router'
 ));
 
+checks.push(() => expect(
+  cli.includes('function providerSupportsMemoryEmbeddings(providerKey) {')
+    && cli.includes("supportsEmbeddings: true")
+    && cli.includes("supportsEmbeddings: false")
+    && cli.includes("function getCliSkillChoices({ providerKey, isVi }) {")
+    && cli.includes("skill.value !== 'memory'")
+    && cli.includes("providerSupportsMemoryEmbeddings(providerKey)"),
+  'CLI skill labels must compute memory recommendations from provider embedding capability instead of hardcoding them'
+));
+
 checks.push(() => expectMatch(
   cli,
   /if \(providerKey === '9router'\) \{[\s\S]*shouldReuseInstalledGlobals\(\) && is9RouterInstalled\(\)[\s\S]*Reusing the installed 9Router[\s\S]*else if \(!is9RouterInstalled\(\)\)/s,
@@ -97,14 +107,14 @@ checks.push(() => expect(
     && cli.includes('const safeDbPath = JSON.stringify(dbPath);')
     && cli.includes("const ROUTER='http://localhost:20128';")
     && cli.includes("fetch(ROUTER + '/api/providers')")
-    && cli.includes("build9RouterSmartRouteSyncScript(path.join(getNative9RouterDataDir(), 'db.json'))"),
-  'Native 9Router flow must write a smart-route sync script based on the platform-specific 9Router data directory'
+    && cli.includes("build9RouterSmartRouteSyncScript(path.join(getProject9RouterDataDir(projectDir), 'db.json'))"),
+  'Native 9Router flow must write a smart-route sync script into the project-controlled 9Router data directory'
 ));
 
 checks.push(() => expectMatch(
   cli,
-  /function getNative9RouterDataDir\(\) \{[\s\S]*process\.platform === 'win32'[\s\S]*AppData[\s\S]*Roaming[\s\S]*9router[\s\S]*os\.homedir\(\)[\s\S]*\.9router/s,
-  'CLI must resolve the correct native 9Router data directory on both Windows and Unix'
+  /function getProjectRuntimeEnv\(projectDir, extraEnv = \{\}\) \{[\s\S]*OPENCLAW_HOME: getProjectOpenClawHome\(projectDir\)[\s\S]*OPENCLAW_STATE_DIR: getProjectOpenClawHome\(projectDir\)[\s\S]*DATA_DIR: getProject9RouterDataDir\(projectDir\)/s,
+  'CLI native runtime must derive OPENCLAW_HOME, OPENCLAW_STATE_DIR, and DATA_DIR from the chosen project directory'
 ));
 
 checks.push(() => expect(
@@ -146,8 +156,8 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   cli,
-  /execSync\(`pm2 start "openclaw gateway run" --name "\$\{appName\}" --cwd "\$\{projectDir\.replace\(\/\\\\\/g, '\/'\)\}" && pm2 save`/,
-  'Native single-bot VPS must start gateway through PM2'
+  /execFileSync\('pm2', \[[\s\S]*'openclaw'[\s\S]*'gateway'[\s\S]*'run'[\s\S]*getProjectRuntimeEnv\(projectDir\)/s,
+  'Native single-bot VPS must start gateway through PM2 with the project runtime environment'
 ));
 
 checks.push(() => expectMatch(
@@ -224,15 +234,18 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   cli,
-  /RUN npm install -g \$\{OPENCLAW_NPM_SPEC\} grammy/,
-  'Docker CLI image must install grammy alongside openclaw so Telegram runtime dependencies resolve'
+  /RUN npm install -g \$\{OPENCLAW_NPM_SPEC\} \$\{OPENCLAW_RUNTIME_PACKAGES\}/,
+  'Docker CLI image must install the full OpenClaw runtime package set alongside openclaw'
 ));
 
 checks.push(() => expect(
   cli.includes("a.add('http://' + entry.address + ':18791')")
     && cli.includes('allowedOrigins:Array.from(a).filter(Boolean)')
+    && cli.includes("bind:'loopback'")
+    && cli.includes("delete c.gateway.customBindHost;")
+    && cli.includes("const gatewayBridge = 'socat TCP-LISTEN:18791,fork,reuseaddr TCP:127.0.0.1:18791 & ';")
     && !cli.includes("a.add(`http://${entry.address}:18791`)"),
-  'Docker CLI patch script must avoid shell-expanding ${entry.address} and must filter null origins'
+  'Docker CLI patch script must keep the gateway loopback-local behind a socat bridge and avoid shell-expanding ${entry.address}'
 ));
 
 checks.push(() => expectMatch(
@@ -255,13 +268,13 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   cli,
-  /function resolveNative9RouterDesktopLaunch\(\) \{[\s\S]*command: process\.execPath[\s\S]*getGlobalNpmRoot\(\), '9router', 'app', 'server\.js'[\s\S]*PORT: '20128'[\s\S]*HOSTNAME: '0\.0\.0\.0'/s,
+  /function resolveNative9RouterDesktopLaunch\(\) \{[\s\S]*get9RouterServerEntryCandidates\(\)\.find\([\s\S]*command: process\.execPath[\s\S]*args: \[serverEntry\][\s\S]*PORT: '20128'[\s\S]*HOSTNAME: '0\.0\.0\.0'/s,
   'Native desktop 9Router launch must bypass the interactive CLI menu by running the 9Router server entry directly'
 ));
 
 checks.push(() => expectMatch(
   cli,
-  /const native9RouterLaunch = resolveNative9RouterDesktopLaunch\(\);[\s\S]*spawnBackgroundProcess\(native9RouterLaunch\.command, native9RouterLaunch\.args, \{[\s\S]*env: native9RouterLaunch\.env/s,
+  /const native9RouterLaunch = resolveNative9RouterDesktopLaunch\(\);[\s\S]*spawnBackgroundProcess\(native9RouterLaunch\.command, native9RouterLaunch\.args, \{[\s\S]*getProjectRuntimeEnv\(projectDir, native9RouterLaunch\.env\)/s,
   'Native desktop 9Router flow must launch through the background helper with the resolved launch spec'
 ));
 
@@ -291,9 +304,16 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectOrder(
   cli,
-  "await syncLocalConfigToHome(projectDir, isVi);",
+  "await ensureProjectRuntimeDirs(projectDir, isVi);",
   "installRelayPluginForProject(projectDir, isVi);",
-  'Relay plugin install must happen after config sync in native flow'
+  'Relay plugin install must happen after preparing the project runtime directories in native flow'
+));
+
+checks.push(() => expect(
+  !cli.includes('Config synced to ~/.openclaw/')
+    && !cli.includes('Config đã được sync vào ~/.openclaw/')
+    && !cli.includes("cp -rn ${localClawDir}/. ${globalClawDir}/"),
+  'CLI native flow must no longer sync project config into the global ~/.openclaw directory'
 ));
 
 checks.push(() => expectMatch(
@@ -334,27 +354,96 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   setup,
-  /RUN npm install -g openclaw@2026\.4\.5 grammy/,
-  'Wizard Dockerfile generation must install grammy alongside openclaw so Telegram runtime dependencies resolve'
+  /RUN npm install -g openclaw@2026\.4\.5 \$\{openClawRuntimePackages\}/,
+  'Wizard Dockerfile generation must install the full OpenClaw runtime package set alongside openclaw'
 ));
 
 checks.push(() => expect(
   setup.includes("a.add('http://' + entry.address + ':18791')")
     && setup.includes('allowedOrigins:Array.from(a).filter(Boolean)')
+    && setup.includes("bind:'loopback'")
+    && setup.includes("delete c.gateway.customBindHost;")
+    && setup.includes("const gatewayBridgePrefix = 'socat TCP-LISTEN:18791,fork,reuseaddr TCP:127.0.0.1:18791 & ';")
     && !setup.includes("a.add(\\`http://\\${entry.address}:18791\\`)"),
-  'Wizard Docker patch command must avoid shell-expanding ${entry.address} and must filter null origins'
+  'Wizard Docker patch command must keep the gateway loopback-local behind a socat bridge and avoid shell-expanding ${entry.address}'
 ));
 
 checks.push(() => expectMatch(
   setup,
-  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*scriptName = 'setup-openclaw-vps\.sh';[\s\S]*npm config set prefix "\$HOME\/\.local"[\s\S]*npm install -g openclaw@2026\.4\.5 pm2@latest[\s\S]*pm2 save && pm2 startup/s,
-  'VPS native script generation must install openclaw+pm2 and persist PM2 startup'
+  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*scriptName = 'setup-openclaw-vps\.sh';[\s\S]*npm config set prefix "\$HOME\/\.local"[\s\S]*PROJECT_DIR="[\s\S]*export OPENCLAW_HOME="\$PROJECT_DIR\/\.openclaw"[\s\S]*export OPENCLAW_STATE_DIR="\$PROJECT_DIR\/\.openclaw"[\s\S]*export DATA_DIR="\$PROJECT_DIR\/\.9router"[\s\S]*npm install -g openclaw@2026\.4\.5[\s\S]*pm2@latest[\s\S]*pm2 save && pm2 startup/s,
+  'VPS native script generation must keep runtime files project-local, install openclaw+pm2, and persist PM2 startup'
+));
+
+checks.push(() => expect(
+  setup.includes('scriptName = isDocker ? \'setup-openclaw-docker-macos.sh\' : \'setup-openclaw-macos.sh\';')
+    && setup.includes('scriptName = \'setup-openclaw-linux.sh\';')
+    && setup.includes('cd "$PROJECT_DIR"')
+    && setup.includes('export OPENCLAW_HOME="$PROJECT_DIR/.openclaw"')
+    && setup.includes('export OPENCLAW_STATE_DIR="$PROJECT_DIR/.openclaw"')
+    && setup.includes('export DATA_DIR="$PROJECT_DIR/.9router"'),
+  'Unix native script generation must use project-local runtime directories and launch from PROJECT_DIR'
+));
+
+checks.push(() => expect(
+  setup.includes("arr.push('call npm install -g 9router || goto :fail');")
+    && setup.includes('function native9RouterServerEntryLookup() {')
+    && setup.includes('return "node -e ')
+    && !setup.includes('return "node -p ')
+    && setup.includes('function windowsHiddenNodeLaunch(targetPath, extraEnv = {}) {')
+    && setup.includes('NINE_ROUTER_ENTRY=%%I')
+    && setup.includes("windowsHiddenNodeLaunch('%NINE_ROUTER_ENTRY%', { PORT: '20128', HOSTNAME: '0.0.0.0', DATA_DIR: '%DATA_DIR%' })")
+    && setup.includes('NINE_ROUTER_ENTRY="$(${native9RouterServerEntryLookup()})"')
+    && setup.includes("const p=path.join(process.env.DATA_DIR||'.9router','db.json');")
+    && setup.includes('nohup env PORT=20128 HOSTNAME=0.0.0.0 DATA_DIR="$PWD/.9router" node "$NINE_ROUTER_ENTRY" >/tmp/9router.log 2>&1 &')
+    && setup.includes('nohup env DATA_DIR="$PWD/.9router" node ./.openclaw/9router-smart-route-sync.js >/tmp/9router-sync.log 2>&1 &')
+    && setup.includes('set "PROJECT_DIR=')
+    && setup.includes('set "OPENCLAW_HOME=%PROJECT_DIR%\\\\.openclaw"')
+    && setup.includes('set "OPENCLAW_STATE_DIR=%PROJECT_DIR%\\\\.openclaw"')
+    && setup.includes('set "DATA_DIR=%PROJECT_DIR%\\\\.9router"'),
+  'Native script generation must install and start a standalone 9Router dashboard on port 20128'
+));
+
+checks.push(() => expect(
+  setup.includes("echo OpenClaw Dashboard: http://127.0.0.1:18791")
+    && setup.includes("echo Other reachable URLs: http://localhost:18791")
+    && setup.includes("echo If the dashboard asks for a Gateway Token, run: openclaw dashboard")
+    && setup.includes("echo 9Router Dashboard: http://127.0.0.1:20128/dashboard")
+    && !setup.includes('set "HOME=%PROJECT_DIR%"')
+    && !setup.includes('set "USERPROFILE=%PROJECT_DIR%"'),
+  'Windows native script generation must print OpenClaw and 9Router dashboard URLs'
+));
+
+checks.push(() => expect(
+  setup.includes("bind: 'loopback'")
+    && !setup.includes("bind: 'custom'")
+    && !setup.includes("customBindHost: '0.0.0.0'")
+    && setup.includes("state.bots[state.activeBotIndex].provider = key;")
+    && setup.includes("state.bots[state.activeBotIndex].model = p.models[0].id;")
+    && setup.includes("state.bots[state.activeBotIndex].provider = state.config.provider;")
+    && setup.includes("state.bots[state.activeBotIndex].model = state.config.model;")
+    && setup.includes("if (state.botCount <= 1 && state.bots[state.activeBotIndex]) {")
+    && setup.includes("state.bots[state.activeBotIndex].token = botTokenEl.value;")
+    && setup.includes("state.bots[state.activeBotIndex].apiKey = apiKeyEl.value;")
+    && setup.includes("const authProviderName = provider.isProxy ? '9router' : state.config.provider;")
+    && setup.includes("const authProviderName = botProvider.isProxy ? '9router' : (bot.provider || state.config.provider);")
+    && setup.includes("const nativeSkillConfigs = state.config.skills")
+    && setup.includes("const nativeSkillInstallCmds = nativeSkillConfigs.map((skill) => `call openclaw skills install ${skill.slug} || echo Warning: Failed to install skill ${skill.slug}`);")
+    && setup.includes("lines.push('call npm install -g agent-browser playwright || goto :fail');")
+    && setup.includes("lines.push('call npx playwright install chromium || goto :fail');")
+    && setup.includes("lines.push('echo Cai skills...');")
+    && setup.includes("const openClawRuntimePackages = 'grammy @grammyjs/runner @grammyjs/transformer-throttler @buape/carbon @larksuiteoapi/node-sdk @slack/web-api';")
+    && setup.includes("memory: 'none'")
+    && setup.includes("workspace: 'workspace'")
+    && setup.includes("workspace: meta.workspaceDir")
+    && !setup.includes("const authProviderName = provider.isProxy ? '9router' : provider.id;")
+    && !setup.includes("const authProviderName = botProvider.isProxy ? '9router' : botProvider.id;"),
+  'Wizard native config generation must keep gateway loopback-local, preserve concrete auth provider ids, disable memory search by default, and sync single-bot provider/model selections into bot state'
 ));
 
 checks.push(() => expectMatch(
   setup,
-  /function providerLines\(arr, shell\) \{[\s\S]*npm install -g 9router[\s\S]*start "9Router" cmd \/k "9router -n -l -H 0\.0\.0\.0 -p 20128 --skip-update"[\s\S]*nohup env PORT=20128 HOSTNAME=0\.0\.0\.0 node "\$\(npm root -g\)\/9router\/app\/server\.js"[\s\S]*9router-smart-route-sync\.js/s,
-  'Native script generation must install and start a standalone 9Router dashboard on port 20128'
+  /window\.downloadNativeScript = function\(\) \{[\s\S]*generateOutput\(\);[\s\S]*const script = window\._nativeScript;/,
+  'Native script download must regenerate the latest wizard output before reading the cached script'
 ));
 
 checks.push(() => expectMatch(
@@ -365,8 +454,8 @@ checks.push(() => expectMatch(
 
 checks.push(() => expectMatch(
   setup,
-  /function native9RouterSyncScriptContent\(\) \{[\s\S]*path\.join\(process\.env\.HOME\|\|process\.env\.USERPROFILE\|\|'\.'\,\'\.9router\'\,\'db\.json\'\)[\s\S]*providerConnections[\s\S]*smart-route/s,
-  'Native script generation must embed a 9Router smart-route sync script'
+  /function native9RouterSyncScriptContent\(\) \{[\s\S]*const p=path\.join\(process\.env\.DATA_DIR\|\|'\.9router','db\.json'\);[\s\S]*const ROUTER='http:\/\/localhost:20128';[\s\S]*fetch\(ROUTER\+'\/api\/providers'\)[\s\S]*d\.connections[\s\S]*smart-route/s,
+  'Native script generation must keep the 9Router sync script project-local via DATA_DIR and sync active providers from the 9Router API'
 ));
 
 checks.push(() => expect(
@@ -377,6 +466,16 @@ checks.push(() => expect(
   '9Router sync logic in setup.js must remove stale smart-route combos when providers are disabled'
 ));
 
+checks.push(() => expect(
+  setup.includes('function providerSupportsMemoryEmbeddings(providerKey) {')
+    && setup.includes('function getSkillDisplayName(skill, providerKey, lang) {')
+    && setup.includes('function getSkillExtraNote(skill, providerKey, lang) {')
+    && setup.includes('renderPluginGrid();')
+    && setup.includes("supportsEmbeddings: true")
+    && setup.includes("supportsEmbeddings: false"),
+  'Wizard skill cards must recompute memory recommendation labels from provider embedding capability when the provider changes'
+));
+
 checks.push(() => expectMatch(
   setup,
   /\.openclaw\/9router-smart-route-sync\.js[\s\S]*pm2 start --name openclaw-9router-sync/s,
@@ -407,13 +506,13 @@ checks.push(() => expect(
 
 checks.push(() => expectMatch(
   setup,
-  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*PORT=20128 HOSTNAME=0\.0\.0\.0 pm2 start "\$\(npm root -g\)\/9router\/app\/server\.js" --name openclaw-multibot-9router --interpreter "\$\(command -v node\)"[\s\S]*pm2 start --name openclaw-multibot -- sh -c "openclaw gateway run"[\s\S]*pm2 logs openclaw-multibot/s,
+  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*NINE_ROUTER_ENTRY="\$\([\s\S]*PORT=20128 HOSTNAME=0\.0\.0\.0 pm2 start "\$NINE_ROUTER_ENTRY" --name openclaw-multibot-9router --interpreter "\$\(command -v node\)"[\s\S]*pm2 start --name openclaw-multibot -- sh -c "openclaw gateway run"[\s\S]*pm2 logs openclaw-multibot/s,
   'VPS multi-bot native script must start the shared gateway via PM2'
 ));
 
 checks.push(() => expectMatch(
   setup,
-  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*PORT=20128 HOSTNAME=0\.0\.0\.0 pm2 start "\$\(npm root -g\)\/9router\/app\/server\.js" --name openclaw-9router --interpreter "\$\(command -v node\)"[\s\S]*pm2 start --name openclaw -- sh -c "openclaw gateway run"[\s\S]*pm2 logs openclaw/s,
+  /else if \(state\.nativeOs === 'vps'\) \{[\s\S]*NINE_ROUTER_ENTRY="\$\([\s\S]*PORT=20128 HOSTNAME=0\.0\.0\.0 pm2 start "\$NINE_ROUTER_ENTRY" --name openclaw-9router --interpreter "\$\(command -v node\)"[\s\S]*pm2 start --name openclaw -- sh -c "openclaw gateway run"[\s\S]*pm2 logs openclaw/s,
   'VPS single-bot native script must start one bot via PM2'
 ));
 

package/upgrade.ps1

@@ -0,0 +1,90 @@
+# OpenClaw Upgrade Script — Windows (PowerShell)
+# Cach dung:
+#   Nhan dup upgrade.ps1 hoac: .\upgrade.ps1
+#   irm https://raw.githubusercontent.com/tuanminhhole/openclaw-setup/main/upgrade.ps1 | iex
+# Chi danh cho Windows. Linux/macOS/Ubuntu: dung upgrade.sh
+
+$ErrorActionPreference = "Stop"
+
+# ── Version ──────────────────────────────────────────────────────────────────
+$VER_STR = ""
+try {
+    if (Test-Path "package.json") {
+        $pkg = Get-Content "package.json" -Raw | ConvertFrom-Json
+        if ($pkg.version) { $VER_STR = " v$($pkg.version)" }
+    }
+} catch {}
+
+# ── Banner: LOGO + BOX ───────────────────────────────────────────────────────
+Write-Host ""
+$logo = @(
+    '████████╗██╗   ██╗ █████╗ ███╗   ██╗███╗   ███╗██╗███╗   ██╗██╗  ██╗██╗  ██╗ ██████╗ ██╗     ███████╗',
+    '╚══██╔══╝██║   ██║██╔══██╗████╗  ██║████╗ ████║██║████╗  ██║██║  ██║██║  ██║██╔═══██╗██║     ██╔════╝',
+    '   ██║   ██║   ██║███████║██╔██╗ ██║██╔████╔██║██║██╔██╗ ██║███████║███████║██║   ██║██║     █████╗  ',
+    '   ██║   ██║   ██║██╔══██║██║╚██╗██║██║╚██╔╝██║██║██║╚██╗██║██╔══██║██╔══██║██║   ██║██║     ██╔══╝  ',
+    '   ██║   ╚██████╔╝██║  ██║██║ ╚████║██║ ╚═╝ ██║██║██║ ╚████║██║  ██║██║  ██║╚██████╔╝███████╗███████╗',
+    '   ╚═╝    ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚══════╝'
+)
+foreach ($l in $logo) { Write-Host $l -ForegroundColor Red }
+Write-Host ""
+
+# Box — node render (handles emoji visual width correctly on all terminals)
+$env:L1 = "  🦞 OpenClaw Setup${VER_STR} | Upgrade Script"
+$env:L2 = "  Windows (PowerShell)"
+node -e @"
+const RED='`u{1b}[0;31m',NC='`u{1b}[0m';
+function vw(s){let w=0;for(const c of[...s]){const cp=c.codePointAt(0);w+=(cp>=0x1F000&&cp<=0x1FFFF?2:1);}return w;}
+const L1=process.env.L1,L2=process.env.L2;
+const INNER=Math.max(vw(L1),vw(L2))+2;
+const D='─'.repeat(INNER);const pad=s=>' '.repeat(Math.max(0,INNER-vw(s)));
+console.log(RED+'╭'+D+'╮'+NC);
+console.log(RED+'│'+NC+L1+pad(L1)+RED+'│'+NC);
+console.log(RED+'│'+NC+L2+pad(L2)+RED+'│'+NC);
+console.log(RED+'╰'+D+'╯'+NC);
+"@
+Write-Host ""
+
+# ── 1. Kiem tra Node.js ──────────────────────────────────────────────────────
+if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+    Write-Host "  ❌ Khong tim thay Node.js." -ForegroundColor Red
+    Write-Host "     Tai LTS: https://nodejs.org/" -ForegroundColor Yellow
+    Read-Host "Nhan Enter de dong"; exit 1
+}
+$nodeVer = node -e "process.stdout.write(process.version)"
+Write-Host "  ✅ Node.js $nodeVer" -ForegroundColor Green
+
+# ── 2. Xac dinh thu muc project ──────────────────────────────────────────────
+$ScriptDir = $PSScriptRoot
+if (-not $ScriptDir -or $ScriptDir -eq "") {
+    $ProjectDir = (Get-Location).Path
+} elseif ((Test-Path (Join-Path $ScriptDir ".openclaw")) -or (Test-Path (Join-Path $ScriptDir "docker"))) {
+    $ProjectDir = $ScriptDir
+} else {
+    $ProjectDir = (Get-Location).Path
+}
+Write-Host "  📁 Project: $ProjectDir" -ForegroundColor DarkGray
+Write-Host ""
+Set-Location $ProjectDir
+
+# ── 3. Chay upgrade ──────────────────────────────────────────────────────────
+Write-Host "  🔄 Dang lay CLI moi nhat va chay upgrade..." -ForegroundColor Cyan
+Write-Host "     npx luon tai create-openclaw-bot@latest — khong can cap nhat tay" -ForegroundColor DarkGray
+Write-Host ""
+
+try {
+    & npx create-openclaw-bot@latest upgrade
+    $exitCode = $LASTEXITCODE
+} catch {
+    Write-Host "  ❌ Loi: $_" -ForegroundColor Red
+    Read-Host "Nhan Enter de dong"; exit 1
+}
+
+Write-Host ""
+if ($exitCode -eq 0) {
+    Write-Host "  🎉 Upgrade hoan tat!" -ForegroundColor Green
+    Write-Host "     Dashboard: http://localhost:18791" -ForegroundColor Cyan
+} else {
+    Write-Host "  ⚠️  Ma loi: $exitCode — xem log o tren." -ForegroundColor Yellow
+}
+Write-Host ""
+Read-Host "Nhan Enter de dong"