@simonyea/holysheep-cli 2.1.40 → 2.1.41

package/src/tools/openclaw.js

@@ -1,925 +0,0 @@
-/**
- * OpenClaw 适配器 (v2 — 基于实测的正确配置格式)
- *
- * 正确方案：写入 HolySheep 的 OpenAI + Anthropic + MiniMax provider，
- * 默认模型固定为 GPT-5.4，同时保留 Claude / MiniMax 模型供 /model 切换。
- */
-const fs = require('fs')
-const path = require('path')
-const os = require('os')
-const { spawnSync, spawn, execSync } = require('child_process')
-const { commandExists } = require('../utils/which')
-const { BRIDGE_CONFIG_FILE } = require('./openclaw-bridge')
-
-const OPENCLAW_DIR = path.join(os.homedir(), '.openclaw')
-const CONFIG_FILE = path.join(OPENCLAW_DIR, 'openclaw.json')
-const OPENCLAW_LAUNCH_AGENTS_DIR = path.join(os.homedir(), 'Library', 'LaunchAgents')
-const OPENCLAW_GATEWAY_PLIST = path.join(OPENCLAW_LAUNCH_AGENTS_DIR, 'ai.openclaw.gateway.plist')
-const isWin = process.platform === 'win32'
-const DEFAULT_BRIDGE_PORT = 18788
-const DEFAULT_GATEWAY_PORT = 18789
-const MAX_PORT_SCAN = 40
-const OPENCLAW_DEFAULT_MODEL = 'gpt-5.4'
-const OPENCLAW_DEFAULT_CODEX_SPARK_MODEL = 'gpt-5.3-codex-spark'
-const OPENCLAW_DEFAULT_CLAUDE_MODEL = 'claude-sonnet-4-6'
-const OPENCLAW_DEFAULT_MINIMAX_MODEL = 'MiniMax-M2.7-highspeed'
-const OPENCLAW_PROVIDER_NAME = 'holysheep'
-
-/**
- * [HolySheep fork v2.1.38 / hs26] Atomic JSON write.
- *
- * Background: `~/.openclaw/` accumulated 30+ `openclaw.json.clobbered.*`
- * backup files (mtime span hours apart, content identical) — OpenClaw's
- * own config layer detected that two processes raced `writeFileSync`
- * against the same path and renamed the half-written file aside to avoid
- * corruption. Each race produced a backup.
- *
- * Root cause: `fs.writeFileSync(path, data)` is NOT atomic — it opens +
- * truncates + writes; a concurrent reader/writer can observe a partial
- * file or overwrite between truncation and final bytes. POSIX
- * `rename(tmp, final)` IS atomic on the same filesystem, so we:
- *   1. Write to `${final}.tmp.${pid}.${rand}`
- *   2. `fs.renameSync(tmp, final)`
- * Windows: `rename` fails if target exists → retry via copyFile + unlink.
- *
- * Never leaves the final path in a half-written state. If two procs race,
- * one's write wins atomically and the other's wins the next one; no
- * .clobbered.* files get produced by OpenClaw.
- */
-function atomicWriteJson(filePath, data) {
-  const dir = path.dirname(filePath)
-  fs.mkdirSync(dir, { recursive: true })
-  const body = JSON.stringify(data, null, 2)
-  const tmp = `${filePath}.tmp.${process.pid}.${Math.random().toString(36).slice(2, 10)}`
-  fs.writeFileSync(tmp, body, 'utf8')
-  try {
-    fs.renameSync(tmp, filePath)
-    return
-  } catch (renameErr) {
-    // Windows: rename fails if target exists. Fall back to copy+unlink.
-    // Also handles cross-device rename (EXDEV) in edge cases.
-    if (process.platform === 'win32' || renameErr.code === 'EXDEV' || renameErr.code === 'EEXIST') {
-      try {
-        fs.copyFileSync(tmp, filePath)
-        try { fs.unlinkSync(tmp) } catch {}
-        return
-      } catch (copyErr) {
-        try { fs.unlinkSync(tmp) } catch {}
-        throw copyErr
-      }
-    }
-    try { fs.unlinkSync(tmp) } catch {}
-    throw renameErr
-  }
-}
-
-/**
- * [HolySheep fork v2.1.38 / hs26] Prune stale OpenClaw config backup files.
- *
- * Removes `~/.openclaw/openclaw.json.clobbered.*` older than 7 days. These
- * are produced by OpenClaw itself when a racy `writeFileSync` is detected,
- * but once our atomicWriteJson is in place no new ones should appear — this
- * cleanup just garbage-collects the historical accumulation without touching
- * `*.last-good` / `*.bak` / `*.pre-*` which users or other tooling may need.
- *
- * Safe: scoped to ONLY the exact glob `openclaw.json.clobbered.*` in the
- * known OpenClaw dir. No-op if dir doesn't exist or user has no matching
- * files. Best-effort (each unlink wrapped in try) so a single locked file
- * won't block the rest of configure().
- */
-function pruneClobberedBackups(maxAgeMs = 7 * 24 * 3600 * 1000) {
-  try {
-    if (!fs.existsSync(OPENCLAW_DIR)) return { scanned: 0, removed: 0 }
-    const entries = fs.readdirSync(OPENCLAW_DIR)
-    const cutoff = Date.now() - maxAgeMs
-    let scanned = 0
-    let removed = 0
-    for (const name of entries) {
-      if (!/^openclaw\.json\.clobbered\./.test(name)) continue
-      scanned++
-      const abs = path.join(OPENCLAW_DIR, name)
-      try {
-        const st = fs.statSync(abs)
-        if (st.mtimeMs < cutoff) {
-          fs.unlinkSync(abs)
-          removed++
-        }
-      } catch {
-        // locked / race — skip
-      }
-    }
-    return { scanned, removed }
-  } catch {
-    return { scanned: 0, removed: 0 }
-  }
-}
-
-
-function getOpenClawBinaryCandidates() {
-  return isWin ? ['openclaw.cmd', 'openclaw'] : ['openclaw']
-}
-
-function getBinaryRunner() {
-  return isWin
-    ? { cmd: 'openclaw.cmd', argsPrefix: [], shell: true, label: 'openclaw', via: 'binary' }
-    : { cmd: 'openclaw', argsPrefix: [], shell: false, label: 'openclaw', via: 'binary' }
-}
-
-function hasOpenClawBinary() {
-  return getOpenClawBinaryCandidates().some((cmd) => commandExists(cmd))
-}
-
-function hasNpx() {
-  return commandExists('npx')
-}
-
-function getRunner(preferNpx = false) {
-  const binaryRunner = hasOpenClawBinary() ? getBinaryRunner() : null
-
-  if (!preferNpx && hasOpenClawBinary()) {
-    return binaryRunner
-  }
-  if (hasNpx()) {
-    return { cmd: 'npx', argsPrefix: ['openclaw'], shell: isWin, label: 'npx openclaw', via: 'npx' }
-  }
-  if (binaryRunner) {
-    return binaryRunner
-  }
-  return null
-}
-
-function runWithRunner(runner, args, opts = {}) {
-  return spawnSync(runner.cmd, [...runner.argsPrefix, ...args], {
-    shell: runner.shell,
-    timeout: opts.timeout || 30000,
-    stdio: opts.stdio || 'pipe',
-    encoding: 'utf8',
-    windowsHide: true,
-  })
-}
-
-function normalizeVersionOutput(text) {
-  return firstLine(text).replace(/^openclaw\s+/i, '').trim()
-}
-
-function probeRunner(runner, timeout) {
-  const result = runWithRunner(runner, ['--version'], { timeout })
-  if (result.error || result.status !== 0) return null
-
-  const version = normalizeVersionOutput(result.stdout || result.stderr || '')
-  return version || null
-}
-
-/** 运行 openclaw CLI（优先全局命令，可切换到 npx 回退） */
-function runOpenClaw(args, opts = {}) {
-  const runner = getRunner(Boolean(opts.preferNpx))
-  if (!runner) {
-    return { status: 1, stdout: '', stderr: 'OpenClaw CLI not found' }
-  }
-
-  return runWithRunner(runner, args, opts)
-}
-
-function spawnOpenClaw(args, opts = {}) {
-  const runner = getRunner(Boolean(opts.preferNpx))
-  if (!runner) throw new Error('OpenClaw CLI not found')
-
-  const { preferNpx: _preferNpx, ...spawnOpts } = opts
-  return spawn(runner.cmd, [...runner.argsPrefix, ...args], {
-    shell: runner.shell,
-    windowsHide: true,
-    ...spawnOpts,
-  })
-}
-
-function getPreferredRuntime() {
-  return module.exports._useNpx || !hasOpenClawBinary()
-}
-
-function firstLine(text) {
-  return String(text || '').trim().split('\n')[0] || ''
-}
-
-function getOpenClawVersion(preferNpx = false) {
-  const runner = getRunner(preferNpx)
-  if (!runner) return null
-  return probeRunner(runner, preferNpx ? 60000 : 15000)
-}
-
-function detectRuntime() {
-  const preferNpx = getPreferredRuntime()
-  const runnerOrder = preferNpx ? [getRunner(true), getRunner(false)] : [getRunner(false), getRunner(true)]
-  const seen = new Set()
-
-  for (const runner of runnerOrder) {
-    if (!runner) continue
-    const key = `${runner.via}:${runner.cmd}:${runner.argsPrefix.join(' ')}`
-    if (seen.has(key)) continue
-    seen.add(key)
-
-    const version = probeRunner(runner, runner.via === 'npx' ? 60000 : 15000)
-    if (version) {
-      return {
-        available: true,
-        via: runner.via,
-        command: runner.label,
-        version,
-      }
-    }
-  }
-
-  const fallbackRunner = getRunner(preferNpx)
-  if (fallbackRunner) {
-    return {
-      available: false,
-      via: fallbackRunner.via,
-      command: fallbackRunner.label,
-      version: null,
-    }
-  }
-
-  return { available: false, via: null, command: null, version: null }
-}
-
-function readBridgeConfig() {
-  try {
-    if (fs.existsSync(BRIDGE_CONFIG_FILE)) {
-      return JSON.parse(fs.readFileSync(BRIDGE_CONFIG_FILE, 'utf8'))
-    }
-  } catch {}
-  return {}
-}
-
-function writeBridgeConfig(data) {
-  // [HolySheep fork v2.1.38 / hs26] Atomic write — see atomicWriteJson.
-  atomicWriteJson(BRIDGE_CONFIG_FILE, data)
-}
-
-function updateBridgeConfig(patch) {
-  const current = readBridgeConfig()
-  writeBridgeConfig({
-    ...current,
-    ...patch,
-  })
-}
-
-function getConfiguredBridgePort(config = readBridgeConfig()) {
-  const port = Number(config?.port)
-  return Number.isInteger(port) && port > 0 ? port : DEFAULT_BRIDGE_PORT
-}
-
-function getBridgeBaseUrl(port = getConfiguredBridgePort()) {
-  return `http://127.0.0.1:${port}/v1`
-}
-
-function waitForBridge(port) {
-  for (let i = 0; i < 10; i++) {
-    const t0 = Date.now()
-    while (Date.now() - t0 < 500) {}
-
-    try {
-      execSync(
-        isWin
-          ? `powershell -NonInteractive -Command "try{(Invoke-WebRequest -Uri http://127.0.0.1:${port}/health -TimeoutSec 1 -UseBasicParsing).StatusCode}catch{exit 1}"`
-          : `curl -sf http://127.0.0.1:${port}/health -o /dev/null --max-time 1`,
-        { stdio: 'ignore', timeout: 3000 }
-      )
-      return true
-    } catch {}
-  }
-
-  return false
-}
-
-function stopBridge() {
-  // 杀掉所有已有的 bridge 进程，避免重新配置时端口冲突
-  try {
-    if (isWin) {
-      execSync('taskkill /F /FI "WINDOWTITLE eq openclaw-bridge*" 2>nul', { shell: true, stdio: 'ignore' })
-      // 按命令行匹配
-      const out = execSync('wmic process where "commandline like \'%openclaw-bridge%\'" get processid', { shell: true, stdio: 'pipe', encoding: 'utf8' })
-      const pids = out.match(/\d+/g)
-      if (pids) pids.forEach(pid => { try { execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore' }) } catch {} })
-    } else {
-      execSync("pkill -f 'openclaw-bridge' 2>/dev/null || true", { shell: true, stdio: 'ignore' })
-    }
-  } catch {}
-}
-
-function startBridge(port) {
-  if (waitForBridge(port)) return true
-
-  const scriptPath = path.join(__dirname, '..', 'index.js')
-  // Windows: use shell+node command to avoid ERROR_FILE_NOT_FOUND with process.execPath
-  // (Windows Store / nvm paths can be unresolvable when spawning detached)
-  // Windows: use 'node' (resolved via PATH by CreateProcess) without shell:true.
-  // shell:true spawns cmd.exe /c which exits after the command, breaking detach.
-  const spawnCmd = isWin ? 'node' : process.execPath
-  const spawnOpts = { detached: true, stdio: 'ignore', windowsHide: true }
-  const child = spawn(spawnCmd, [scriptPath, 'openclaw-bridge', '--port', String(port)], spawnOpts)
-  child.unref()
-  return waitForBridge(port)
-}
-
-function getBridgeCommand(port = getConfiguredBridgePort()) {
-  return `hs openclaw-bridge --port ${port}`
-}
-
-function pickPrimaryModel(primaryModel, selectedModels) {
-  const models = Array.isArray(selectedModels) ? selectedModels : []
-  return primaryModel || models[0] || OPENCLAW_DEFAULT_MODEL
-}
-
-function readConfig() {
-  try {
-    if (fs.existsSync(CONFIG_FILE)) {
-      const raw = fs.readFileSync(CONFIG_FILE, 'utf8')
-      try {
-        return JSON.parse(raw)
-      } catch {
-        // 兼容极少数带注释的配置，但不要误伤 https:// 之类的 URL
-        return JSON.parse(raw.replace(/^\s*\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, ''))
-      }
-    }
-  } catch {}
-  return {}
-}
-
-function getConfiguredGatewayPort(config = readConfig()) {
-  const port = Number(config?.gateway?.port)
-  return Number.isInteger(port) && port > 0 ? port : DEFAULT_GATEWAY_PORT
-}
-
-function getConfiguredPrimaryModel(config = readConfig()) {
-  return config?.agents?.defaults?.model?.primary || ''
-}
-
-function normalizePrimaryModelRef(ref = getConfiguredPrimaryModel()) {
-  const value = String(ref || '')
-  const parts = value.split('/')
-  return parts[parts.length - 1] || ''
-}
-
-function getPrimaryModelRoute(modelRef = getConfiguredPrimaryModel()) {
-  const model = normalizePrimaryModelRef(modelRef)
-  if (model.startsWith('gpt-')) {
-    return 'openai /chat/completions'
-  }
-  if (model.startsWith('claude-')) {
-    return 'anthropic /v1/messages'
-  }
-  if (model.startsWith('MiniMax-')) {
-    return 'minimax /minimax/v1/messages'
-  }
-  return 'unknown'
-}
-
-function isPortInUse(port) {
-  try {
-    if (isWin) {
-      const out = execSync(`netstat -ano | findstr :${port}`, { shell: true, stdio: 'pipe', encoding: 'utf8' })
-      return out.trim().length > 0
-    }
-
-    execSync(`lsof -nP -iTCP:${port} -sTCP:LISTEN`, { shell: true, stdio: 'ignore' })
-    return true
-  } catch {
-    return false
-  }
-}
-
-function listPortListeners(port) {
-  try {
-    if (isWin) {
-      const out = execSync(`netstat -ano | findstr :${port}`, { shell: true, stdio: 'pipe', encoding: 'utf8' })
-      return out
-        .trim()
-        .split('\n')
-        .filter(Boolean)
-        .map((line) => {
-          const parts = line.trim().split(/\s+/)
-          return { pid: parts[parts.length - 1], command: 'pid', detail: parts[1] || '' }
-        })
-    }
-
-    const out = execSync(`lsof -nP -iTCP:${port} -sTCP:LISTEN`, { shell: true, stdio: 'pipe', encoding: 'utf8' })
-    return out
-      .trim()
-      .split('\n')
-      .slice(1)
-      .filter(Boolean)
-      .map((line) => {
-        const parts = line.trim().split(/\s+/)
-        return {
-          command: parts[0] || 'unknown',
-          pid: parts[1] || '?',
-          detail: parts[parts.length - 1] || '',
-        }
-      })
-  } catch {
-    return []
-  }
-}
-
-function findAvailableGatewayPort(startPort = DEFAULT_GATEWAY_PORT, excludedPorts = []) {
-  const excluded = new Set((excludedPorts || []).map((value) => Number(value)).filter((value) => Number.isInteger(value) && value > 0))
-  for (let offset = 0; offset < MAX_PORT_SCAN; offset++) {
-    const port = startPort + offset
-    if (excluded.has(port)) continue
-    if (!isPortInUse(port)) return port
-  }
-  return null
-}
-
-function getLaunchCommand(port = getConfiguredGatewayPort()) {
-  const runtime = module.exports._lastRuntimeCommand || (hasOpenClawBinary() ? 'openclaw' : 'npx openclaw')
-  return `${runtime} gateway --port ${port}`
-}
-
-function getDashboardCommand() {
-  const runtime = module.exports._lastRuntimeCommand || (hasOpenClawBinary() ? 'openclaw' : 'npx openclaw')
-  return `${runtime} dashboard --no-open`
-}
-
-function getDashboardUrlForPort(port) {
-  return `http://127.0.0.1:${port}/`
-}
-
-function isNpxCachePath(value) {
-  return /[\\/]_npx[\\/]/i.test(String(value || ''))
-}
-
-function readOpenClawLaunchAgent() {
-  if (process.platform !== 'darwin') return null
-  try {
-    if (!fs.existsSync(OPENCLAW_GATEWAY_PLIST)) return null
-    return fs.readFileSync(OPENCLAW_GATEWAY_PLIST, 'utf8')
-  } catch {
-    return null
-  }
-}
-
-function parseLaunchAgentProgramArguments(content) {
-  const match = String(content || '').match(/<key>ProgramArguments<\/key>\s*<array>([\s\S]*?)<\/array>/i)
-  if (!match) return []
-
-  return Array.from(match[1].matchAll(/<string>([\s\S]*?)<\/string>/g)).map((item) => item[1])
-}
-
-function getLaunchAgentDiagnosis() {
-  const content = readOpenClawLaunchAgent()
-  if (!content) {
-    return { exists: false, path: OPENCLAW_GATEWAY_PLIST, unstable: false, programArguments: [] }
-  }
-
-  const programArguments = parseLaunchAgentProgramArguments(content)
-  const unstableArg = programArguments.find(isNpxCachePath) || ''
-
-  return {
-    exists: true,
-    path: OPENCLAW_GATEWAY_PLIST,
-    unstable: Boolean(unstableArg),
-    unstableArg,
-    programArguments,
-  }
-}
-
-function removeBrokenLaunchAgent() {
-  const diagnosis = getLaunchAgentDiagnosis()
-  if (!diagnosis.exists || !diagnosis.unstable) return false
-
-  try {
-    execSync(`launchctl bootout "gui/${process.getuid()}" "${diagnosis.path}"`, {
-      shell: true,
-      stdio: 'ignore',
-    })
-  } catch {}
-
-  try {
-    fs.unlinkSync(diagnosis.path)
-    return true
-  } catch {
-    return false
-  }
-}
-
-function buildModelEntry(id) {
-  return {
-    id,
-    name: `${id} (HolySheep)`,
-    reasoning: false,
-    input: ['text'],
-    contextWindow: 200000,
-    maxTokens: id.startsWith('gpt-') ? 8192 : 16000,
-  }
-}
-
-function normalizeRequestedModels(selectedModels) {
-  const requestedModels = Array.isArray(selectedModels) && selectedModels.length > 0
-    ? [...selectedModels]
-    : [OPENCLAW_DEFAULT_MODEL, OPENCLAW_DEFAULT_CODEX_SPARK_MODEL, OPENCLAW_DEFAULT_CLAUDE_MODEL, OPENCLAW_DEFAULT_MINIMAX_MODEL]
-
-  if (!requestedModels.includes(OPENCLAW_DEFAULT_MODEL)) requestedModels.unshift(OPENCLAW_DEFAULT_MODEL)
-  return Array.from(new Set(requestedModels))
-}
-
-function buildManagedPlan(baseUrlBridge, apiKey, primaryModel, selectedModels) {
-  const requestedModels = normalizeRequestedModels(selectedModels)
-  const managedModelRefs = requestedModels.map((model) => `${OPENCLAW_PROVIDER_NAME}/${model}`)
-  const fallbackPrimaryModel = pickPrimaryModel(primaryModel, requestedModels)
-  const primaryRef = managedModelRefs.includes(`${OPENCLAW_PROVIDER_NAME}/${fallbackPrimaryModel}`)
-    ? `${OPENCLAW_PROVIDER_NAME}/${fallbackPrimaryModel}`
-    : managedModelRefs[0] || `${OPENCLAW_PROVIDER_NAME}/${OPENCLAW_DEFAULT_MODEL}`
-
-  return {
-    providers: {
-      [OPENCLAW_PROVIDER_NAME]: {
-        baseUrl: baseUrlBridge,
-        apiKey,
-        api: 'openai-completions',
-        models: requestedModels.map(buildModelEntry),
-      },
-    },
-    managedModelRefs,
-    models: requestedModels,
-    primaryRef,
-  }
-}
-
-function isHolySheepProvider(provider) {
-  return typeof provider?.baseUrl === 'string' && (
-    provider.baseUrl.includes('api.holysheep.ai') ||
-    provider.baseUrl.includes('127.0.0.1')
-  )
-}
-
-function writeManagedConfig(baseConfig, bridgeBaseUrl, apiKey, primaryModel, selectedModels, gatewayPort) {
-  fs.mkdirSync(OPENCLAW_DIR, { recursive: true })
-
-  const plan = buildManagedPlan(bridgeBaseUrl, apiKey, primaryModel, selectedModels)
-  const existingProviders = baseConfig?.models?.providers || {}
-  const managedProviderIds = Object.entries(existingProviders)
-    .filter(([providerId, provider]) => providerId === OPENCLAW_PROVIDER_NAME || isHolySheepProvider(provider))
-    .map(([providerId]) => providerId)
-
-  const preservedProviders = Object.fromEntries(
-    Object.entries(existingProviders).filter(([, provider]) => !isHolySheepProvider(provider))
-  )
-
-  const existingModelMap = baseConfig?.agents?.defaults?.models || {}
-  const preservedModelMap = Object.fromEntries(
-    Object.entries(existingModelMap).filter(([ref]) => {
-      return !managedProviderIds.some((providerId) => ref.startsWith(`${providerId}/`))
-    })
-  )
-
-  const managedModelMap = Object.fromEntries(plan.managedModelRefs.map((ref) => [ref, {}]))
-
-  const nextConfig = {
-    ...baseConfig,
-    models: {
-      ...(baseConfig.models || {}),
-      mode: 'merge',
-      providers: {
-        ...preservedProviders,
-        ...plan.providers,
-      },
-    },
-    agents: {
-      ...(baseConfig.agents || {}),
-      defaults: {
-        ...(baseConfig.agents?.defaults || {}),
-        model: {
-          ...(baseConfig.agents?.defaults?.model || {}),
-          primary: plan.primaryRef,
-        },
-        models: {
-          ...preservedModelMap,
-          ...managedModelMap,
-        },
-      },
-    },
-    gateway: {
-      ...(baseConfig.gateway || {}),
-      mode: 'local',
-      port: gatewayPort,
-      bind: 'loopback',
-      auth: {
-        ...(baseConfig.gateway?.auth || {}),
-        mode: 'none',
-      },
-    },
-  }
-
-  // [HolySheep fork v2.1.38 / hs26] Atomic write — prevents the
-  // openclaw.json.clobbered.* pile-up from racing writeFileSync.
-  atomicWriteJson(CONFIG_FILE, nextConfig)
-  return plan
-}
-
-function _disableGatewayAuth(preferNpx = false) {
-  try {
-    runOpenClaw(['config', 'set', 'gateway.auth.mode', 'none'], { preferNpx })
-  } catch {}
-}
-
-function _installGatewayService(port, preferNpx = false) {
-  if (preferNpx) return false
-
-  const result = runOpenClaw(['gateway', 'install', '--force', '--port', String(port)], {
-    preferNpx,
-    timeout: 60000,
-  })
-  return result.status === 0
-}
-
-function _startGateway(port, preferNpx = false, preferService = true) {
-  const serviceResult = preferService
-    ? runOpenClaw(['gateway', 'start'], { preferNpx, timeout: 20000 })
-    : { status: 1 }
-
-  let directChild = null
-
-  if (serviceResult.status !== 0) {
-    directChild = spawnOpenClaw(['gateway', '--port', String(port)], {
-      preferNpx,
-      detached: true,
-      stdio: 'ignore',
-    })
-    directChild.unref()
-  }
-
-  for (let i = 0; i < 8; i++) {
-    const t0 = Date.now()
-    while (Date.now() - t0 < 1000) {}
-
-    try {
-      execSync(
-        isWin
-          ? `powershell -NonInteractive -Command "try{(Invoke-WebRequest -Uri http://127.0.0.1:${port}/ -TimeoutSec 1 -UseBasicParsing).StatusCode}catch{exit 1}"`
-          : `curl -sf http://127.0.0.1:${port}/ -o /dev/null --max-time 1`,
-        { stdio: 'ignore', timeout: 3000 }
-      )
-      return {
-        ok: true,
-        pid: directChild?.pid || null,
-        mode: directChild ? 'direct-process' : 'daemon',
-      }
-    } catch {}
-  }
-
-  return {
-    ok: false,
-    pid: directChild?.pid || null,
-    mode: directChild ? 'direct-process' : 'daemon',
-  }
-}
-
-function getDashboardUrl(port, preferNpx = false) {
-  const result = runOpenClaw(['dashboard', '--no-open'], {
-    preferNpx,
-    timeout: preferNpx ? 60000 : 20000,
-  })
-  if (result.status === 0) {
-    const output = String(result.stdout || '')
-    const match = output.match(/Dashboard URL:\s*(\S+)/) || output.match(/(https?:\/\/\S+)/)
-    if (match) return match[1]
-  }
-  return getDashboardUrlForPort(port)
-}
-
-module.exports = {
-  name: 'OpenClaw',
-  id: 'openclaw',
-
-  checkInstalled() {
-    return detectRuntime().available
-  },
-
-  detectRuntime,
-
-  getVersion() {
-    return detectRuntime().version
-  },
-
-  isConfigured() {
-    const cfg = readConfig()
-    const hasProvider = cfg?.models?.providers?.[OPENCLAW_PROVIDER_NAME]?.baseUrl?.includes('127.0.0.1')
-    const bridge = readBridgeConfig()
-    return Boolean(hasProvider && bridge?.apiKey)
-  },
-
-  configure(apiKey, baseUrlAnthropic, baseUrlOpenAI, primaryModel, selectedModels) {
-    const chalk = require('chalk')
-    console.log(chalk.gray('\n  ⚙️  正在配置 OpenClaw...'))
-
-    // [HolySheep fork v2.1.38 / hs26] Garbage-collect stale OpenClaw
-    // backup files from pre-atomic-write builds. Scoped to exact glob
-    // `openclaw.json.clobbered.*` older than 7 days — leaves .last-good
-    // and .bak files alone.
-    try {
-      const pruned = pruneClobberedBackups()
-      if (pruned.removed > 0) {
-        console.log(chalk.gray(`  → 已清理 ${pruned.removed} 个过期的 OpenClaw 配置备份（>7 天的 .clobbered.* 文件）`))
-      }
-    } catch {}
-
-    const runtime = detectRuntime()
-    if (!runtime.available) {
-      throw new Error('未检测到 OpenClaw；请先全局安装，或确保 npx 可用')
-    }
-    this._lastRuntimeCommand = runtime.command
-    this._lastRuntimeVia = runtime.via
-
-    // 重新配置前先停掉旧的 Bridge 和 Gateway，释放端口
-    console.log(chalk.gray('  → 停止旧的 Bridge 和 Gateway...'))
-    stopBridge()
-    runOpenClaw(['gateway', 'stop'], { preferNpx: runtime.via === 'npx' })
-    // 等端口释放
-    const t0 = Date.now()
-    while (Date.now() - t0 < 1000) {}
-
-    if (runtime.via === 'npx' && removeBrokenLaunchAgent()) {
-      console.log(chalk.gray('  → 已清理旧的 OpenClaw 守护进程配置（失效的 npx 缓存路径）'))
-    }
-
-    const resolvedPrimaryModel = pickPrimaryModel(primaryModel, selectedModels)
-    const gatewayPort = findAvailableGatewayPort(DEFAULT_GATEWAY_PORT)
-    if (!gatewayPort) {
-      throw new Error(`找不到可用端口（已检查 ${DEFAULT_GATEWAY_PORT}-${DEFAULT_GATEWAY_PORT + MAX_PORT_SCAN - 1}）`)
-    }
-    this._lastGatewayPort = gatewayPort
-
-    const bridgePort = findAvailableGatewayPort(DEFAULT_BRIDGE_PORT, [gatewayPort])
-    if (!bridgePort) {
-      throw new Error(`找不到可用桥接端口（已检查 ${DEFAULT_BRIDGE_PORT}-${DEFAULT_BRIDGE_PORT + MAX_PORT_SCAN - 1}）`)
-    }
-    this._lastBridgePort = bridgePort
-
-    writeBridgeConfig({
-      port: bridgePort,
-      host: '127.0.0.1',
-      apiKey,
-      baseUrlAnthropic,
-      baseUrlOpenAI,
-      models: normalizeRequestedModels(selectedModels),
-      gatewayPort,
-      gatewayHost: '127.0.0.1',
-      gatewayPid: null,
-      gatewayLaunchMode: null,
-      watchdog: {
-        enabled: true,
-        intervalMs: 3000,
-        failureThreshold: 3,
-        startupGraceMs: 30000,
-        requestTimeoutMs: 1500,
-      },
-    })
-
-    console.log(chalk.gray('  → 正在启动 HolySheep Bridge...'))
-    if (!startBridge(bridgePort)) {
-      throw new Error('HolySheep OpenClaw Bridge 启动失败')
-    }
-    const bridgeBaseUrl = getBridgeBaseUrl(bridgePort)
-
-    if (gatewayPort !== DEFAULT_GATEWAY_PORT) {
-      console.log(chalk.yellow(`  ⚠️  端口 ${DEFAULT_GATEWAY_PORT} 已占用，自动切换到 ${gatewayPort}`))
-      const listeners = listPortListeners(DEFAULT_GATEWAY_PORT)
-      if (listeners.length) {
-        const summary = listeners
-          .slice(0, 2)
-          .map((item) => `${item.command}(${item.pid})`)
-          .join(', ')
-        console.log(chalk.gray(`     占用进程: ${summary}`))
-      }
-    }
-
-    try { fs.unlinkSync(CONFIG_FILE) } catch {}
-
-    console.log(chalk.gray('  → 写入配置...'))
-    const onboardArgs = [
-      'onboard',
-      '--non-interactive',
-      '--accept-risk',
-      '--auth-choice', 'custom-api-key',
-      '--custom-base-url', bridgeBaseUrl,
-      '--custom-api-key', apiKey,
-      '--custom-model-id', resolvedPrimaryModel.replace(/\[.*\]/, ''),
-      '--custom-compatibility', 'openai',
-      '--gateway-port', String(gatewayPort),
-    ]
-    if (runtime.via !== 'npx') onboardArgs.push('--install-daemon')
-
-    const result = runOpenClaw(onboardArgs, { preferNpx: runtime.via === 'npx' })
-
-    if (result.status !== 0) {
-      console.log(chalk.yellow('  ⚠️  onboard 失败，使用备用配置...'))
-    }
-
-    const plan = writeManagedConfig(
-      result.status === 0 ? readConfig() : {},
-      bridgeBaseUrl,
-      apiKey,
-      resolvedPrimaryModel,
-      selectedModels,
-      gatewayPort,
-    )
-
-    _disableGatewayAuth(runtime.via === 'npx')
-    const serviceReady = _installGatewayService(gatewayPort, runtime.via === 'npx')
-    if (runtime.via === 'npx') {
-      console.log(chalk.gray('  → 当前仅检测到 npx openclaw，跳过 daemon 安装，改为直接启动 Gateway 进程'))
-    }
-
-    console.log(chalk.gray('  → 正在启动 Gateway...'))
-    const gatewayState = _startGateway(gatewayPort, runtime.via === 'npx', serviceReady)
-    updateBridgeConfig({
-      gatewayPort,
-      gatewayPid: gatewayState.pid,
-      gatewayLaunchMode: gatewayState.mode,
-      gatewayStartedAt: new Date().toISOString(),
-    })
-
-    if (gatewayState.ok) {
-      console.log(chalk.green('  ✓ OpenClaw Gateway 已启动'))
-    } else {
-      console.log(chalk.yellow('  ⚠️  Gateway 未就绪；当前不要打开 about:blank 或裸浏览器壳窗口'))
-    }
-
-    const dashUrl = gatewayState.ok ? getDashboardUrl(gatewayPort, runtime.via === 'npx') : getDashboardUrlForPort(gatewayPort)
-    console.log(chalk.cyan('\n  → 浏览器打开（推荐使用此地址）:'))
-    console.log(chalk.bold.cyan(`     ${dashUrl}`))
-    console.log(chalk.gray(`     Bridge 地址: ${bridgeBaseUrl}`))
-    console.log(chalk.gray(`     默认模型: ${plan.primaryRef || OPENCLAW_DEFAULT_MODEL}`))
-    console.log(chalk.gray(`     Gateway 启动方式: ${gatewayState.mode}`))
-    console.log(chalk.gray('     浏览器应直接打开 dashboard URL，不应停在 about:blank'))
-    console.log(chalk.gray('     Bridge 会在检测到 OpenClaw Gateway 持续不可用后自动退出'))
-    console.log(chalk.gray('     如在 Windows 上打开裸 http://127.0.0.1:PORT/ 仍报 Unauthorized，请使用上面的 dashboard 地址'))
-
-    return {
-      file: CONFIG_FILE,
-      hot: false,
-      dashboardUrl: dashUrl,
-      gatewayPort,
-      gatewayReady: gatewayState.ok,
-      gatewayLaunchMode: gatewayState.mode,
-      launchCmd: getLaunchCommand(gatewayPort),
-    }
-  },
-
-  reset() {
-    // 先停进程再删配置，避免残留进程指向已删除的配置导致 timeout
-    stopBridge()
-    try { runOpenClaw(['gateway', 'stop'], { preferNpx: detectRuntime().via === 'npx' }) } catch {}
-    try { fs.unlinkSync(CONFIG_FILE) } catch {}
-    try { fs.unlinkSync(BRIDGE_CONFIG_FILE) } catch {}
-  },
-
-  getConfigPath() { return CONFIG_FILE },
-  getBridgePort() { return getConfiguredBridgePort() },
-  getGatewayPort() { return getConfiguredGatewayPort() },
-  ensureBridgeRunning(port) {
-    port = port || getConfiguredBridgePort()
-    return startBridge(port)
-  },
-  ensureGatewayRunning(port) {
-    port = port || getConfiguredGatewayPort()
-    // 检查端口是否有进程在监听（不依赖 HTTP 状态码，500 也算运行中）
-    try {
-      const checkCmd = isWin
-        ? `powershell -NonInteractive -Command "if(Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue){exit 0}else{exit 1}"`
-        : `curl -so /dev/null --max-time 1 http://127.0.0.1:${port}/ || lsof -iTCP:${port} -sTCP:LISTEN -t >/dev/null 2>&1`
-      execSync(checkCmd, { stdio: 'ignore', timeout: 5000 })
-      return true
-    } catch {}
-    // 未运行，启动它
-    const preferNpx = !hasOpenClawBinary()
-    const result = _startGateway(port, preferNpx, !preferNpx)
-    return result.ok
-  },
-  getPrimaryModel() { return getConfiguredPrimaryModel() },
-  getPrimaryModelRoute() { return getPrimaryModelRoute() },
-  getPortListeners(port = getConfiguredGatewayPort()) { return listPortListeners(port) },
-  getLaunchAgentDiagnosis,
-  get hint() {
-    return `Bridge + Gateway 已配置，默认模型为 ${getConfiguredPrimaryModel() || OPENCLAW_DEFAULT_MODEL}`
-  },
-  get launchSteps() {
-    const bridgePort = getConfiguredBridgePort()
-    const port = getConfiguredGatewayPort()
-    return [
-      { cmd: getBridgeCommand(bridgePort), note: '先启动 HolySheep OpenClaw Bridge' },
-      { cmd: getLaunchCommand(port), note: '再启动 OpenClaw Gateway' },
-      { cmd: getDashboardCommand(), note: '再生成/打开可直接连接的 Dashboard 地址（推荐）' },
-    ]
-  },
-  get launchNote() {
-    const runtime = module.exports._lastRuntimeVia === 'npx' ? '当前为 npx 模式，不安装常驻 daemon。' : ''
-    return `🌐 请先启动 Bridge，再启动 Gateway；最后运行 ${getDashboardCommand()} ${runtime}`.trim()
-  },
-  installCmd: 'npm install -g openclaw@latest',
-  docsUrl: 'https://docs.openclaw.ai',
-  // [HolySheep fork v2.1.38 / hs26] Test-only exports.
-  _atomicWriteJson: atomicWriteJson,
-  _pruneClobberedBackups: pruneClobberedBackups,
-}