create-openclaw-bot 5.5.0 → 5.6.0

package/{cli.js → dist/cli.js}

@@ -9,91 +9,50 @@ import { spawn, execSync, execFileSync } from 'child_process';
 import { createRequire } from 'module';
 
 // ─── Shared generators (dual-mode IIFE + CJS) ────────────────────────────────
-// These modules export via module.exports when required from Node.js
-const _require = createRequire(import.meta.url);
-const {
-  OPENCLAW_NPM_SPEC,
-  OPENCLAW_RUNTIME_PACKAGES,
-  TELEGRAM_RELAY_PLUGIN_SPEC,
-  buildRelayPluginInstallCommand,
-  buildRelayPluginInstallCommandWin,
-  buildTelegramPostInstallChecklist,
-  buildAuthProfilesString,
-  buildAuthProfilesJson,
-} = _require('./setup/shared/common-gen.js');
-
-const {
-  build9RouterSmartRouteSyncScript: build9RouterSmartRouteSyncScriptShared,
-  build9RouterComposeEntrypointScript,
-  buildGatewayPatchCmd,
-  indentBlock,
-  buildDockerArtifacts,
-  encodeBase64Utf8,
-} = _require('./setup/shared/docker-gen.js');
-
-const {
-  buildIdentityDoc,
-  buildSoulDoc,
-  buildTeamDoc,
-  buildUserDoc,
-  buildMemoryDoc,
-  buildBrowserToolJs,
-  buildBrowserDoc,
-  buildSecurityRules,
-  buildAgentsDoc,
-  buildToolsDoc,
-  buildRelayDoc,
-} = _require('./setup/shared/scaffold-gen.js');
+// These modules export via module.exports when required from Node.js
+const _require = createRequire(import.meta.url);
 
-let dataExport = _require('./setup/data/index.js');
-if (!dataExport.CHANNELS) dataExport = globalThis.__openclawData || {};
+function loadSharedModule(modulePath, globalName) {
+  const loaded = _require(modulePath);
+  if (loaded && Object.keys(loaded).length > 0) {
+    return loaded;
+  }
+  return globalThis[globalName] || loaded || {};
+}
 
 const {
-  PROVIDERS: _PROVIDERS,
-  SKILLS: _SKILLS,
-  CHANNELS: _CHANNELS,
-  OLLAMA_MODELS,
-} = dataExport;
+  OPENCLAW_NPM_SPEC,
+  OPENCLAW_RUNTIME_PACKAGES,
+  TELEGRAM_RELAY_PLUGIN_SPEC,
+  buildRelayPluginInstallCommand,
+  buildTelegramPostInstallChecklist,
+} = loadSharedModule('./setup/shared/common-gen.js', '__openclawCommon');
 
 const {
-  buildChromeDebugBat,
-  buildChromeDebugSh,
-} = _require('./setup/shared/runtime-gen.js');
+  buildDockerArtifacts,
+} = loadSharedModule('./setup/shared/docker-gen.js', '__openclawDockerGen');
 
