openclawsetup 2.1.5 → 2.2.0

package/bin/cli.mjs

@@ -78,6 +78,7 @@ function parseArgs() {
     update: args.includes('--update'),
     reinstall: args.includes('--reinstall'),
     uninstall: args.includes('--uninstall'),
+    check: args.includes('--check'),
     manual: args.includes('--manual'),
     auto: args.includes('--auto'),
     withModel: args.includes('--with-model'),
@@ -91,7 +92,8 @@ function showHelp() {
 ${colors.bold('OpenClaw 安装向导')}
 
 ${colors.cyan('用法:')}
-  npx openclawsetup              带中文指引的安装
+  npx openclawsetup              交互式菜单（已安装）/ 安装向导（未安装）
+  npx openclawsetup --check      检查配置和服务状态
   npx openclawsetup --update     更新已安装的 OpenClaw
   npx openclawsetup --reinstall  卸载后重新安装
   npx openclawsetup --uninstall  卸载 OpenClaw
@@ -866,6 +868,243 @@ async function uninstallOpenClaw(existing) {
   log.success('卸载完成');
 }
 
+// ============ 健康检查 ============
+
+async function runHealthCheck(cliName) {
+  console.log(colors.bold(colors.cyan('\n🔍 OpenClaw 健康检查\n')));
+
+  const issues = [];
+  const config = getConfigInfo();
+
+  // 1. 检查配置文件
+  console.log(colors.cyan('检查配置文件...'));
+  if (!config.configPath || !existsSync(config.configPath)) {
+    issues.push({
+      level: 'error',
+      title: '配置文件不存在',
+      detail: '未找到 openclaw.json 配置文件',
+      solution: '运行 openclaw onboard 重新配置',
+    });
+  } else {
+    try {
+      const raw = readFileSync(config.configPath, 'utf8');
+      JSON.parse(raw);
+      log.success('配置文件格式正确');
+    } catch (e) {
+      issues.push({
+        level: 'error',
+        title: '配置文件 JSON 格式错误',
+        detail: `解析失败: ${e.message}`,
+        solution: '检查 ~/.openclaw/openclaw.json 的 JSON 语法，或删除后重新运行 openclaw onboard',
+      });
+    }
+  }
+
+  // 2. 检查 Gateway 进程
+  console.log(colors.cyan('检查 Gateway 进程...'));
+  const statusResult = safeExec(`${cliName} status`);
+  if (statusResult.ok) {
+    const output = statusResult.output.toLowerCase();
+    if (output.includes('running') || output.includes('active')) {
+      log.success('Gateway 进程正在运行');
+    } else if (output.includes('stopped') || output.includes('inactive') || output.includes('not running')) {
+      issues.push({
+        level: 'error',
+        title: 'Gateway 未运行',
+        detail: 'Gateway 服务已停止',
+        solution: `运行 ${cliName} gateway start 启动服务`,
+      });
+    }
+  } else {
+    issues.push({
+      level: 'warning',
+      title: '无法获取 Gateway 状态',
+      detail: statusResult.error || '状态检查失败',
+      solution: `尝试运行 ${cliName} status 查看详情`,
+    });
+  }
+
+  // 3. 检查端口监听
+  console.log(colors.cyan('检查端口监听...'));
+  const port = config.port || 18789;
+  const portCheckCmd = platform() === 'win32'
+    ? `netstat -an | findstr :${port}`
+    : `lsof -i :${port} 2>/dev/null || netstat -tlnp 2>/dev/null | grep :${port}`;
+  const portResult = safeExec(portCheckCmd);
+
+  if (portResult.ok && portResult.output) {
+    log.success(`端口 ${port} 正在监听`);
+  } else {
+    issues.push({
+      level: 'error',
+      title: `端口 ${port} 未监听`,
+      detail: 'Gateway 端口未开放，服务可能未正常启动',
+      solution: `1. 运行 ${cliName} gateway restart\n     2. 检查是否有其他程序占用端口 ${port}`,
+    });
+  }
+
+  // 4. 检查 API 健康
+  console.log(colors.cyan('检查 API 健康状态...'));
+  const healthResult = safeExec(`curl -s --connect-timeout 3 http://127.0.0.1:${port}/health`);
+  if (healthResult.ok && healthResult.output) {
+    try {
+      const health = JSON.parse(healthResult.output);
+      if (health.status === 'ok' || health.healthy) {
+        log.success('API 健康检查通过');
+      } else {
+        issues.push({
+          level: 'warning',
+          title: 'API 健康状态异常',
+          detail: JSON.stringify(health),
+          solution: `运行 ${cliName} gateway logs 查看日志`,
+        });
+      }
+    } catch {
+      if (healthResult.output.includes('ok') || healthResult.output.includes('healthy')) {
+        log.success('API 健康检查通过');
+      } else {
+        log.warn('API 返回非标准格式');
+      }
+    }
+  } else {
+    issues.push({
+      level: 'error',
+      title: 'API 无响应',
+      detail: '无法连接到 Gateway API',
+      solution: `1. 确认 Gateway 正在运行: ${cliName} status\n     2. 重启服务: ${cliName} gateway restart`,
+    });
+  }
+
+  // 5. 检查模型配置
+  console.log(colors.cyan('检查模型配置...'));
+  if (config.raw) {
+    const hasModels = config.raw.includes('"models"') || config.raw.includes('"providers"');
+    const hasApiKey = config.raw.includes('"apiKey"') || config.raw.includes('"api_key"');
+    if (!hasModels && !hasApiKey) {
+      issues.push({
+        level: 'warning',
+        title: '未配置 AI 模型',
+        detail: '配置文件中未找到模型或 API Key 配置',
+        solution: '运行 npx openclawapi@latest 配置模型',
+      });
+    } else {
+      log.success('已配置模型');
+    }
+  }
+
+  // 6. 运行官方诊断
+  console.log(colors.cyan('运行官方诊断...'));
+  const doctorResult = safeExec(`${cliName} doctor`);
+  if (doctorResult.ok) {
+    const output = doctorResult.output.toLowerCase();
+    if (output.includes('error') || output.includes('fail') || output.includes('问题')) {
+      issues.push({
+        level: 'warning',
+        title: '官方诊断发现问题',
+        detail: doctorResult.output.slice(0, 200),
+        solution: `运行 ${cliName} doctor 查看完整诊断`,
+      });
+    } else {
+      log.success('官方诊断通过');
+    }
+  }
+
+  // 输出结果
+  console.log('\n' + '='.repeat(50));
+  if (issues.length === 0) {
+    console.log(colors.bold(colors.green('✅ 所有检查通过，OpenClaw 运行正常！')));
+  } else {
+    console.log(colors.bold(colors.yellow(`⚠ 发现 ${issues.length} 个问题：`)));
+    console.log('='.repeat(50));
+
+    issues.forEach((issue, i) => {
+      const icon = issue.level === 'error' ? colors.red('❌') : colors.yellow('⚠');
+      console.log(`\n${icon} ${colors.bold(`问题 ${i + 1}: ${issue.title}`)}`);
+      console.log(colors.gray(`   ${issue.detail}`));
+      console.log(colors.cyan(`   解决方案: ${issue.solution}`));
+    });
+  }
+  console.log('');
+}
+
+// ============ 交互式菜单 ============
+
+async function showInteractiveMenu(existing) {
+  const cliName = existing.name || 'openclaw';
+
+  while (true) {
+    console.log(colors.bold(colors.cyan('\n' + '='.repeat(50))));
+    console.log(colors.bold(colors.cyan('  OpenClaw 管理菜单')));
+    console.log(colors.bold(colors.cyan('='.repeat(50))));
+
+    showDashboardAccessInfo();
+
+    console.log(colors.cyan('\n请选择操作：'));
+    console.log(`  ${colors.yellow('1')}. 检查 - 诊断配置和服务状态`);
+    console.log(`  ${colors.yellow('2')}. 更新 - 更新到最新版本`);
+    console.log(`  ${colors.yellow('3')}. 安装 - 重新安装（保留配置）`);
+    console.log(`  ${colors.yellow('4')}. 卸载 - 完全卸载 OpenClaw`);
+    console.log(`  ${colors.yellow('5')}. 配置模型 - 配置 AI 模型`);
+    console.log(`  ${colors.yellow('0')}. 退出`);
+
+    const choice = await askQuestion('\n请输入选项 (0-5): ');
+
+    switch (choice.trim()) {
+      case '1':
+        await runHealthCheck(cliName);
+        await waitForEnter('\n按回车返回菜单...');
+        break;
+      case '2':
+        await updateOpenClaw(cliName);
+        await waitForEnter('\n按回车返回菜单...');
+        break;
+      case '3':
+        console.log(colors.yellow('\n即将重新安装 OpenClaw...'));
+        const confirmReinstall = await askQuestion('确认重新安装？(y/N): ');
+        if (confirmReinstall.toLowerCase() === 'y') {
+          await uninstallOpenClaw(existing);
+          const newCliName = await installOpenClaw();
+          await runOnboard(newCliName);
+          showCompletionInfo(newCliName);
+        }
+        break;
+      case '4':
+        console.log(colors.red('\n⚠ 警告：卸载将删除所有配置！'));
+        const confirmUninstall = await askQuestion('确认卸载？(y/N): ');
+        if (confirmUninstall.toLowerCase() === 'y') {
+          await uninstallOpenClaw(existing);
+          console.log(colors.green('\n卸载完成，感谢使用 OpenClaw！'));
+          process.exit(0);
+        }
+        break;
+      case '5':
+        console.log(colors.cyan('\n启动模型配置...'));
+        spawnSync('npx', ['openclawapi@latest'], {
+          stdio: 'inherit',
+          shell: true,
+        });
+        await waitForEnter('\n按回车返回菜单...');
+        break;
+      case '0':
+      case '':
+        console.log(colors.gray('\n再见！'));
+        process.exit(0);
+      default:
+        log.warn('无效选项，请输入 0-5');
+    }
+  }
+}
+
+function askQuestion(prompt) {
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(colors.yellow(prompt), (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+
 // ============ 主函数 ============
 
 async function main() {
@@ -888,6 +1127,11 @@ async function main() {
   if (existing.installed) {
     console.log(colors.green(`\n✓ 检测到已安装: ${existing.name}`));
 
+    if (options.check) {
+      await runHealthCheck(existing.name);
+      process.exit(0);
+    }
+
     if (options.update) {
       await updateOpenClaw(existing.name);
       process.exit(0);
@@ -901,14 +1145,8 @@ async function main() {
     if (options.reinstall) {
       await uninstallOpenClaw(existing);
     } else {
-      console.log(colors.cyan('\n已安装，可选操作:'));
-      console.log(`  更新:     ${colors.yellow('npx openclawsetup --update')}`);
-      console.log(`  重装:     ${colors.yellow('npx openclawsetup --reinstall')}`);
-      console.log(`  卸载:     ${colors.yellow('npx openclawsetup --uninstall')}`);
-      console.log(`  配置模型: ${colors.yellow('npx openclawapi@latest preset-claude')}`);
-      showDashboardAccessInfo();
-      console.log('');
-      process.exit(0);
+      // 交互式菜单
+      await showInteractiveMenu(existing);
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclawsetup",
-  "version": "2.1.5",
+  "version": "2.2.0",
   "description": "OpenClaw 安装向导 - 带中文指引的官方安装流程",
   "type": "module",
   "bin": {