@aiyiran/myclaw 1.0.5 → 1.0.7

package/README.md

@@ -0,0 +1,126 @@
+# MyClaw - 学生友好的 OpenClaw 工具
+
+一个简化 OpenClaw 日常操作的命令行工具，专为教学环境设计。
+
+## 跨平台要求 ⚠️
+
+```
+╔══════════════════════════════════════════════════════════════════════╗
+║                       跨平台兼容性说明                               ║
+╠══════════════════════════════════════════════════════════════════════╣
+║                                                                      ║
+║  支持系统:                                                           ║
+║    ✅ macOS      - 完全支持，包括颜色和 Emoji                         ║
+║    ✅ Linux      - 完全支持，包括颜色和 Emoji                         ║
+║    ✅ Windows 10/11 - 基本支持，推荐使用 Windows Terminal            ║
+║    ⚠️ Windows 7/8 - 支持，但 Emoji 可能显示为方块                    ║
+║                                                                      ║
+║  Windows 用户建议:                                                   ║
+║    • 安装 Windows Terminal (Microsoft Store 免费下载)                ║
+║    • 或使用 PowerShell 7+ (https://aka.ms/powershell)               ║
+║                                                                      ║
+║  颜色说明:                                                           ║
+║    • macOS/Linux: 正常显示 ANSI 颜色                                ║
+║    • Windows: 自动禁用颜色输出，避免乱码                             ║
+║                                                                      ║
+╚══════════════════════════════════════════════════════════════════════╝
+```
+
+## 安装
+
+```bash
+# 方式一: 直接运行
+node myclaw/index.js <command>
+
+# 方式二: 添加到 PATH (macOS/Linux)
+ln -s /path/to/myclaw/index.js /usr/local/bin/myclaw
+chmod +x /usr/local/bin/myclaw
+
+# 方式三: Windows PowerShell
+# 将 myclaw/index.js 路径添加到系统 PATH
+```
+
+## 使用方法
+
+### 查看状态
+```bash
+myclaw status
+```
+简化版的 OpenClaw 状态面板，一眼看清 Gateway、Agents、Sessions 状态。
+
+### 创建新 Agent
+```bash
+myclaw new <agent名称>
+```
+快速创建一个新的 OpenClaw Agent，自动完成：
+- 创建 workspace 目录
+- 配置 agent 文件
+- 发送出生消息
+
+示例：
+```bash
+myclaw new helper      # 创建名为 helper 的 Agent
+myclaw new testbot     # 创建名为 testbot 的 Agent
+```
+
+### 安装 OpenClaw
+```bash
+myclaw install
+```
+自动检测操作系统并执行对应的安装命令。
+
+### 帮助
+```bash
+myclaw help
+```
+
+## 文件结构
+
+```
+myclaw/
+├── index.js          # 主入口，命令解析和输出
+├── create_agent.js   # Agent 创建逻辑模块
+└── README.md         # 本文件
+```
+
+### 模块说明
+
+| 文件 | 职责 |
+|------|------|
+| `index.js` | 主入口，解析命令、颜色输出、调用模块 |
+| `create_agent.js` | Agent 创建的完整逻辑，可独立使用 |
+
+## 开发说明
+
+### 代码规范
+
+1. **跨平台兼容性** - 必须考虑 Windows 用户体验
+   - 使用 `os.platform()` 检测系统
+   - Windows 下禁用 ANSI 颜色输出
+   - 避免使用只在 Unix 系统有效的命令
+
+2. **错误处理**
+   - 所有 `execSync` 调用必须使用 `try-catch`
+   - 失败时提供清晰的错误信息和解决方案
+
+3. **模块化**
+   - 业务逻辑放入独立模块
+   - 主入口只做命令解析和输出
+
+### 测试清单
+
+发布前请在以下环境测试：
+- [ ] macOS (Terminal)
+- [ ] Linux (bash)
+- [ ] Windows 10/11 (PowerShell)
+- [ ] Windows 10/11 (CMD)
+- [ ] Windows Terminal (如果可用)
+
+## 依赖
+
+- Node.js 14+
+- OpenClaw CLI (用于实际命令执行)
+
+## 许可证
+
+内部教学工具

package/create_agent.js

