@aiyiran/myclaw 1.0.28 → 1.0.30

package/index.js

@@ -236,6 +236,16 @@ function runNew() {
   }
 }
 
+// ============================================================================
+// 微信接入向导
+// ============================================================================
+
+function runWeixin() {
+  const { WizardRunner } = require('./wizards/wizard-runner');
+  const config = require('./wizards/weixin.config.json');
+  new WizardRunner(config).run();
+}
+
 // ============================================================================
 // WSL2 安装 (独立模块)
 // ============================================================================
@@ -519,6 +529,9 @@ function showHelp() {
   console.log('用法:');
   console.log('  myclaw <command>');
   console.log('');
+  console.log('向导 (交互式):');
+  console.log('  weixin     微信接入向导（步骤引导 + 教学说明）');
+  console.log('');
   console.log('命令:');
   console.log('  install    安装 OpenClaw 服务');
   console.log('  status     简化版状态查看（学生友好）');
@@ -532,11 +545,11 @@ function showHelp() {
   console.log('  help       显示帮助信息');
   console.log('');
   console.log('示例:');
+  console.log('  myclaw weixin          # 打开微信接入向导');
   console.log('  myclaw install         # 安装 OpenClaw');
   console.log('  myclaw status          # 查看状态');
   console.log('  myclaw new helper      # 创建名为 helper 的 Agent');
   console.log('  myclaw open            # 打开默认控制台');
-  console.log('  myclaw open http://... # 打开指定 URL');
   console.log('  myclaw patch           # 注入 UI 扩展');
   console.log('  myclaw restart         # 重启 Gateway');
   console.log('');
@@ -552,6 +565,8 @@ console.log(colors.blue + 'MyClaw v' + version + colors.nc);
 
 if (!command || command === 'help' || command === '--help' || command === '-h') {
   showHelp();
+} else if (command === 'weixin') {
+  runWeixin();
 } else if (command === 'install') {
   runInstall();
 } else if (command === 'status') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiyiran/myclaw",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "description": "",
   "main": "index.js",
   "bin": {
@@ -13,5 +13,9 @@
   },
   "keywords": [],
   "author": "",
-  "license": "ISC"
+  "license": "ISC",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1"
+  }
 }

package/wizards/weixin.config.json

