@aiyiran/myclaw 1.0.30 → 1.0.31

package/index.js

@@ -237,13 +237,12 @@ function runNew() {
 }
 
 // ============================================================================
-// 微信接入向导
+// 向导系统（统一入口）
 // ============================================================================
 
 function runWeixin() {
-  const { WizardRunner } = require('./wizards/wizard-runner');
-  const config = require('./wizards/weixin.config.json');
-  new WizardRunner(config).run();
+  const { runWeixin } = require('./wizards/index');
+  runWeixin();
 }
 
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiyiran/myclaw",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "",
   "main": "index.js",
   "bin": {
@@ -15,7 +15,9 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "chalk": "^4.1.2",
-    "ora": "^5.4.1"
+    "chalk": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=16"
   }
 }

package/wizards/commons/gateway.steps.json

@@ -0,0 +1,52 @@
+{
+  "restart": {
+    "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": "⏳ 重启期间短暂不可用，请等待几秒钟再继续。"
+    }
+  },
+
+  "check-health": {
+    "id": "check-gateway-health",
+    "icon": "🔍",
+    "label": "检查 Gateway 运行状态",
+    "type": "check",
+    "command": {
+      "exec": "openclaw health",
+      "display": "openclaw health"
+    },
+    "teach": {
+      "title": "检查 Gateway 是否正在运行",
+      "description": "检查 OpenClaw Gateway 的健康状态。\n\n返回 OK 说明 Gateway 正常运行，\n返回错误说明 Gateway 未启动或出现问题。",
+      "look_for": "输出 OK 或类似健康状态提示",
+      "tip": "🔒 只读检查，可以随时运行。"
+    }
+  },
+
+  "check-status": {
+    "id": "check-openclaw-status",
+    "icon": "📊",
+    "label": "查看 OpenClaw 完整状态",
+    "type": "check",
+    "command": {
+      "exec": "openclaw status",
+      "display": "openclaw status"
+    },
+    "teach": {
+      "title": "查看 OpenClaw 完整运行状态",
+      "description": "显示 OpenClaw 所有组件的运行状态，\n包括 Gateway、已加载插件、已连接渠道等。",
+      "look_for": "查看各组件状态是否正常",
+      "tip": "🔒 只读命令，可以随时查看。"
+    }
+  }
+}

package/wizards/configs/weixin/bind.config.json