-function buildCLIUninstallScript({ os, projectDir, botName = 'openclaw', isDocker = false }) {
-  const absWin = projectDir.replace(/\//g, '\\');
-  const absUnix = projectDir.replace(/\\/g, '/');
-  if (os === 'win' && !isDocker) {
-    return {
-      name: 'uninstall-openclaw-win.bat',
-      content: `@echo off\r\nsetlocal EnableExtensions\r\nchcp 65001 >nul\r\necho.\r\necho ============================================================\r\necho   OpenClaw Uninstaller - Windows Native\r\necho   Project: ${absWin}\r\necho ============================================================\r\necho.\r\necho [WARNING] This will:\r\necho   1. Kill openclaw and 9router background processes\r\necho   2. Uninstall global npm packages (openclaw, 9router)\r\necho   3. Delete the project folder and all its data\r\necho.\r\nset /p CONFIRM=Nhap YES de xac nhan xoa toan bo: \r\nif /i not "%CONFIRM%"=="YES" (\r\n  echo Huy bo. Khong xoa gi ca.\r\n  pause\r\n  exit /b 0\r\n)\r\necho.\r\necho [1/4] Dang dung cac tien trinh openclaw va 9router...\r\nwmic process where "Name='node.exe' and CommandLine like '%%9router%%'" delete >nul 2>&1\r\nwmic process where "Name='cmd.exe' and CommandLine like '%%9router%%'" delete >nul 2>&1\r\nwmic process where "Name='node.exe' and CommandLine like '%%openclaw.mjs%%'" delete >nul 2>&1\r\ntimeout /t 2 /nobreak >nul\r\necho    OK: Tien trinh da dung.\r\necho.\r\necho [2/4] Dang go cai npm packages toan cau...\r\nset "PATH=%APPDATA%\\npm;%PATH%"\r\ncall npm uninstall -g openclaw 9router grammy @grammyjs/runner @grammyjs/transformer-throttler @buape/carbon @larksuiteoapi/node-sdk @slack/web-api 2>nul\r\necho    OK: npm packages da duoc go cai.\r\necho.\r\necho [3/4] Xoa thu muc project...\r\nset "TARGET=${absWin}"\r\nif exist "%TARGET%" (\r\n  rd /s /q "%TARGET%"\r\n  echo    OK: Da xoa %TARGET%\r\n) else (\r\n  echo    INFO: Thu muc khong ton tai: %TARGET%\r\n)\r\necho.\r\necho [4/4] Xoa thu muc .9router trong Home (neu co)...\r\nif exist "%USERPROFILE%\\.9router" (\r\n  set /p CLEAN_HOME=Xoa ca %USERPROFILE%\\.9router? [YES/no]: \r\n  if /i "%CLEAN_HOME%"=="YES" rd /s /q "%USERPROFILE%\\.9router" >nul 2>&1\r\n)\r\necho.\r\necho ============================================================\r\necho   Go cai hoan tat!\r\necho   De cai lai: chay lai file setup hoac npx create-openclaw-bot\r\necho ============================================================\r\npause\r\nendlocal\r\n`,
-    };
-  }
-  if (os === 'win' && isDocker) {
-    return {
-      name: 'uninstall-openclaw-docker.bat',
-      content: `@echo off\r\nsetlocal EnableExtensions\r\nchcp 65001 >nul\r\necho.\r\necho ============================================================\r\necho   OpenClaw Uninstaller - Docker (Windows)\r\necho   Project: ${absWin}\r\necho ============================================================\r\necho.\r\nset /p CONFIRM=Nhap YES de xac nhan xoa toan bo: \r\nif /i not "%CONFIRM%"=="YES" ( echo Huy bo. & pause & exit /b 0 )\r\necho.\r\necho [1/2] Dang dung Docker containers...\r\ncd /d "${absWin}\\docker\\openclaw" 2>nul && ( docker compose down --volumes --remove-orphans 2>nul || docker-compose down --volumes --remove-orphans 2>nul )\r\necho [2/2] Xoa thu muc project...\r\ncd /d "%USERPROFILE%"\r\nif exist "${absWin}" rd /s /q "${absWin}"\r\necho.\r\necho Go cai hoan tat! De cai lai: npx create-openclaw-bot@latest\r\npause\r\nendlocal\r\n`,
-    };
-  }
-  // macOS / Linux
-  const label = os === 'linux' ? 'macOS' : 'Linux Desktop';
-  const scriptName = isDocker ? 'uninstall-openclaw-docker.sh' : 'uninstall-openclaw.sh';
-  if (!isDocker) {
-    return {
-      name: scriptName,
-      content: `#!/usr/bin/env bash\n# ====== OpenClaw Uninstaller — ${label} (Native) ======\nset -e\nPROJECT_DIR="${absUnix}"\necho ""\necho "============================================================"\necho "  OpenClaw Uninstaller — ${label} Native"\necho "  Project: $PROJECT_DIR"\necho "============================================================"\necho ""\nread -rp "Type YES to confirm full removal: " CONFIRM\nif [ "$CONFIRM" != "YES" ]; then echo "Cancelled."; exit 0; fi\necho "[1/4] Stopping openclaw and 9router..."\nopenclaw gateway stop 2>/dev/null || true\npkill -f "9router" 2>/dev/null || true\nfor port in 18791 20128; do\n  pid=$(lsof -ti tcp:$port 2>/dev/null || true)\n  [ -n "$pid" ] && kill -9 $pid 2>/dev/null || true\ndone\necho "[2/4] Uninstalling npm packages..."\nnpm uninstall -g openclaw 9router grammy @grammyjs/runner @grammyjs/transformer-throttler @buape/carbon @larksuiteoapi/node-sdk @slack/web-api 2>/dev/null || true\nsudo npm uninstall -g openclaw 9router 2>/dev/null || true\necho "[3/4] Removing project directory..."\n[ -d "$PROJECT_DIR" ] && rm -rf "$PROJECT_DIR" && echo "   OK: Deleted $PROJECT_DIR" || echo "   INFO: Not found."\necho "[4/4] Checking home-level dirs..."\nfor dir in "$HOME/.9router" "$HOME/.openclaw"; do\n  if [ -d "$dir" ]; then\n    read -rp "Delete $dir? [YES/no]: " CLEAN\n    [ "$CLEAN" = "YES" ] && rm -rf "$dir" && echo "   OK." || echo "   Kept."\n  fi\ndone\necho ""\necho "============================================================"\necho "  Uninstall complete! Re-install: run setup or npx create-openclaw-bot"\necho "============================================================"\n`,
-    };
-  }
-  return {
-    name: scriptName,
-    content: `#!/usr/bin/env bash\n# ====== OpenClaw Uninstaller — Docker ======\nset -e\nPROJECT_DIR="${absUnix}"\nread -rp "Type YES to confirm: " CONFIRM\n[ "$CONFIRM" = "YES" ] || exit 0\ncd "$PROJECT_DIR/docker/openclaw" 2>/dev/null && docker compose down --volumes --remove-orphans 2>/dev/null || true\nrm -rf "$PROJECT_DIR"\necho "Uninstall complete!"\n`,
-  };
-}
+const {
+  buildWorkspaceFileMap,
+} = loadSharedModule('./setup/shared/workspace-gen.js', '__openclawWorkspace');
+
+const dataExport = loadSharedModule('./setup/data/index.js', '__openclawData');
+
+const {
+  PROVIDERS: _PROVIDERS,
+  SKILLS: _SKILLS,
+  CHANNELS: _CHANNELS,
+  OLLAMA_MODELS,
+} = dataExport;
 
-// TELEGRAM_RELAY_PLUGIN_SPEC đã được import từ common-gen
-const TELEGRAM_RELAY_PLUGIN_ID = TELEGRAM_RELAY_PLUGIN_SPEC;
+const {
+  buildCliChromeDebugArtifacts,
+  buildCliUninstallArtifacts,
+  buildCliUpgradeArtifacts,
+  buildCliStartBotArtifacts,
+} = loadSharedModule('./setup/shared/install-gen.js', '__openclawInstall');
 
-function installRelayPluginForProject(projectDir, isVi) {
+function installRelayPluginForProject(projectDir, isVi) {
   try {
     execSync(`openclaw plugins install ${TELEGRAM_RELAY_PLUGIN_SPEC}`, { cwd: projectDir, stdio: 'ignore' });
     return true;
@@ -598,18 +557,28 @@ function printZaloPersonalLoginInfo({ isVi, deployMode, projectDir }) {
     : `   → If needed, copy the QR into the project folder with: ${copyCmd}`));
 }
 
-async function waitForFile(filePath, timeoutMs = 15000, intervalMs = 500) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (await fs.pathExists(filePath)) {
-      return true;
+async function waitForFile(filePath, timeoutMs = 15000, intervalMs = 500) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await fs.pathExists(filePath)) {
+      return true;
     }
     await new Promise((resolve) => setTimeout(resolve, intervalMs));
-  }
-  return fs.pathExists(filePath);
-}
-
-function extractZaloPairingCode(text) {
+  }
+  return fs.pathExists(filePath);
+}
+
+async function writeGeneratedArtifacts(targetDir, artifacts = []) {
+  for (const artifact of artifacts.filter(Boolean)) {
+    const artifactPath = path.join(targetDir, artifact.name);
+    await fs.writeFile(artifactPath, artifact.content, 'utf8');
+    if (artifact.executable || artifact.name.endsWith('.sh')) {
+      try { await fs.chmod(artifactPath, 0o755); } catch (_) {}
+    }
+  }
+}
+
+function extractZaloPairingCode(text) {
   const value = String(text || '');
   const explicitCommandMatch = value.match(/openclaw pairing approve zalouser\s+([A-Z0-9-]+)/i);
   if (explicitCommandMatch) {
@@ -729,10 +698,10 @@ async function runNativeZaloPersonalLoginFlow({ isVi, projectDir }) {
   }
 }
 
-function runPm2Save({ projectDir, isVi }) {
-  try {
-    execSync('pm2 save', {
-      cwd: projectDir,
+function runPm2Save({ projectDir, isVi }) {
+  try {
+    execSync('pm2 save', {
+      cwd: projectDir,
       stdio: 'inherit',
       shell: true,
       env: process.env
@@ -741,10 +710,138 @@ function runPm2Save({ projectDir, isVi }) {
     console.log(chalk.yellow(isVi
       ? '⚠️  PM2 save khong hoan tat. Bot van co the dang chay, nhung hay thu chay lai `pm2 save` sau.'
       : '⚠️  PM2 save did not complete. The app may still be running, but try `pm2 save` again afterwards.'));
-  }
-}
-
-function startNative9RouterPm2({ isVi, projectDir, appName, syncScriptPath }) {
+  }
+}
+
+function getDetectedOsChoice() {
+  const detectedPlatform = process.platform;
+  return detectedPlatform === 'win32' ? 'windows'
+    : detectedPlatform === 'darwin' ? 'macos'
+    : 'vps';
+}
+
+function getCliSubcommand() {
+  return String(process.argv[2] || '').trim().toLowerCase();
+}
+
+function findProjectDir(startDir = process.cwd()) {
+  let currentDir = path.resolve(startDir);
+
+  while (true) {
+    if (
+      fs.existsSync(path.join(currentDir, '.openclaw'))
+      || fs.existsSync(path.join(currentDir, 'docker', 'openclaw'))
+    ) {
+      return currentDir;
+    }
+
+    const isDockerOpenClawDir =
+      path.basename(currentDir).toLowerCase() === 'openclaw'
+      && path.basename(path.dirname(currentDir)).toLowerCase() === 'docker';
+    if (isDockerOpenClawDir) {
+      const projectDir = path.dirname(path.dirname(currentDir));
+      if (
+        fs.existsSync(path.join(projectDir, '.openclaw'))
+        || fs.existsSync(path.join(currentDir, 'docker-compose.yml'))
+      ) {
+        return projectDir;
+      }
+    }
+
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
+    }
+    currentDir = parentDir;
+  }
+}
+
+function detectProjectDeployMode(projectDir) {
+  const dockerDir = path.join(projectDir, 'docker', 'openclaw');
+  if (
+    fs.existsSync(path.join(dockerDir, 'docker-compose.yml'))
+    || fs.existsSync(path.join(dockerDir, '.env'))
+  ) {
+    return 'docker';
+  }
+  return 'native';
+}
+
+function detectProjectBotName(projectDir) {
+  try {
+    const configPath = path.join(projectDir, '.openclaw', 'openclaw.json');
+    if (fs.existsSync(configPath)) {
+      const config = fs.readJsonSync(configPath);
+      const firstAgentId = config?.agents?.list?.[0]?.id;
+      if (firstAgentId) {
+        return firstAgentId;
+      }
+    }
+  } catch {
+    // fallback below
+  }
+  return path.basename(projectDir);
+}
+
+function detectProjectUses9Router(projectDir) {
+  try {
+    const configPath = path.join(projectDir, '.openclaw', 'openclaw.json');
+    if (fs.existsSync(configPath)) {
+      const config = fs.readJsonSync(configPath);
+      if (config?.models?.providers?.['9router']) {
+        return true;
+      }
+    }
+  } catch {
+    // fallback below
+  }
+  return fs.existsSync(path.join(projectDir, '.9router'));
+}
+
+async function runUpgradeCommand() {
+  const projectDir = findProjectDir();
+  if (!projectDir) {
+    console.error(chalk.red('Error: no OpenClaw project found in the current directory tree.'));
+    console.error(chalk.yellow('Run this inside the bot project folder that contains .openclaw or docker/openclaw.'));
+    process.exit(1);
+  }
+
+  const deployMode = detectProjectDeployMode(projectDir);
+  const osChoice = getDetectedOsChoice();
+  const botName = detectProjectBotName(projectDir);
+  const is9Router = detectProjectUses9Router(projectDir);
+
+  console.log(chalk.cyan('\nRefreshing generated OpenClaw project artifacts...'));
+  console.log(chalk.gray(`   Project: ${projectDir}`));
+  console.log(chalk.gray(`   Mode: ${deployMode}`));
+
+  await writeGeneratedArtifacts(projectDir, buildCliChromeDebugArtifacts());
+  await writeGeneratedArtifacts(projectDir, buildCliUninstallArtifacts({
+    deployMode,
+    osChoice,
+    projectDir,
+    botName,
+  }));
+  await writeGeneratedArtifacts(projectDir, buildCliUpgradeArtifacts());
+
+  if (deployMode !== 'docker') {
+    await writeGeneratedArtifacts(projectDir, buildCliStartBotArtifacts({
+      projectDir,
+      openclawHome: path.join(projectDir, '.openclaw'),
+      is9Router,
+      isVi: false,
+    }));
+  }
+
+  console.log(chalk.green('\nUpgrade artifacts refreshed successfully.'));
+  if (deployMode === 'docker') {
+    console.log(chalk.white(`   Next: cd ${path.join(projectDir, 'docker', 'openclaw')} && docker compose up -d --build`));
+  } else {
+    console.log(chalk.white(`   Next: run ${process.platform === 'win32' ? '.\\start-bot.bat' : './start-bot.sh'} from ${projectDir}`));
+  }
+}
+
+function startNative9RouterPm2({ isVi, projectDir, appName, syncScriptPath }) {
   const routerAppName = `${appName}-9router`;
   const routerLaunch = resolveNative9RouterDesktopLaunch();
   const normalizedProjectDir = projectDir.replace(/\\/g, '/');
@@ -874,10 +971,11 @@ async function writeWorkspaceFiles({
   ownAliases = [],
   otherAgents = [],       // [{ name, agentId }]
   teamRoster = [],
-  userInfo = '',
-  agentWorkspaceDir = 'workspace',
-  isRelayBot = false,
-}) {
+  userInfo = '',
+  agentWorkspaceDir = 'workspace',
+  isRelayBot = false,
+  replyToDirectMessages = true,
+}) {
   const skillListStr = SKILLS
     .filter((s) => selectedSkills.includes(s.value))
     .map((s) => {
@@ -888,58 +986,58 @@ async function writeWorkspaceFiles({
     })
     .join('\n') || (isVi ? '- _(Chưa có skill nào)_' : '- _(No skills installed)_');
 
-  const workspacePath = `/root/.openclaw/${agentWorkspaceDir}/`;
-
-  const identityMd = buildIdentityDoc({ isVi, name: botName, desc: botDesc, richAiNote: false });
-  const soulMd = buildSoulDoc({ isVi, persona, variant: isRelayBot ? 'cli-simple' : 'cli-rich' });
-  const userMd = buildUserDoc({ isVi, userInfo, variant: isRelayBot ? 'cli-multi' : 'cli-single' });
-  const memoryMd = buildMemoryDoc({ isVi, variant: isRelayBot ? 'cli-multi' : 'cli-single' });
-  const agentsMd = buildAgentsDoc({
-    isVi, botName, botDesc, ownAliases, otherAgents,
-    workspacePath,
-    variant: isRelayBot ? 'relay' : 'single',
-    includeSecurity: !isRelayBot,
-  });
-  const toolsMd = buildToolsDoc({
-    isVi, skillListStr, workspacePath,
+  const workspacePath = `.openclaw/${agentWorkspaceDir}/`;
+  const teamRosterFormatted = teamRoster
+    .map((peer, idx) => {
+      const agentId = peer.agentId || String(peer.name || `Bot ${idx + 1}`).toLowerCase().replace(/[^a-z0-9]+/g, '-');
+      const desc = peer.desc || (isVi ? 'Tro ly AI ca nhan' : 'Personal AI assistant');
+      const accountId = peer.accountId ? `, accountId: ${peer.accountId}` : '';
+      const slashCmd = peer.slashCmd ? `, slash: ${peer.slashCmd}` : '';
+      return `- \`${agentId}\`: ${peer.name || `Bot ${idx + 1}`} - ${desc}${accountId}${slashCmd}`;
+    })
+    .join('\n');
+
+  const files = buildWorkspaceFileMap({
+    isVi,
     variant: isRelayBot ? 'relay' : 'single',
+    botName,
+    botDesc,
+    ownAliases,
+    otherAgents,
+    replyToDirectMessages,
+    skillListStr,
+    workspacePath,
     agentWorkspaceDir,
+    persona,
+    userInfo,
+    hasBrowser: isDesktop || isServer,
+    soulVariant: isRelayBot ? 'cli-simple' : 'cli-rich',
+    userVariant: isRelayBot ? 'cli-multi' : 'cli-single',
+    memoryVariant: isRelayBot ? 'cli-multi' : 'cli-single',
+    browserDocVariant: isServer ? 'cli-server' : 'cli-desktop',
+    browserToolVariant: 'cli',
+    includeBrowserTool: isDesktop,
+    teamRosterFormatted,
+    hasScheduler: selectedSkills.includes('scheduler'),
   });
-  const teamSection = teamRoster.length > 0
-    ? `\n\n${buildTeamDoc({
-      isVi,
-      teamRoster,
-      includeAgentIds: isRelayBot,
-      includeAccountIds: isRelayBot && teamRoster.some((p) => p.accountId),
-      relayMode: isRelayBot && otherAgents.length > 0,
-    })}`
-    : '';
-  const relaySection = isRelayBot
-    ? `\n\n${buildRelayDoc(isVi)}`
-    : '';
 
   await fs.ensureDir(workspaceDir);
-  await fs.writeFile(path.join(workspaceDir, 'IDENTITY.md'), identityMd);
-  await fs.writeFile(path.join(workspaceDir, 'SOUL.md'), soulMd);
-  await fs.writeFile(path.join(workspaceDir, 'AGENTS.md'), `${agentsMd}${teamSection}`);
-  await fs.writeFile(path.join(workspaceDir, 'USER.md'), userMd);
-  await fs.writeFile(path.join(workspaceDir, 'TOOLS.md'), `${toolsMd}${relaySection}`);
-  await fs.writeFile(path.join(workspaceDir, 'MEMORY.md'), memoryMd);
+  for (const [name, content] of Object.entries(files)) {
+    await fs.writeFile(path.join(workspaceDir, name), content, 'utf8');
+  }
+}
+
+
+async function main() {
+  const cliSubcommand = getCliSubcommand();
+  if (cliSubcommand === 'upgrade') {
+    await runUpgradeCommand();
+    return;
+  }
 
-  // Browser files
-  if (isDesktop) {
-    await fs.writeFile(path.join(workspaceDir, 'browser-tool.js'), buildBrowserToolJs('cli'));
-    await fs.writeFile(path.join(workspaceDir, 'BROWSER.md'), buildBrowserDoc({ isVi, variant: 'cli-desktop', workspaceRoot: '/root/.openclaw' }));
-  } else if (isServer) {
-    await fs.writeFile(path.join(workspaceDir, 'BROWSER.md'), buildBrowserDoc({ isVi, variant: 'cli-server' }));
-  }
-}
-
-
-async function main() {
-  console.log(chalk.red('\n=================================='));
-  console.log(chalk.redBright(LOGO));
-  console.log(chalk.greenBright('     OpenClaw Auto Setup CLI     '));
+  console.log(chalk.red('\n=================================='));
+  console.log(chalk.redBright(LOGO));
+  console.log(chalk.greenBright('     OpenClaw Auto Setup CLI     '));
   console.log(chalk.red('==================================\n'));
 
   // 1. Language
@@ -1458,7 +1556,7 @@ async function main() {
         [groupId || '*']: { enabled: true, requireMention: false },
       },
       replyToMode: 'first',
-      reactionLevel: 'ack',
+      reactionLevel: 'minimal',
       actions: {
         sendMessage: true,
         reactions: true,
@@ -1481,13 +1579,13 @@ async function main() {
           timeoutSeconds: provider.isLocal ? 900 : 120,
           ...(provider.isLocal ? { llm: { idleTimeoutSeconds: 300 } } : {}),
         },
-        list: agentMetas.map((meta) => ({
-          id: meta.agentId,
-          name: meta.name,
-          workspace: `/root/.openclaw/${meta.workspaceDir}`,
-          agentDir: `/root/.openclaw/agents/${meta.agentId}/agent`,
-          model: { primary: modelsPrimary, fallbacks: [] },
-        })),
+        list: agentMetas.map((meta) => ({
+          id: meta.agentId,
+          name: meta.name,
+          workspace: `.openclaw/${meta.workspaceDir}`,
+          agentDir: `agents/${meta.agentId}/agent`,
+          model: { primary: modelsPrimary, fallbacks: [] },
+        })),
       },
       ...(providerKey === '9router' ? {
         models: {
@@ -1543,11 +1641,7 @@ async function main() {
         auth: { mode: 'token', token: 'cli-dummy-token-xyz123' },
       },
     };
-    sharedConfig.plugins = {
-      entries: {
-        [TELEGRAM_RELAY_PLUGIN_ID]: { enabled: true },
-      },
-    };
+    sharedConfig.plugins = { entries: {} };
 
     if (hasBrowserDesktop) {
       sharedConfig.browser = {
@@ -1621,8 +1715,7 @@ async function main() {
         .map((peer) => ({ name: peer.name, agentId: peer.agentId }));
 
       // agentYaml & auth still needed, keep non-workspace writes here
-      const agentYaml = `name: ${meta.agentId}\ndescription: "${meta.desc}"\n\nmodel:\n  primary: ${modelsPrimary}`;
-      await fs.writeFile(path.join(rootClawDir, 'agents', `${meta.agentId}.yaml`), agentYaml);
+      // .yaml removed — OpenClaw reads config exclusively from openclaw.json
       if (Object.keys(authProfilesJson).length > 0) {
         await fs.writeJson(path.join(rootClawDir, 'agents', meta.agentId, 'agent', 'auth-profiles.json'), authProfilesJson, { spaces: 2 });
       }
@@ -1634,10 +1727,11 @@ async function main() {
         selectedSkills, deployMode,
         isDesktop: hasBrowserDesktop, isServer: hasBrowserServer,
         isMultiBot: true, ownAliases, otherAgents,
-        teamRoster: teamMdRoster, userInfo,
-        agentWorkspaceDir: meta.workspaceDir,
-        isRelayBot: true,
-      });
+        teamRoster: teamMdRoster, userInfo,
+        agentWorkspaceDir: meta.workspaceDir,
+        isRelayBot: true,
+        replyToDirectMessages: true,
+      });
     }
   } else {
   const numBotsToConfigure = 1;
@@ -1654,8 +1748,9 @@ async function main() {
     }));
     const ownAliases = [loopBotName, bots[bIndex]?.slashCmd || '', `bot ${bIndex + 1}`].filter(Boolean);
     const otherBotNames = teamRoster.filter((peer) => peer.idx !== bIndex).map((peer) => peer.name);
-    const loopAgentId = loopBotName.replace(/\s+/g, '-').toLowerCase();
-    const loopBotDir = isMultiBot ? path.join(projectDir, `bot${bIndex+1}`) : projectDir;
+    const loopAgentId = loopBotName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || `bot${bIndex + 1}`;
+    const loopWorkspaceDir = `workspace-${loopAgentId}`;
+    const loopBotDir = isMultiBot ? path.join(projectDir, `bot${bIndex+1}`) : projectDir;
     
     await fs.ensureDir(path.join(loopBotDir, '.openclaw', 'agents', loopAgentId, 'agent'));
     if (Object.keys(authProfilesJson).length > 0) {
@@ -1672,11 +1767,13 @@ async function main() {
           compaction: { mode: 'safeguard' },
           timeoutSeconds: provider.isLocal ? 900 : 120,
           ...(provider.isLocal ? { llm: { idleTimeoutSeconds: 300 } } : {}),
-        },
-        list: [{
-          id: loopAgentId,
-          model: { primary: modelsPrimary, fallbacks: [] }
-        }]
+        },
+        list: [{
+          id: loopAgentId,
+          workspace: `.openclaw/${loopWorkspaceDir}`,
+          agentDir: `agents/${loopAgentId}/agent`,
+          model: { primary: modelsPrimary, fallbacks: [] }
+        }]
       },
       ...(providerKey === '9router' ? {
         models: {
@@ -1760,7 +1857,7 @@ async function main() {
     await fs.writeJson(path.join(loopBotDir, '.openclaw', 'openclaw.json'), botConfig, { spaces: 2 });
     
     // ── Workspace files: use shared writeWorkspaceFiles() ──────────────────────
-    const dockerWorkspaceDir = path.join(loopBotDir, '.openclaw', 'workspace');
+    const dockerWorkspaceDir = path.join(loopBotDir, '.openclaw', loopWorkspaceDir);
     const dockerOwnAliases = [loopBotName, bots[bIndex]?.slashCmd || '', `bot ${bIndex + 1}`].filter(Boolean);
     const dockerOtherAgents = teamRoster
       .filter((peer) => peer.idx !== bIndex)
@@ -1779,70 +1876,44 @@ async function main() {
       isMultiBot,
       ownAliases: dockerOwnAliases,
       otherAgents: dockerOtherAgents,
-      teamRoster,
-      userInfo,
-      agentWorkspaceDir: 'workspace',
-      isRelayBot: isMultiBot,
-    });
+      teamRoster,
+      userInfo,
+      agentWorkspaceDir: loopWorkspaceDir,
+      isRelayBot: isMultiBot,
+      replyToDirectMessages: true,
+    });
 
     if (isMultiBot) {
       // Append per-bot reply rules to AGENTS.md
       const otherBotNames = teamRoster.filter((p) => p.idx !== bIndex).map((p) => p.name);
       const extraAgentsMd = isVi
-        ? `\n\n## Khi nao nen tra loi\n- Trong group, chi tra loi khi tin nhan co alias cua ban: ${dockerOwnAliases.map((a) => `\`${a}\``).join(', ')} hoac username Telegram cua ban.\n- Neu tin nhan khong goi ban, hay im lang hoan toan.\n- Neu tin nhan chi goi ro bot khac ${otherBotNames.length ? otherBotNames.map((n) => `\`${n}\``).join(', ') : '`bot khac`'} thi khong cuop loi.\n- Khi da biet user dang goi ban, hay tha reaction co dinh \`👍\` truoc roi moi tra loi bang text. Khong dung emoji khac.\n- Khi can phoi hop noi bo, dung dung agent id ky thuat trong \`AGENTS.md\`, khong dung ten hien thi.\n- Khi hoi ve vai tro cac bot, dung \`AGENTS.md\` lam nguon su that.`
-        : `\n\n## When To Reply\n- In group chats, only reply when the message contains one of your aliases: ${dockerOwnAliases.map((a) => `\`${a}\``).join(', ')} or your Telegram username.\n- If the message is not calling you, stay completely silent.\n- If the message is clearly calling another bot such as ${otherBotNames.length ? otherBotNames.map((n) => `\`${n}\``).join(', ') : '`another bot`'}, do not hijack it.\n- Once you know the user is calling you, add the fixed reaction \`👍\` first, then send the text reply. Do not use any other reaction emoji.\n- When you need internal coordination, use the exact technical agent id from \`AGENTS.md\`, not the display name.\n- Use \`AGENTS.md\` as the source of truth for team roles.`;
+        ? `\n\n## Khi nao nen tra loi\n- Neu metadata khong noi ro day la group/supergroup, mac dinh xem la chat rieng/DM va tra loi binh thuong.\n- Trong group, chi tra loi khi tin nhan co alias cua ban: ${dockerOwnAliases.map((a) => `\`${a}\``).join(', ')} hoac username Telegram cua ban.\n- Quy tac im lang khi tin nhan khong goi ban chi ap dung cho group chat, khong ap dung cho DM/chat rieng.\n- Neu group message chi goi ro bot khac ${otherBotNames.length ? otherBotNames.map((n) => `\`${n}\``).join(', ') : '`bot khac`'} thi khong cuop loi.\n- Gateway tu dong tha ack reaction; khong goi action react thu cong tru khi user yeu cau.\n- Khi can phoi hop noi bo, dung dung agent id ky thuat trong \`AGENTS.md\`, khong dung ten hien thi.\n- Khi hoi ve vai tro cac bot, dung \`AGENTS.md\` lam nguon su that.`
+        : `\n\n## When To Reply\n- If metadata does not clearly say this is a group/supergroup, treat it as a private DM and reply normally.\n- In group chats, only reply when the message contains one of your aliases: ${dockerOwnAliases.map((a) => `\`${a}\``).join(', ')} or your Telegram username.\n- The stay-silent rule for messages not addressed to you applies only to group chats, never to DMs/private chats.\n- If a group message is clearly calling another bot such as ${otherBotNames.length ? otherBotNames.map((n) => `\`${n}\``).join(', ') : '`another bot`'}, do not hijack it.\n- The gateway automatically sends ack reactions; do not call react manually unless the user asks.\n- When you need internal coordination, use the exact technical agent id from \`AGENTS.md\`, not the display name.\n- Use \`AGENTS.md\` as the source of truth for team roles.`;
       await fs.appendFile(path.join(dockerWorkspaceDir, 'AGENTS.md'), extraAgentsMd);
     }
   } // END FOR LOOP
   }
 
   // ── Chrome Debug scripts — via shared builder (same content as wizard ZIP) ─
