aisoulhub 1.0.7 → 1.0.8

package/README.md

@@ -1,2 +1,54 @@
-# install-tool
+# AISoulHub CLI
+
+A powerful 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>
+```
+
+**What happens during install?**
+- Checks for OpenClaw dependency.
+- Prompts for your email (if not already logged in) and saves it to `~/.aisoulhub.json`.
+- Asks you to select an existing Agent or create a new one.
+- Downloads the corresponding zip package from AISoulHub.
+- Extracts files (like `SOUL.md`, `AGENTS.md`, `IDENTITY.md`, `aisoul-meta.json`) into the Agent's workspace.
+- Automatically reads `aisoul-meta.json` and installs all defined skills via OpenClaw.
+
+### 2. Update an AI Soul
+
+Updates an existing OpenClaw Agent with the latest AI Soul package configuration and skills.
+
+```bash
+npx aisoulhub update
+```
+
+**What happens during update?**
+- Displays a list of your existing Agents for you to select.
+- Attempts to read the `ai_soul_id` from the Agent's `aisoul-meta.json`. If missing, prompts you to input it.
+- Downloads the latest zip package from AISoulHub.
+- Extracts and overwrites the existing configuration files in the workspace.
+- Updates/re-installs the skills defined in the new `aisoul-meta.json`.
+
+## Configuration
+
+The CLI saves a minimal configuration file at `~/.aisoulhub.json` which currently stores your login email to streamline subsequent command executions.
+
+## License
+
+ISC
+
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aisoulhub",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "",
   "main": "index.js",
   "scripts": {
@@ -25,6 +25,7 @@
     "@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

@@ -2,14 +2,14 @@ import { checkOpenclaw, checkLogin } from '../utils/check.js';
 import { getAgents, addAgent } from '../utils/openclaw.js';
 import { downloadAndExtract } 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 path from 'path';
 import os from 'os';
 
 export async function installCommand(aiSoulId) {
   if (!aiSoulId) {
-    console.error(chalk.red('❌ 错误: 必须提供 ai_soul_id，例如: aisoulhub install <ai_soul_id>'));
+    console.error(chalk.red('❌ Error: ai_soul_id is required, e.g.: aisoulhub install <ai_soul_id>'));
     process.exit(1);
   }
 
@@ -22,40 +22,52 @@ export async function installCommand(aiSoulId) {
   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;
 
-  if (agentChoice === 'create_new') {
+  if (agentChoice.name === '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:',
+      validate: (val) => val.trim().length > 0 ? true : 'Agent name cannot be empty'
     });
 
     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 的路径
       const updatedAgents = getAgents();
@@ -72,11 +84,11 @@ 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 downloadSuccess = await downloadAndExtract(aiSoulId, targetPath);
@@ -84,8 +96,8 @@ export async function installCommand(aiSoulId) {
     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 ${aiSoulId} to the Agent.`));
 }

package/src/commands/update.js

@@ -2,7 +2,7 @@ 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 { select, input, confirm } from '@inquirer/prompts';
 import fs from 'fs';
 import path from 'path';
 import chalk from 'chalk';
@@ -17,49 +17,63 @@ export async function updateCommand() {
   try {
     agents = getAgents();
   } catch (err) {
-    console.error(chalk.red(`❌ 获取 agents 列表失败: ${err.message}`));
+    console.error(chalk.red(`❌ Failed to get agents list: ${err.message}`));
     process.exit(1);
   }
 
   if (agents.length === 0) {
-    console.error(chalk.yellow('⚠️ 当前没有可更新的 Agent。请先使用 install 命令安装。'));
+    console.error(chalk.yellow('⚠️ No agents available to update. Please install one first using the install command.'));
     process.exit(1);
   }
 
   // 3. 提示用户选择 Agent
-  const choices = agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: a.path }));
+  const choices = agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: { name: a.name, path: a.path } }));
 
-  const targetPath = await select({
-    message: '请选择要更新的 Agent：',
+  const agentChoice = await select({
+    message: 'Please select the Agent to update:',
     choices
   });
 
+  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);
+    }
+  }
+
+  const targetPath = agentChoice.path;
+
   if (!targetPath || !fs.existsSync(targetPath)) {
-    console.error(chalk.red('❌ 错误: 无效的 Agent 工作目录。'));
+    console.error(chalk.red('❌ Error: Invalid Agent workspace directory.'));
     process.exit(1);
   }
 
   // 4. 确定 ai_soul_id
   let aiSoulId = null;
-  const metaPath = path.join(targetPath, 'meta.json');
+  const metaPath = path.join(targetPath, 'aisoul-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}`));
+        console.log(chalk.blue(`ℹ️ Detected ai_soul_id from aisoul-meta.json: ${aiSoulId}`));
       }
     } catch (e) {
-      console.warn(chalk.yellow('⚠️ 无法解析 meta.json。'));
+      console.warn(chalk.yellow('⚠️ Unable to parse aisoul-meta.json.'));
     }
   }
 
   if (!aiSoulId) {
-    console.log(chalk.yellow('ℹ️ 未能从当前 Agent 的 meta.json 中获取 ai_soul_id。'));
+    console.log(chalk.yellow('ℹ️ Unable to get ai_soul_id from the current Agent\'s aisoul-meta.json.'));
     aiSoulId = await input({
-      message: '请输入需要更新的 ai_soul_id：',
-      validate: (val) => val.trim().length > 0 ? true : 'ai_soul_id 不能为空'
+      message: 'Please enter the ai_soul_id to update:',
+      validate: (val) => val.trim().length > 0 ? true : 'ai_soul_id cannot be empty'
     });
   }
 
