openclawsetup 2.1.4 → 2.2.0

package/bin/cli.mjs

@@ -16,6 +16,32 @@ import { homedir, platform } from 'os';
 import { join } from 'path';
 import { createInterface } from 'readline';
 
+// ============ 错误码定义 ============
+
+const ERROR_CODES = {
+  NODE_VERSION: { code: 1, message: 'Node.js 版本过低' },
+  OPENCLAW_NOT_FOUND: { code: 2, message: '未检测到 OpenClaw 安装' },
+  NPM_INSTALL_FAILED: { code: 3, message: 'npm 安装失败' },
+  ONBOARD_FAILED: { code: 4, message: 'onboard 执行失败' },
+  GATEWAY_RESTART_FAILED: { code: 5, message: 'Gateway 重启失败' },
+  INVALID_INPUT: { code: 6, message: '输入无效' },
+  PERMISSION_DENIED: { code: 7, message: '权限不足' },
+  NETWORK_ERROR: { code: 8, message: '网络错误' },
+  PTY_UNAVAILABLE: { code: 9, message: '自动模式不可用' },
+};
+
+function exitWithError(errorType, details = '') {
+  const err = ERROR_CODES[errorType] || { code: 99, message: '未知错误' };
+  console.log('\n' + '='.repeat(40));
+  console.log(`\x1b[31m❌ 错误: ${err.message}\x1b[0m`);
+  console.log('='.repeat(40));
+  if (details) {
+    console.log(details);
+  }
+  console.log(`\n错误码: ${err.code}`);
+  process.exit(err.code);
+}
+
 // ============ 工具函数 ============
 
 const colors = {
@@ -52,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'),
@@ -65,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
@@ -91,11 +119,14 @@ function checkNodeVersion() {
   const version = process.version;
   const major = parseInt(version.slice(1).split('.')[0], 10);
   if (major < 18) {
-    log.error(`Node.js 版本过低: ${version}，需要 18+`);
-    console.log(colors.cyan('\n解决方案:'));
-    console.log('  1. 访问 https://nodejs.org/ 下载最新版本');
-    console.log('  2. 或使用 nvm: nvm install 22');
-    process.exit(1);
+    exitWithError('NODE_VERSION', `
+当前版本: ${version}，需要 18+
+
+解决方案:
+  1. 访问 https://nodejs.org/ 下载最新版本
+  2. 或使用 nvm: nvm install 22
+  3. 或使用一键脚本（自动安装 Node.js）:
+     curl -fsSL https://unpkg.com/openclawsetup@latest/install.sh | bash`);
   }
   return true;
 }
@@ -161,9 +192,9 @@ function getConfigInfo() {
     } catch {
       try {
         const raw = readFileSync(configPath, 'utf8');
-        const tokenMatch = raw.match(/"token"\\s*:\\s*"([^"]+)"/i);
-        const portMatch = raw.match(/"port"\\s*:\\s*(\\d+)/i);
-        const bindMatch = raw.match(/"bind"\\s*:\\s*"([^"]+)"/i);
+        const tokenMatch = raw.match(/"token"\s*:\s*"([^"]+)"/i);
+        const portMatch = raw.match(/"port"\s*:\s*(\d+)/i);
+        const bindMatch = raw.match(/"bind"\s*:\s*"([^"]+)"/i);
         return {
           configDir: cfg.dir,
           configPath,
@@ -382,11 +413,15 @@ async function installOpenClaw() {
     return 'clawdbot';
   }
 
-  log.error('安装失败');
-  console.log(colors.cyan('\n解决方案:'));
-  console.log('  1. 检查网络连接');
-  console.log('  2. 手动安装: npm install -g openclaw@latest');
-  process.exit(1);
+  exitWithError('NPM_INSTALL_FAILED', `
+解决方案:
+  1. 检查网络连接
+  2. 清除 npm 缓存后重试:
+     npm cache clean --force
+     npx openclawsetup@latest
+  3. 手动安装:
+     npm install -g openclaw@latest
+     openclaw onboard --install-daemon`);
 }
 
 // ============ 运行 Onboard ============
@@ -426,9 +461,18 @@ async function runOnboard(cliName) {
           log.hint('如果配置未完成，可以手动运行: ' + cliName + ' onboard');
         }
       } else if (options.auto) {
-        log.error('自动模式不可用，已退出');
-        log.hint(autoResult.reason || '请尝试 --manual');
-        process.exit(1);
+        exitWithError('PTY_UNAVAILABLE', `
+原因: ${autoResult.reason || '未能启用自动应答'}
+
+解决方案:
+  1. 使用手动模式:
+     npx openclawsetup@latest --manual
+  2. 在 Linux 服务器上补齐编译依赖后再试:
+     sudo apt-get install -y build-essential python3 make g++
+     npx openclawsetup@latest --auto
+  3. 或直接运行官方命令:
+     npm install -g openclaw@latest
+     openclaw onboard --install-daemon`);
       } else {
         log.warn('自动模式不可用，已切换为手动模式');
         log.hint(autoResult.reason || '未能启用自动应答');
@@ -824,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() {
@@ -846,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);
@@ -859,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/install.ps1

@@ -1,6 +1,6 @@
 #!/usr/bin/env pwsh
 # OpenClaw 一键安装脚本 (Windows PowerShell)
-# 用法: irm https://raw.githubusercontent.com/xxx/openclawsetup/main/install.ps1 | iex
+# 用法: irm https://unpkg.com/openclawsetup@latest/install.ps1 | iex
 
 $ErrorActionPreference = "Stop"
 

package/install.sh

@@ -190,25 +190,52 @@ install_node() {
             nvm alias default 22
         fi
     elif [ "$OS" == "linux" ]; then
+        # 检查是否需要 sudo
+        local need_sudo=false
+        if [ "$(id -u)" -ne 0 ]; then
+            case "$PM" in
+                apt|dnf|yum|pacman|apk)
+                    need_sudo=true
+                    ;;
+            esac
+        fi
+
+        if [ "$need_sudo" = true ] && ! command -v sudo &> /dev/null; then
+            log_error "需要 root 权限安装 Node.js"
+            echo ""
+            echo "请使用以下方式之一："
+            echo "  1. 以 root 用户运行此脚本"
+            echo "  2. 安装 sudo 后重试"
+            echo "  3. 手动安装 Node.js: https://nodejs.org/"
+            echo ""
+            exit 7
+        fi
+
+        local SUDO_CMD=""
+        if [ "$need_sudo" = true ]; then
+            SUDO_CMD="sudo"
+            log_warn "需要 sudo 权限安装 Node.js，可能会提示输入密码"
+        fi
+
         case "$PM" in
             apt)
                 log_info "使用 NodeSource 安装..."
