soulhubcli 1.0.14 → 1.0.16

package/README.md

@@ -1,6 +1,6 @@
 # SoulHub CLI
 
-SoulHub CLI — 用于安装和管理 OpenClaw AI Agent 人格模板的命令行工具。支持从 SoulHub Registry 或本地目录安装单 Agent 和多 Agent 团队。
+SoulHub CLI — 用于发现、安装和管理 AI Agent 灵魂（Soul）的命令行工具。支持从 SoulHub Registry 或本地目录安装单 Agent 和多 Agent 团队，兼容 OpenClaw 和 LightClaw。
 
 ## 安装
 
@@ -34,14 +34,14 @@ npx soulhubcli <command>
 
 | 命令 | 说明 |
 |------|------|
-| `soulhub search <keyword>` | 按关键词搜索 Agent 模板 |
-| `soulhub info <name>` | 查看 Agent 详细信息 |
-| `soulhub install <name>` | 从 Registry 安装 Agent 或团队 |
+| `soulhub search <keyword>` | 搜索 Agent |
+| `soulhub info <name>` | 查看 Agent 详细信息（identity、soul、skills 等） |
+| `soulhub install <name>` | 从 Registry 安装 Agent 或团队（默认为 worker，安装到所有检测到的 claw） |
+| `soulhub install <name> --main` | 安装为主 Agent |
 | `soulhub install --from <source>` | 从本地目录、ZIP 文件或 URL 安装 |
 | `soulhub list` | 列出已安装的 Agent |
 | `soulhub update [name]` | 更新已安装的 Agent |
-| `soulhub uninstall <name>` | 卸载已安装的 Agent |
-| `soulhub publish` | 验证并发布你的 Agent |
+| `soulhub rollback` | 回滚到上一次安装状态 |
 
 ## 使用方法
 
@@ -56,11 +56,16 @@ soulhub search "content writing"
 
 CLI 会自动识别目标是单 Agent 还是多 Agent 团队，无需手动区分。
 
+**默认行为：安装为 Worker Agent，自动安装到所有检测到的 claw 目录。**
+
 **从 Registry 安装：**
 
 ```bash
-# 安装单 Agent（作为主 Agent，部署到 workspace 目录）
-soulhub install ops-assistant
+# 安装单 Agent（默认为 worker，安装到所有检测到的 claw）
+soulhub install writer-wechat
+
+# 安装为主 Agent
+soulhub install writer-wechat --main
 
 # 安装多 Agent 团队（调度 Agent + 工作 Agent）
 soulhub install dev-squad
@@ -82,11 +87,11 @@ soulhub install --from https://example.com/agent-team.zip
 **指定目标目录：**
 
 ```bash
-# 安装到自定义目录（不依赖 OpenClaw 环境）
-soulhub install ops-assistant --dir ./my-agents
+# 安装到自定义目录（不依赖 OpenClaw/LightClaw 环境）
+soulhub install writer-wechat --dir ./my-agents
 
-# 指定 OpenClaw 安装目录
-soulhub install ops-assistant --claw-dir /opt/openclaw
+# 指定 claw 安装目录（只安装到该 claw）
+soulhub install writer-wechat --claw-dir ~/.lightclaw
 ```
 
 ### 列出已安装的 Agent
@@ -112,9 +117,11 @@ soulhub uninstall ops-assistant
 
 ### 单 Agent 安装
 
-- 单 Agent 会作为**主 Agent** 安装到 OpenClaw 的 `workspace/` 目录
-- 如果已存在主 Agent，CLI 会**自动备份**（复制到 `agentbackup/workspace`），原目录保持不变
-- 仅覆盖 `IDENTITY.md` 和 `SOUL.md` 等灵魂文件，不影响 workspace 中的其他运行时文件
+- **默认安装为 Worker Agent**（子 agent），部署到 `workspace-<agentId>/` 目录
+- 使用 `--main` 参数可安装为主 Agent，部署到 `workspace/` 目录
+- **自动安装到所有检测到的 claw 目录**（OpenClaw / LightClaw），使用 `--claw-dir` 可指定单个 claw
+- 如果目标目录已存在，CLI 会**自动备份**（复制到 `agentbackup/`）
+- 仅覆盖 `IDENTITY.md`、`SOUL.md` 等灵魂文件，不影响 workspace 中的其他运行时文件
 - 安装完成后自动重启 OpenClaw Gateway；若重启失败会提示手动重启
 
 ### 多 Agent 团队安装
@@ -122,7 +129,7 @@ soulhub uninstall ops-assistant
 - **调度 Agent（Dispatcher）** 作为主 Agent 安装到 `workspace/` 目录
 - **工作 Agent（Worker）** 安装到各自的 `workspace-<agentId>/` 目录
 - 自动配置多 Agent 之间的通信
-- Worker Agent 通过 `openclaw agents add` 命令注册
+- Worker Agent 自动注册到 claw 配置中
 - 安装完成后自动重启 OpenClaw Gateway
 
 ## 配置
@@ -137,18 +144,20 @@ CLI 将配置存储在 `~/.soulhub/config.json`。
 export SOULHUB_REGISTRY_URL=https://your-registry.example.com
 ```
 
