create-openclaw-bot 5.8.17 → 5.8.19

package/dist/server/local-server.js

@@ -19,7 +19,7 @@ const { buildDockerArtifacts } = loadSharedModule('../setup/shared/docker-gen.js
 const { OPENCLAW_NPM_SPEC, NINE_ROUTER_NPM_SPEC, build9RouterProviderConfig, get9RouterBaseUrl } = loadSharedModule('../setup/shared/common-gen.js', '__openclawCommon');
 const dataExport = loadSharedModule('../setup/data/index.js', '__openclawData');
 
-async function syncExecApprovals(projectDir, cfg) {
+async function syncExecApprovals(projectDir, cfg) {
   const openclawHome = join(projectDir, '.openclaw');
   const agentMetas = (cfg.agents?.list || []).map((a) => ({ agentId: a.id }));
   const approvals = buildExecApprovalsJson({ agentMetas });
@@ -41,8 +41,189 @@ async function syncExecApprovals(projectDir, cfg) {
   if (existing.socket) {
     approvals.socket = existing.socket;
   }
-  await fsp.writeFile(path2, JSON.stringify(approvals, null, 2), 'utf8');
-}
+  await fsp.writeFile(path2, JSON.stringify(approvals, null, 2), 'utf8');
+}
+
+async function patchBrowserAutomationHostPreference(projectDir, aliases = [], sendLog = () => {}) {
+  const preferredCdpBlock = `const dns = require('dns').promises;
+const DEFAULT_CDP_URLS = [
+    'host-gateway:9222',
+    'http://127.0.0.1:9222',
+];
+const CDP_URLS = (process.env.OPENCLAW_BROWSER_CDP_URLS || DEFAULT_CDP_URLS.join(','))
+    .split(',')
+    .map((u) => u.trim())
+    .filter(Boolean);
+
+async function normalizeCdpUrl(url) {
+    if (url === 'host-gateway:9222') {
+        try {
+            const resolved = await dns.lookup('host.docker.internal');
+            return 'http://' + resolved.address + ':9222';
+        } catch (_) {
+            return 'http://host.docker.internal:9222';
+        }
+    }
+    return url;
+}
+
+async function connectPreferredChrome() {
+    let lastError;
+    for (const rawUrl of CDP_URLS) {
+        const url = await normalizeCdpUrl(rawUrl);
+        try {
+            const connected = await chromium.connectOverCDP(url, { timeout: 2500 });
+            console.error('[Browser] Connected CDP: ' + url);
+            return connected;
+        } catch (err) {
+            lastError = err;
+        }
+    }
+    throw lastError || new Error('No Chrome CDP endpoint available');
+}`;
+
+  const patchContent = (content) => {
+    let next = content;
+    next = next.replace(
+      "const CDP_URL = 'http://127.0.0.1:9222';",
+      preferredCdpBlock
+    );
+    next = next.replace(
+      'browser = await chromium.connectOverCDP(CDP_URL, { timeout: 5000 });',
+      'browser = await connectPreferredChrome();'
+    );
+    return next;
+  };
+
+  const browserToolCandidates = new Set();
+  const extensionDirs = [];
+  for (const alias of aliases) {
+    const extensionDir = join(projectDir, '.openclaw', 'extensions', alias);
+    extensionDirs.push(extensionDir);
+    browserToolCandidates.add(join(extensionDir, 'browser-tool.js'));
+  }
+
+  const workspaceDirs = new Set();
+  try {
+    const cfgPath = join(projectDir, '.openclaw', 'openclaw.json');
+    if (existsSync(cfgPath)) {
+      const cfg = JSON.parse(await fsp.readFile(cfgPath, 'utf8'));
+      for (const a of cfg.agents?.list || []) {
+        const workspaceRel = a.workspace || cfg.agents?.defaults?.workspace;
+        if (!workspaceRel) continue;
+        const workspacePath = workspaceRel.startsWith('/') ? join(projectDir, workspaceRel.replace(/^\/home\/node\/project\/?/, '')) : join(projectDir, workspaceRel);
+        workspaceDirs.add(workspacePath);
+        browserToolCandidates.add(join(workspacePath, 'plugin-skills', 'browser-automation', 'browser-tool.js'));
+      }
+    }
+  } catch (err) {
+    sendLog(`[browser] Warning: could not scan workspaces for browser-tool.js: ${err.message}`);
+  }
+
+  let patched = 0;
+  for (const file of browserToolCandidates) {
+    if (!existsSync(file)) continue;
+    const content = await fsp.readFile(file, 'utf8');
+    if (content.includes('connectPreferredChrome')) continue;
+    const next = patchContent(content);
+    if (next !== content) {
+      await fsp.writeFile(file, next, 'utf8');
+      patched += 1;
+    }
+  }
+  if (patched > 0) {
+    sendLog(`[browser] Patched ${patched} browser-tool.js file(s) to prefer host Chrome debug before headless Chromium.`);
+  }
+
+  const browserMd = `# Browser Automation
+
+This plugin skill owns browser automation only. For normal web search, use OpenClaw's built-in \`web_search\` capability.
+
+Run commands from this folder or pass the full path from the workspace root:
+
+- \`cd plugin-skills/browser-automation && node browser-tool.js status\`
+- \`node plugin-skills/browser-automation/browser-tool.js status\`
+
+## Chrome Debug Mode
+
+On a desktop machine, start real Chrome in debug mode before asking the bot to browse:
+
+- Windows: run \`start-chrome-debug.bat\`
+- macOS/Linux: run \`./start-chrome-debug.sh\`
+
+The tool will try real host Chrome first. If Chrome debug is not available, it falls back to local headless Chromium, which is suitable for VPS/server use.
+
+## Browser Commands
+
+- \`node plugin-skills/browser-automation/browser-tool.js status\`: check the active browser/tab
+- \`node plugin-skills/browser-automation/browser-tool.js open <url>\`: open a page
+- \`node plugin-skills/browser-automation/browser-tool.js get_text [max_chars]\`: read rendered page text
+- \`node plugin-skills/browser-automation/browser-tool.js get_links [filter]\`: list links
+- \`node plugin-skills/browser-automation/browser-tool.js click "<selector>"\`: click an element
+- \`node plugin-skills/browser-automation/browser-tool.js fill "<selector>" "<text>"\`: fill an input
+- \`node plugin-skills/browser-automation/browser-tool.js scroll [px]\`: scroll the page
+- \`node plugin-skills/browser-automation/browser-tool.js screenshot [path]\`: capture the viewport
+- \`node plugin-skills/browser-automation/browser-tool.js tabs\`: list tabs
+
+Do not call \`search-tool.js\`; browser-automation does not own search. Use \`web_search\` for search and this browser tool only when a rendered browser is needed.
+`;
+
+  const removeManagedBlock = (content, blockId) => {
+    const startTag = `<!-- OPENCLAW:${blockId}:START -->`;
+    const endTag = `<!-- OPENCLAW:${blockId}:END -->`;
+    const startIdx = content.indexOf(startTag);
+    const endIdx = content.indexOf(endTag);
+    if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) return content;
+    return `${content.substring(0, startIdx).trimEnd()}\n${content.substring(endIdx + endTag.length).trimStart()}`.trim() + '\n';
+  };
+
+  const hostOs = normalizeHostOs(await resolveProjectHostOs(projectDir));
+  const shouldKeepBat = hostOs === 'win';
+  const scriptToKeep = shouldKeepBat ? 'start-chrome-debug.bat' : 'start-chrome-debug.sh';
+  const scriptToRemove = shouldKeepBat ? 'start-chrome-debug.sh' : 'start-chrome-debug.bat';
+  const sourceScript = extensionDirs.map((dir) => join(dir, scriptToKeep)).find((file) => existsSync(file));
+  const sourceBrowserTool = extensionDirs.map((dir) => join(dir, 'browser-tool.js')).find((file) => existsSync(file));
+
+  let sanitized = 0;
+  for (const workspacePath of workspaceDirs) {
+    if (!existsSync(workspacePath)) continue;
+    const pluginSkillPath = join(workspacePath, 'plugin-skills', 'browser-automation');
+    await fsp.mkdir(pluginSkillPath, { recursive: true }).catch(() => {});
+    await fsp.rm(join(workspacePath, 'search-tool.js'), { force: true }).catch(() => {});
+    await fsp.rm(join(workspacePath, 'browser-tool.js'), { force: true }).catch(() => {});
+    await fsp.rm(join(workspacePath, 'BROWSER.md'), { force: true }).catch(() => {});
+    await fsp.rm(join(workspacePath, scriptToRemove), { force: true }).catch(() => {});
+    await fsp.rm(join(workspacePath, scriptToKeep), { force: true }).catch(() => {});
+    await fsp.rm(join(pluginSkillPath, scriptToRemove), { force: true }).catch(() => {});
+    if (sourceBrowserTool) {
+      const targetBrowserTool = join(pluginSkillPath, 'browser-tool.js');
+      await fsp.copyFile(sourceBrowserTool, targetBrowserTool).catch(() => {});
+      if (existsSync(targetBrowserTool)) {
+        const content = await fsp.readFile(targetBrowserTool, 'utf8');
+        const next = content.includes('connectPreferredChrome') ? content : patchContent(content);
+        if (next !== content) await fsp.writeFile(targetBrowserTool, next, 'utf8');
+      }
+    }
+    if (sourceScript) {
+      await fsp.copyFile(sourceScript, join(pluginSkillPath, scriptToKeep)).catch(() => {});
+      if (scriptToKeep.endsWith('.sh')) await fsp.chmod(join(pluginSkillPath, scriptToKeep), 0o755).catch(() => {});
+    }
+    await fsp.writeFile(join(pluginSkillPath, 'BROWSER.md'), browserMd, 'utf8');
+    for (const dirName of ['cl-stealth-search', 'openclaw-smart-search']) {
+      await fsp.rm(join(workspacePath, 'plugin-skills', dirName), { recursive: true, force: true }).catch(() => {});
+    }
+    const toolsMdPath = join(workspacePath, 'TOOLS.md');
+    if (existsSync(toolsMdPath)) {
+      const toolsContent = await fsp.readFile(toolsMdPath, 'utf8');
+      const cleaned = removeManagedBlock(toolsContent, 'STEALTH_BROWSER_GUIDE');
+      if (cleaned !== toolsContent) await fsp.writeFile(toolsMdPath, cleaned, 'utf8');
+    }
+    sanitized += 1;
+  }
+  if (sanitized > 0) {
+    sendLog(`[browser] Sanitized ${sanitized} workspace(s): browser assets are in plugin-skills/browser-automation; web_search remains responsible for search.`);
+  }
+}
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const WEB_DIR = resolve(__dirname, '../web');
@@ -88,6 +269,7 @@ const state = {
   mode: null,
   os: null,
   startedAt: null,
+  projects: null,
 };
 
 function sendLog(line) {
@@ -113,13 +295,39 @@ function extractCompletePngBase64(stdout) {
   return b64;
 }
 
-function detectOs() {
-  const platform = process.platform;
-  if (platform === 'win32') return 'win';
-  if (platform === 'darwin') return 'macos';
-  if (platform === 'linux') return os.release().toLowerCase().includes('microsoft') ? 'linux-desktop' : 'linux-desktop';
-  return 'linux-desktop';
-}
+function detectOs() {
+  const platform = process.platform;
+  if (platform === 'win32') return 'win';
+  if (platform === 'darwin') return 'macos';
+  if (platform === 'linux') return os.release().toLowerCase().includes('microsoft') ? 'linux-desktop' : 'linux-desktop';
+  return 'linux-desktop';
+}
+
+function normalizeHostOs(value = '') {
+  const v = String(value || '').trim().toLowerCase();
+  if (['win', 'windows', 'win32'].includes(v)) return 'win';
+  if (['mac', 'macos', 'darwin'].includes(v)) return 'macos';
+  if (['vps', 'server'].includes(v)) return 'vps';
+  if (['linux', 'linux-desktop', 'ubuntu', 'debian'].includes(v)) return 'linux-desktop';
+  return '';
+}
+
+async function resolveProjectHostOs(projectDir = '') {
+  try {
+    const cfgPath = join(projectDir || '', '.openclaw', 'openclaw.json');
+    if (existsSync(cfgPath)) {
+      const cfg = JSON.parse(await fsp.readFile(cfgPath, 'utf8'));
+      const pluginEntries = cfg.plugins?.entries || {};
+      const browserEntry = pluginEntries['browser-automation'] || pluginEntries['openclaw-browser-automation'] || {};
+      const fromConfig = normalizeHostOs(browserEntry.config?.hostOs || cfg.meta?.osChoice || cfg.meta?.hostOs);
+      if (fromConfig) return fromConfig;
+    }
+  } catch {}
+  const fromState = normalizeHostOs(state.os);
+  if (fromState) return fromState;
+  if (/^[A-Za-z]:[\\/]/.test(String(projectDir || ''))) return 'win';
+  return detectOs();
+}
 
 function getRealHomedir() {
   const home = os.homedir();
@@ -1074,7 +1282,7 @@ async function createBotInProject(projectDir, body = {}, runtime = {}) {
   const emoji = String(body.emoji || '').trim();
   const userName = String(body.userName || '').trim();
   const userDesc = String(body.userDescription || body.userDesc || '').trim();
-  const userInfo = [userName ? `- **Tên:** ${userName}` : '', userDesc ? `- **Mô tả:** ${userDesc}` : ''].filter(Boolean).join('\n');
+  const userInfo = [userName ? `- **Tên:** ${userName}` : '', userDesc ? `- **Mô tả:** ${userDesc}` : ''].filter(Boolean).join('\n');
 
   const openclawHome = join(projectDir, '.openclaw');
   await fsp.mkdir(openclawHome, { recursive: true });
@@ -1607,8 +1815,9 @@ async function syncDockerInfra(projectDir, force = false) {
   const botContainer = parseComposeServiceContainerName(compose, 'ai-bot') || `openclaw-${slugify(basename(projectDir))}`;
   const routerContainer = parseComposeServiceContainerName(compose, '9router') || `9router-${slugify(basename(projectDir))}`;
   const composeName = (compose.match(/^name:\s*(\S+)/m) || [])[1] || `oc-${slugify(basename(projectDir))}`;
-  const gatewayPort = state.gatewayPort || 18789;
-  const routerPort = state.routerPort || 20128;
+  const gatewayPort = state.gatewayPort || 18789;
+  const routerPort = state.routerPort || 20128;
+  const osChoice = await resolveProjectHostOs(projectDir);
 
   // Detect features from openclaw.json
   const cfgPath = join(projectDir, '.openclaw', 'openclaw.json');
@@ -1623,9 +1832,10 @@ async function syncDockerInfra(projectDir, force = false) {
     is9Router: true,
     openClawNpmSpec: OPENCLAW_NPM_SPEC,
     openClawRuntimePackages: '',
-    allSkills: [],
-    dockerfilePlugins: [],
-    gatewayPort,
+    allSkills: [],
+    dockerfilePlugins: [],
+    osChoice,
+    gatewayPort,
     routerPort,
     singleComposeName: composeName,
     singleAppContainerName: botContainer,
@@ -1944,6 +2154,7 @@ async function saveState(rootProjectDir) {
     gatewayPort: state.gatewayPort,
     routerUrl: state.routerUrl,
     routerPort: state.routerPort,
+    projects: state.projects || [],
   }, null, 2), 'utf8').catch(() => {});
 }
 
@@ -1951,6 +2162,9 @@ async function loadSavedState(rootProjectDir) {
   const file = join(rootProjectDir, STATE_FILE);
   if (!existsSync(file)) return;
   const saved = JSON.parse(await fsp.readFile(file, 'utf8'));
+  if (Array.isArray(saved?.projects)) {
+    state.projects = saved.projects;
+  }
   if (saved?.projectDir && existsSync(join(saved.projectDir, '.openclaw', 'openclaw.json'))) {
     Object.assign(state, saved, { installed: !!saved.installed });
     await syncRuntimeState(state.projectDir);
@@ -1974,20 +2188,31 @@ function isRestrictedSystemDir(dirPath) {
   if (lower.includes(':\\users\\') || lower.endsWith(':\\users')) {
     const home = resolve(getRealHomedir()).toLowerCase();
     if (lower !== home && !lower.startsWith(home + '\\') && !lower.startsWith(home + '/')) {
-      return true;
+      const cwd = resolve(process.cwd()).toLowerCase();
+      const match = cwd.match(/^([a-z]:\\users\\[^\\]+)/) || cwd.match(/^(\/mnt\/[a-z]\/users\/[^\/]+)/);
+      const cwdHome = match ? match[1] : '';
+      if (!cwdHome || (lower !== cwdHome && !lower.startsWith(cwdHome + '\\') && !lower.startsWith(cwdHome + '/'))) {
+        return true;
+      }
     }
   }
 
   if (process.platform !== 'win32') {
     const unixBlacklist = new Set([
-      'usr', 'var', 'proc', 'sys', 'dev', 'etc', 'sbin', 'bin', 'lib', 'lib64', 'run', 'tmp', 'boot', 'lost+found', 'srv', 'mnt', 'media', 'opt'
+      'usr', 'var', 'proc', 'sys', 'dev', 'etc', 'sbin', 'bin', 'lib', 'lib64', 'run', 'tmp', 'boot', 'lost+found', 'srv', 'mnt', 'media', 'opt',
+      'applications', 'library', 'system', 'volumes', 'private', 'cores', 'network', 'users'
     ]);
     if (unixBlacklist.has(basename(lower))) return true;
     
-    if (lower.startsWith('/home') || lower.startsWith('/root')) {
+    if (lower.startsWith('/home') || lower.startsWith('/root') || lower.startsWith('/mnt/') || lower.startsWith('/users/') || lower === '/users') {
       const realHome = resolve(getRealHomedir()).toLowerCase();
       if (lower !== realHome && !lower.startsWith(realHome + '/')) {
-        return true;
+        const cwd = resolve(process.cwd()).toLowerCase();
+        const match = cwd.match(/^(\/home\/[^\/]+)/) || cwd.match(/^(\/root)/) || cwd.match(/^(\/mnt\/[a-z]\/users\/[^\/]+)/) || cwd.match(/^(\/users\/[^\/]+)/);
+        const cwdHome = match ? match[1] : '';
+        if (!cwdHome || (lower !== cwdHome && !lower.startsWith(cwdHome + '/'))) {
+          return true;
+        }
       }
     }
   }
@@ -2045,108 +2270,114 @@ async function findLatestProject(rootProjectDir) {
   return candidates[0]?.dir || null;
 }
 
-async function discoverProjects(rootProjectDir) {
-  const realHome = getRealHomedir();
-  const roots = [
-    process.env.OPENCLAW_PROJECT_DIR,
-    rootProjectDir,
-    dirname(rootProjectDir),
-    process.env.OPENCLAW_HOME ? dirname(process.env.OPENCLAW_HOME) : '',
-    realHome,
-    join(realHome, 'Documents'),
-  ].filter(Boolean);
-  
-  const drives = await getAvailableDrives();
-  for (const drive of drives) {
-    const entries = await fsp.readdir(drive, { withFileTypes: true }).catch(() => []);
-    for (const e of entries) {
-      if (e.isDirectory() && !e.name.startsWith('$') && !SYSTEM_DIR_BLACKLIST.has(e.name.toLowerCase())) {
-        const fullPath = join(drive, e.name);
-        if (!isRestrictedSystemDir(fullPath)) {
-          roots.push(fullPath);
-        }
+async function ensureProjectsLoaded(rootProjectDir) {
+  if (state.projects !== null) return;
+  state.projects = [];
+  const file = join(rootProjectDir, STATE_FILE);
+  if (existsSync(file)) {
+    try {
+      const saved = JSON.parse(await fsp.readFile(file, 'utf8'));
+      if (Array.isArray(saved?.projects)) {
+        state.projects = saved.projects;
       }
-    }
-  }
-  const seen = new Set();
-  const hits = [];
-  async function walk(dir, depth = 0) {
-    if (!dir || depth > 2 || !existsSync(dir)) return;
-    const full = resolve(dir);
-    if (isRestrictedSystemDir(full)) return;
-    if (seen.has(full)) return;
-    seen.add(full);
-    const cfgPath = join(full, '.openclaw', 'openclaw.json');
-    if (existsSync(cfgPath)) {
-      const st = await fsp.stat(cfgPath).catch(() => null);
-      const runtime = await detectRuntime(full).catch(() => ({ mode: 'unknown', gatewayPort: 0, routerPort: 0, syncSource: 'config' }));
-      const bots = await listConfiguredBots(full).catch(() => []);
-      const uniqueBotCount = new Set(bots.map((b) => b.id)).size;
-      const hasDocker = existsSync(join(full, 'docker', 'openclaw', 'docker-compose.yml'));
-      const isLikelyProject = uniqueBotCount > 0 || hasDocker || existsSync(join(full, '.env')) || existsSync(join(full, 'package.json'));
-      if (!isLikelyProject) return;
-      hits.push({
-        projectDir: full,
-        os: process.platform === 'win32' ? 'Windows' : process.platform === 'darwin' ? 'macOS' : 'Linux',
-        mode: runtime.mode || 'unknown',
-        gatewayPort: runtime.gatewayPort || 0,
-        routerPort: runtime.routerPort || 0,
-        syncSource: runtime.syncSource || 'config',
-        botCount: uniqueBotCount,
-        hasDocker,
-        updatedAt: st?.mtimeMs || 0,
-      });
-      return;
-    }
-    const entries = await fsp.readdir(full, { withFileTypes: true }).catch(() => []);
-    for (const e of entries) {
-      if (!e.isDirectory()) continue;
-      if (e.name === 'node_modules' || e.name.startsWith('.') || SYSTEM_DIR_BLACKLIST.has(e.name.toLowerCase())) continue;
-      await walk(join(full, e.name), depth + 1);
-    }
+    } catch {}
   }
-  for (const root of roots) await walk(root);
-  hits.sort((a, b) =>
-    (b.botCount - a.botCount) ||
-    (Number(b.hasDocker) - Number(a.hasDocker)) ||
-    (b.updatedAt - a.updatedAt)
-  );
-  return hits.slice(0, 20);
 }
 
-async function resolveProjectDir(rootProjectDir, body = {}) {
-  if (body.projectDir && existsSync(join(resolve(String(body.projectDir)), '.openclaw', 'openclaw.json'))) {
-    state.projectDir = resolve(String(body.projectDir));
-    await syncRuntimeState(state.projectDir);
-    return state.projectDir;
-  }
-  const envProjectDir = process.env.OPENCLAW_PROJECT_DIR || (process.env.OPENCLAW_HOME ? dirname(process.env.OPENCLAW_HOME) : '');
-  if (envProjectDir && existsSync(join(resolve(String(envProjectDir)), '.openclaw', 'openclaw.json'))) {
-    state.projectDir = resolve(String(envProjectDir));
-    await syncRuntimeState(state.projectDir);
-    return state.projectDir;
-  }
-  if (state.projectDir && existsSync(join(state.projectDir, '.openclaw', 'openclaw.json'))) {
-    await syncRuntimeState(state.projectDir);
-    return state.projectDir;
-  }
-  await loadSavedState(rootProjectDir);
+async function discoverProjects(rootProjectDir) {
+  await ensureProjectsLoaded(rootProjectDir);
+
   if (state.projectDir && existsSync(join(state.projectDir, '.openclaw', 'openclaw.json'))) {
-    await syncRuntimeState(state.projectDir);
-    return state.projectDir;
+    const resolved = resolve(state.projectDir);
+    if (!state.projects.some(p => resolve(p.projectDir) === resolved)) {
+      const meta = await buildProjectMeta(resolved).catch(() => null);
+      if (meta) state.projects.push(meta);
+    }
   }
-  const found = await findLatestProject(rootProjectDir);
-  if (found) {
-    await syncRuntimeState(found);
-    await saveState(rootProjectDir);
+
+  const updatedProjects = [];
+  for (const p of state.projects) {
+    if (existsSync(join(p.projectDir, '.openclaw', 'openclaw.json'))) {
+      const meta = await buildProjectMeta(p.projectDir).catch(() => null);
+      if (meta) {
+        updatedProjects.push(meta);
+      }
+    }
   }
+  state.projects = updatedProjects;
+  
+  state.projects.sort((a, b) => {
+    const aActive = state.projectDir && resolve(state.projectDir) === resolve(a.projectDir);
+    const bActive = state.projectDir && resolve(state.projectDir) === resolve(b.projectDir);
+    if (aActive && !bActive) return -1;
+    if (!aActive && bActive) return 1;
+    return (b.botCount - a.botCount) || (b.updatedAt - a.updatedAt);
+  });
+
+  await saveState(rootProjectDir).catch(() => {});
+  return state.projects.slice(0, 20);
+}
+
+async function resolveProjectDir(rootProjectDir, body = {}) {
+  if (body.projectDir && existsSync(join(resolve(String(body.projectDir)), '.openclaw', 'openclaw.json'))) {
+    state.projectDir = resolve(String(body.projectDir));
+    await syncRuntimeState(state.projectDir);
+    return state.projectDir;
+  }
+  if (state.projectDir && existsSync(join(state.projectDir, '.openclaw', 'openclaw.json'))) {
+    await syncRuntimeState(state.projectDir);
+    return state.projectDir;
+  }
+  await loadSavedState(rootProjectDir);
+  if (state.projectDir && existsSync(join(state.projectDir, '.openclaw', 'openclaw.json'))) {
+    await syncRuntimeState(state.projectDir);
+    return state.projectDir;
+  }
+  const envProjectDir = process.env.OPENCLAW_PROJECT_DIR || (process.env.OPENCLAW_HOME ? dirname(process.env.OPENCLAW_HOME) : '');
+  if (envProjectDir && existsSync(join(resolve(String(envProjectDir)), '.openclaw', 'openclaw.json'))) {
+    state.projectDir = resolve(String(envProjectDir));
+    await syncRuntimeState(state.projectDir);
+    return state.projectDir;
+  }
+  const found = await findLatestProject(rootProjectDir);
+  if (found) {
+    await syncRuntimeState(found);
+    await saveState(rootProjectDir);
+  }
   return state.projectDir;
 }
 
+async function buildProjectMeta(projectDir) {
+  const full = resolve(projectDir);
+  const cfgPath = join(full, '.openclaw', 'openclaw.json');
+  const st = await fsp.stat(cfgPath).catch(() => null);
+  const runtime = await detectRuntime(full).catch(() => ({ mode: 'unknown', gatewayPort: 0, routerPort: 0, syncSource: 'config' }));
+  const bots = await listConfiguredBots(full).catch(() => []);
+  const uniqueBotCount = new Set(bots.map((b) => b.id)).size;
+  const hasDocker = existsSync(join(full, 'docker', 'openclaw', 'docker-compose.yml'));
+  return {
+    projectDir: full,
+    os: process.platform === 'win32' ? 'Windows' : process.platform === 'darwin' ? 'macOS' : 'Linux',
+    mode: runtime.mode || 'unknown',
+    gatewayPort: runtime.gatewayPort || 0,
+    routerPort: runtime.routerPort || 0,
+    syncSource: runtime.syncSource || 'config',
+    botCount: uniqueBotCount,
+    hasDocker,
+    updatedAt: st?.mtimeMs || 0,
+  };
+}
+
 async function connectExistingProject(projectDir, rootProjectDir) {
   const resolved = resolve(String(projectDir || ''));
   if (!existsSync(join(resolved, '.openclaw', 'openclaw.json'))) throw httpError(404, 'openclaw.json not found in selected project');
   await syncRuntimeState(resolved);
+  await ensureProjectsLoaded(rootProjectDir);
+  const meta = await buildProjectMeta(resolved).catch(() => null);
+  if (meta) {
+    state.projects = state.projects.filter(p => resolve(p.projectDir) !== resolved);
+    state.projects.unshift(meta);
+  }
   await saveState(rootProjectDir);
   const bots = await listConfiguredBots(resolved).catch(() => []);
   return {
@@ -2200,6 +2431,8 @@ async function deleteProjectFolder(projectDir, rootProjectDir) {
     state.projectDir = null;
     state.installed = false;
   }
+  await ensureProjectsLoaded(rootProjectDir);
+  state.projects = state.projects.filter(p => resolve(p.projectDir) !== resolved);
   await saveState(rootProjectDir);
   return { ok: true, projectDir: resolved };
 }
@@ -2263,15 +2496,17 @@ async function applyFeatureToggle(projectDir, agentId, kind, id, enabled) {
     cfg.plugins.allow = cfg.plugins.allow || [];
     if (enabled) {
       if (!cfg.plugins.allow.includes(existingKey)) cfg.plugins.allow.push(existingKey);
-    } else {
-      cfg.plugins.allow = cfg.plugins.allow.filter((x) => x !== existingKey);
-      for (const a of cfg.agents.list) {
-        const bf = await readWorkspaceText(projectDir, a, 'BROWSER.md');
-        if (existsSync(bf.file)) await fsp.rm(bf.file, { force: true });
-        const bt = await readWorkspaceText(projectDir, a, 'browser-tool.js');
-        if (existsSync(bt.file)) await fsp.rm(bt.file, { force: true });
-      }
-    }
+    } else {
+      cfg.plugins.allow = cfg.plugins.allow.filter((x) => x !== existingKey);
+      for (const a of cfg.agents.list) {
+        const bf = await readWorkspaceText(projectDir, a, 'BROWSER.md');
+        if (existsSync(bf.file)) await fsp.rm(bf.file, { force: true });
+        const bt = await readWorkspaceText(projectDir, a, 'browser-tool.js');
+        if (existsSync(bt.file)) await fsp.rm(bt.file, { force: true });
+        const rel = workspaceRelForAgent(a, cfg, projectDir);
+        await fsp.rm(join(projectDir, '.openclaw', rel, 'plugin-skills', 'browser-automation'), { recursive: true, force: true }).catch(() => {});
+      }
+    }
 
     // Write cfgPath early so syncDockerInfra reads the updated openclaw.json
     await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
@@ -2562,12 +2797,17 @@ async function installFeature(projectDir, agentId, kind, id) {
         const cfg = ensureConfigShape(JSON.parse(await fsp.readFile(cfgPath, 'utf8')));
         cfg.plugins = cfg.plugins || { entries: {} };
         cfg.plugins.entries = cfg.plugins.entries || {};
-        const existingKey = aliases.find((a) => cfg.plugins.entries[a]) || aliases[0];
-        cfg.plugins.entries[existingKey] = cfg.plugins.entries[existingKey] || {};
-        cfg.plugins.entries[existingKey].enabled = true;
-        if (existingKey === 'zalo-mod' || existingKey === 'openclaw-zalo-mod') {
-          ensureZaloModPluginConfig(cfg.plugins.entries[existingKey], cfg);
-        }
+        const existingKey = aliases.find((a) => cfg.plugins.entries[a]) || aliases[0];
+        cfg.plugins.entries[existingKey] = cfg.plugins.entries[existingKey] || {};
+        cfg.plugins.entries[existingKey].enabled = true;
+        if (existingKey === 'browser-automation' || existingKey === 'openclaw-browser-automation') {
+          cfg.plugins.entries[existingKey].config = Object.assign({}, cfg.plugins.entries[existingKey].config, {
+            hostOs: await resolveProjectHostOs(projectDir),
+          });
+        }
+        if (existingKey === 'zalo-mod' || existingKey === 'openclaw-zalo-mod') {
+          ensureZaloModPluginConfig(cfg.plugins.entries[existingKey], cfg);
+        }
         // Only add the canonical config key to allow list (not all aliases)
         if (!cfg.plugins.allow.includes(existingKey)) cfg.plugins.allow.push(existingKey);
         await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
@@ -2595,14 +2835,15 @@ async function installFeature(projectDir, agentId, kind, id) {
         }
       }
 
-      // Browser-automation plugin needs Docker rebuild for Playwright/Chromium deps
-      const isBrowserPlugin = id === 'openclaw-browser-automation' || id === 'browser-automation';
-      if (isBrowserPlugin && composeDir) {
-        sendLog(`[plugin] Browser plugin requires Docker rebuild for Playwright/Chromium...`);
-        const svcName = getBotServiceName(projectDir);
-        await run('docker', ['compose', '-f', join(composeDir, 'docker-compose.yml'), 'up', '-d', '--build', '--force-recreate', svcName], { shell: false }).catch((err) => {
-          sendLog(`[plugin] Docker rebuild failed: ${err.message}. Falling back to restart...`);
-          return run('docker', ['restart', botContainer], { shell: false });
+      // Browser-automation plugin needs Docker rebuild for Playwright/Chromium deps
+      const isBrowserPlugin = id === 'openclaw-browser-automation' || id === 'browser-automation';
+      if (isBrowserPlugin && composeDir) {
+        await patchBrowserAutomationHostPreference(projectDir, aliases, sendLog);
+        sendLog(`[plugin] Browser plugin requires Docker rebuild for Playwright/Chromium...`);
+        const svcName = getBotServiceName(projectDir);
+        await run('docker', ['compose', '-f', join(composeDir, 'docker-compose.yml'), 'up', '-d', '--build', '--force-recreate', svcName], { shell: false }).catch((err) => {
+          sendLog(`[plugin] Docker rebuild failed: ${err.message}. Falling back to restart...`);
+          return run('docker', ['restart', botContainer], { shell: false });
         });
       } else if (isZaloMod && composeDir) {
         // Use docker compose up to apply new port mappings from docker-compose.yml
@@ -2638,26 +2879,37 @@ async function installFeature(projectDir, agentId, kind, id) {
       
       // Automatically enable it in config after install
       const cfgPath = join(projectDir, '.openclaw', 'openclaw.json');
-      if (existsSync(cfgPath)) {
-        const cfg = ensureConfigShape(JSON.parse(await fsp.readFile(cfgPath, 'utf8')));
-        cfg.plugins = cfg.plugins || { entries: {} };
-        cfg.plugins.entries = cfg.plugins.entries || {};
-        const pluginAliasMap = {
-          'openclaw-zalo-mod': ['zalo-mod', 'openclaw-zalo-mod'],
-          'openclaw-facebook-crawler': ['openclaw-facebook-crawler', 'openclaw-n8n-facebook-crawler', 'n8n-facebook-crawler'],
-          'openclaw-n8n-facebook-poster': ['openclaw-n8n-facebook-poster', 'openclaw-facebook-poster', 'facebook-poster'],
-        };
-        const aliases = pluginAliasMap[id] || [id];
-        const existingKey = aliases.find((a) => cfg.plugins.entries[a]) || aliases[0];
-        cfg.plugins.entries[existingKey] = cfg.plugins.entries[existingKey] || {};
-        cfg.plugins.entries[existingKey].enabled = true;
-        if (existingKey === 'zalo-mod' || existingKey === 'openclaw-zalo-mod') {
-          ensureZaloModPluginConfig(cfg.plugins.entries[existingKey], cfg);
-        }
-        await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
-      }
-    }
-  }
+      if (existsSync(cfgPath)) {
+        const cfg = ensureConfigShape(JSON.parse(await fsp.readFile(cfgPath, 'utf8')));
+        cfg.plugins = cfg.plugins || { entries: {} };
+        cfg.plugins.entries = cfg.plugins.entries || {};
+        const pluginAliasMap = {
+          'openclaw-browser-automation': ['browser-automation', 'openclaw-browser-automation'],
+          'openclaw-zalo-mod': ['zalo-mod', 'openclaw-zalo-mod'],
+          'openclaw-facebook-crawler': ['openclaw-facebook-crawler', 'openclaw-n8n-facebook-crawler', 'n8n-facebook-crawler'],
+          'openclaw-n8n-facebook-poster': ['openclaw-n8n-facebook-poster', 'openclaw-facebook-poster', 'facebook-poster'],
+        };
+        const aliases = pluginAliasMap[id] || [id];
+        const existingKey = aliases.find((a) => cfg.plugins.entries[a]) || aliases[0];
+        cfg.plugins.entries[existingKey] = cfg.plugins.entries[existingKey] || {};
+        cfg.plugins.entries[existingKey].enabled = true;
+        if (existingKey === 'browser-automation' || existingKey === 'openclaw-browser-automation') {
+          cfg.plugins.entries[existingKey].config = Object.assign({}, cfg.plugins.entries[existingKey].config, {
+            hostOs: await resolveProjectHostOs(projectDir),
+          });
+        }
+        if (existingKey === 'zalo-mod' || existingKey === 'openclaw-zalo-mod') {
+          ensureZaloModPluginConfig(cfg.plugins.entries[existingKey], cfg);
+        }
+        await fsp.writeFile(cfgPath, JSON.stringify(cfg, null, 2), 'utf8');
+      }
+
+      if (id === 'openclaw-browser-automation' || id === 'browser-automation') {
+        const aliases = ['browser-automation', 'openclaw-browser-automation'];
+        await patchBrowserAutomationHostPreference(projectDir, aliases, sendLog);
+      }
+    }
+  }
   return { ok: true };
 }
 
@@ -2931,10 +3183,10 @@ async function handler(req, res, rootProjectDir) {
       const body = await readJson(req);
       return json(res, await connectPickedProject(body.projectName, rootProjectDir));
     }
-    if (url.pathname === '/api/bot/status' && req.method === 'GET') {
-      await resolveProjectDir(rootProjectDir);
-      return json(res, await buildBotStatus());
-    }
+    if (url.pathname === '/api/bot/status' && req.method === 'GET') {
+      await resolveProjectDir(rootProjectDir, Object.fromEntries(url.searchParams));
+      return json(res, await buildBotStatus());
+    }
     if (url.pathname === '/api/bot/credentials' && req.method === 'PUT') {
       const body = await readJson(req);
       const projectDir = await resolveProjectDir(rootProjectDir, body);
@@ -3061,29 +3313,34 @@ async function handler(req, res, rootProjectDir) {
       });
       return json(res, { ok: true, message: 'Zalo login initiated. QR will appear in UI.' });
     }
-    if (url.pathname.startsWith('/api/bot/') && req.method === 'DELETE' && !url.pathname.startsWith('/api/bot/files/')) {
-      const agentId = decodeURIComponent(url.pathname.replace('/api/bot/', ''));
-      const projectDir = await resolveProjectDir(rootProjectDir);
-      const result = await deleteBotInProject(projectDir, agentId);
-      sendLog(`? Bot deleted: ${agentId}`);
-      await recreateDockerBot(projectDir).catch((err) => sendLog(`[docker] recreate skipped/failed: ${err.message}`));
-      return json(res, result);
-    }
-    if (url.pathname === '/api/bot/files' && req.method === 'GET') {
-      await resolveProjectDir(rootProjectDir);
-      return json(res, { files: state.projectDir ? await listMarkdownFiles(state.projectDir, url.searchParams.get('agentId') || '') : [] });
-    }
-    if (url.pathname.startsWith('/api/bot/files/') && state.projectDir) {
-      const name = decodeURIComponent(url.pathname.replace('/api/bot/files/', ''));
-      const file = safeJoin(state.projectDir, name);
-      if (req.method === 'GET') return json(res, { name, content: await fsp.readFile(file, 'utf8') });
-      if (req.method === 'PUT') {
-        if (!name.endsWith('.md')) throw httpError(400, 'Only markdown files (.md) can be modified');
-        const body = await readJson(req);
-        await fsp.writeFile(file, String(body.content || ''), 'utf8');
-        return json(res, { ok: true });
-      }
-    }
+    if (url.pathname.startsWith('/api/bot/') && req.method === 'DELETE' && !url.pathname.startsWith('/api/bot/files/')) {
+      const agentId = decodeURIComponent(url.pathname.replace('/api/bot/', ''));
+      const projectDir = await resolveProjectDir(rootProjectDir, Object.fromEntries(url.searchParams));
+      const result = await deleteBotInProject(projectDir, agentId);
+      sendLog(`? Bot deleted: ${agentId}`);
+      await recreateDockerBot(projectDir).catch((err) => sendLog(`[docker] recreate skipped/failed: ${err.message}`));
+      return json(res, result);
+    }
+    if (url.pathname === '/api/bot/files' && req.method === 'GET') {
+      await resolveProjectDir(rootProjectDir, Object.fromEntries(url.searchParams));
+      return json(res, { files: state.projectDir ? await listMarkdownFiles(state.projectDir, url.searchParams.get('agentId') || '') : [] });
+    }
+    if (url.pathname.startsWith('/api/bot/files/')) {
+      const name = decodeURIComponent(url.pathname.replace('/api/bot/files/', ''));
+      if (req.method === 'GET') {
+        const projectDir = await resolveProjectDir(rootProjectDir, Object.fromEntries(url.searchParams));
+        const file = safeJoin(projectDir, name);
+        return json(res, { name, content: await fsp.readFile(file, 'utf8') });
+      }
+      if (req.method === 'PUT') {
+        if (!name.endsWith('.md')) throw httpError(400, 'Only markdown files (.md) can be modified');
+        const body = await readJson(req);
+        const projectDir = await resolveProjectDir(rootProjectDir, body);
+        const file = safeJoin(projectDir, name);
+        await fsp.writeFile(file, String(body.content || ''), 'utf8');
+        return json(res, { ok: true });
+      }
+    }
     if (url.pathname === '/api/catalog' && req.method === 'GET') return json(res, {
       skills: [
         { name: 'Browser', slug: 'browser' },
@@ -3098,20 +3355,20 @@ async function handler(req, res, rootProjectDir) {
         { name: 'openclaw-n8n-facebook-poster', package: 'openclaw-n8n-facebook-poster' },
       ]
     });
-    if (url.pathname === '/api/features' && req.method === 'GET') {
-      const projectDir = await resolveProjectDir(rootProjectDir);
-      return json(res, await getFeatureFlags(projectDir, url.searchParams.get('agentId') || ''));
-    }
-    if (url.pathname === '/api/features/toggle' && req.method === 'POST') {
-      const body = await readJson(req);
-      const projectDir = await resolveProjectDir(rootProjectDir);
-      return json(res, await applyFeatureToggle(projectDir, body.agentId || '', body.kind, body.id, !!body.enabled));
-    }
-    if (url.pathname === '/api/features/install' && req.method === 'POST') {
-      const body = await readJson(req);
-      const projectDir = await resolveProjectDir(rootProjectDir);
-      return json(res, await installFeature(projectDir, body.agentId || '', body.kind, body.id));
-    }
+    if (url.pathname === '/api/features' && req.method === 'GET') {
+      const projectDir = await resolveProjectDir(rootProjectDir, Object.fromEntries(url.searchParams));
+      return json(res, await getFeatureFlags(projectDir, url.searchParams.get('agentId') || ''));
+    }
+    if (url.pathname === '/api/features/toggle' && req.method === 'POST') {
+      const body = await readJson(req);
+      const projectDir = await resolveProjectDir(rootProjectDir, body);
+      return json(res, await applyFeatureToggle(projectDir, body.agentId || '', body.kind, body.id, !!body.enabled));
+    }
+    if (url.pathname === '/api/features/install' && req.method === 'POST') {
+      const body = await readJson(req);
+      const projectDir = await resolveProjectDir(rootProjectDir, body);
+      return json(res, await installFeature(projectDir, body.agentId || '', body.kind, body.id));
+    }
     if (await serveStatic(req, res)) return;
     json(res, { error: 'Not found' }, 404);
   } catch (err) {