@aiyiran/myclaw 1.0.5 → 1.0.6

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,124 @@ 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);
+    // create_agent.js 已经有错误信息输出
+    console.log('');
+    console.log('[' + colors.red + '失败' + colors.nc + '] Agent 创建失败');
     console.log('');
-    console.log('常见问题:');
-    console.log('  - Agent 名称已存在');
-    console.log('  - 权限不足');
-    console.log('  - OpenClaw 未运行');
     process.exit(1);
   }
 }
 
+// ============================================================================
+// 安装/修复 WSL2
+// ============================================================================
+
+function runWsl2() {
+  if (!isWindows) {
+    console.error('[' + colors.red + '提示' + colors.nc + '] 本命令主要用于 Windows 系统。在 Mac/Linux 下不需要安装 WSL2。');
+    process.exit(0);
+  }
+
+  const bar = '----------------------------------------';
+  console.log('');
+  console.log('[' + colors.blue + 'MyClaw' + colors.nc + '] ' + colors.blue + '修复/安装 Windows WSL2 环境' + colors.nc);
+  console.log(bar);
+  console.log('');
+  console.log('即将申请管理员权限以启用 Windows WSL2 和 虚拟机平台功能...');
+  console.log('这使用的是兼容性最好的"手动打补丁"底层方法，用来解决直接安装失败的问题。');
+  console.log('[' + colors.yellow + '注意' + colors.nc + '] 请在稍后弹出的 UAC 授权窗口中选【是】。');
+  console.log('');
+  
+  const psCommand = `
+Write-Host "============================";
+Write-Host " MyClaw - WSL2 环境底座修复";
+Write-Host "============================";
+Write-Host "";
+Write-Host "步骤 1/3: 正在启用 Windows Subsystem for Linux...";
+dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart;
+Write-Host "";
+Write-Host "步骤 2/3: 正在启用 虚拟机平台...";
+dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart;
+Write-Host "";
+Write-Host "步骤 3/3: 尝试设置 WSL2 为默认版本...";
+try { wsl --set-default-version 2 2>$null } catch {}
+Write-Host "";
+Write-Host "============================";
+Write-Host " 操作执行完毕！";
+Write-Host " 注意：必须 [重新启动电脑] 才能生效！";
+Write-Host "============================";
+Write-Host " -> 若重启后运行 wsl 提示需要内核更新，";
+Write-Host " -> 请浏览器访问下载并安装: https://aka.ms/wsl2kernel";
+Write-Host " -> 最后去 Microsoft Store 搜索 Ubuntu 并安装即可。";
+Write-Host "";
+Write-Host "按任意键退出当前窗口...";
+$null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown");
+`;
+
+  // 为了跨 PowerShell 调用避免引号转移错乱，转为 Base64 执行 (UTF-16LE 编码)
+  const b64Cmd = Buffer.from(psCommand, 'utf16le').toString('base64');
+
+  try {
+    execSync(`powershell -Command "Start-Process powershell -ArgumentList '-NoProfile -ExecutionPolicy Bypass -EncodedCommand ${b64Cmd}' -Verb RunAs"`, { stdio: 'inherit' });
+    console.log('[' + colors.green + '成功' + colors.nc + '] 修复命令已下发，请查看新弹出的蓝色 PowerShell 窗口。');
+    console.log('');
+    console.log('执行完后记得 ' + colors.yellow + '重启电脑' + colors.nc + ' 哦！');
+    console.log('');
+  } catch (err) {
+    console.error('[' + colors.red + '错误' + colors.nc + '] 执行提权脚本失败:', err.message);
+    console.log('建议右键点击终端，选择【以管理员身份运行】再重试。');
+  }
+}
+
 // ============================================================================
 // 帮助信息
 // ============================================================================
@@ -285,6 +312,7 @@ function showHelp() {
   console.log('  install    安装 OpenClaw 服务');
   console.log('  status     简化版状态查看（学生友好）');
   console.log('  new        创建新的 Agent（学生练习用）');
+  console.log('  wsl2       修复 Windows 下 WSL2 安装失败的问题 (仅限 Windows)');
   console.log('  help       显示帮助信息');
   console.log('');
   console.log('示例:');
@@ -308,6 +336,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.6",
   "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 "🎉 发布流执行完成！"