-### OpenClaw 目录
+### OpenClaw / LightClaw 目录
+
+CLI 按以下优先级查找 claw 安装目录：
 
-CLI 按以下优先级查找 OpenClaw 安装目录：
+1. `--claw-dir` 命令行参数（指定时只安装到该 claw）
+2. `OPENCLAW_HOME` / `LIGHTCLAW_HOME` 环境变量
+3. 默认路径 `~/.openclaw`、`~/.lightclaw`
 
-1. `--claw-dir` 命令行参数
-2. `OPENCLAW_HOME` 环境变量
-3. 默认路径 `~/.openclaw`
+未指定 `--claw-dir` 时，CLI 会检测所有可用的 claw 目录并全部安装。
 
 ## 环境要求
 
 - Node.js >= 18.0.0
-- OpenClaw（可选，使用 `--dir` 参数时不需要）
+- OpenClaw 或 LightClaw（可选，使用 `--dir` 参数时不需要）
 
 ## License
 

package/dist/index.cjs

@@ -19731,7 +19731,14 @@ async function resolveClawDir(clawDir) {
   }
   return promptSelectClawDir();
 }
-var installCommand = new Command("install").description("Install an agent or team from the SoulHub registry (default: as worker)").argument("[name]", "Agent or team name to install").option("--from <source>", "Install from a local directory, ZIP file, or URL").option("--main", "Install as main agent (default is worker/sub-agent)").option(
+function resolveAllClawDirs(clawDir) {
+  if (clawDir) {
+    const resolved = findOpenClawDir(clawDir);
+    return resolved ? [resolved] : [];
+  }
+  return findAllClawDirs();
+}
+var installCommand = new Command("install").description("Install an agent or team from the SoulHub registry (default: as worker, installs to all detected claws)").argument("[name]", "Agent or team name to install").option("--from <source>", "Install from a local directory, ZIP file, or URL").option("--main", "Install as main agent").option(
   "--dir <path>",
   "Target directory (defaults to OpenClaw/LightClaw workspace)"
 ).option(
@@ -19747,10 +19754,11 @@ var installCommand = new Command("install").description("Install an agent or tea
     } else {
       console.error(source_default.red("Please specify an agent or team name, or use --from to install from a local source."));
       console.log(source_default.dim("  Examples:"));
-      console.log(source_default.dim("    soulhub install writer-wechat          # \u5B89\u88C5\u4E3A\u5B50 agent (workspace-writer-wechat/)"));
-      console.log(source_default.dim("    soulhub install writer-wechat --main   # \u5B89\u88C5\u4E3A\u4E3B agent (workspace/)"));
-      console.log(source_default.dim("    soulhub install dev-squad              # \u4ECE registry \u5B89\u88C5\u56E2\u961F"));
-      console.log(source_default.dim("    soulhub install --from ./agent-team/   # \u4ECE\u672C\u5730\u76EE\u5F55\u5B89\u88C5"));
+      console.log(source_default.dim("    soulhub install writer-wechat            # Install as worker to all detected claws"));
+      console.log(source_default.dim("    soulhub install writer-wechat --main     # Install as main agent"));
+      console.log(source_default.dim("    soulhub install dev-squad                # Install a team from registry"));
+      console.log(source_default.dim("    soulhub install --from ./agent-team/     # Install from local directory"));
+      console.log(source_default.dim("    soulhub install writer-wechat --claw-dir ~/.lightclaw  # Install to specific claw"));
       process.exit(1);
     }
   } catch (error) {
@@ -19762,7 +19770,7 @@ var installCommand = new Command("install").description("Install an agent or tea
     process.exit(1);
   }
 });