-                curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
-                apt-get install -y nodejs
+                curl -fsSL https://deb.nodesource.com/setup_22.x | $SUDO_CMD bash -
+                $SUDO_CMD apt-get install -y nodejs
                 ;;
             dnf)
-                curl -fsSL https://rpm.nodesource.com/setup_22.x | bash -
-                dnf install -y nodejs
+                curl -fsSL https://rpm.nodesource.com/setup_22.x | $SUDO_CMD bash -
+                $SUDO_CMD dnf install -y nodejs
                 ;;
             yum)
-                curl -fsSL https://rpm.nodesource.com/setup_22.x | bash -
-                yum install -y nodejs
+                curl -fsSL https://rpm.nodesource.com/setup_22.x | $SUDO_CMD bash -
+                $SUDO_CMD yum install -y nodejs
                 ;;
             pacman)
-                pacman -Sy --noconfirm nodejs npm
+                $SUDO_CMD pacman -Sy --noconfirm nodejs npm
                 ;;
             apk)
-                apk add --no-cache nodejs npm
+                $SUDO_CMD apk add --no-cache nodejs npm
                 ;;
             *)
                 log_info "使用 nvm 安装..."

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "openclawsetup",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "description": "OpenClaw 安装向导 - 带中文指引的官方安装流程",
   "type": "module",
   "bin": {
     "openclawsetup": "bin/cli.mjs"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/openclaw-tools.git",
+    "directory": "packages/openclawsetup"
+  },
   "optionalDependencies": {
     "node-pty": "^1.0.0"
   },

package//344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -233,6 +233,100 @@ rm ~/.config/systemd/user/openclaw.service
 systemctl --user daemon-reload
 ```
 
+---
+
+### 错误：权限不足
+**现象**：提示 "permission denied" 或 "EACCES"
+**原因**：npm 全局安装目录没有写入权限
+**解决**：
+1. Linux 用户使用 sudo：
+   ```bash
+   sudo npm install -g openclaw@latest
+   ```
+2. 或修复 npm 权限（推荐）：
+   ```bash
+   mkdir -p ~/.npm-global
+   npm config set prefix '~/.npm-global'
+   echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+   source ~/.bashrc
+   ```
+
+错误码: 7
+
+---
+
+### 错误：网络连接失败
+**现象**：提示 "ETIMEDOUT"、"ECONNREFUSED" 或下载超时
+**原因**：网络问题或 npm 源不可达
+**解决**：
+1. 检查网络连接
+2. 尝试使用国内镜像源：
+   ```bash
+   npm config set registry https://registry.npmmirror.com
+   npx openclawsetup@latest
+   ```
+3. 恢复官方源：
+   ```bash
+   npm config set registry https://registry.npmjs.org
+   ```
+
+错误码: 8
+
+---
+
+### 错误：node-pty 编译失败
+**现象**：安装时提示 "gyp ERR!" 或 "node-pty" 相关错误
+**原因**：缺少 C++ 编译工具链
+**解决**：
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get update
+sudo apt-get install -y build-essential python3 make g++ pkg-config
+```
+
+**CentOS/RHEL:**
+```bash
+sudo yum groupinstall -y "Development Tools"
+sudo yum install -y python3
+```
+
+**macOS:**
+```bash
+xcode-select --install
+```
+
+**Windows:**
+```powershell
+npm install -g windows-build-tools
+```
+
+安装依赖后重试：
+```bash
+npx openclawsetup@latest
+```
+
+如果仍然失败，可以使用手动模式（不需要 node-pty）：
+```bash
+npx openclawsetup@latest --manual
+```
+
+---
+
+## 错误码速查表
+
+| 错误码 | 含义 | 常见原因 |
+|--------|------|----------|
+| 1 | Node.js 版本过低 | 需要 Node.js 18+ |
+| 2 | 未检测到 OpenClaw | 安装未完成 |
+| 3 | npm 安装失败 | 网络问题或权限问题 |
+| 4 | onboard 执行失败 | 配置过程中断 |
+| 5 | Gateway 重启失败 | 服务异常 |
+| 6 | 输入无效 | 参数错误 |
+| 7 | 权限不足 | 需要 sudo 或修复 npm 权限 |
+| 8 | 网络错误 | 检查网络或更换镜像源 |
+| 9 | 自动模式不可用 | 缺少编译依赖，使用 --manual |
+
 ## 获取帮助
 
 ```bash