@@ -0,0 +1,272 @@
+/**
+ * ============================================================================
+ * MyClaw - Create Agent 模块
+ * ============================================================================
+ * 
+ * 创建 OpenClaw Agent 的完整逻辑
+ * 
+ * 功能:
+ * - 标准化 agent ID
+ * - 检查重复
+ * - 创建工作空间目录和默认文件
+ * - 更新 OpenClaw 配置文件
+ * - 发送出生消息
+ * 
+ * ============================================================================
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ============================================================================
+// 路径工具
+// ============================================================================
+
+function normalizePath(p) {
+  return p.replace(/\\/g, '/');
+}
+
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+function writeIfAbsent(filePath, content) {
+  if (!fs.existsSync(filePath)) {
+    fs.writeFileSync(filePath, content, 'utf8');
+  }
+}
+
+// ============================================================================
+// 工具函数
+// ============================================================================
+
+function fail(msg, code = 1) {
+  console.error('[错误] ' + msg);
+  process.exit(code);
+}
+
+/**
+ * 标准化 agent ID
+ * - 转小写
+ * - 非法字符替换为连字符
+ * - 去除多余连字符
+ */
+function normalizeAgentId(raw) {
+  let value = raw.trim().toLowerCase();
+  value = value.replace(/[^a-z0-9-]/g, '-');
+  value = value.replace(/-{2,}/g, '-').replace(/^-|-$/g, '');
+  return value;
+}
+
+/**
+ * 验证 agent ID
+ */
+function validateAgentId(agentId) {
+  if (!agentId) {
+    fail('Agent 名称标准化后为空，请检查输入。');
+  }
+  if (agentId.length > 64) {
+    fail('Agent ID 太长，请保持在 64 个字符以内。');
+  }
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(agentId)) {
+    fail('Agent ID 只能包含小写字母、数字和连字符（不能以连字符开头或结尾）。');
+  }
+}
+
+/**
+ * 生成北京时间出生消息
+ */
+function buildBirthMessage() {
+  const nowUtc = new Date();
+  const nowBj = new Date(nowUtc.getTime() + 8 * 60 * 60 * 1000);
+  const y = nowBj.getUTCFullYear();
+  const m = nowBj.getUTCMonth() + 1;
+  const d = nowBj.getUTCDate();
+  const h = String(nowBj.getUTCHours()).padStart(2, '0');
+  const min = String(nowBj.getUTCMinutes()).padStart(2, '0');
+  const ts = `${y}年${m}月${d}日${h}:${min}`;
+  return (
+    `你好，你的生日是北京时间${ts}，请记录这个信息。\n` +
+    '欢迎你来到这个世界，我是你的造物主，我们是伙伴，我叫做孙依然，' +
+    '你可以叫我依然，请多多指教，共同成长。'
+  );
+}
+
+/**
+ * 默认工作空间文件内容
+ */
+function defaultWorkspaceFiles(agentId) {
+  return {
+    'AGENTS.md': (
+      `# AGENTS.md - ${agentId}\n\n` +
+      `This workspace belongs to the \`${agentId}\` agent.\n\n` +
+      '## Startup\n' +
+      '- Read `SOUL.md`\n' +
+      '- Read `USER.md`\n' +
+      '- Read recent memory if available\n\n' +
+      '## Rules\n' +
+      '- Be helpful, careful, and concise.\n' +
+      '- Prefer using the existing workspace and defaults.\n' +
+      '- Ask before destructive or external actions.\n'
+    ),
+    'SOUL.md': (
+      `# SOUL.md\n\n` +
+      `You are \`${agentId}\`.\n\n` +
+      'Be useful, calm, direct, and trustworthy.\n' +
+      'Use the default OpenClaw behavior unless the user asks for something special.\n'
+    ),
+    'USER.md': (
+      '# USER.md\n\n' +
+      '- Name: 孙依然\n' +
+      '- What to call them: 依然\n' +
+      '- Timezone: Asia/Shanghai\n\n' +
+      'Build understanding gradually and respectfully.\n'
+    ),
+    'IDENTITY.md': (
+      '# IDENTITY.md\n\n' +
+      `- Name: ${agentId}\n` +
+      '- Role: OpenClaw agent\n' +
+      '- Vibe: practical, reliable, clear\n'
+    ),
+    'HEARTBEAT.md': (
+      '# HEARTBEAT.md\n\n' +
+      '# Keep empty unless periodic checks are needed.\n'
+    ),
+    'BOOTSTRAP.md': (
+      `# BOOTSTRAP.md\n\n` +
+      `You are a newly created OpenClaw agent named \`${agentId}\`.\n\n` +
+      'On first runs, learn your workspace files and begin helping.\n'
+    ),
+  };
+}
+
+// ============================================================================
+// 主函数
+// ============================================================================
+
+/**
+ * 创建新的 OpenClaw Agent
+ * 
+ * @param {string} rawName - 原始名称
+ * @returns {object} 创建结果
+ */
+function createAgent(rawName) {
+  // 标准化 & 验证名称
+  const agentId = normalizeAgentId(rawName);
+  validateAgentId(agentId);
+
+  // 确定 OpenClaw 配置目录
+  const homeDir = os.homedir();
+  const openclawDir = path.join(homeDir, '.openclaw');
+  const configPath = path.join(openclawDir, 'openclaw.json');
+  const agentsDir = path.join(openclawDir, 'agents');
+  const workspaceDir = path.join(openclawDir, 'workspace-' + agentId);
+  const agentDir = path.join(agentsDir, agentId, 'agent');
+
+  // 检查配置是否存在
+  if (!fs.existsSync(configPath)) {
+    fail('配置文件不存在: ' + normalizePath(configPath) + '\n请先运行 openclaw onboard 完成初始化。');
+  }
+
+  // 加载配置
+  let configData;
+  try {
+    const raw = fs.readFileSync(configPath, 'utf8');
+    configData = JSON.parse(raw);
+  } catch (err) {
+    fail('配置文件读取失败: ' + err.message);
+  }
+
+  // 确保 agents 结构存在
+  if (!configData.agents) {
+    configData.agents = {};
+  }
+  if (!Array.isArray(configData.agents.list)) {
+    configData.agents.list = [];
+  }
+
+  // 检查重复 ID
+  const existingIds = new Set(
+    configData.agents.list
+      .filter(e => e && typeof e === 'object')
+      .map(e => e.id)
+  );
+  if (existingIds.has(agentId)) {
+    fail('Agent "' + agentId + '" 已存在，请使用其他名称。');
+  }
+
+  // 检查目录冲突
+  if (fs.existsSync(workspaceDir) || fs.existsSync(agentDir)) {
+    fail(
+      '工作空间或 Agent 目录已存在，请检查是否已有同名 Agent。\n' +
+      'workspace=' + normalizePath(workspaceDir) + '\n' +
+      'agentDir=' + normalizePath(agentDir)
+    );
+  }
+
+  // 创建目录结构
+  ensureDir(workspaceDir);
+  ensureDir(agentDir);
+  ensureDir(path.join(agentsDir, agentId, 'sessions'));
+
+  // 创建默认工作空间文件
+  const files = defaultWorkspaceFiles(agentId);
+  for (const [filename, content] of Object.entries(files)) {
+    writeIfAbsent(path.join(workspaceDir, filename), content);
+  }
+
+  // 备份配置
+  const backupPath = configPath + '.bak.agent-birth.' + 
+    new Date().toISOString().replace(/[:.]/g, '-').slice(0, 26) + 'Z';
+  fs.copyFileSync(configPath, backupPath);
+
+  // 添加 Agent 条目
+  configData.agents.list.push({
+    id: agentId,
+    name: agentId,
+    workspace: workspaceDir,
+    agentDir: agentDir,
+  });
+
+  // 写入配置
+  try {
+    fs.writeFileSync(configPath, JSON.stringify(configData, null, 2) + '\n', 'utf8');
+  } catch (err) {
+    fail('配置文件写入失败: ' + err.message + '\n备份文件: ' + normalizePath(backupPath));
+  }
+
+  // 发送出生消息
+  const birthMessage = buildBirthMessage();
+  let firstMessageSent = false;
+  let firstMessageError = null;
+
+  try {
+    execSync(
+      'openclaw agent --agent ' + agentId + ' --message ' + JSON.stringify(birthMessage) + ' --json 2>&1',
+      { encoding: 'utf8', timeout: 30000 }
+    );
+    firstMessageSent = true;
+  } catch (err) {
+    firstMessageSent = false;
+    firstMessageError = err.message;
+  }
+
+  // 返回结果
+  return {
+    ok: true,
+    agentId: agentId,
+    sessionKey: 'agent:' + agentId + ':main',
+    workspace: normalizePath(workspaceDir),
+    agentDir: normalizePath(agentDir),
+    configBackup: normalizePath(backupPath),
+    birthMessage: birthMessage,
+    firstMessageSent: firstMessageSent,
+    firstMessageError: firstMessageError,
+  };
+}
+
+module.exports = { createAgent, normalizeAgentId, validateAgentId };