@@ -69,8 +83,8 @@ export async function updateCommand() {
     process.exit(1);
   }
 
-  // 6. 解析 meta.json 并更新技能
+  // 6. 解析 aisoul-meta.json 并更新技能
   await processMetaJson(targetPath);
 
-  console.log(chalk.green(`🎉 成功更新 Agent [${aiSoulId}]。`));
+  console.log(chalk.green(`🎉 Successfully updated Agent [${aiSoulId}].`));
 }

package/src/index.js

@@ -16,20 +16,20 @@ export async function main() {
 
   program
     .name('aisoulhub')
-    .description('AISoulHub CLI 命令行工具，用于安装和更新 Agent 技能与配置')
+    .description('AISoulHub CLI tool for installing and updating 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')
+    .argument('<ai_soul_id>', 'Specify the ai_soul_id to install (e.g.: 12345)')
     .action(async (aiSoulId) => {
       await installCommand(aiSoulId);
     });
 
   program
     .command('update')
-    .description('更新已存在的 Agent 配置及技能')
+    .description('Update existing Agent configuration and skills')
     .action(async () => {
       await updateCommand();
     });

package/src/utils/check.js

@@ -7,7 +7,7 @@ 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);
   }
 }
@@ -26,27 +26,27 @@ export async function checkLogin() {
   }
 
   if (!config.email) {
-    console.log(chalk.yellow('ℹ️ 未检测到登录信息，请输入您的邮箱进行登录：'));
+    console.log(chalk.yellow('ℹ️ No login information detected. Please enter your email to login:'));
     const email = await input({ 
-      message: '请输入您的邮箱地址:',
+      message: 'Please enter your email address:',
       validate: (value) => {
         const pass = value.match(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
         if (pass) {
           return true;
         }
-        return '请输入有效的邮箱地址';
+        return 'Please enter a valid email address';
       }
     });
 
     config.email = email;
     try {
       fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
-      console.log(chalk.green(`✅ 登录成功！邮箱: ${email} 已保存。`));
+      console.log(chalk.green(`✅ Login successful! Email: ${email} saved.`));
     } catch (e) {
-      console.log(chalk.yellow(`⚠️ 登录成功，但无法保存到 ${CONFIG_PATH}: ${e.message}`));
+      console.log(chalk.yellow(`⚠️ Login successful, but unable to save to ${CONFIG_PATH}: ${e.message}`));
     }
   } else {
-    console.log(chalk.blue(`ℹ️ 当前登录邮箱: ${config.email}`));
+    console.log(chalk.blue(`ℹ️ Currently logged in as: ${config.email}`));
   }
   
   return config.email;

package/src/utils/download.js

@@ -11,7 +11,7 @@ export async function downloadAndExtract(aiSoulId, targetPath) {
   const tempDir = os.tmpdir();
   const zipPath = path.join(tempDir, `${aiSoulId}.zip`);
 
-  const spinner = ora(`正在下载包 ${aiSoulId}...`).start();
+  const spinner = ora(`Downloading package ${aiSoulId}...`).start();
 
   try {
     const response = await axios({
@@ -30,7 +30,7 @@ export async function downloadAndExtract(aiSoulId, targetPath) {
       writer.on('error', reject);
     });
 
-    spinner.text = `下载完成，正在解压...`;
+    spinner.text = `Download complete, extracting...`;
 
     // Ensure target path exists
     if (!fs.existsSync(targetPath)) {
@@ -42,13 +42,17 @@ export async function downloadAndExtract(aiSoulId, targetPath) {
       .pipe(unzipper.Extract({ path: targetPath }))
       .promise();
 
-    spinner.succeed(chalk.green(`包 ${aiSoulId} 下载并解压成功！`));
+    spinner.succeed(chalk.green(`Package ${aiSoulId} downloaded and extracted successfully.`));
 
     // Cleanup temp zip
     fs.unlinkSync(zipPath);
     return true;
   } catch (err) {
-    spinner.fail(chalk.red(`下载或解压失败: ${err.message}`));
+    if (err.response && err.response.status === 404) {
+      spinner.fail(chalk.red(`Error: Package not found. Please check if the ai_soul_id [${aiSoulId}] is correct.`));
+    } else {
+      spinner.fail(chalk.red(`Error: Failed to download or extract the package: ${err.message}`));
+    }
     if (fs.existsSync(zipPath)) {
       fs.unlinkSync(zipPath);
     }

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,22 @@ 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} 个技能...`));
+    console.log(chalk.cyan(`🔄 Starting installation of ${skills.length} skills...`));
     for (const skill of skills) {
-      console.log(chalk.blue(`⏳ 正在安装技能: ${skill}...`));
-      const success = installSkill(workspacePath, skill);
+      console.log(chalk.blue(`⏳ Installing skill: ${skill}...`));
+      const success = await installSkill(workspacePath, skill);
       if (success) {
-        console.log(chalk.green(`✅ 技能 ${skill} 安装成功。`));
+        console.log(chalk.green(`✅ Skill ${skill} installed successfully.`));
       } else {
-        console.log(chalk.red(`❌ 技能 ${skill} 安装失败。`));
+        console.log(chalk.red(`❌ Failed to install skill ${skill}.`));
       }
     }
-    console.log(chalk.green('🎉 所有技能安装流程结束。'));
+    console.log(chalk.green('🎉 All skills installation processes completed.'));
   } 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,7 +3,7 @@ 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
@@ -45,21 +45,30 @@ 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 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;
 }