openclawsetup 1.0.0

package/README.md

@@ -0,0 +1,198 @@
+# openclawsetup
+
+一键安装 OpenClaw - 自动完成基础部署，无需交互。
+
+## 功能
+
+- 自动安装 OpenClaw CLI
+- 自动创建配置文件和 workspace
+- 自动配置服务持久化（开机自启动）
+- 支持 macOS、Linux、Windows 三系统
+- 无需任何交互，全自动完成
+
+## 快速开始
+
+```bash
+npx openclawsetup
+```
+
+## 安装选项
+
+### 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `OPENCLAW_PORT` | Gateway 端口 | 18789 |
+| `GATEWAY_TOKEN` | 自定义 Token | 自动生成 |
+| `SKIP_DAEMON` | 跳过服务持久化 | false |
+
+### 命令行参数
+
+| 参数 | 说明 |
+|------|------|
+| `--port <port>` | 指定 Gateway 端口 |
+| `--token <token>` | 指定 Gateway Token |
+| `--skip-daemon` | 跳过服务持久化配置 |
+| `--skip-start` | 安装后不启动服务 |
+| `--help, -h` | 显示帮助信息 |
+
+## 使用示例
+
+### 默认安装（推荐）
+
+```bash
+npx openclawsetup
+```
+
+### 指定端口
+
+```bash
+# macOS/Linux
+OPENCLAW_PORT=8080 npx openclawsetup
+
+# Windows PowerShell
+$env:OPENCLAW_PORT=8080; npx openclawsetup
+
+# Windows CMD
+set OPENCLAW_PORT=8080 && npx openclawsetup
+```
+
+### 指定 Token
+
+```bash
+# macOS/Linux
+GATEWAY_TOKEN="my-secret-token" npx openclawsetup
+
+# Windows PowerShell
+$env:GATEWAY_TOKEN="my-secret-token"; npx openclawsetup
+
+# Windows CMD
+set GATEWAY_TOKEN=my-secret-token && npx openclawsetup
+```
+
+### 命令行参数方式
+
+```bash
+npx openclawsetup --port 8080 --token my-secret-token
+```
+
+### 仅安装不启动
+
+```bash
+npx openclawsetup --skip-start
+```
+
+## 安装后
+
+安装完成后，你需要配置 AI 模型才能使用：
+
+```bash
+# 配置 Claude 模型（推荐）
+npx openclawapi@latest preset-claude
+
+# 或配置其他模型
+npx openclawapi@latest
+```
+
+## 配置聊天渠道
+
+```bash
+# Discord
+npx openclawdc
+
+# 飞书
+npx openclawfs
+```
+
+## 常用命令
+
+```bash
+# 查看状态
+openclaw status
+
+# 查看日志
+openclaw gateway logs
+
+# 重启服务
+openclaw gateway restart
+
+# 诊断问题
+openclaw doctor
+```
+
+## 服务持久化
+
+安装时会自动配置开机自启动：
+
+- **macOS**: launchd (`~/Library/LaunchAgents/com.openclaw.gateway.plist`)
+- **Linux**: systemd --user (`~/.config/systemd/user/openclaw.service`)
+- **Windows**: 计划任务 (OpenClaw)
+
+### 手动管理服务
+
+**macOS:**
+```bash
+# 启动
+launchctl start com.openclaw.gateway
+
+# 停止
+launchctl stop com.openclaw.gateway
+
+# 卸载
+launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist
+```
+
+**Linux:**
+```bash
+# 启动
+systemctl --user start openclaw
+
+# 停止
+systemctl --user stop openclaw
+
+# 查看状态
+systemctl --user status openclaw
+```
+
+**Windows (PowerShell):**
+```powershell
+# 启动
+Start-ScheduledTask -TaskName "OpenClaw"
+
+# 停止
+Stop-ScheduledTask -TaskName "OpenClaw"
+
+# 删除
+Unregister-ScheduledTask -TaskName "OpenClaw" -Confirm:$false
+```
+
+## 卸载
+
+```bash
+# 1. 停止服务
+openclaw gateway stop
+
+# 2. 卸载 CLI
+npm uninstall -g openclaw
+
+# 3. 删除配置
+rm -rf ~/.openclaw
+
+# 4. 删除服务配置
+# macOS
+rm ~/Library/LaunchAgents/com.openclaw.gateway.plist
+
+# Linux
+rm ~/.config/systemd/user/openclaw.service
+systemctl --user daemon-reload
+```
+
+## 系统要求
+
+- Node.js 18+
+- npm 或 npx
+- macOS / Linux / Windows (WSL2 推荐)
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,537 @@
+#!/usr/bin/env node
+/**
+ * OpenClaw 一键安装 CLI
+ *
+ * 基本用法:
+ *   npx openclawsetup
+ *
+ * 环境变量:
+ *   OPENCLAW_PORT      - Gateway 端口 (默认: 18789)
+ *   GATEWAY_TOKEN      - 自定义 Token (默认: 自动生成)
+ *   SKIP_DAEMON        - 跳过服务持久化 (默认: false)
+ *
+ * 命令行参数:
+ *   --port <port>      - 指定 Gateway 端口
+ *   --token <token>    - 指定 Gateway Token
+ *   --skip-daemon      - 跳过服务持久化配置
+ *   --skip-start       - 安装后不启动服务
+ */
+
+import { execSync, spawn } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { homedir, platform } from 'os';
+import { join } from 'path';
+import { randomBytes } from 'crypto';
+
+// 解析命令行参数
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const result = {
+    port: parseInt(process.env.OPENCLAW_PORT, 10) || 18789,
+    token: process.env.GATEWAY_TOKEN || '',
+    skipDaemon: process.env.SKIP_DAEMON === 'true' || process.env.SKIP_DAEMON === '1',
+    skipStart: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case '--port':
+        result.port = parseInt(args[++i], 10) || 18789;
+        break;
+      case '--token':
+        result.token = args[++i] || '';
+        break;
+      case '--skip-daemon':
+        result.skipDaemon = true;
+        break;
+      case '--skip-start':
+        result.skipStart = true;
+        break;
+      case '--help':
+      case '-h':
+        showHelp();
+        process.exit(0);
+    }
+  }
+
+  return result;
+}
+
+function showHelp() {
+  console.log(`
+OpenClaw 一键安装工具
+
+用法:
+  npx openclawsetup [选项]
+
+选项:
+  --port <port>      指定 Gateway 端口 (默认: 18789)
+  --token <token>    指定 Gateway Token (默认: 自动生成)
+  --skip-daemon      跳过服务持久化配置
+  --skip-start       安装后不启动服务
+  --help, -h         显示帮助信息
+
+环境变量:
+  OPENCLAW_PORT      Gateway 端口
+  GATEWAY_TOKEN      自定义 Token
+  SKIP_DAEMON        跳过服务持久化 (true/1)
+
+示例:
+  # 默认安装
+  npx openclawsetup
+
+  # 指定端口和 Token
+  npx openclawsetup --port 8080 --token mytoken123
+
+  # macOS/Linux 环境变量方式
+  OPENCLAW_PORT=8080 npx openclawsetup
+
+  # Windows PowerShell
+  $env:OPENCLAW_PORT=8080; npx openclawsetup
+`);
+}
+
+// 颜色
+const colors = {
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+  gray: (s) => `\x1b[90m${s}\x1b[0m`,
+};
+
+const log = {
+  info: (msg) => console.log(colors.cyan(msg)),
+  success: (msg) => console.log(colors.green(`✓ ${msg}`)),
+  warn: (msg) => console.log(colors.yellow(`⚠ ${msg}`)),
+  error: (msg) => console.log(colors.red(`✗ ${msg}`)),
+  hint: (msg) => console.log(colors.gray(`  提示: ${msg}`)),
+  detail: (msg) => console.log(colors.gray(`  ${msg}`)),
+  step: (n, msg) => console.log(colors.cyan(`[${n}] ${msg}`)),
+};
+
+// 错误码定义
+const ERROR_CODES = {
+  NODE_VERSION: { code: 1, message: 'Node.js 版本过低' },
+  ALREADY_INSTALLED: { code: 2, message: 'OpenClaw 已安装' },
+  NPM_INSTALL_FAILED: { code: 3, message: 'npm 安装失败' },
+  CONFIG_FAILED: { code: 4, message: '配置文件创建失败' },
+  DAEMON_SETUP_FAILED: { code: 5, message: '服务持久化配置失败' },
+  START_FAILED: { code: 6, message: '服务启动失败' },
+  PERMISSION_DENIED: { code: 7, message: '权限不足' },
+  UNSUPPORTED_PLATFORM: { code: 8, message: '不支持的操作系统' },
+};
+
+// 退出并显示错误
+function exitWithError(errorType, details = '', solutions = []) {
+  const err = ERROR_CODES[errorType] || { code: 99, message: '未知错误' };
+  console.log(colors.bold(colors.red('\n========================================')));
+  console.log(colors.bold(colors.red(`❌ 错误: ${err.message}`)));
+  console.log(colors.bold(colors.red('========================================')));
+  if (details) log.detail(details);
+  if (solutions.length > 0) {
+    console.log(colors.cyan('\n解决方案:'));
+    solutions.forEach((s, i) => console.log(`  ${i + 1}. ${s}`));
+  }
+  console.log(colors.gray(`\n错误码: ${err.code}`));
+  process.exit(err.code);
+}
+
+// 安全执行命令
+function safeExec(cmd, options = {}) {
+  try {
+    const output = execSync(cmd, { encoding: 'utf8', stdio: 'pipe', ...options });
+    return { ok: true, output: output.trim() };
+  } catch (e) {
+    return {
+      ok: false,
+      error: e.message,
+      stderr: e.stderr?.toString() || '',
+      stdout: e.stdout?.toString() || '',
+    };
+  }
+}
+
+// 检查 Node.js 版本
+function checkNodeVersion() {
+  const version = process.version;
+  const major = parseInt(version.slice(1).split('.')[0], 10);
+  if (major < 18) {
+    exitWithError('NODE_VERSION', `当前版本: ${version}，需要 Node.js 18+`, [
+      '升级 Node.js 到 18 或更高版本',
+      '访问 https://nodejs.org/ 下载最新版本',
+      '使用 nvm 管理 Node.js 版本: nvm install 22',
+    ]);
+  }
+  return true;
+}
+
+// 检测现有安装
+function detectExistingInstall() {
+  const home = homedir();
+  const openclawDir = join(home, '.openclaw');
+  const clawdbotDir = join(home, '.clawdbot');
+
+  if (existsSync(openclawDir) || existsSync(clawdbotDir)) {
+    return {
+      installed: true,
+      configDir: existsSync(openclawDir) ? openclawDir : clawdbotDir,
+      name: existsSync(openclawDir) ? 'openclaw' : 'clawdbot',
+    };
+  }
+
+  // 检查命令是否存在
+  const openclawResult = safeExec('openclaw --version');
+  if (openclawResult.ok) {
+    return { installed: true, name: 'openclaw', version: openclawResult.output };
+  }
+
+  const clawdbotResult = safeExec('clawdbot --version');
+  if (clawdbotResult.ok) {
+    return { installed: true, name: 'clawdbot', version: clawdbotResult.output };
+  }
+
+  return { installed: false };
+}
+
+// 安装 OpenClaw CLI
+function installOpenClaw() {
+  log.step(1, '安装 OpenClaw CLI...');
+
+  const result = safeExec('npm install -g openclaw@latest', { timeout: 300000 });
+  if (!result.ok) {
+    // 尝试 clawdbot 作为备选
+    log.warn('openclaw 安装失败，尝试 clawdbot...');
+    const fallback = safeExec('npm install -g clawdbot@latest', { timeout: 300000 });
+    if (!fallback.ok) {
+      exitWithError('NPM_INSTALL_FAILED', result.stderr || result.error, [
+        '检查网络连接',
+        '尝试使用代理: npm config set proxy http://proxy:port',
+        '手动安装: npm install -g openclaw@latest',
+        '检查 npm 权限，可能需要 sudo (Linux/macOS)',
+      ]);
+    }
+    return 'clawdbot';
+  }
+
+  log.success('OpenClaw CLI 安装完成');
+  return 'openclaw';
+}
+
+// 生成 Token
+function generateToken() {
+  return randomBytes(32).toString('hex');
+}
+
+// 创建配置文件
+function createConfig(options) {
+  log.step(2, '创建配置文件...');
+
+  const home = homedir();
+  const configDir = join(home, '.openclaw');
+  const workspaceDir = join(configDir, 'workspace');
+  const configPath = join(configDir, 'openclaw.json');
+
+  // 创建目录
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true });
+  }
+  if (!existsSync(workspaceDir)) {
+    mkdirSync(workspaceDir, { recursive: true });
+  }
+
+  // 生成 Token
+  const token = options.token || generateToken();
+
+  // 配置内容
+  const config = {
+    agents: {
+      defaults: {
+        workspace: workspaceDir,
+        model: { primary: 'anthropic/claude-sonnet-4-20250514' },
+        models: ['anthropic/claude-sonnet-4-20250514', 'anthropic/claude-opus-4-5-20251101'],
+        maxConcurrent: 4,
+        sandbox: { mode: 'non-main', scope: 'agent', workspaceAccess: 'rw' },
+      },
+    },
+    gateway: {
+      port: options.port,
+      mode: 'local',
+      bind: 'loopback',
+      auth: { mode: 'token', token: token },
+    },
+    session: { dmScope: 'per-channel-peer' },
+    models: {
+      providers: {},
+    },
+    tools: { profile: 'coding', allow: ['fs', 'shell', 'browser'], deny: [] },
+    skills: { load: { watch: true, watchDebounceMs: 250 } },
+    channels: {},
+  };
+
+  try {
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+    log.success(`配置文件已创建: ${configPath}`);
+  } catch (e) {
+    exitWithError('CONFIG_FAILED', e.message, [
+      `检查目录权限: ${configDir}`,
+      '尝试手动创建目录: mkdir -p ~/.openclaw',
+    ]);
+  }
+
+  // 创建 workspace 文件
+  const workspaceFiles = ['AGENTS.md', 'SOUL.md', 'USER.md', 'IDENTITY.md', 'TOOLS.md', 'MEMORY.md'];
+  for (const file of workspaceFiles) {
+    const filePath = join(workspaceDir, file);
+    if (!existsSync(filePath)) {
+      writeFileSync(filePath, `# ${file.replace('.md', '')}\n`);
+    }
+  }
+  log.success('Workspace 文件已初始化');
+
+  return { configDir, configPath, token, port: options.port };
+}
+
+// 配置服务持久化 - macOS
+function setupDaemonMacOS(cliName) {
+  const plistPath = join(homedir(), 'Library', 'LaunchAgents', 'com.openclaw.gateway.plist');
+  const plistDir = join(homedir(), 'Library', 'LaunchAgents');
+
+  if (!existsSync(plistDir)) {
+    mkdirSync(plistDir, { recursive: true });
+  }
+
+  // 获取 CLI 路径
+  const cliPathResult = safeExec(`which ${cliName}`);
+  const cliPath = cliPathResult.ok ? cliPathResult.output : `/usr/local/bin/${cliName}`;
+
+  const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.openclaw.gateway</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${cliPath}</string>
+        <string>gateway</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/openclaw.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/openclaw.err</string>
+</dict>
+</plist>`;
+
+  try {
+    writeFileSync(plistPath, plistContent);
+    safeExec(`launchctl load "${plistPath}"`);
+    log.success('macOS 服务持久化已配置 (launchd)');
+    return true;
+  } catch (e) {
+    log.warn(`服务持久化配置失败: ${e.message}`);
+    return false;
+  }
+}
+
+// 配置服务持久化 - Linux
+function setupDaemonLinux(cliName) {
+  const serviceDir = join(homedir(), '.config', 'systemd', 'user');
+  const servicePath = join(serviceDir, 'openclaw.service');
+
+  if (!existsSync(serviceDir)) {
+    mkdirSync(serviceDir, { recursive: true });
+  }
+
+  // 获取 CLI 路径
+  const cliPathResult = safeExec(`which ${cliName}`);
+  const cliPath = cliPathResult.ok ? cliPathResult.output : `/usr/local/bin/${cliName}`;
+
+  const serviceContent = `[Unit]
+Description=OpenClaw Gateway Service
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${cliPath} gateway
+Restart=always
+RestartSec=10
+
+[Install]
+WantedBy=default.target
+`;
+
+  try {
+    writeFileSync(servicePath, serviceContent);
+    safeExec('systemctl --user daemon-reload');
+    safeExec('systemctl --user enable openclaw');
+    // 允许用户服务在登出后继续运行
+    safeExec(`loginctl enable-linger ${process.env.USER || 'root'}`);
+    log.success('Linux 服务持久化已配置 (systemd --user)');
+    return true;
+  } catch (e) {
+    log.warn(`服务持久化配置失败: ${e.message}`);
+    return false;
+  }
+}
+
+// 配置服务持久化 - Windows
+function setupDaemonWindows(cliName) {
+  // Windows 使用计划任务
+  const taskName = 'OpenClaw';
+  const result = safeExec(
+    `schtasks /create /tn "${taskName}" /tr "${cliName} gateway" /sc onlogon /rl limited /f`,
+    { shell: 'cmd.exe' }
+  );
+
+  if (result.ok) {
+    log.success('Windows 服务持久化已配置 (计划任务)');
+    return true;
+  } else {
+    log.warn(`服务持久化配置失败: ${result.stderr || result.error}`);
+    log.hint('可以手动创建计划任务或使用 NSSM 工具');
+    return false;
+  }
+}
+
+// 配置服务持久化
+function setupDaemon(cliName) {
+  log.step(3, '配置服务持久化...');
+
+  const os = platform();
+  switch (os) {
+    case 'darwin':
+      return setupDaemonMacOS(cliName);
+    case 'linux':
+      return setupDaemonLinux(cliName);
+    case 'win32':
+      return setupDaemonWindows(cliName);
+    default:
+      log.warn(`不支持的操作系统: ${os}，跳过服务持久化`);
+      return false;
+  }
+}
+
+// 启动服务
+function startService(cliName) {
+  log.step(4, '启动 OpenClaw Gateway...');
+
+  const os = platform();
+
+  // 根据系统使用不同的启动方式
+  if (os === 'darwin') {
+    const result = safeExec('launchctl start com.openclaw.gateway');
+    if (result.ok) {
+      log.success('Gateway 已启动 (launchd)');
+      return true;
+    }
+  } else if (os === 'linux') {
+    const result = safeExec('systemctl --user start openclaw');
+    if (result.ok) {
+      log.success('Gateway 已启动 (systemd)');
+      return true;
+    }
+  }
+
+  // 备选：直接启动
+  log.info('尝试直接启动 Gateway...');
+  const startResult = safeExec(`${cliName} gateway &`, { timeout: 5000 });
+  if (startResult.ok || startResult.error?.includes('timeout')) {
+    log.success('Gateway 已启动');
+    return true;
+  }
+
+  log.warn('Gateway 启动可能失败，请手动检查');
+  log.hint(`手动启动: ${cliName} gateway`);
+  return false;
+}
+
+// 主函数
+async function main() {
+  const options = parseArgs();
+
+  console.log(colors.bold(colors.cyan('\n🦞 OpenClaw 一键安装\n')));
+  console.log(colors.gray('自动完成 OpenClaw 基础部署，无需交互\n'));
+
+  // 前置检查
+  checkNodeVersion();
+  log.success(`Node.js 版本: ${process.version}`);
+
+  // 检测现有安装
+  const existing = detectExistingInstall();
+  if (existing.installed) {
+    console.log(colors.yellow('\n检测到已有安装:'));
+    if (existing.configDir) {
+      log.detail(`配置目录: ${existing.configDir}`);
+    }
+    if (existing.version) {
+      log.detail(`版本: ${existing.version}`);
+    }
+    console.log(colors.cyan('\n如需重新安装，请先卸载:'));
+    console.log(`  npm uninstall -g ${existing.name}`);
+    console.log(`  rm -rf ~/.openclaw ~/.clawdbot`);
+    console.log('');
+    process.exit(0);
+  }
+
+  // 安装 CLI
+  const cliName = installOpenClaw();
+
+  // 创建配置
+  const config = createConfig(options);
+
+  // 配置服务持久化
+  if (!options.skipDaemon) {
+    setupDaemon(cliName);
+  } else {
+    log.info('跳过服务持久化配置 (--skip-daemon)');
+  }
+
+  // 启动服务
+  if (!options.skipStart) {
+    startService(cliName);
+  } else {
+    log.info('跳过服务启动 (--skip-start)');
+  }
+
+  // 完成
+  console.log(colors.bold(colors.green('\n========================================')));
+  console.log(colors.bold(colors.green('✅ OpenClaw 安装完成！')));
+  console.log(colors.bold(colors.green('========================================')));
+
+  console.log(colors.cyan('\n配置信息:'));
+  console.log(`  配置目录: ${colors.yellow(config.configDir)}`);
+  console.log(`  Gateway 端口: ${colors.yellow(config.port)}`);
+  console.log(`  Gateway Token: ${colors.yellow(config.token)}`);
+
+  console.log(colors.cyan('\nDashboard 访问:'));
+  console.log(`  ${colors.yellow(`http://127.0.0.1:${config.port}/?token=${config.token}`)}`);
+
+  console.log(colors.cyan('\n下一步 - 配置 AI 模型:'));
+  console.log(`  ${colors.yellow('npx openclawapi@latest preset-claude')}`);
+
+  console.log(colors.cyan('\n常用命令:'));
+  console.log(`  查看状态: ${colors.yellow(`${cliName} status`)}`);
+  console.log(`  查看日志: ${colors.yellow(`${cliName} gateway logs`)}`);
+  console.log(`  重启服务: ${colors.yellow(`${cliName} gateway restart`)}`);
+  console.log(`  诊断问题: ${colors.yellow(`${cliName} doctor`)}`);
+
+  console.log(colors.cyan('\n配置聊天渠道:'));
+  console.log(`  Discord: ${colors.yellow('npx openclawdc')}`);
+  console.log(`  飞书:    ${colors.yellow('npx openclawfs')}`);
+
+  console.log('');
+}
+
+main().catch((e) => {
+  exitWithError('CONFIG_FAILED', e.message, [
+    '检查网络连接',
+    '确保有足够的磁盘空间',
+    '查看详细错误信息并重试',
+  ]);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "openclawsetup",
+  "version": "1.0.0",
+  "description": "一键安装 OpenClaw - 自动完成基础部署，无需交互",
+  "type": "module",
+  "bin": {
+    "openclawsetup": "./bin/cli.mjs"
+  },
+  "scripts": {
+    "start": "node bin/cli.mjs"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "使用说明.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "openclaw",
+    "clawdbot",
+    "moltbot",
+    "ai",
+    "assistant",
+    "setup",
+    "install"
+  ],
+  "author": "OpenClaw Community",
+  "license": "MIT"
+}

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

@@ -0,0 +1,264 @@
+# OpenClaw 一键安装 使用说明
+
+## 快速开始
+
+**方式一：默认安装（推荐）**
+```bash
+npx openclawsetup
+```
+自动完成所有配置，无需输入任何内容。
+
+**方式二：指定端口**
+```bash
+# macOS/Linux
+OPENCLAW_PORT=8080 npx openclawsetup
+
+# Windows PowerShell
+$env:OPENCLAW_PORT=8080; npx openclawsetup
+
+# Windows CMD
+set OPENCLAW_PORT=8080 && npx openclawsetup
+```
+
+## 安装完成后
+
+1. **配置 AI 模型（必须）**
+   ```bash
+   npx openclawapi@latest preset-claude
+   ```
+
+2. **访问 Dashboard**
+   ```
+   http://127.0.0.1:18789/?token=<你的token>
+   ```
+   Token 在安装完成时会显示。
+
+3. **配置聊天渠道（可选）**
+   ```bash
+   npx openclawdc    # Discord
+   npx openclawfs    # 飞书
+   ```
+
+## 常见问题
+
+### 错误：Node.js 版本过低
+**现象**：提示 "Node.js 版本过低"
+**解决**：
+1. 升级 Node.js 到 18 或更高版本
+2. 访问 https://nodejs.org/ 下载最新版本
+3. 或使用 nvm: `nvm install 22`
+
+错误码: 1
+
+---
+
+### 错误：检测到已有安装
+**现象**：提示 "检测到已有安装"
+**解决**：
+1. 如果想保留现有安装，无需操作
+2. 如果想重新安装：
+   ```bash
+   npm uninstall -g openclaw
+   rm -rf ~/.openclaw ~/.clawdbot
+   npx openclawsetup
+   ```
+
+错误码: 2
+
+---
+
+### 错误：npm 安装失败
+**现象**：提示 "npm 安装失败"
+**解决**：
+1. 检查网络连接
+2. 尝试使用代理：
+   ```bash
+   npm config set proxy http://proxy:port
+   ```
+3. 手动安装：
+   ```bash
+   npm install -g openclaw@latest
+   ```
+4. Linux/macOS 可能需要 sudo：
+   ```bash
+   sudo npm install -g openclaw@latest
+   ```
+
+错误码: 3
+
+---
+
+### 错误：配置文件创建失败
+**现象**：提示 "配置文件创建失败"
+**解决**：
+1. 检查目录权限：
+   ```bash
+   ls -la ~/
+   ```
+2. 手动创建目录：
+   ```bash
+   mkdir -p ~/.openclaw
+   ```
+3. 检查磁盘空间：
+   ```bash
+   df -h
+   ```
+
+错误码: 4
+
+---
+
+### 错误：服务持久化配置失败
+**现象**：提示 "服务持久化配置失败"
+**解决**：
+1. 这不是致命错误，OpenClaw 仍可手动启动
+2. 手动启动：
+   ```bash
+   openclaw gateway
+   ```
+3. macOS 手动配置 launchd：
+   ```bash
+   launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist
+   ```
+4. Linux 手动配置 systemd：
+   ```bash
+   systemctl --user daemon-reload
+   systemctl --user enable openclaw
+   ```
+
+错误码: 5
+
+---
+
+### 错误：服务启动失败
+**现象**：提示 "服务启动失败" 或 Gateway 无法访问
+**解决**：
+1. 手动启动：
+   ```bash
+   openclaw gateway
+   ```
+2. 查看日志：
+   ```bash
+   openclaw gateway logs
+   ```
+3. 检查端口占用：
+   ```bash
+   # macOS/Linux
+   lsof -i :18789
+
+   # Windows
+   netstat -ano | findstr 18789
+   ```
+4. 运行诊断：
+   ```bash
+   openclaw doctor
+   ```
+
+错误码: 6
+
+---
+
+### 错误：权限不足
+**现象**：提示 "权限不足" 或 EACCES 错误
+**解决**：
+1. Linux/macOS 使用 sudo：
+   ```bash
+   sudo npm install -g openclaw@latest
+   ```
+2. 或修复 npm 权限：
+   ```bash
+   mkdir ~/.npm-global
+   npm config set prefix '~/.npm-global'
+   export PATH=~/.npm-global/bin:$PATH
+   ```
+3. 将上面的 export 添加到 `~/.bashrc` 或 `~/.zshrc`
+
+错误码: 7
+
+---
+
+### 错误：不支持的操作系统
+**现象**：提示 "不支持的操作系统"
+**解决**：
+1. 目前支持 macOS、Linux、Windows
+2. Windows 建议使用 WSL2：
+   ```powershell
+   wsl --install
+   ```
+3. 在 WSL2 中运行安装命令
+
+错误码: 8
+
+---
+
+### Dashboard 无法访问
+**现象**：浏览器打开 Dashboard 显示无法连接
+**解决**：
+1. 确认 Gateway 正在运行：
+   ```bash
+   openclaw status
+   ```
+2. 检查端口：
+   ```bash
+   curl http://127.0.0.1:18789/health
+   ```
+3. 确认 Token 正确（在 `~/.openclaw/openclaw.json` 中查看）
+4. 重启 Gateway：
+   ```bash
+   openclaw gateway restart
+   ```
+
+---
+
+### 忘记 Token
+**现象**：忘记了 Gateway Token
+**解决**：
+查看配置文件：
+```bash
+# macOS/Linux
+cat ~/.openclaw/openclaw.json | grep token
+
+# Windows PowerShell
+Get-Content ~/.openclaw/openclaw.json | Select-String token
+```
+
+---
+
+### 如何完全卸载
+**步骤**：
+```bash
+# 1. 停止服务
+openclaw gateway stop
+
+# 2. 卸载 CLI
+npm uninstall -g openclaw
+
+# 3. 删除配置
+rm -rf ~/.openclaw
+
+# 4. 删除服务配置
+# macOS
+launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist
+rm ~/Library/LaunchAgents/com.openclaw.gateway.plist
+
+# Linux
+systemctl --user stop openclaw
+systemctl --user disable openclaw
+rm ~/.config/systemd/user/openclaw.service
+systemctl --user daemon-reload
+
+# Windows PowerShell
+Unregister-ScheduledTask -TaskName "OpenClaw" -Confirm:$false
+```
+
+## 获取帮助
+
+```bash
+npx openclawsetup --help
+```
+
+如有其他问题，请查看日志或运行诊断：
+```bash
+openclaw gateway logs
+openclaw doctor
+```