clawkittool 0.1.0 → 0.1.1

package/README.md

@@ -8,6 +8,30 @@
 clawkittool get product-kit
 clawkittool get hotnews-kit --dir ./my-clawkit
 clawkittool get product-kit --manifest https://example.com/clawkit/manifest.json
+clawkittool get product-kit --config ~/.openclaw
+clawkittool get product-kit --target-name sandbox
+```
+
+默认行为：
+
+- 下载 `core.zip`
+- 下载指定 kit
+- 自动执行 `npm install`
+- 自动探测本机 OpenClaw 目录并执行 `deploy`
+
+自动探测顺序：
+
+- `--config <path>`
+- `OPENCLAW_HOME`
+- `OPENCLAW_CONFIG_DIR`
+- `OPENCLAW_CONFIG_PATH`
+- `~/.openclaw/openclaw.json`
+- `~/.config/openclaw/openclaw.json`
+
+如果只想下载但不自动部署，可以加：
+
+```bash
+clawkittool get product-kit --skip-deploy
 ```
 
 ## manifest 格式

package/bin/clawkittool.js

@@ -5,7 +5,7 @@ const { installKitFromManifest } = require('../lib/get');
 
 function printUsage() {
   console.log(`Usage:
-  clawkittool get <kit-name> [--dir <path>] [--manifest <url-or-path>] [--force] [--skip-install]
+  clawkittool get <kit-name> [--dir <path>] [--manifest <url-or-path>] [--config <path>] [--target-name <name>] [--force] [--skip-install] [--skip-deploy]
 `);
 }
 
@@ -29,6 +29,9 @@ async function main(argv) {
   let manifestSource = process.env.CLAWKIT_MANIFEST_URL || null;
   let force = false;
   let skipInstall = false;
+  let skipDeploy = false;
+  let explicitConfigPath = null;
+  let targetName = null;
 
   for (let index = 0; index < rest.length; index += 1) {
     const arg = rest[index];
@@ -45,6 +48,18 @@ async function main(argv) {
       continue;
     }
 
+    if (arg === '--config') {
+      explicitConfigPath = rest[index + 1] || null;
+      index += 1;
+      continue;
+    }
+
+    if (arg === '--target-name') {
+      targetName = rest[index + 1] || null;
+      index += 1;
+      continue;
+    }
+
     if (arg === '--force') {
       force = true;
       continue;
@@ -55,6 +70,11 @@ async function main(argv) {
       continue;
     }
 
+    if (arg === '--skip-deploy') {
+      skipDeploy = true;
+      continue;
+    }
+
     throw new Error(`Unknown argument: ${arg}`);
   }
 
@@ -68,9 +88,19 @@ async function main(argv) {
     manifestSource,
     force,
     skipInstall,
+    explicitConfigPath,
+    skipDeploy,
+    targetName,
   });
 
   console.log(`Installed ${result.kitName} into ${result.targetDir}`);
+  if (result.deployed) {
+    console.log(`Deployed ${result.kitName} to ${result.detectedConfigPath}`);
+  } else if (result.detectedConfigPath) {
+    console.log(`Detected OpenClaw config at ${result.detectedConfigPath}, but deployment was skipped.`);
+  } else {
+    console.log('No OpenClaw config detected. Pass --config to deploy automatically.');
+  }
 }
 
 main(process.argv.slice(2)).catch((error) => {

package/lib/get.js

@@ -7,6 +7,70 @@ function ensureDir(dirPath) {
   fs.mkdirSync(dirPath, { recursive: true });
 }
 
+function resolveOpenClawConfigFile(candidatePath) {
+  if (!candidatePath) {
+    return null;
+  }
+
+  const resolvedPath = path.resolve(candidatePath);
+  if (!fs.existsSync(resolvedPath)) {
+    return null;
+  }
+
+  const stats = fs.statSync(resolvedPath);
+  if (stats.isDirectory()) {
+    const configPath = path.join(resolvedPath, 'openclaw.json');
+    return fs.existsSync(configPath) ? configPath : null;
+  }
+
+  return path.basename(resolvedPath) === 'openclaw.json' ? resolvedPath : null;
+}
+
+function detectOpenClawConfigPath({
+  explicitConfigPath = null,
+  env = process.env,
+  homeDir = os.homedir(),
+  platform = process.platform,
+} = {}) {
+  const explicitMatch = resolveOpenClawConfigFile(explicitConfigPath);
+  if (explicitMatch) {
+    return explicitMatch;
+  }
+
+  const envCandidates = [
+    env.OPENCLAW_HOME,
+    env.OPENCLAW_CONFIG_DIR,
+    env.OPENCLAW_CONFIG_PATH,
+  ];
+
+  for (const candidate of envCandidates) {
+    const envMatch = resolveOpenClawConfigFile(candidate);
+    if (envMatch) {
+      return envMatch;
+    }
+  }
+
+  const defaultCandidates =
+    platform === 'win32'
+      ? [
+          path.join(homeDir, '.openclaw'),
+          env.APPDATA ? path.join(env.APPDATA, 'openclaw') : null,
+        ]
+      : [
+          path.join(homeDir, '.openclaw'),
+          path.join(homeDir, '.config', 'openclaw'),
+        ];
+
+  for (const candidate of defaultCandidates) {
+    const defaultMatch = resolveOpenClawConfigFile(candidate);
+    if (defaultMatch) {
+      return defaultMatch;
+    }
+  }
+
+  return null;
+}
+
 function makeTempDir() {
   return fs.mkdtempSync(path.join(os.tmpdir(), 'clawkittool-'));
 }
@@ -184,12 +248,40 @@ function runInstall(targetDir) {
   }
 }
 
+function runDeploy({ targetDir, kitName, configPath, targetName = null, force = false }) {
+  const nodeCommand = process.execPath;
+  const deployArgs = [path.join(targetDir, 'cli', 'index.js'), 'deploy', kitName, '--config', configPath, '--apply'];
+
+  if (targetName) {
+    deployArgs.push('--target-name', targetName);
+  }
+
+  if (force) {
+    deployArgs.push('--force');
+  }
+
+  const result = spawnSync(nodeCommand, deployArgs, {
+    cwd: targetDir,
+    stdio: 'inherit',
+  });
+
+  if (result.status !== 0) {
+    throw new Error(`clawkit deploy failed for ${kitName}`);
+  }
+}
+
 async function installKitFromManifest({
   kitName,
   targetDir,
   manifestSource,
   force = false,
   skipInstall = false,
+  explicitConfigPath = null,
+  skipDeploy = false,
+  targetName = null,
+  env = process.env,
+  homeDir = os.homedir(),
+  deployRunner = runDeploy,
 }) {
   const manifest = await loadManifest(manifestSource);
   const kitEntry = manifest.kits[kitName];
@@ -205,6 +297,11 @@ async function installKitFromManifest({
   const coreExtractDir = path.join(tempDir, 'core');
   const kitZipPath = path.join(tempDir, `${kitName}.zip`);
   const kitExtractDir = path.join(tempDir, kitName);
+  const detectedConfigPath = detectOpenClawConfigPath({
+    explicitConfigPath,
+    env,
+    homeDir,
+  });
 
   try {
     await downloadFile(manifest.core.url, coreZipPath);
@@ -219,9 +316,23 @@ async function installKitFromManifest({
       runInstall(targetDir);
     }
 
+    let deployed = false;
+    if (!skipDeploy && detectedConfigPath) {
+      deployRunner({
+        targetDir,
+        kitName,
+        configPath: detectedConfigPath,
+        targetName,
+        force,
+      });
+      deployed = true;
+    }
+
     return {
       kitName,
       targetDir,
+      detectedConfigPath,
+      deployed,
     };
   } finally {
     fs.rmSync(tempDir, { recursive: true, force: true });
@@ -229,6 +340,7 @@ async function installKitFromManifest({
 }
 
 module.exports = {
+  detectOpenClawConfigPath,
   installKitFromManifest,
   loadManifest,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawkittool",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "On-demand installer for OpenClaw ClawKit workflow kits",
   "bin": {
     "clawkittool": "./bin/clawkittool.js"
@@ -12,6 +12,6 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   }
 }