@@ -0,0 +1,153 @@
+{
+  "id": "weixin-bind",
+  "title": "微信多账号绑定",
+  "subtitle": "为每个微信账号绑定专属的 Agent",
+
+  "steps": [
+    {
+      "id": "check-before-bind",
+      "icon": "🔍",
+      "label": "查看当前账号列表",
+      "type": "check",
+      "command": {
+        "exec": "openclaw channels status",
+        "display": "openclaw channels status"
+      },
+      "teach": {
+        "title": "查看当前已登录的账号列表",
+        "description": "在开始绑定之前，先看看当前哪些微信账号已经登录。\n\n这条命令会列出所有已登录的渠道账号，以及它们当前\n绑定到哪个 Agent（如果已绑定的话）。\n\n从这里你可以确认账号ID（--account 参数的值），\n后续绑定步骤会用到。",
+        "look_for": "每行显示一个账号，记下账号ID（通常是一串标识符）",
+        "tip": "🔒 只读操作，可以随时运行查看最新状态。"
+      }
+    },
+    {
+      "id": "login-account-1",
+      "icon": "📱",
+      "label": "扫码登录第一个微信账号",
+      "type": "interactive",
+      "command": {
+        "exec": "openclaw channels login --channel openclaw-weixin",
+        "display": "openclaw channels login --channel openclaw-weixin"
+      },
+      "teach": {
+        "title": "扫码登录第一个微信账号",
+        "description": "每个微信账号需要单独扫码登录，系统会为它创建一个独立的账号条目。\n\n这一步登录「第一个微信账号」（比如用于课堂答疑的账号）。\n\n操作步骤：\n  1. 打开手机微信（第一个账号）\n  2. 扫描终端里的二维码\n  3. 手机上点击「确认授权」",
+        "look_for": "登录成功后，系统会显示新的账号条目（记下账号ID）",
+        "tip": "📱 确保手机是你想绑定的第一个账号，不要用错手机。"
+      }
+    },
+    {
+      "id": "login-account-2",
+      "icon": "📱",
+      "label": "扫码登录第二个微信账号",
+      "type": "interactive",
+      "command": {
+        "exec": "openclaw channels login --channel openclaw-weixin",
+        "display": "openclaw channels login --channel openclaw-weixin"
+      },
+      "teach": {
+        "title": "扫码登录第二个微信账号",
+        "description": "现在登录「第二个微信账号」（比如用于生活助手的账号）。\n\n这条命令和第一步相同，但登录的是不同的微信账号，\n系统会自动识别并创建新的独立账号条目。\n\n操作步骤：\n  1. 打开手机微信（第二个账号）\n  2. 扫描终端里的二维码\n  3. 手机上点击「确认授权」",
+        "look_for": "看到第二个账号条目出现在列表中",
+        "tip": "📱 换另一部手机（或另一个微信账号）来扫码。"
+      }
+    },
+    {
+      "id": "check-accounts",
+      "icon": "🔍",
+      "label": "查看账号列表（确认登录成功）",
+      "type": "check",
+      "capture": "accounts_output",
+      "command": {
+        "exec": "openclaw channels status",
+        "display": "openclaw channels status"
+      },
+      "teach": {
+        "title": "确认两个账号都已登录",
+        "description": "再次查看账号列表，确认两个微信账号都已成功登录。\n\n在这一步，你需要从输出中：\n  1. 找到第一个账号的「账号ID」\n  2. 找到第二个账号的「账号ID」\n\n后面的绑定步骤（第 5、6 步）的 --account 参数就填这些ID。\n\n✅ 这一步的输出会被记录，绑定时可直接参考。",
+        "look_for": "两个账号都出现在列表中，状态为 connected",
+        "tip": "📋 详细看输出，记录账号ID，避免后续填写出错。"
+      }
+    },
+    {
+      "id": "bind-account-1",
+      "icon": "🔗",
+      "label": "绑定账号1 → Agent",
+      "type": "input",
+      "requires": ["check-accounts"],
+      "show_capture": "accounts_output",
+      "command": {
+        "template": "openclaw channels bind --channel openclaw-weixin --account {{account}} --agent {{agent}}",
+        "display":  "openclaw channels bind --channel openclaw-weixin --account {{account}} --agent {{agent}}"
+      },
+      "inputs": [
+        {
+          "key": "account",
+          "label": "账号1 的账号ID",
+          "hint": "从上一步（步骤4）的输出中找到第一个账号的标识符",
+          "placeholder": "例如：wx_123456789"
+        },
+        {
+          "key": "agent",
+          "label": "要绑定到的 Agent 名称",
+          "hint": "填写你已创建的 Agent 名称（使用 myclaw status 可查看）",
+          "placeholder": "例如：blog、helper、assistant"
+        }
+      ],
+      "teach": {
+        "title": "将账号1绑定到指定 Agent",
+        "description": "这条命令将第一个微信账号与指定的 Agent 绑定。\n\n绑定后，从这个微信账号发来的消息，\n都会由对应的 Agent 来处理和回复。\n\n命令中的两个参数：\n  --account  指定要绑定的微信账号ID\n  --agent    指定负责处理消息的 Agent 名称",
+        "look_for": "看到绑定成功的提示",
+        "tip": "💡 绑定是永久的，除非你重新执行绑定命令修改。"
+      }
+    },
+    {
+      "id": "bind-account-2",
+      "icon": "🔗",
+      "label": "绑定账号2 → Agent",
+      "type": "input",
+      "requires": ["check-accounts"],
+      "show_capture": "accounts_output",
+      "command": {
+        "template": "openclaw channels bind --channel openclaw-weixin --account {{account}} --agent {{agent}}",
+        "display":  "openclaw channels bind --channel openclaw-weixin --account {{account}} --agent {{agent}}"
+      },
+      "inputs": [
+        {
+          "key": "account",
+          "label": "账号2 的账号ID",
+          "hint": "从步骤4的输出中找到第二个账号的标识符",
+          "placeholder": "例如：wx_987654321"
+        },
+        {
+          "key": "agent",
+          "label": "要绑定到的 Agent 名称",
+          "hint": "填写另一个 Agent 的名称（与账号1绑定的不同）",
+          "placeholder": "例如：classroom、assistant"
+        }
+      ],
+      "teach": {
+        "title": "将账号2绑定到另一个 Agent",
+        "description": "这条命令将第二个微信账号绑定到另一个 Agent。\n\n多账号绑定的典型用法：\n  - 账号1 → Agent「blog」   ← 处理博客读者的问题\n  - 账号2 → Agent「classroom」← 处理学生课堂问题\n\n每个微信账号有自己专属的对话上下文和 Agent 配置。",
+        "look_for": "看到绑定成功的提示",
+        "tip": "💡 两个账号绑定的 Agent 不同，这正是多账号的意义所在。"
+      }
+    },
+    {
+      "id": "verify-bindings",
+      "icon": "✅",
+      "label": "验证绑定结果",
+      "type": "check",
+      "command": {
+        "exec": "openclaw channels status",
+        "display": "openclaw channels status"
+      },
+      "teach": {
+        "title": "验证所有账号的绑定情况",
+        "description": "最后查看账号状态，确认绑定配置正确。\n\n如果配置成功，你应该能看到：\n  - 账号1 → Agent 名称A\n  - 账号2 → Agent 名称B\n\n如果某个账号绑定不对，重新执行对应的绑定步骤（第5或第6步）。",
+        "look_for": "每个账号后面显示了正确的 Agent 名称",
+        "tip": "🎉 绑定完成后，从不同微信账号发消息，对应 Agent 会自动回复！"
+      }
+    }
+  ]
+}

