openclawsetup 2.1.3 → 2.1.5

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 = {
@@ -91,11 +117,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 +190,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 +411,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 +459,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 || '未能启用自动应答');

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.3",
+  "version": "2.1.5",
   "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