aisoulhub 1.0.7 → 1.0.11

package/README.md

@@ -1,2 +1,36 @@
-# install-tool
+# AISoulHub CLI
 
+A command-line interface tool to easily install, update, and manage AI Soul configurations and skills for OpenClaw agents. It seamlessly integrates with [AISoulHub](https://aisoulhub.com) to provide a streamlined experience.
+
+## Prerequisites
+
+Before using this tool, ensure you have the following installed:
+
+- [Node.js](https://nodejs.org/) (v16 or higher recommended)
+- [OpenClaw](https://openclaw.ai/) CLI (`openclaw` command must be available in your PATH)
+
+## Usage
+
+You can run `aisoulhub` directly via `npx` without needing to install it globally.
+
+### 1. Install an AI Soul
+
+Downloads and installs an AI Soul package into a new or existing OpenClaw Agent.
+
+```bash
+npx aisoulhub install <ai_soul_id>
+```
+
+### 2. Update an AI Soul
+
+Updates an existing OpenClaw Agent with the latest AI Soul package configuration and skills.
+
+```bash
+npx aisoulhub update
+```
+
+<br />
+
+## License
+
+ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aisoulhub",
-  "version": "1.0.7",
+  "version": "1.0.11",
   "description": "",
   "main": "index.js",
   "scripts": {
@@ -23,8 +23,8 @@
   "type": "module",
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
-    "axios": "^1.13.6",
     "chalk": "^5.6.2",
+    "clawhub": "^0.9.0",
     "commander": "^14.0.3",
     "ora": "^9.3.0",
     "shelljs": "^0.10.0",

package/src/commands/install.js

@@ -1,61 +1,120 @@
-import { checkOpenclaw, checkLogin } from '../utils/check.js';
-import { getAgents, addAgent } from '../utils/openclaw.js';
-import { downloadAndExtract } from '../utils/download.js';
+import { checkOpenclaw } from '../utils/check.js';
+import { getAgents, addAgent, setAgentIdentity } from '../utils/openclaw.js';
+import { extractLocalZip } from '../utils/download.js';
 import { processMetaJson } from '../utils/meta.js';
-import { select, input } from '@inquirer/prompts';
+import { select, input, confirm } from '@inquirer/prompts';
 import chalk from 'chalk';
+import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import unzipper from 'unzipper';
 
-export async function installCommand(aiSoulId) {
-  if (!aiSoulId) {
-    console.error(chalk.red('❌ 错误: 必须提供 ai_soul_id，例如: aisoulhub install <ai_soul_id>'));
+export async function installCommand(zipPath) {
+  if (!zipPath) {
+    console.error(chalk.red('❌ Error: zip path is required, e.g.: aisoulhub install <path_to_zip>'));
     process.exit(1);
   }
 
+  // 检查是否为本地 zip 文件
+  if (!zipPath.endsWith('.zip') || !fs.existsSync(path.resolve(zipPath))) {
+    console.error(chalk.red(`❌ Error: Invalid or missing local zip file at [${zipPath}]`));
+    process.exit(1);
+  }
+  const localZipPath = path.resolve(zipPath);
+
   // 1. 前置检查
   checkOpenclaw();
-  await checkLogin();
 
   // 2. 获取当前的 agents 列表
   let agents = [];
   try {
     agents = getAgents();
   } catch (err) {
-    console.error(chalk.yellow(`⚠️ 获取 agents 列表失败: ${err.message}`));
+    console.error(chalk.yellow(`⚠️ Failed to get agents list: ${err.message}`));
   }
 
   // 3. 提示用户选择或创建 Agent
   const choices = [
-    { name: '✨ 创建新的 Agent', value: 'create_new' },
-    ...agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: a.path }))
+    { name: '✨ Create new Agent', value: { name: 'create_new', path: null } },
+    ...agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: { name: a.name, path: a.path } }))
   ];
 
   const agentChoice = await select({
-    message: '请选择要安装的 Agent：',
+    message: 'Please select the Agent to install:',
     choices
   });
 
-  let targetPath = agentChoice;
+  if (agentChoice.name === 'main') {
+    const isConfirmed = await confirm({
+      message: chalk.yellow('⚠️ Warning: Overwriting the "main" agent might cause unexpected issues. Are you sure you want to continue?'),
+      default: false
+    });
+    
+    if (!isConfirmed) {
+      console.log(chalk.blue('ℹ️ Operation cancelled by user.'));
+      process.exit(0);
+    }
+  }
+
+  let targetPath = agentChoice.path;
+  let finalAgentName = agentChoice.name;
+
+  if (agentChoice.name === 'create_new') {
+    let defaultAgentName = '';
+    let identityName = '';
+    
+    // 尝试从 zip 文件中的 aisoul-meta.json 获取默认 name 和 slug
+    try {
+      const directory = await unzipper.Open.file(localZipPath);
+      const metaFile = directory.files.find(d => d.path === 'aisoul-meta.json');
+      if (metaFile) {
+        const content = await metaFile.buffer();
+        const meta = JSON.parse(content.toString('utf-8'));
+        if (meta.slug) {
+          defaultAgentName = meta.slug;
+        }
+        if (meta.name) {
+          identityName = meta.name;
+        }
+      }
+    } catch (err) {
+      // 忽略读取 zip 出错的情况
+    }
 
-  if (agentChoice === 'create_new') {
     const newAgentName = await input({
-      message: '请输入新 Agent 的名称：',
-      validate: (val) => val.trim().length > 0 ? true : 'Agent 名称不能为空'
+      message: 'Please enter the name of the new Agent:',
+      default: defaultAgentName,
+      validate: (val) => {
+        if (val.trim().length === 0) return 'Agent name cannot be empty';
+        if (val.trim().toLowerCase() === 'main') return '"main" is reserved. Choose another name.';
+        return true;
+      }
     });
+    
+    finalAgentName = newAgentName;
 
     const defaultWorkspace = path.join(os.homedir(), '.openclaw', `workspace-${newAgentName}`);
     
     const newWorkspacePath = await input({
-      message: '请输入新 Agent 的工作目录：',
+      message: 'Please enter the workspace directory for the new Agent:',
       default: defaultWorkspace,
-      validate: (val) => val.trim().length > 0 ? true : '工作目录不能为空'
+      validate: (val) => val.trim().length > 0 ? true : 'Workspace directory cannot be empty'
     });
     
-    console.log(chalk.cyan(`🔄 正在创建 Agent [${newAgentName}]...`));
+    console.log(chalk.cyan(`🔄 Creating Agent [${newAgentName}]...`));
     try {
       addAgent(newAgentName, newWorkspacePath);
-      console.log(chalk.green(`✅ Agent [${newAgentName}] 创建成功。`));
+      console.log(chalk.green(`✅ Agent [${newAgentName}] created successfully.`));
+      
+      // 设置 Agent 的显示名称
+      if (identityName) {
+        try {
+          setAgentIdentity(newAgentName, identityName);
+          console.log(chalk.green(`✅ Agent identity name set to [${identityName}].`));
+        } catch (identityErr) {
+          console.error(chalk.yellow(`⚠️ Warning: Failed to set identity name: ${identityErr.message}`));
+        }
+      }
       
       // 重新获取列表以获取新 agent 的路径
       const updatedAgents = getAgents();
@@ -72,20 +131,34 @@ export async function installCommand(aiSoulId) {
   }
 
   if (!targetPath) {
-    console.error(chalk.red('❌ 错误: 无法确定 Agent 的工作目录路径。'));
+    console.error(chalk.red('❌ Error: Unable to determine the workspace directory path for the Agent.'));
     process.exit(1);
   }
 
-  console.log(chalk.blue(`ℹ️ 目标工作目录: ${targetPath}`));
+  console.log(chalk.blue(`ℹ️ Target workspace directory: ${targetPath}`));
+
+  // 4. 解压本地 ZIP 文件
+  const extractSuccess = await extractLocalZip(localZipPath, targetPath);
 
-  // 4. 下载并解压 ZIP 文件
-  const downloadSuccess = await downloadAndExtract(aiSoulId, targetPath);
-  if (!downloadSuccess) {
+  if (!extractSuccess) {
     process.exit(1);
   }
 
-  // 5. 解析 meta.json 并安装技能
+  // 5. 解析 aisoul-meta.json 并安装技能
   await processMetaJson(targetPath);
 
-  console.log(chalk.green(`🎉 成功将 ${aiSoulId} 安装到 Agent。`));
+  console.log(chalk.green(`🎉 Successfully installed local package to the Agent.`));
+  
+  // 直接唤醒 Agent
+  console.log(chalk.cyan(`\n👉 Waking up the agent...`));
+  const { spawn } = await import('child_process');
+  
+  const child = spawn('openclaw', ['agent', '--agent', finalAgentName, '--message', 'hi'], {
+    stdio: 'inherit',
+    shell: true
+  });
+
+  child.on('error', (error) => {
+    console.error(chalk.red(`❌ Failed to start the agent: ${error.message}`));
+  });
 }

package/src/index.js

@@ -1,6 +1,5 @@
 import { Command } from 'commander';
 import { installCommand } from './commands/install.js';
-import { updateCommand } from './commands/update.js';
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -16,23 +15,16 @@ export async function main() {
 
   program
     .name('aisoulhub')
-    .description('AISoulHub CLI 命令行工具，用于安装和更新 Agent 技能与配置')
+    .description('AISoulHub CLI tool for installing Agent skills and configurations')
     .version(pkg.version);
 
   program
     .command('install')
-    .description('安装新的 Agent 配置及技能')
-    .argument('<ai_soul_id>', '指定要安装的 ai_soul_id (例如：12345)')
+    .description('Install new Agent configuration and skills from a local zip file')
+    .argument('<path_to_zip>', 'Specify the local path to the zip file')
     .action(async (aiSoulId) => {
       await installCommand(aiSoulId);
     });
 
-  program
-    .command('update')
-    .description('更新已存在的 Agent 配置及技能')
-    .action(async () => {
-      await updateCommand();
-    });
-
   program.parseAsync(process.argv);
 }

package/src/utils/check.js

@@ -1,53 +1,9 @@
 import shell from 'shelljs';
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
 import chalk from 'chalk';
-import { input } from '@inquirer/prompts';
 
 export function checkOpenclaw() {
   if (!shell.which('openclaw')) {
-    console.error(chalk.red('❌ 错误: 未找到 openclaw 命令。请按照 https://openclaw.ai 的指引安装 openclaw，然后重试。'));
+    console.error(chalk.red('❌ Error: openclaw command not found. Please follow the instructions at https://openclaw.ai to install openclaw, then try again.'));
     process.exit(1);
   }
 }
-
-const CONFIG_PATH = path.join(os.homedir(), '.aisoulhub.json');
-
-export async function checkLogin() {
-  let config = {};
-  if (fs.existsSync(CONFIG_PATH)) {
-    try {
-      const content = fs.readFileSync(CONFIG_PATH, 'utf-8');
-      config = JSON.parse(content);
-    } catch (e) {
-      // ignore parse error
-    }
-  }
-
-  if (!config.email) {
-    console.log(chalk.yellow('ℹ️ 未检测到登录信息，请输入您的邮箱进行登录：'));
-    const email = await input({ 
-      message: '请输入您的邮箱地址:',
-      validate: (value) => {
-        const pass = value.match(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
-        if (pass) {
-          return true;
-        }
-        return '请输入有效的邮箱地址';
-      }
-    });
-
-    config.email = email;
-    try {
-      fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
-      console.log(chalk.green(`✅ 登录成功！邮箱: ${email} 已保存。`));
-    } catch (e) {
-      console.log(chalk.yellow(`⚠️ 登录成功，但无法保存到 ${CONFIG_PATH}: ${e.message}`));
-    }
-  } else {
-    console.log(chalk.blue(`ℹ️ 当前登录邮箱: ${config.email}`));
-  }
-  
-  return config.email;
-}

package/src/utils/download.js

@@ -1,37 +1,12 @@
-import axios from 'axios';
 import fs from 'fs';
-import path from 'path';
-import os from 'os';
 import unzipper from 'unzipper';
 import ora from 'ora';
 import chalk from 'chalk';
 
-export async function downloadAndExtract(aiSoulId, targetPath) {
-  const url = `https://aisoulhub.com/packages/${aiSoulId}.zip`;
-  const tempDir = os.tmpdir();
-  const zipPath = path.join(tempDir, `${aiSoulId}.zip`);
-
-  const spinner = ora(`正在下载包 ${aiSoulId}...`).start();
+export async function extractLocalZip(zipPath, targetPath) {
+  const spinner = ora(`Extracting local package from ${zipPath}...`).start();
 
   try {
-    const response = await axios({
-      method: 'GET',
-      url,
-      responseType: 'stream',
-      // Provide a mock user-agent just in case
-      headers: { 'User-Agent': 'aisoulhub-cli/1.0.0' }
-    });
-
-    const writer = fs.createWriteStream(zipPath);
-    response.data.pipe(writer);
-
-    await new Promise((resolve, reject) => {
-      writer.on('finish', resolve);
-      writer.on('error', reject);
-    });
-
-    spinner.text = `下载完成，正在解压...`;
-
     // Ensure target path exists
     if (!fs.existsSync(targetPath)) {
       fs.mkdirSync(targetPath, { recursive: true });
@@ -42,16 +17,10 @@ export async function downloadAndExtract(aiSoulId, targetPath) {
       .pipe(unzipper.Extract({ path: targetPath }))
       .promise();
 
-    spinner.succeed(chalk.green(`包 ${aiSoulId} 下载并解压成功！`));
-
-    // Cleanup temp zip
-    fs.unlinkSync(zipPath);
+    spinner.succeed(chalk.green(`Local package extracted successfully.`));
     return true;
   } catch (err) {
-    spinner.fail(chalk.red(`下载或解压失败: ${err.message}`));
-    if (fs.existsSync(zipPath)) {
-      fs.unlinkSync(zipPath);
-    }
+    spinner.fail(chalk.red(`Error: Failed to extract the local package: ${err.message}`));
     return false;
   }
 }

package/src/utils/meta.js

@@ -4,9 +4,9 @@ import chalk from 'chalk';
 import { installSkill } from './openclaw.js';
 
 export async function processMetaJson(workspacePath) {
-  const metaPath = path.join(workspacePath, 'meta.json');
+  const metaPath = path.join(workspacePath, 'aisoul-meta.json');
   if (!fs.existsSync(metaPath)) {
-    console.log(chalk.yellow(`ℹ️ 未找到 meta.json，跳过技能安装。(${metaPath})`));
+    console.log(chalk.yellow(`ℹ️ aisoul-meta.json not found, skipping skill installation. (${metaPath})`));
     return;
   }
 
@@ -16,22 +16,10 @@ export async function processMetaJson(workspacePath) {
     const skills = meta.skills || [];
     
     if (skills.length === 0) {
-      console.log(chalk.blue('ℹ️ meta.json 中没有定义需要安装的技能。'));
+      console.log(chalk.blue('ℹ️ No skills defined to install in aisoul-meta.json.'));
       return;
     }
-
-    console.log(chalk.cyan(`🔄 开始安装 ${skills.length} 个技能...`));
-    for (const skill of skills) {
-      console.log(chalk.blue(`⏳ 正在安装技能: ${skill}...`));
-      const success = installSkill(workspacePath, skill);
-      if (success) {
-        console.log(chalk.green(`✅ 技能 ${skill} 安装成功。`));
-      } else {
-        console.log(chalk.red(`❌ 技能 ${skill} 安装失败。`));
-      }
-    }
-    console.log(chalk.green('🎉 所有技能安装流程结束。'));
   } catch (err) {
-    console.error(chalk.red(`❌ 读取或解析 meta.json 失败: ${err.message}`));
+    console.error(chalk.red(`❌ Failed to read or parse aisoul-meta.json: ${err.message}`));
   }
 }

package/src/utils/openclaw.js

@@ -3,17 +3,31 @@ import shell from 'shelljs';
 export function getAgents() {
   const result = shell.exec('openclaw agents list --json', { silent: true });
   if (result.code !== 0) {
-    throw new Error('获取 agents 列表失败: ' + result.stderr);
+    throw new Error('Failed to get agents list: ' + result.stderr);
   }
   
   // Try to parse JSON first
   try {
-    const list = JSON.parse(result.stdout);
-    if (Array.isArray(list)) {
-      return list.map(item => ({
-        name: item.id || item.name,
-        path: item.workspace || item.path || item.agentDir
-      }));
+    // 尝试提取标准 JSON 数组结构（截取第一个 '[' 到匹配的 ']' 的内容）
+    // 为了防止截取到后面的无关内容，我们查找从 '[' 开始，以 ']' 结束，并且紧跟换行或结尾的部分
+    const jsonMatch = result.stdout.match(/\[[\s\S]*?\n\]/);
+    if (jsonMatch) {
+      const list = JSON.parse(jsonMatch[0]);
+      if (Array.isArray(list)) {
+        return list.map(item => ({
+          name: item.id || item.name,
+          path: item.workspace || item.path || item.agentDir
+        }));
+      }
+    } else {
+      // 如果没有匹配到数组结构，则尝试直接解析
+      const list = JSON.parse(result.stdout);
+      if (Array.isArray(list)) {
+        return list.map(item => ({
+          name: item.id || item.name,
+          path: item.workspace || item.path || item.agentDir
+        }));
+      }
     }
   } catch (err) {
     // Not JSON, parse text
@@ -45,21 +59,39 @@ export function addAgent(name, workspacePath) {
   }
   const result = shell.exec(cmd, { silent: true });
   if (result.code !== 0) {
-    throw new Error(`创建 agent [${name}] 失败: ` + result.stderr);
+    throw new Error(`Failed to create agent [${name}]: ` + result.stderr);
+  }
+  return result.stdout;
+}
+
+export function setAgentIdentity(agentName, identityName) {
+  const cmd = `openclaw agents set-identity --agent "${agentName}" --name "${identityName}"`;
+  const result = shell.exec(cmd, { silent: true });
+  if (result.code !== 0) {
+    throw new Error(`Failed to set agent identity for [${agentName}]: ` + result.stderr);
   }
   return result.stdout;
 }
 
-export function installSkill(workspacePath, skillStr) {
-  // Try `openclaw mcp install` or similar
-  const result = shell.exec(`openclaw mcp add ${skillStr}`, { cwd: workspacePath, silent: true });
+export async function installSkill(workspacePath, skillStr, retryCount = 0) {
+  const maxRetries = 3;
+  const result = shell.exec(`npx clawhub install ${skillStr} --workdir "${workspacePath}"`, { silent: true });
+  
   if (result.code !== 0) {
-    // fallback
-    const fallback = shell.exec(`openclaw skills add ${skillStr}`, { cwd: workspacePath, silent: true });
-    if (fallback.code !== 0) {
-      console.error(`安装技能 ${skillStr} 失败: `, fallback.stderr || result.stderr);
-      return false;
+    const errorOutput = result.stderr || result.stdout;
+    if (errorOutput.includes('Rate limit exceeded')) {
+      if (retryCount < maxRetries) {
+        console.log(`⚠️ Rate limit exceeded. Waiting 5 seconds before retrying (${retryCount + 1}/${maxRetries})...`);
+        await new Promise(resolve => setTimeout(resolve, 5000));
+        return installSkill(workspacePath, skillStr, retryCount + 1);
+      } else {
+        console.error(`❌ Failed to install skill ${skillStr} after ${maxRetries} retries due to rate limit.`);
+        return false;
+      }
     }
+    
+    console.error(`❌ Failed to install skill ${skillStr}: `, errorOutput);
+    return false;
   }
   return true;
 }

package/src/commands/update.js

@@ -1,76 +0,0 @@
-import { checkOpenclaw, checkLogin } from '../utils/check.js';
-import { getAgents } from '../utils/openclaw.js';
-import { downloadAndExtract } from '../utils/download.js';
-import { processMetaJson } from '../utils/meta.js';
-import { select, input } from '@inquirer/prompts';
-import fs from 'fs';
-import path from 'path';
-import chalk from 'chalk';
-
-export async function updateCommand() {
-  // 1. 前置检查
-  checkOpenclaw();
-  await checkLogin();
-
-  // 2. 获取当前的 agents 列表
-  let agents = [];
-  try {
-    agents = getAgents();
-  } catch (err) {
-    console.error(chalk.red(`❌ 获取 agents 列表失败: ${err.message}`));
-    process.exit(1);
-  }
-
-  if (agents.length === 0) {
-    console.error(chalk.yellow('⚠️ 当前没有可更新的 Agent。请先使用 install 命令安装。'));
-    process.exit(1);
-  }
-
-  // 3. 提示用户选择 Agent
-  const choices = agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: a.path }));
-
-  const targetPath = await select({
-    message: '请选择要更新的 Agent：',
-    choices
-  });
-
-  if (!targetPath || !fs.existsSync(targetPath)) {
-    console.error(chalk.red('❌ 错误: 无效的 Agent 工作目录。'));
-    process.exit(1);
-  }
-
-  // 4. 确定 ai_soul_id
-  let aiSoulId = null;
-  const metaPath = path.join(targetPath, 'meta.json');
-  if (fs.existsSync(metaPath)) {
-    try {
-      const content = fs.readFileSync(metaPath, 'utf-8');
-      const meta = JSON.parse(content);
-      if (meta.ai_soul_id) {
-        aiSoulId = meta.ai_soul_id;
-        console.log(chalk.blue(`ℹ️ 从 meta.json 中检测到 ai_soul_id: ${aiSoulId}`));
-      }
-    } catch (e) {
-      console.warn(chalk.yellow('⚠️ 无法解析 meta.json。'));
-    }
-  }
-
-  if (!aiSoulId) {
-    console.log(chalk.yellow('ℹ️ 未能从当前 Agent 的 meta.json 中获取 ai_soul_id。'));
-    aiSoulId = await input({
-      message: '请输入需要更新的 ai_soul_id：',
-      validate: (val) => val.trim().length > 0 ? true : 'ai_soul_id 不能为空'
-    });
-  }
-
-  // 5. 下载并解压 ZIP 文件 (覆盖)
-  const downloadSuccess = await downloadAndExtract(aiSoulId, targetPath);
-  if (!downloadSuccess) {
-    process.exit(1);
-  }
-
-  // 6. 解析 meta.json 并更新技能
-  await processMetaJson(targetPath);
-
-  console.log(chalk.green(`🎉 成功更新 Agent [${aiSoulId}]。`));
-}