package/wizards/{weixin.config.json → configs/weixin/index.config.json}

@@ -84,22 +84,7 @@
         "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": "⏳ 重启期间短暂不可用，请等待几秒钟再继续。"
-      }
-    },
+    { "$ref": "../../commons/gateway.steps.json#restart" },
     {
       "id": "verify",
       "icon": "✅",
@@ -115,6 +100,18 @@
         "look_for": "openclaw-weixin 的状态为 connected ✅",
         "tip": "🎉 如果看到 connected，恭喜完成微信接入！"
       }
+    },
+    {
+      "id": "multi-account",
+      "icon": "👥",
+      "label": "多账号绑定（进阶）",
+      "type": "submenu",
+      "submenu": "./bind.config.json",
+      "teach": {
+        "title": "微信多账号绑定",
+        "description": "如果你需要让多个微信账号分别对接不同的 Agent，\n可以进入这个子向导完成配置。\n\n适用场景：\n  - 一个 Agent 负责课堂答疑（账号A）\n  - 另一个 Agent 负责生活助手（账号B）\n\n普通接入不需要这一步，完成步骤 1-7 即可。",
+        "tip": "💡 按 Enter 进入子向导，按 q 随时返回此页面。"
+      }
     }
   ]
 }

package/wizards/index.js

@@ -0,0 +1,32 @@
+'use strict';
+
+/**
+ * wizards/index.js
+ * ────────────────────────────────────────────────────────
+ * 所有向导的统一入口
+ *
+ * 新增向导只需：
+ *   1. 在 configs/ 下建目录，写 index.config.json
+ *   2. 在这里 `startWizard(path.join(...))` 注册一个入口函数
+ */
+
+const path             = require('path');
+const { WizardRunner } = require('./runner/wizard-runner');
+const { loadConfig }   = require('./runner/config-loader');
+
+function startWizard(configPath) {
+  const config = loadConfig(configPath);
+  new WizardRunner(config).run();
+}
+
+// ── 各向导入口 ────────────────────────────────────────────────
+
+function runWeixin() {
+  startWizard(path.join(__dirname, 'configs/weixin/index.config.json'));
+}
+
+// 未来扩展示例：
+// function runGateway() { startWizard(path.join(__dirname, 'configs/gateway/index.config.json')); }
+// function runAgent()   { startWizard(path.join(__dirname, 'configs/agent/index.config.json'));   }
+
+module.exports = { runWeixin };

