#!/usr/bin/env node /** * OpenClaw VOC Skills 一键部署脚本 * * 功能:将 skills 文件夹中的所有技能部署到 OpenClaw 的 skills 目录 * 兼容:Windows / macOS / Linux * 依赖:仅需 Node.js(OpenClaw 已自带) * * 使用方法: * node install.js # 部署所有技能 * node install.js --list # 仅列出技能,不部署 * node install.js --only a,b,c # 仅部署指定技能 * node install.js --skip a,b,c # 跳过指定技能 * node install.js --target /path # 指定目标目录(默认 ~/.openclaw/skills) * node install.js --clean # 部署前清空目标目录 * node install.js --dry-run # 预览模式,不实际写入 */ const fs = require('fs'); const path = require('path'); const os = require('os'); // ============================================ // 配置 // ============================================ const VERSION = '1.0.0'; const SKILLS_SUBDIR = 'skills'; // zip 包内的技能目录名 // ============================================ // 参数解析 // ============================================ function parseArgs() { const args = process.argv.slice(2); const opts = { list: false, only: [], skip: [], target: '', clean: false, dryRun: false, help: false }; for (let i = 0; i < args.length; i++) { switch (args[i]) { case '--list': case '-l': opts.list = true; break; case '--only': opts.only = (args[++i] || '').split(',').filter(Boolean); break; case '--skip': opts.skip = (args[++i] || '').split(',').filter(Boolean); break; case '--target': case '-t': opts.target = args[++i] || ''; break; case '--clean': opts.clean = true; break; case '--dry-run': opts.dryRun = true; break; case '--help': case '-h': opts.help = true; break; } } return opts; } // ============================================ // 工具函数 // ============================================ function getOpenClawSkillsDir() { const home = os.homedir(); return path.join(home, '.openclaw', 'skills'); } function ensureDir(dir) { if (!fs.existsSync(dir)) { fs.mkdirSync(dir, { recursive: true }); } } function copyFileSync(src, dest) { ensureDir(path.dirname(dest)); fs.copyFileSync(src, dest); } function removeDir(dir) { if (fs.existsSync(dir)) { fs.rmSync(dir, { recursive: true, force: true }); } } function getFileSize(filePath) { try { return fs.statSync(filePath).size; } catch { return 0; } } function formatSize(bytes) { if (bytes < 1024) return bytes + ' B'; if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1) + ' KB'; return (bytes / 1024 / 1024).toFixed(1) + ' MB'; } // ============================================ // 核心逻辑 // ============================================ function discoverSkills(sourceDir) { if (!fs.existsSync(sourceDir)) { return []; } return fs.readdirSync(sourceDir) .filter(name => { const fullPath = path.join(sourceDir, name); return fs.statSync(fullPath).isDirectory() && fs.existsSync(path.join(fullPath, 'SKILL.md')); }) .map(name => { const skillDir = path.join(sourceDir, name); const files = []; let totalSize = 0; for (const fileName of fs.readdirSync(skillDir)) { const filePath = path.join(skillDir, fileName); if (fs.statSync(filePath).isFile()) { const size = getFileSize(filePath); files.push({ name: fileName, path: filePath, size }); totalSize += size; } } return { name, dir: skillDir, files, totalSize }; }) .sort((a, b) => a.name.localeCompare(b.name)); } function filterSkills(skills, opts) { let filtered = skills; if (opts.only.length > 0) { filtered = filtered.filter(s => opts.only.includes(s.name)); } if (opts.skip.length > 0) { filtered = filtered.filter(s => !opts.skip.includes(s.name)); } return filtered; } function showHelp() { console.log(` OpenClaw VOC Skills Installer v${VERSION} Usage: node install.js [options] Options: --list, -l List available skills without installing --only a,b,c Install only specified skills --skip a,b,c Skip specified skills --target, -t PATH Custom target directory (default: ~/.openclaw/skills) --clean Remove existing skills before installing --dry-run Preview what would be installed --help, -h Show this help Examples: node install.js # Install all skills node install.js --list # List skills node install.js --only tiktok-video-search # Install one skill node install.js --skip test-billing,test-skill # Skip test skills node install.js --target ./my-skills # Custom directory `); } function listSkills(skills) { console.log(`\n Found ${skills.length} skills:\n`); let totalSize = 0; let totalFiles = 0; for (const skill of skills) { const fileNames = skill.files.map(f => f.name).join(', '); console.log(` ${skill.name.padEnd(35)} ${formatSize(skill.totalSize).padStart(8)} [${fileNames}]`); totalSize += skill.totalSize; totalFiles += skill.files.length; } console.log(`\n Total: ${skills.length} skills, ${totalFiles} files, ${formatSize(totalSize)}\n`); } function installSkills(skills, targetDir, opts) { const prefix = opts.dryRun ? '[DRY-RUN] ' : ''; console.log(`\n${prefix}Installing ${skills.length} skills to:`); console.log(` ${targetDir}\n`); if (opts.clean && !opts.dryRun) { console.log(`${prefix}Cleaning target directory...`); for (const skill of skills) { const dest = path.join(targetDir, skill.name); if (fs.existsSync(dest)) { removeDir(dest); } } } let installed = 0; let skipped = 0; let errors = 0; for (const skill of skills) { const destDir = path.join(targetDir, skill.name); try { if (!opts.dryRun) { ensureDir(destDir); } for (const file of skill.files) { const destFile = path.join(destDir, file.name); // Check if file already exists and is identical if (fs.existsSync(destFile)) { const existingContent = fs.readFileSync(destFile); const newContent = fs.readFileSync(file.path); if (existingContent.equals(newContent)) { skipped++; continue; } } if (!opts.dryRun) { copyFileSync(file.path, destFile); } installed++; } process.stdout.write(` ✅ ${skill.name}\n`); } catch (err) { process.stdout.write(` ❌ ${skill.name}: ${err.message}\n`); errors++; } } console.log(`\n${'─'.repeat(50)}`); console.log(`${prefix}Done!`); console.log(` Installed: ${installed} files`); console.log(` Unchanged: ${skipped} files`); if (errors > 0) console.log(` Errors: ${errors}`); console.log(` Target: ${targetDir}`); console.log(''); if (!opts.dryRun && errors === 0) { console.log(' Skills are ready. Restart OpenClaw gateway to load them.'); console.log(''); } } // ============================================ // 主入口 // ============================================ function main() { const opts = parseArgs(); if (opts.help) { showHelp(); return; } console.log(''); console.log(' ╔══════════════════════════════════════════════╗'); console.log(` ║ OpenClaw VOC Skills Installer v${VERSION} ║`); console.log(' ╚══════════════════════════════════════════════╝'); // Determine source directory (skills/ next to this script) const scriptDir = __dirname; const sourceDir = path.join(scriptDir, SKILLS_SUBDIR); if (!fs.existsSync(sourceDir)) { console.error(`\n ❌ Skills directory not found: ${sourceDir}`); console.error(' Make sure the "skills" folder is in the same directory as this script.\n'); process.exit(1); } // Discover skills const allSkills = discoverSkills(sourceDir); if (allSkills.length === 0) { console.error(`\n ❌ No skills found in: ${sourceDir}\n`); process.exit(1); } // Filter const skills = filterSkills(allSkills, opts); if (opts.list) { listSkills(skills); return; } if (skills.length === 0) { console.log('\n No skills matched the filter.\n'); return; } // Target directory const targetDir = opts.target || getOpenClawSkillsDir(); // Pre-flight check const openclawDir = path.join(os.homedir(), '.openclaw'); if (!opts.target && !fs.existsSync(openclawDir)) { console.error(`\n ⚠️ OpenClaw directory not found: ${openclawDir}`); console.error(' Is OpenClaw installed? You can specify a custom target with --target PATH\n'); process.exit(1); } listSkills(skills); installSkills(skills, targetDir, opts); } main();