@@ -0,0 +1,120 @@
+{
+  "id": "weixin",
+  "title": "微信接入向导",
+  "subtitle": "引导你一步步完成微信通道的接入配置",
+
+  "steps": [
+    {
+      "id": "check-plugins",
+      "icon": "🔍",
+      "label": "查看微信插件状态",
+      "type": "check",
+      "command": {
+        "exec": "openclaw plugins list",
+        "display": "openclaw plugins list"
+      },
+      "teach": {
+        "title": "查看微信插件状态",
+        "description": "列出系统中当前已安装的所有 OpenClaw 插件。\n\nOpenClaw 通过「插件」来支持不同平台（微信、飞书、钉钉等），\n每个插件负责一个平台的通信协议。",
+        "look_for": "在输出中查找 openclaw-weixin，有就说明插件已安装",
+        "tip": "🔒 只读操作，不修改任何配置，可以随时查看。"
+      }
+    },
+    {
+      "id": "check-channels",
+      "icon": "🔍",
+      "label": "查看渠道连接状态",
+      "type": "check",
+      "command": {
+        "exec": "openclaw channels list",
+        "display": "openclaw channels list"
+      },
+      "teach": {
+        "title": "查看所有渠道的连接状态",
+        "description": "列出系统中所有已配置的「渠道（Channel）」。\n\n渠道是平台账号与 OpenClaw 的实际连接通道：\n  - 插件 = 能力（知道怎么对接微信）\n  - 渠道 = 连接（你的微信账号已登录并在线）\n\n两者都需要就绪，微信功能才能正常运行。",
+        "look_for": "查找 openclaw-weixin，状态是否为 connected",
+        "tip": "🔒 只读操作，不修改任何配置，可以随时查看。"
+      }
+    },
+    {
+      "id": "install-plugin",
+      "icon": "📦",
+      "label": "安装微信插件",
+      "type": "action",
+      "command": {
+        "exec": "openclaw plugins install \"@tencent-weixin/openclaw-weixin\"",
+        "display": "openclaw plugins install \"@tencent-weixin/openclaw-weixin\""
+      },
+      "teach": {
+        "title": "安装微信插件",
+        "description": "从官方源下载并安装微信通道插件。\n\n这条命令做了三件事：\n  1. 找到 @tencent-weixin/openclaw-weixin 插件包\n  2. 从官方源下载插件代码\n  3. 安装到 OpenClaw 插件目录\n\n整个接入流程只需安装一次，重新登录时不需要重复执行。",
+        "look_for": "看到 installed successfully 或类似成功提示",
+        "tip": "⚠️  需要网络连接，首次下载可能需要一点时间，请耐心等待。"
+      }
+    },
+    {
+      "id": "enable-plugin",
+      "icon": "⚙️",
+      "label": "启用微信插件",
+      "type": "action",
+      "command": {
+        "exec": "openclaw config set plugins.entries.openclaw-weixin.enabled true",
+        "display": "openclaw config set plugins.entries.openclaw-weixin.enabled true"
+      },
+      "teach": {
+        "title": "启用微信插件",
+        "description": "将微信插件的「启用状态」写入 OpenClaw 配置文件。\n\n安装插件 ≠ 启用插件。这类似于：\n  - 安装 = 把软件下载到电脑\n  - 启用 = 打开这个软件的开关\n\n这条命令修改了配置文件中的一个开关：\n  plugins.entries.openclaw-weixin.enabled = true",
+        "look_for": "命令无报错即为成功，配置通常立即生效",
+        "tip": "💡 安装和启用是两个独立步骤，缺一不可。"
+      }
+    },
+    {
+      "id": "login-weixin",
+      "icon": "📱",
+      "label": "扫码登录微信",
+      "type": "interactive",
+      "command": {
+        "exec": "openclaw channels login --channel openclaw-weixin",
+        "display": "openclaw channels login --channel openclaw-weixin"
+      },
+      "teach": {
+        "title": "扫码登录微信账号",
+        "description": "将你的微信账号与 OpenClaw 渠道绑定。\n\n执行后终端会显示一个二维码，操作步骤：\n  1. 打开手机微信\n  2. 点击右上角「+」→「扫一扫」\n  3. 扫描终端里的二维码\n  4. 手机上点击「确认授权」\n\n重新连接时，只需重复这一步，不需要重装插件。",
+        "look_for": "终端显示「登录成功」或类似提示",
+        "tip": "📱 准备好手机，扫码后在手机上点击确认才算完成。"
+      }
+    },
+    {
+      "id": "restart-gateway",
+      "icon": "🔄",
+      "label": "重启 Gateway",
+      "type": "action",
+      "command": {
+        "exec": "openclaw gateway restart",
+        "display": "openclaw gateway restart"
+      },
+      "teach": {
+        "title": "重启 Gateway 使配置生效",
+        "description": "重启 OpenClaw 核心服务，让之前的所有配置变更生效。\n\nGateway 是 OpenClaw 的「大脑」，它在启动时读取配置。\n我们刚才修改了配置（安装并启用了插件），\n所以需要重启让 Gateway 加载新配置。\n\n类比：改了系统设置后，有时候需要重启电脑才生效。",
+        "look_for": "重启后 Gateway 运行中，控制台地址 http://127.0.0.1:18789",
+        "tip": "⏳ 重启期间短暂不可用，请等待几秒钟再继续。"
+      }
+    },
+    {
+      "id": "verify",
+      "icon": "✅",
+      "label": "验证微信接入是否成功",
+      "type": "check",
+      "command": {
+        "exec": "openclaw channels list",
+        "display": "openclaw channels list"
+      },
+      "teach": {
+        "title": "验证微信是否成功接入",
+        "description": "再次查看渠道列表，确认微信已正常连接。\n\n这和第 2 步用的是同一条命令，但现在应该能看到：\n  - openclaw-weixin 出现在列表中\n  - 状态显示为 connected（已连接）\n\n如果状态还是 disconnected，可能需要重新扫码（步骤 5）。",
+        "look_for": "openclaw-weixin 的状态为 connected ✅",
+        "tip": "🎉 如果看到 connected，恭喜完成微信接入！"
+      }
+    }
+  ]
+}