-  const batPath = path.join(projectDir, 'start-chrome-debug.bat');
-  await fs.writeFile(batPath, buildChromeDebugBat(), 'utf8');
-  const shPath = path.join(projectDir, 'start-chrome-debug.sh');
-  await fs.writeFile(shPath, buildChromeDebugSh(), 'utf8');
-  try { await fs.chmod(shPath, 0o755); } catch (_) {}
-
-  // ── Uninstall script — write to project dir (native only) ─────────────────
-  if (deployMode !== 'docker') {
-    const _nativeOs = process.platform === 'win32' ? 'win'
-      : process.platform === 'darwin' ? 'linux'
-      : 'linux-desktop';
-    const _uninstallScript = buildCLIUninstallScript({
-      os: _nativeOs, projectDir, botName, isDocker: false,
-    });
-    if (_uninstallScript) {
-      await fs.writeFile(path.join(projectDir, _uninstallScript.name), _uninstallScript.content, 'utf8');
-      if (_uninstallScript.name.endsWith('.sh')) {
-        try { await fs.chmod(path.join(projectDir, _uninstallScript.name), 0o755); } catch (_) {}
-      }
-    }
-  }
+  await writeGeneratedArtifacts(projectDir, buildCliChromeDebugArtifacts());
 
-  // ── start-bot.bat / start-bot.sh — one-click restart scripts ─────────────
-  // Generated for native deployments only (docker has docker compose up)
-  if (deployMode !== 'docker') {
-    const { generateStartBotBat, generateStartBotSh } = _require('./setup/generators/gateway-start-gen.js');
-
-    // Windows: start-bot.bat
-    const startBotBatPath = path.join(projectDir, 'start-bot.bat');
-    const startBotBatContent = generateStartBotBat({
-      projectDir,
-      openclawHome: path.join(projectDir, '.openclaw'),
-      is9Router: providerKey === '9router',
-      isVi,
-    });
-    await fs.writeFile(startBotBatPath, startBotBatContent, 'utf8');
+  // ── Uninstall scripts ───────────────────────────────────────────────────────
+  await writeGeneratedArtifacts(projectDir, buildCliUninstallArtifacts({
+    deployMode, osChoice: detectedOS, projectDir, botName,
+  }));
+
+  // ── Upgrade scripts ─────────────────────────────────────────────────────────
+  await writeGeneratedArtifacts(projectDir, buildCliUpgradeArtifacts());
 
-    // macOS/Linux: start-bot.sh
-    const startBotShPath = path.join(projectDir, 'start-bot.sh');
-    const startBotShContent = generateStartBotSh({
-      projectDir,
-      is9Router: providerKey === '9router',
-      isVi,
-    });
-    await fs.writeFile(startBotShPath, startBotShContent, 'utf8');
-    try { await fs.chmod(startBotShPath, 0o755); } catch (_) {}
+  // ── start-bot.bat / start-bot.sh — one-click restart scripts ─────────────
+  // Generated for native deployments only (docker has docker compose up)
+  if (deployMode !== 'docker') {
+    await writeGeneratedArtifacts(projectDir, buildCliStartBotArtifacts({
+      projectDir,
+      openclawHome: path.join(projectDir, '.openclaw'),
+      is9Router: providerKey === '9router',
+      isVi,
+    }));
 
     console.log(chalk.cyan(
       isVi
@@ -1993,7 +2064,7 @@ async function main() {
       native9RouterSyncScriptPath = await writeNative9RouterSyncScript(projectDir);
     }
 
-    await ensureProjectRuntimeDirs(projectDir, isVi);
+    await ensureProjectRuntimeDirs(projectDir, isVi);
 
     if (isMultiBot && channelKey === 'telegram') {
       installRelayPluginForProject(projectDir, isVi);