-async function installFromRegistry(name, targetDir, clawDir, asMain = false) {
+async function installFromRegistry(name, targetDir, clawDir, asMain) {
   const spinner = createSpinner(`Checking registry for ${source_default.cyan(name)}...`).start();
   const index = await fetchIndex();
   const agent = index.agents.find((a) => a.name === name);
@@ -19782,21 +19790,17 @@ async function installFromRegistry(name, targetDir, clawDir, asMain = false) {
   }
 }
 async function installSingleAgent(name, targetDir, clawDir, asMain = false) {
-  const spinner = createSpinner(`Checking environment...`).start();
-  let selectedClawDir = null;
-  if (!targetDir) {
-    spinner.stop();
-    selectedClawDir = await resolveClawDir(clawDir);
-    if (!selectedClawDir) {
-      console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
-      printOpenClawInstallHelp();
-      return;
-    }
-    spinner.start();
-    const brand = detectClawBrand(selectedClawDir);
-    spinner.text = source_default.dim(`${brand} detected: ${selectedClawDir}`);
+  if (targetDir) {
+    await installSingleAgentToClaw(name, null, targetDir, asMain);
+    return;
   }
-  spinner.text = `Fetching agent ${source_default.cyan(name)}...`;
+  const allClawDirs = resolveAllClawDirs(clawDir);
+  if (allClawDirs.length === 0) {
+    console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
+    printOpenClawInstallHelp();
+    return;
+  }
+  const spinner = createSpinner(`Fetching agent ${source_default.cyan(name)}...`).start();
   const index = await fetchIndex();
   const agent = index.agents.find((a) => a.name === name);
   if (!agent) {
@@ -19804,8 +19808,33 @@ async function installSingleAgent(name, targetDir, clawDir, asMain = false) {
     console.log(source_default.dim("  Use 'soulhub search' to find available agents."));
     return;
   }
-  let workspaceDir;
+  spinner.text = `Downloading ${source_default.cyan(agent.displayName)} package...`;
+  const pkgDir = await downloadAgentPackage(name, agent.version);
+  spinner.succeed(`Package ${source_default.cyan(agent.displayName)} downloaded.`);
+  for (const selectedClawDir of allClawDirs) {
+    await installSingleAgentToClaw(name, selectedClawDir, void 0, asMain, pkgDir, agent);
+  }
+  import_node_fs9.default.rmSync(pkgDir, { recursive: true, force: true });
+}
+async function installSingleAgentToClaw(name, selectedClawDir, targetDir, asMain = false, preDownloadedPkgDir, preLoadedAgent) {
+  const brand = selectedClawDir ? detectClawBrand(selectedClawDir) : null;
+  const clawLabel = brand ? `${brand} (${selectedClawDir})` : targetDir;
+  const spinner = createSpinner(`Installing to ${source_default.dim(clawLabel)}...`).start();
   const agentId = name.toLowerCase().replace(/[\s_]+/g, "-");
+  logger.info(`Install role resolved: asMain=${asMain}, claw=${selectedClawDir || targetDir}`);
+  let agent = preLoadedAgent;
+  if (!agent) {
+    spinner.text = `Fetching agent ${source_default.cyan(name)}...`;
+    const index = await fetchIndex();
+    const found = index.agents.find((a) => a.name === name);
+    if (!found) {
+      spinner.fail(`Agent "${name}" not found in registry.`);
+      console.log(source_default.dim("  Use 'soulhub search' to find available agents."));
+      return;
+    }
+    agent = found;
+  }
+  let workspaceDir;
   if (targetDir) {
     workspaceDir = import_node_path12.default.resolve(targetDir);
   } else if (asMain) {
@@ -19817,9 +19846,7 @@ async function installSingleAgent(name, targetDir, clawDir, asMain = false) {
   if (!targetDir && asMain) {
     const mainCheck = checkMainAgentExists(selectedClawDir);
     if (mainCheck.hasContent) {
-      spinner.warn(
-        `Existing main agent detected. Backing up workspace...`
-      );
+      spinner.warn(`Existing main agent detected. Backing up workspace...`);
       const backupDir = backupAgentWorkspace(workspaceDir);
       if (backupDir) {
         console.log(source_default.yellow(`  \u26A0 Existing main agent backed up to: ${backupDir}`));
@@ -19859,21 +19886,23 @@ async function installSingleAgent(name, targetDir, clawDir, asMain = false) {
     if (asMain) {
       spinner.text = `Registering ${source_default.cyan(agent.displayName)} as main agent...`;
       addAgentToOpenClawConfig(selectedClawDir, "main", name, true);
-      spinner.text = source_default.dim(`Main agent registered in config`);
     } else {
       spinner.text = `Registering ${source_default.cyan(agent.displayName)} as worker agent...`;
-      const regResult = registerAgentToOpenClaw(agentId, workspaceDir, clawDir);
+      const regResult = registerAgentToOpenClaw(agentId, workspaceDir);
       if (!regResult.success) {
         spinner.fail(`Failed to register ${agentId}: ${regResult.message}`);
         return;
       }
-      spinner.text = source_default.dim(`Worker agent ${agentId} registered in config`);
     }
   }
-  spinner.text = `Downloading ${source_default.cyan(agent.displayName)} package...`;
-  const pkgDir = await downloadAgentPackage(name, agent.version);
-  copyAgentFilesFromPackage(pkgDir, workspaceDir);
-  import_node_fs9.default.rmSync(pkgDir, { recursive: true, force: true });
+  if (preDownloadedPkgDir) {
+    copyAgentFilesFromPackage(preDownloadedPkgDir, workspaceDir);
+  } else {
+    spinner.text = `Downloading ${source_default.cyan(agent.displayName)} package...`;
+    const pkgDir = await downloadAgentPackage(name, agent.version);
+    copyAgentFilesFromPackage(pkgDir, workspaceDir);
+    import_node_fs9.default.rmSync(pkgDir, { recursive: true, force: true });
+  }
   recordInstall(name, agent.version, workspaceDir);
   if (backupRecord) {
     if (asMain) {
@@ -19887,9 +19916,8 @@ async function installSingleAgent(name, targetDir, clawDir, asMain = false) {
   const typeLabel = asMain ? source_default.blue("Single Agent (Main)") : source_default.green("Single Agent (Worker)");
   logger.info(`Single agent installed as ${roleLabel}: ${name}`, { version: agent.version, workspace: workspaceDir });
   spinner.succeed(
-    `${source_default.cyan.bold(agent.displayName)} installed as ${roleLabel}!`
+    `${source_default.cyan.bold(agent.displayName)} installed as ${roleLabel} \u2192 ${source_default.dim(clawLabel)}`
   );
-  console.log();
   console.log(`  ${source_default.dim("Location:")} ${workspaceDir}`);
   console.log(`  ${source_default.dim("Version:")}  ${agent.version}`);
   console.log(`  ${source_default.dim("Type:")}     ${typeLabel}`);
@@ -19990,7 +20018,7 @@ async function installRecipeFromRegistry(name, recipe, targetDir, clawDir) {
     await tryRestartGateway();
   }
 }
-async function installFromSource(source, targetDir, clawDir, asMain = false) {
+async function installFromSource(source, targetDir, clawDir, asMain) {
   const spinner = createSpinner("Analyzing package...").start();
   let packageDir;
   let tempDir = null;
@@ -20057,22 +20085,29 @@ async function installFromSource(source, targetDir, clawDir, asMain = false) {
   }
 }
 async function installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain = false) {
-  const spinner = createSpinner("Installing single agent...").start();
   const pkg = readSoulHubPackage(packageDir);
   const agentName = pkg?.name || import_node_path12.default.basename(packageDir);
-  let selectedClawDir = null;
-  if (!targetDir) {
-    spinner.stop();
-    selectedClawDir = await resolveClawDir(clawDir);
-    if (!selectedClawDir) {
-      console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
-      printOpenClawInstallHelp();
-      return;
-    }
-    spinner.start();
+  if (targetDir) {
+    await installSingleAgentFromDirToClaw(packageDir, agentName, pkg, null, targetDir, asMain);
+    return;
   }
-  let workspaceDir;
+  const allClawDirs = resolveAllClawDirs(clawDir);
+  if (allClawDirs.length === 0) {
+    console.log(source_default.red("OpenClaw/LightClaw workspace directory not found."));
+    printOpenClawInstallHelp();
+    return;
+  }
+  for (const selectedClawDir of allClawDirs) {
+    await installSingleAgentFromDirToClaw(packageDir, agentName, pkg, selectedClawDir, void 0, asMain);
+  }
+}
+async function installSingleAgentFromDirToClaw(packageDir, agentName, pkg, selectedClawDir, targetDir, asMain = false) {
+  const brand = selectedClawDir ? detectClawBrand(selectedClawDir) : null;
+  const clawLabel = brand ? `${brand} (${selectedClawDir})` : targetDir;
+  const spinner = createSpinner(`Installing to ${source_default.dim(clawLabel)}...`).start();
   const agentId = agentName.toLowerCase().replace(/[\s_]+/g, "-");
+  logger.info(`Install role resolved: asMain=${asMain}, claw=${selectedClawDir || targetDir}`);
+  let workspaceDir;
   if (targetDir) {
     workspaceDir = import_node_path12.default.resolve(targetDir);
   } else if (asMain) {
@@ -20121,7 +20156,7 @@ async function installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain
       addAgentToOpenClawConfig(selectedClawDir, "main", agentName, true);
     } else {
       spinner.text = `Registering ${source_default.cyan(agentName)} as worker agent...`;
-      const regResult = registerAgentToOpenClaw(agentId, workspaceDir, clawDir);
+      const regResult = registerAgentToOpenClaw(agentId, workspaceDir);
       if (!regResult.success) {
         spinner.fail(`Failed to register ${agentId}: ${regResult.message}`);
         return;
@@ -20142,8 +20177,7 @@ async function installSingleAgentFromDir(packageDir, targetDir, clawDir, asMain
   const roleLabel = asMain ? "main agent" : "worker agent";
   const typeLabel = asMain ? source_default.blue("Single Agent (Main)") : source_default.green("Single Agent (Worker)");
   logger.info(`Single agent installed from dir as ${roleLabel}: ${agentName}`, { source: packageDir, workspace: workspaceDir });
-  spinner.succeed(`${source_default.cyan.bold(agentName)} installed as ${roleLabel}!`);
-  console.log();
+  spinner.succeed(`${source_default.cyan.bold(agentName)} installed as ${roleLabel} \u2192 ${source_default.dim(clawLabel)}`);
   console.log(`  ${source_default.dim("Location:")} ${workspaceDir}`);
   console.log(`  ${source_default.dim("Source:")}   ${packageDir}`);
   console.log(`  ${source_default.dim("Type:")}     ${typeLabel}`);
@@ -20649,13 +20683,13 @@ function formatInstallType(type2) {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("soulhub").description("SoulHub CLI - Discover, install and manage AI agent souls").version("1.0.14").option("--verbose", "Enable verbose debug logging").hook("preAction", () => {
+program2.name("soulhub").description("SoulHub CLI - Discover, install and manage AI agent souls").version("1.0.16").option("--verbose", "Enable verbose debug logging").hook("preAction", () => {
   const opts = program2.opts();
   const verbose = opts.verbose || process.env.SOULHUB_DEBUG === "1";
   logger.init(verbose);
   logger.info("CLI started", {
     args: process.argv.slice(2),
-    version: "1.0.14",
+    version: "1.0.16",
     node: process.version
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soulhubcli",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "SoulHub CLI - Install and manage AI agent persona templates for OpenClaw",
   "type": "module",
   "bin": {