package/wizards/wizard-runner.js

@@ -0,0 +1,353 @@
+'use strict';
+
+/**
+ * wizard-runner.js
+ * ─────────────────────────────────────────────────────────────
+ * 通用 TUI 向导引擎
+ *
+ * 读取一个 wizard config 对象，渲染交互式分屏界面：
+ *   - 上半部分：步骤列表（↑↓ 移动光标）
+ *   - 下半部分：当前步骤的教学说明 + 要执行的命令
+ *   - Enter：进入执行流程（先展示说明，确认后再跑命令）
+ *
+ * 步骤类型（type）：
+ *   check       只读查询，直接 execSync + 显示输出
+ *   action      有副作用的操作，execSync + 显示输出
+ *   interactive 需要终端交互（如扫码），spawnSync + inherit stdio
+ *
+ * 使用方式：
+ *   const { WizardRunner } = require('./wizard-runner');
+ *   const config = require('./weixin.config.json');
+ *   new WizardRunner(config).run();
+ */
+
+const chalk   = require('chalk');
+const { execSync, spawnSync } = require('child_process');
+
+// ─────────────────────────────────────────────────────────────
+// 常量 & 工具
+// ─────────────────────────────────────────────────────────────
+
+const W = 62; // 界面宽度（字符数）
+
+function hr(char = '─', w = W) {
+  return char.repeat(w);
+}
+
+function cls() {
+  process.stdout.write('\x1b[2J\x1b[H');
+}
+
+// 把多行字符串每行加前缀
+function indent(text, prefix = '  ') {
+  return text.split('\n').map(l => prefix + l).join('\n');
+}
+
+// ─────────────────────────────────────────────────────────────
+// 状态标签
+// ─────────────────────────────────────────────────────────────
+
+const BADGE = {
+  check:   () => chalk.bgCyan.black(' 查 看 '),
+  pending: () => chalk.bgGray.white(' 未执行 '),
+  done:    () => chalk.bgGreen.black(' ✓ 完成 '),
+  error:   () => chalk.bgRed.white(' ✗ 失败 '),
+};
+
+// ─────────────────────────────────────────────────────────────
+// WizardRunner
+// ─────────────────────────────────────────────────────────────
+
+class WizardRunner {
+  constructor(config) {
+    this.config   = config;
+    this.steps    = config.steps;
+    this.cursor   = 0;
+    this._busy    = false; // 执行期间屏蔽主键盘
+    
+    // 初始化每步状态
+    this.statuses = {};
+    this.steps.forEach(s => {
+      this.statuses[s.id] = s.type === 'check' ? 'check' : 'pending';
+    });
+  }
+
+  // ───────────────────────────────────────────────────────────
+  // 渲染：主界面（上：步骤列表 / 下：当前步骤说明）
+  // ───────────────────────────────────────────────────────────
+
+  render() {
+    cls();
+    const { config, steps, cursor, statuses } = this;
+
+    // ── Header ──
+    console.log('');
+    console.log('  ' + chalk.bold.cyan('⚡ ' + config.title));
+    console.log('  ' + chalk.gray(config.subtitle));
+    console.log('');
+
+    // ── 步骤列表 ──
+    console.log(
+      '  ' + chalk.bold('步骤列表') +
+      chalk.dim('  ( ↑↓ 移动    Enter 执行    q 退出 )')
+    );
+    console.log('  ' + chalk.gray(hr('─', W - 4)));
+
+    steps.forEach((step, i) => {
+      const selected = i === cursor;
+      const arrow    = selected ? chalk.cyan.bold('▶') : ' ';
+      const numStr   = chalk.dim(String(i + 1).padStart(2) + '.');
+      const label    = selected
+        ? chalk.bold.white(step.label)
+        : chalk.white(step.label);
+      const badge    = (BADGE[statuses[step.id]] || BADGE.pending)();
+
+      console.log(`  ${arrow} ${numStr} ${step.icon}  ${label}  ${badge}`);
+    });
+
+    console.log('  ' + chalk.gray(hr('─', W - 4)));
+    console.log('');
+
+    // ── 当前步骤说明 ──
+    const step  = steps[cursor];
+    const teach = step.teach;
+
+    console.log('  ' + chalk.bold.yellow('📖 步骤说明'));
+    console.log('');
+    console.log('  ' + chalk.bold.white('【' + teach.title + '】'));
+    console.log('');
+    console.log(indent(teach.description, '  '));
+    console.log('');
+    console.log('  ' + chalk.dim('执行命令：'));
+    this._renderCommand(step.command.display);
+    console.log('');
+
+    if (teach.look_for) {
+      console.log('  ' + chalk.dim('👀 执行后观察：') + chalk.yellow(teach.look_for));
+      console.log('');
+    }
+
+    console.log('  ' + chalk.dim('💡 ') + chalk.gray(teach.tip));
+    console.log('');
+  }
+
+  // ───────────────────────────────────────────────────────────
+  // 渲染：执行前说明页（按 Enter 之后先展示，再确认执行）
+  // ───────────────────────────────────────────────────────────
+
+  renderPreExec(step) {
+    cls();
+    const teach = step.teach;
+
+    console.log('');
+    console.log('  ' + chalk.bold.cyan('▶  ' + step.icon + '  ' + step.label));
+    console.log('  ' + chalk.gray(hr('─', W - 4)));
+    console.log('');
+
+    // 教学说明
+    console.log('  ' + chalk.bold.yellow('📋 执行前说明'));
+    console.log('');
+    console.log(indent(teach.description, '  '));
+    console.log('');
+
+    // 将要执行的命令（教学核心：让学生看清命令）
+    console.log('  ' + chalk.bold('将要执行的命令：'));
+    console.log('');
+    this._renderCommand(step.command.display);
+    console.log('');
+
+    if (step.type === 'interactive') {
+      console.log('  ' + chalk.yellow('⚠️  此步骤是交互式操作，将接管终端（如显示二维码）'));
+      console.log('');
+    }
+
+    if (teach.tip) {
+      console.log('  ' + chalk.dim('💡 ') + chalk.gray(teach.tip));
+      console.log('');
+    }
+
+    console.log('  ' + chalk.gray(hr('─', W - 4)));
+    console.log(
+      '  ' + chalk.dim('按 ') + chalk.bold('Enter') + chalk.dim(' 开始执行') +
+      chalk.dim('  |  按 ') + chalk.bold('q') + chalk.dim(' 取消')
+    );
+  }
+
+  // ───────────────────────────────────────────────────────────
+  // 渲染：执行中 header
+  // ───────────────────────────────────────────────────────────
+
+  renderExecHeader(step) {
+    cls();
+    console.log('');
+    console.log('  ' + chalk.bold.cyan('⚡ 正在执行：' + step.icon + '  ' + step.label));
+    console.log('  ' + chalk.gray(hr('─', W - 4)));
+    console.log('  ' + chalk.dim('$ ' + step.command.display));
+    console.log('  ' + chalk.gray(hr('─', W - 4)));
+    console.log('');
+    console.log('  ' + chalk.dim('↓ 命令输出 ↓'));
+    console.log('');
+  }
+
+  // ───────────────────────────────────────────────────────────
+  // 执行步骤（完整流程）
+  // ───────────────────────────────────────────────────────────
+
+  async executeStep(idx) {
+    const step = this.steps[idx];
+
+    // 1. 展示执行前说明页
+    this.renderPreExec(step);
+
+    // 2. 等待用户确认（Enter 继续，q 取消）
+    const confirmed = await this._waitForConfirm();
+    if (!confirmed) {
+      this.render();
+      return;
+    }
+
+    // 3. 展示执行中头部
+    this.renderExecHeader(step);
+
+    // 4. 关闭 raw mode，让命令输出正常渲染
+    process.stdin.setRawMode(false);
+
+    // 5. 执行命令
+    let success = false;
+    try {
+      if (step.type === 'interactive') {
+        // interactive：透传 stdin/stdout（扫码、确认等）
+        const result = spawnSync(step.command.exec, {
+          shell:  true,
+          stdio:  'inherit',
+        });
+        success = result.status === 0;
+      } else {
+        // check / action：普通执行
+        execSync(step.command.exec, {
+          shell:  true,
+          stdio:  'inherit',
+        });
+        success = true;
+      }
+    } catch (e) {
+      success = false;
+    }
+
+    // 6. 更新状态
+    this.statuses[step.id] = success ? 'done' : 'error';
+
+    // 7. 显示结果
+    console.log('');
+    console.log('  ' + chalk.gray(hr('─', W - 4)));
+
+    if (success) {
+      console.log('  ' + chalk.bold.green('✓ 执行完成！'));
+      if (step.teach.look_for) {
+        console.log('  ' + chalk.yellow('👆 观察上方输出：' + step.teach.look_for));
+      }
+    } else {
+      console.log('  ' + chalk.bold.red('✗ 执行遇到问题，请查看上方错误信息'));
+    }
+
+    console.log('');
+    console.log('  ' + chalk.dim('按任意键返回步骤列表...'));
+
+    // 8. 重启 raw mode，等待任意键
+    process.stdin.setRawMode(true);
+    await this._waitForAnyKey();
+
+    this.render();
+  }
+
+  // ───────────────────────────────────────────────────────────
+  // 键盘处理
+  // ───────────────────────────────────────────────────────────
+
+  _onData(buf) {
+    // 执行期间主键盘屏蔽（由 _busy 控制）
+    if (this._busy) return;
+
+    const key = buf.toString();
+
+    if (key === '\x1b[A') {                          // ↑
+      this.cursor = Math.max(0, this.cursor - 1);
+      this.render();
+    } else if (key === '\x1b[B') {                   // ↓
+      this.cursor = Math.min(this.steps.length - 1, this.cursor + 1);
+      this.render();
+    } else if (key === '\r' || key === '\n') {        // Enter
+      this._busy = true;
+      this.executeStep(this.cursor).finally(() => {
+        this._busy = false;
+      });
+    } else if (key === 'q' || key === 'Q' || key === '\x03') { // q / Ctrl+C
+      this.exit();
+    }
+  }
+
+  // 等待 Enter（确认）或 q（取消）
+  // 返回 true = 确认，false = 取消
+  _waitForConfirm() {
+    return new Promise(resolve => {
+      process.stdin.once('data', buf => {
+        const key = buf.toString();
+        if (key === 'q' || key === 'Q' || key === '\x03') {
+          resolve(false);
+        } else {
+          resolve(true); // 任意其他键（包括 Enter）= 确认
+        }
+      });
+    });
+  }
+
+  // 等待任意键
+  _waitForAnyKey() {
+    return new Promise(resolve => {
+      process.stdin.once('data', resolve);
+    });
+  }
+
+  // ───────────────────────────────────────────────────────────
+  // 辅助：渲染命令行样式
+  // ───────────────────────────────────────────────────────────
+
+  _renderCommand(display) {
+    // 命令太长时拆行显示（>50 字符）
+    const MAX = 54;
+    if (display.length <= MAX) {
+      console.log('  ' + chalk.bgBlack.cyan(' $ ') + chalk.bgBlack.white(' ' + display + ' '));
+    } else {
+      // 简单的命令折行
+      const parts = display.match(/.{1,MAX}/g) || [display];
+      parts.forEach((part, i) => {
+        const prefix = i === 0
+          ? chalk.bgBlack.cyan(' $ ')
+          : chalk.bgBlack.cyan('   ');
+        console.log('  ' + prefix + chalk.bgBlack.white(' ' + part + ' '));
+      });
+    }
+  }
+
+  // ───────────────────────────────────────────────────────────
+  // 入口 & 退出
+  // ───────────────────────────────────────────────────────────
+
+  run() {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on('data', buf => this._onData(buf));
+    this.render();
+  }
+
+  exit() {
+    process.stdin.setRawMode(false);
+    process.stdin.pause();
+    console.log('');
+    console.log('  ' + chalk.cyan('再见！👋'));
+    console.log('');
+    process.exit(0);
+  }
+}
+
+module.exports = { WizardRunner };