package/index.js

@@ -25,6 +25,7 @@
 
 const { execSync } = require('child_process');
 const os = require('os');
+const { createAgent } = require('./create_agent');
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -46,22 +47,10 @@ const isWindows = detectPlatform() === 'windows';
 // 跨平台颜色输出
 // ============================================================================
 
-/**
- * 颜色输出函数 - 自动兼容 Windows
- * Windows 旧版本会 stripped ANSI 颜色代码，避免乱码
- */
 function makeColors() {
   if (isWindows) {
-    // Windows: 禁用颜色，strip ANSI codes
-    return {
-      red: '',
-      green: '',
-      yellow: '',
-      blue: '',
-      nc: ''
-    };
+    return { red: '', green: '', yellow: '', blue: '', nc: '' };
   }
-  // macOS/Linux: 正常 ANSI 颜色
   return {
     red: '\x1b[31m',
     green: '\x1b[32m',
@@ -189,86 +178,71 @@ function runStatus() {
 // ============================================================================
 
 function runNew() {
-  const agentName = args[1];
+  const rawName = args[1];
   
-  if (!agentName) {
+  if (!rawName) {
     console.error('[' + colors.red + '错误' + colors.nc + '] 请提供 Agent 名称');
     console.log('');
     console.log('用法: myclaw new <agent名称>');
     console.log('');
     console.log('示例:');
     console.log('  myclaw new helper    # 创建名为 helper 的 Agent');
-    console.log('  myclaw new testbot  # 创建名为 testbot 的 Agent');
-    process.exit(1);
-  }
-
-  // 验证名称格式
-  if (!/^[a-z0-9-]+$/.test(agentName)) {
-    console.error('[' + colors.red + '错误' + colors.nc + '] Agent 名称只能包含小写字母、数字和连字符（-）');
-    console.log('');
-    console.log('示例:');
-    console.log('  myclaw new helper');
-    console.log('  myclaw new my-bot');
+    console.log('  myclaw new testbot   # 创建名为 testbot 的 Agent');
     process.exit(1);
   }
 
   const bar = '----------------------------------------';
   
   console.log('');
-  console.log('[' + colors.blue + 'MyClaw' + colors.nc + '] ' + colors.blue + '创建新 Agent: ' + agentName + colors.nc);
+  console.log('[' + colors.blue + 'MyClaw' + colors.nc + '] ' + colors.blue + '创建新 Agent' + colors.nc);
   console.log(bar);
   console.log('');
-
-  // 检查是否已存在
-  try {
-    const agentsOutput = execSync('openclaw agents list 2>/dev/null', { encoding: 'utf8' });
-    if (agentsOutput.includes(`agent:${agentName}:`)) {
-      console.error('[' + colors.red + '错误' + colors.nc + '] Agent "' + agentName + '" 已存在');
-      process.exit(1);
-    }
-  } catch (e) {
-    // 继续创建
-  }
-
-  // 查找 yiran-agent-birth 脚本
-  const birthScript = '/Users/yiran/.openclaw/workspace/skills/yiran-agent-birth/scripts/create_agent.py';
-  
   console.log('[创建中] 正在创建 Agent...');
-  
+  console.log('');
+
   try {
-    const result = execSync(`python3 "${birthScript}" ${agentName}`, { encoding: 'utf8' });
-    const jsonResult = JSON.parse(result);
+    const result = createAgent(rawName);
     
-    console.log('');
     console.log('[' + colors.green + '成功' + colors.nc + '] Agent 创建成功！');
     console.log('');
-    console.log('  名称: ' + agentName);
-    console.log('  Session: ' + jsonResult.sessionKey);
-    console.log('  Workspace: ' + jsonResult.workspace);
+    console.log('  名称:      ' + result.agentId);
+    console.log('  Session:   ' + result.sessionKey);
+    console.log('  Workspace: ' + result.workspace);
+    console.log('  备份:      ' + result.configBackup);
     console.log('');
     
-    if (jsonResult.firstMessageSent) {
+    if (result.firstMessageSent) {
       console.log('[' + colors.green + 'OK' + colors.nc + '] 出生消息已发送');
     } else {
-      console.log('[' + colors.yellow + '警告' + colors.nc + '] 出生消息发送失败，可手动重试');
+      console.log('[' + colors.yellow + '警告' + colors.nc + '] 出生消息发送失败');
+      if (result.firstMessageError) {
+        console.log('         错误: ' + result.firstMessageError);
+      }
+      console.log('  手动重试: ' + colors.yellow + 'openclaw agent --agent ' + result.agentId + ' --message "你好"' + colors.nc);
     }
     
     console.log('');
     console.log(bar);
-    console.log('下一步: 运行 ' + colors.yellow + `openclaw agent --agent ${agentName} --message "你好"` + colors.nc + ' 与它对话');
+    console.log('下一步: 运行 ' + colors.yellow + 'openclaw agent --agent ' + result.agentId + ' --message "你好"' + colors.nc + ' 与它对话');
     console.log('');
     
   } catch (err) {
-    console.error('[' + colors.red + '错误' + colors.nc + '] 创建失败:', err.message);
     console.log('');
-    console.log('常见问题:');
-    console.log('  - Agent 名称已存在');
-    console.log('  - 权限不足');
-    console.log('  - OpenClaw 未运行');
+    console.log('[' + colors.red + '失败' + colors.nc + '] Agent 创建失败');
+    console.log('');
     process.exit(1);
   }
 }
 
+// ============================================================================
+// WSL2 安装 (独立模块)
+// ============================================================================
+
+function runWsl2() {
+  const wsl2 = require('./wsl2');
+  wsl2.run();
+}
+
 // ============================================================================
 // 帮助信息
 // ============================================================================
@@ -285,12 +259,14 @@ function showHelp() {
   console.log('  install    安装 OpenClaw 服务');
   console.log('  status     简化版状态查看（学生友好）');
   console.log('  new        创建新的 Agent（学生练习用）');
+  console.log('  wsl2       WSL2 一键安装/修复 (仅限 Windows)');
   console.log('  help       显示帮助信息');
   console.log('');
   console.log('示例:');
   console.log('  myclaw install    # 安装 OpenClaw');
   console.log('  myclaw status     # 查看状态');
   console.log('  myclaw new helper # 创建名为 helper 的 Agent');
+  console.log('  myclaw wsl2       # Windows 下一键安装 WSL2');
   console.log('');
   console.log('跨平台: macOS / Linux / Windows (PowerShell/CMD)');
   console.log('');
@@ -308,6 +284,8 @@ if (!command || command === 'help' || command === '--help' || command === '-h')
   runStatus();
 } else if (command === 'new') {
   runNew();
+} else if (command === 'wsl2') {
+  runWsl2();
 } else {
   console.error('[' + colors.red + '错误' + colors.nc + '] 未知命令: ' + command);
   showHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiyiran/myclaw",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "",
   "main": "index.js",
   "bin": {

package/publish.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+set -e # 遇到错误即停止
+
+echo "📦 准备发布新版本..."
+
+# 1. 添加所有变动
+git add .
+
+# 2. 检查是否有未提交的代码，如果有则先提交
+if ! git diff-index --quiet HEAD; then
+    echo "📝 发现有修改的内容，正在自动提交..."
+    git commit -m "chore: auto update before publish"
+else
+    echo "✅ 工作区很干净，不需要额外提交代码。"
+fi
+
+# 3. 自动更新最小版本号 (npm version patch 会自动再做一个改 package.json 的 commit 并且打上 Tag)
+echo "📈 增加 Patch 版本号..."
+npm version patch
+
+# 4. 推送代码和 Tag 到 GitHub
+echo "☁️ 推送代码和版本 Tag 到 GitHub..."
+git push origin main
+git push origin --tags
+
+# 5. 发布到 npm
+echo "🚀 发布到 npm 仓库..."
+npm publish
+
+echo "🎉 发布流执行完成！"

package/wsl2.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+
+/**
+ * ============================================================================
+ * MyClaw WSL2 一键安装器 (终极全自动版)
+ * ============================================================================
+ *
+ * 使用方式: myclaw wsl2
+ *
+ * 自动检测当前 WSL2 安装状态，分两个阶段完成安装：
+ *   Phase 1: 启用底层 Windows 功能 + 预下载安装包 → 需要重启
+ *   Phase 2: 安装内核更新 + Ubuntu → 完成
+ *
+ * 用户只需反复运行 myclaw wsl2，脚本会自动接续上次的进度。
+ * ============================================================================
+ */
+
+const { execSync } = require('child_process');
+const os = require('os');
+
+// ============================================================================
+// 配置
+// ============================================================================
+
+// 下载源（可替换为你自己的 CDN 地址加速国内下载）
+const WSL_CDN = {
+  kernel: 'https://cdn.yiranlaoshi.com/software/myclaw/wsl_update_x64.msi',
+  // ★ 预制 rootfs tar 包（内含 Node.js + OpenClaw，用户开箱即用）
+  // TODO: 替换为你自己的 CDN 地址，制作方法见 README
+  rootfs: 'https://openclaw.ai/wsl/openclaw-rootfs.tar',
+  // 降级备选：微软官方 Ubuntu Appx 包
+  ubuntu: 'https://aka.ms/wslubuntu2204',
+};
+
+// ★ 是否启用降级方案（方法 B: wsl --install / 方法 C: Appx 离线包）
+// 如果你的 CDN 稳定可靠，设为 false 只用方法 A（tar 导入）
+const ENABLE_FALLBACK = false;
+
+const isWindows = os.platform() === 'win32';
+
+// 颜色（Windows 下禁用避免乱码）
+const C = isWindows
+  ? { r: '', g: '', y: '', b: '', nc: '' }
+  : { r: '\x1b[31m', g: '\x1b[32m', y: '\x1b[33m', b: '\x1b[34m', nc: '\x1b[0m' };
+
+// ============================================================================
+// 工具函数
+// ============================================================================
+
+/**
+ * 以管理员权限启动 PowerShell 脚本
+ * 利用 UTF-16LE Base64 编码避免引号转义地狱
+ */
+function launchElevatedPS(script) {
+  const b64 = Buffer.from(script, 'utf16le').toString('base64');
+  try {
+    execSync(
+      `powershell -Command "Start-Process powershell -ArgumentList '-NoProfile -ExecutionPolicy Bypass -EncodedCommand ${b64}' -Verb RunAs"`,
+      { stdio: 'inherit' }
+    );
+    return true;
+  } catch (err) {
+    console.error('[' + C.r + '错误' + C.nc + '] 无法获取管理员权限: ' + err.message);
+    console.log('建议右键终端选择【以管理员身份运行】后重试。');
+    return false;
+  }
+}
+
+// ============================================================================
+// 状态检测
+// ============================================================================
+
+/**
+ * 自动检测当前 WSL2 安装状态
+ * @returns {'ready'|'needs-setup'|'needs-features'}
+ */
+function detectState() {
+  // 1. WSL 已完全可用（有发行版能跑命令）
+  try {
+    execSync('wsl echo ok', { stdio: 'pipe', timeout: 15000 });
+    return 'ready';
+  } catch {}
+
+  // 2. WSL 命令可用但没有发行版（功能已启用，重启后的状态）
+  try {
+    execSync('wsl --status', { stdio: 'pipe', timeout: 5000 });
+    return 'needs-setup';
+  } catch {}
+
+  // 3. WSL 功能未启用
+  return 'needs-features';
+}
+
+// ============================================================================
+// Phase 1: 启用底层功能 + 预下载
+// ============================================================================
+
+function runPhase1() {
+  console.log('');
+  console.log('[当前进度] WSL 功能 ' + C.r + '[未启用]' + C.nc);
+  console.log('           内核更新 ' + C.r + '[未安装]' + C.nc);
+  console.log('           Ubuntu   ' + C.r + '[未安装]' + C.nc);
+  console.log('');
+  console.log('本次执行 阶段 1/2: 启用底层功能 + 预下载安装包');
+  console.log('  完成后需要 ' + C.y + '重启电脑' + C.nc);
+  console.log('  重启后再运行 ' + C.y + 'myclaw wsl2' + C.nc + ' 自动进入阶段 2');
+  console.log('');
+  console.log('[' + C.y + '注意' + C.nc + '] 请在 UAC 弹窗中点击【是】');
+  console.log('');
+
+  const ps = `
+$ErrorActionPreference = 'Continue'
+$Host.UI.RawUI.WindowTitle = 'MyClaw WSL2 Installer - Phase 1'
+Write-Host ''
+Write-Host '========================================'
+Write-Host '  MyClaw WSL2 安装 - 阶段 1/2'
+Write-Host '  启用底层功能 + 预下载安装包'
+Write-Host '========================================'
+Write-Host ''
+
+Write-Host '[1/4] 启用 Windows Subsystem for Linux...'
+try {
+    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart | Out-Null
+    Write-Host '      [OK]'
+} catch {
+    Write-Host '      跳过 (可能已启用)'
+}
+Write-Host ''
+
+Write-Host '[2/4] 启用虚拟机平台 (VirtualMachinePlatform)...'
+try {
+    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart | Out-Null
+    Write-Host '      [OK]'
+} catch {
+    Write-Host '      跳过 (可能已启用)'
+}
+Write-Host ''
+
+Write-Host '[3/4] 预下载 WSL2 内核更新包...'
+$dir = "$env:LOCALAPPDATA\\myclaw"
+$msi = "$dir\\wsl_update_x64.msi"
+New-Item -ItemType Directory -Force -Path $dir | Out-Null
+try {
+    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+    Invoke-WebRequest -Uri '${WSL_CDN.kernel}' -OutFile $msi -UseBasicParsing
+    Write-Host '      [OK] 已缓存'
+} catch {
+    Write-Host '      [跳过] 下载失败, 重启后将重试'
+}
+Write-Host ''
+
+Write-Host '[4/4] 尝试提前安装内核更新...'
+if (Test-Path $msi) {
+    try {
+        Start-Process msiexec.exe -ArgumentList "/i \`"$msi\`" /quiet /norestart" -Wait -NoNewWindow
+        Write-Host '      [OK]'
+    } catch {
+        Write-Host '      [跳过] 重启后将自动完成'
+    }
+} else {
+    Write-Host '      [跳过] 文件未就绪'
+}
+
+Write-Host ''
+Write-Host '========================================'
+Write-Host '  阶段 1/2 完成!'
+Write-Host ''
+Write-Host '  >>> 请立即 [重启电脑] <<<'
+Write-Host ''
+Write-Host '  重启后运行: myclaw wsl2'
+Write-Host '  将自动进入阶段 2 完成安装'
+Write-Host '========================================'
+Write-Host ''
+Write-Host '按任意键关闭此窗口...'
+$null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
+`;
+
+  if (launchElevatedPS(ps)) {
+    console.log('[' + C.g + '已启动' + C.nc + '] 请查看新弹出的蓝色窗口');
+    console.log('');
+    console.log('执行完请 ' + C.y + '重启电脑' + C.nc + '，然后运行 ' + C.y + 'myclaw wsl2' + C.nc + ' 续装');
+    console.log('');
+  }
+}
+
+// ============================================================================
+// Phase 2: 安装内核 + Ubuntu
+// ============================================================================
+
+function runPhase2() {
+  console.log('');
+  console.log('[当前进度] WSL 功能已启用 ' + C.g + '[OK]' + C.nc);
+  console.log('           内核更新 + Ubuntu ' + C.y + '[待安装]' + C.nc);
+  console.log('');
+  console.log('即将自动下载并安装（需要管理员权限）...');
+  console.log('[' + C.y + '注意' + C.nc + '] 请在 UAC 弹窗中点击【是】');
+  console.log('');
+
+  const ps = `
+$ErrorActionPreference = 'Continue'
+$Host.UI.RawUI.WindowTitle = 'MyClaw WSL2 Installer - Phase 2'
+Write-Host ''
+Write-Host '========================================'
+Write-Host '  MyClaw WSL2 安装 - 阶段 2/2'
+Write-Host '  安装内核更新 + Ubuntu'
+Write-Host '========================================'
+Write-Host ''
+
+Write-Host '[1/5] 设置 WSL2 为默认版本...'
+try { wsl --set-default-version 2 2>$null } catch {}
+Write-Host '      [OK]'
+Write-Host ''
+
+Write-Host '[2/5] 安装 WSL2 内核更新包...'
+$dir = "$env:LOCALAPPDATA\\myclaw"
+$msi = "$dir\\wsl_update_x64.msi"
+New-Item -ItemType Directory -Force -Path $dir | Out-Null
+
+if (-Not (Test-Path $msi)) {
+    Write-Host '      正在从微软服务器下载...'
+    try {
+        [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+        Invoke-WebRequest -Uri '${WSL_CDN.kernel}' -OutFile $msi -UseBasicParsing
+        Write-Host '      下载完成!'
+    } catch {
+        Write-Host '      [失败] 下载失败，请检查网络'
+        Write-Host '      手动下载: https://aka.ms/wsl2kernel'
+        Write-Host ''; Write-Host '按任意键退出...'
+        $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
+        exit 1
+    }
+} else {
+    Write-Host '      使用上次预下载的缓存文件'
+}
+try {
+    Start-Process msiexec.exe -ArgumentList "/i \`"$msi\`" /quiet /norestart" -Wait -NoNewWindow
+    Write-Host '      [OK] 内核更新安装成功!'
+} catch {
+    Write-Host '      可能已安装,继续...'
+}
+Write-Host ''
+
+Write-Host '[3/5] 确认 WSL2 为默认版本...'
+try { wsl --set-default-version 2 2>$null } catch {}
+Write-Host '      [OK]'
+Write-Host ''
+
+Write-Host '[4/5] 安装 Linux 发行版...'
+$installed = $false
+$distroName = 'OpenClaw'
+$installDir = "$dir\\OpenClaw"
+
+# ---- 方法 A (最强): 预制 rootfs tar 包，wsl --import ----
+Write-Host '      方法 A: 导入 OpenClaw 预制 Linux 环境...'
+$tarPath = "$dir\\openclaw-rootfs.tar"
+if (-Not (Test-Path $tarPath)) {
+    Write-Host '      正在下载预制环境包...'
+    try {
+        [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+        Invoke-WebRequest -Uri '` + WSL_CDN.rootfs + `' -OutFile $tarPath -UseBasicParsing
+        Write-Host '      下载完成!'
+    } catch {
+        Write-Host '      下载失败, 尝试备选方案...'
+    }
+}
+if (Test-Path $tarPath) {
+    try {
+        New-Item -ItemType Directory -Force -Path $installDir | Out-Null
+        wsl --import $distroName $installDir $tarPath 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            $installed = $true
+            Write-Host '      [OK] 方法 A 成功! (预制环境已导入)'
+        }
+    } catch {}
+}
+
+# ---- 方法 B / C (降级备选，由 ENABLE_FALLBACK 控制) ----
+` + (ENABLE_FALLBACK ? `
+if (-Not $installed) {
+    Write-Host '      方法 B: wsl --install ...'
+    try {
+        $output = wsl --install -d Ubuntu --no-launch 2>&1
+        if ($LASTEXITCODE -eq 0) {
+            $installed = $true
+            Write-Host '      [OK] 方法 B 成功!'
+        }
+    } catch {}
+}
+
+if (-Not $installed) {
+    Write-Host '      方法 C: 离线 Appx 安装...'
+    $appx = "$dir\\Ubuntu.appx"
+    if (-Not (Test-Path $appx)) {
+        Write-Host '      正在下载 Ubuntu (约 500MB)...'
+        try {
+            [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+            Invoke-WebRequest -Uri '` + WSL_CDN.ubuntu + `' -OutFile $appx -UseBasicParsing
+        } catch {
+            Write-Host '      [失败] 下载失败'
+        }
+    }
+    if (Test-Path $appx) {
+        try {
+            Add-AppxPackage -Path $appx
+            $installed = $true
+            Write-Host '      [OK] 方法 C 成功!'
+        } catch {}
+    }
+}
+` : `
+if (-Not $installed) {
+    Write-Host '      [失败] 预制环境包安装失败'
+    Write-Host '      请检查网络后重试: myclaw wsl2'
+}
+`) + `
+Write-Host ''
+
+Write-Host '[5/5] 验证安装结果...'
+try {
+    $result = wsl -l -v 2>&1 | Out-String
+    Write-Host $result
+} catch {
+    Write-Host '      无法获取信息'
+}
+
+Write-Host ''
+Write-Host '========================================'
+if ($installed) {
+    Write-Host '  [OK] WSL2 + Linux 环境安装完成!'
+    Write-Host ''
+    Write-Host '  输入 wsl 即可进入 Linux 环境'
+    Write-Host '  如使用预制包, OpenClaw 已预装就绪'
+} else {
+    Write-Host '  [注意] Linux 发行版可能需要手动安装'
+    Write-Host '  请打开 Microsoft Store 搜索 Ubuntu'
+}
+Write-Host '========================================'
+Write-Host ''
+Write-Host '按任意键关闭此窗口...'
+$null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown')
+`;
+
+  if (launchElevatedPS(ps)) {
+    console.log('[' + C.g + '已启动' + C.nc + '] 请查看新弹出的蓝色窗口');
+    console.log('');
+    console.log('安装完成后，输入 ' + C.y + 'wsl' + C.nc + ' 即可进入 Linux');
+    console.log('可随时运行 ' + C.y + 'myclaw wsl2' + C.nc + ' 检查状态');
+    console.log('');
+  }
+}
+
+// ============================================================================
+// 主入口
+// ============================================================================
+
+function run() {
+  if (!isWindows) {
+    console.error('[提示] 本命令仅用于 Windows 系统。Mac/Linux 不需要 WSL2。');
+    process.exit(0);
+  }
+
+  const bar = '========================================';
+  const state = detectState();
+
+  console.log('');
+  console.log('[' + C.b + 'MyClaw' + C.nc + '] WSL2 一键安装向导');
+  console.log(bar);
+
+  if (state === 'ready') {
+    console.log('');
+    console.log('[' + C.g + 'OK' + C.nc + '] WSL2 已完全安装就绪！');
+    console.log('');
+    try {
+      const info = execSync('wsl -l -v', { stdio: 'pipe' }).toString('utf16le');
+      console.log(info.trim());
+    } catch {
+      console.log('（运行 wsl -l -v 查看详情）');
+    }
+    console.log('');
+    console.log('输入 ' + C.y + 'wsl' + C.nc + ' 即可进入 Linux 环境。');
+    console.log('');
+    return;
+  }
+
+  if (state === 'needs-setup') {
+    runPhase2();
+  } else {
+    runPhase1();
+  }
+}
+
+module.exports = { run };