package/wizards/runner/config-loader.js

@@ -0,0 +1,89 @@
+'use strict';
+
+/**
+ * config-loader.js
+ * ──────────────────────────────────────────────────────────
+ * Wizard config 加载器
+ *
+ * 功能：
+ *   1. 加载 JSON config 文件并注入 _dir（用于解析相对路径）
+ *   2. 展开 steps 中的 $ref 引用（指向公共步骤片段）
+ *
+ * $ref 格式：
+ *   { "$ref": "../../commons/gateway.steps.json#restart" }
+ *       ↑ 文件路径（相对于当前 config 所在目录）   ↑ 步骤 key
+ *
+ *   如果不加 #key，则将整个文件的值视为步骤（需是数组或对象）。
+ *
+ * 公共步骤文件格式（commons/xxx.steps.json）：
+ *   {
+ *     "restart": { ...step对象... },
+ *     "check-health": { ...step对象... }
+ *   }
+ */
+
+const path = require('path');
+
+/**
+ * 加载并解析 wizard config
+ * @param {string} configPath - 绝对路径
+ * @returns {Object} 解析后的 config（steps 已展开 $ref）
+ */
+function loadConfig(configPath) {
+  // delete require cache 确保每次都重新读取（方便开发调试）
+  delete require.cache[require.resolve(configPath)];
+
+  const raw     = require(configPath);
+  const baseDir = path.dirname(configPath);
+
+  const steps = _expandSteps(raw.steps || [], baseDir);
+
+  return { ...raw, steps, _dir: baseDir };
+}
+
+/**
+ * 展开 steps 数组中的 $ref 项
+ */
+function _expandSteps(steps, baseDir) {
+  const result = [];
+
+  for (const step of steps) {
+    if (step.$ref) {
+      const expanded = _resolveRef(step.$ref, baseDir);
+      if (Array.isArray(expanded)) {
+        result.push(...expanded);
+      } else {
+        result.push(expanded);
+      }
+    } else {
+      result.push(step);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 解析单个 $ref 字符串
+ * @param {string} ref - "path/to/file.json#key"
+ * @param {string} baseDir - 当前 config 所在目录
+ */
+function _resolveRef(ref, baseDir) {
+  const [filePart, key] = ref.split('#');
+  const absPath = path.resolve(baseDir, filePart);
+
+  // 每次都清缓存，保持公共步骤文件可热更新
+  delete require.cache[require.resolve(absPath)];
+  const file = require(absPath);
+
+  if (key) {
+    if (!file[key]) {
+      throw new Error(`[config-loader] $ref "${ref}" 中找不到 key "${key}"`);
+    }
+    return file[key];
+  }
+
+  return file;
+}
+
+module.exports = { loadConfig };

package/wizards/runner/input-prompt.js

@@ -0,0 +1,96 @@
+'use strict';
+
+/**
+ * input-prompt.js
+ * ─────────────────────────────────────────────────────
+ * 通用「参数填写」交互模块
+ *
+ * 用于 input 类型的步骤：执行命令前需要用户填写动态参数。
+ * 暂时退出 raw mode → 用 readline 逐个收集参数 → 恢复 raw mode。
+ *
+ * 可复用于任何需要在 TUI 会话中收集用户输入的场景。
+ */
+
+const readline = require('readline');
+const chalk    = require('chalk');
+const { hr, W } = require('./render');
+
+/**
+ * 收集一组用户输入参数
+ *
+ * @param {Array<InputDef>} inputs
+ *   InputDef: { key, label, hint?, placeholder? }
+ * @returns {Promise<Object>} - { [key]: value }
+ */
+async function collectInputs(inputs) {
+  // 退出 raw mode，使 readline 能正常接收输入
+  process.stdin.setRawMode(false);
+
+  const values = {};
+
+  for (const input of inputs) {
+    values[input.key] = await _ask(input);
+  }
+
+  // 恢复 raw mode
+  // readline.close() 内部会 pause stdin，必须显式 resume 否则后续监听失效
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+
+  return values;
+}
+
+/**
+ * 显示单个参数的输入提示并等待用户输入
+ */
+function _ask(input) {
+  return new Promise(resolve => {
+    const rl = readline.createInterface({
+      input:    process.stdin,
+      output:   process.stdout,
+      terminal: true,
+    });
+
+    // Ctrl+C 优雅处理：恢复 raw mode 后退出
+    rl.on('SIGINT', () => {
+      rl.close();
+      // 恢复 raw mode，然后退出程序
+      try { process.stdin.setRawMode(true); } catch (_) {}
+      console.log('');
+      console.log('  ' + chalk.cyan('已取消。再见！👋'));
+      console.log('');
+      process.exit(0);
+    });
+
+    // 显示 hint
+    if (input.hint) {
+      console.log('  ' + chalk.dim('💡 ' + input.hint));
+    }
+    if (input.placeholder) {
+      console.log('  ' + chalk.dim('   例如：' + input.placeholder));
+    }
+
+    rl.question(
+      '  ' + chalk.bold.white(input.label) + chalk.dim('：'),
+      answer => {
+        rl.close();
+        resolve(answer.trim() || '');
+      }
+    );
+  });
+}
+
+/**
+ * 用参数值替换命令模板中的 {{key}} 占位符
+ *
+ * @param {string} template - 含 {{key}} 的模板字符串
+ * @param {Object} values   - { key: value }
+ * @returns {string}
+ */
+function fillTemplate(template, values) {
+  return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+    return values[key] !== undefined ? values[key] : `<${key}>`;
+  });
+}
+
+module.exports = { collectInputs, fillTemplate };

package/wizards/runner/render.js

@@ -0,0 +1,87 @@
+'use strict';
+
+/**
+ * render.js
+ * ─────────────────────────────────────────
+ * 通用渲染工具
+ *
+ * W 改为动态读取终端宽度（getW），每次 render 时实时计算，
+ * 支持终端窗口 resize 后自动适配。
+ */
+
+const chalk = require('chalk');
+
+/**
+ * 获取当前终端宽度（限制在 50~80 之间）
+ */
+function getW() {
+  const cols = process.stdout.columns;
+  if (!cols || cols < 50) return 66; // 无法获取或过窄时使用默认值
+  return Math.min(cols - 2, 80);
+}
+
+function hr(char = '─', w) {
+  return char.repeat(w || getW());
+}
+
+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('  ✗ 失败  '),
+  submenu: () => chalk.bgMagenta.white(' ▸ 子向导 '),
+  input:   () => chalk.bgYellow.black(' 填参数 '),
+};
+
+/**
+ * 渲染命令行（自动折行）
+ */
+function renderCommand(display) {
+  if (!display) return;
+  const W = getW();
+  const maxLen = W - 10;
+
+  if (display.length <= maxLen) {
+    console.log('  ' + chalk.bgBlack.cyan(' $ ') + chalk.bgBlack.white(' ' + display + ' '));
+    return;
+  }
+
+  // 按空格拆词后贪心折行
+  const words = display.split(' ');
+  const lines = [];
+  let   cur   = '';
+
+  for (const word of words) {
+    const next = cur ? cur + ' ' + word : word;
+    if (next.length > maxLen && cur) {
+      lines.push(cur);
+      cur = word;
+    } else {
+      cur = next;
+    }
+  }
+  if (cur) lines.push(cur);
+
+  lines.forEach((line, i) => {
+    const prefix = i === 0
+      ? chalk.bgBlack.cyan(' $ ')
+      : chalk.bgBlack.dim('   ');
+    console.log('  ' + prefix + chalk.bgBlack.white(' ' + line + ' '));
+  });
+}
+
+module.exports = { getW, hr, cls, indent, BADGE, renderCommand };