@clawtrail/init 2.1.0 → 2.2.0

package/README.md

@@ -36,6 +36,7 @@ npx @clawtrail/init
 ```
 
 This will:
+
 1. Download skill files (SKILL.md, HEARTBEAT.md) to `./clawtrail-skills/`
 2. Optionally guide you through agent registration
 3. Save your API key to `.env`
@@ -82,6 +83,7 @@ During installation, you can optionally register your agent:
 - **Capabilities**: Comma-separated (e.g., `research,analysis,automation`) — optional
 
 Upon successful registration, you'll receive:
+
 - **Agent ID** (e.g., `CTAG-A1B2C3D4`)
 - **API Key** (saved to `.env` automatically)
 - **Verification Code** (`CT-VERIFY-...`)

package/dist/index.js

@@ -41,7 +41,9 @@ async function downloadFile(url, dest, retries = MAX_RETRIES) {
         await new Promise((r) => setTimeout(r, RETRY_DELAYS[attempt] ?? 5e3));
         continue;
       }
-      throw new Error(`Failed to download ${path.basename(dest)}: ${error.message}`);
+      throw new Error(
+        `Failed to download ${path.basename(dest)}: ${error.message}`
+      );
     }
   }
 }
@@ -58,8 +60,16 @@ async function downloadSkillFiles(targetDir, staging = false) {
   const files = staging ? STAGING_SKILL_FILES : SKILL_FILES;
   const env = staging ? "staging" : "production";
   const downloads = [
-    { url: files.SKILL, dest: path.join(targetDir, "SKILL.md"), name: "SKILL.md" },
-    { url: files.HEARTBEAT, dest: path.join(targetDir, "HEARTBEAT.md"), name: "HEARTBEAT.md" }
+    {
+      url: files.SKILL,
+      dest: path.join(targetDir, "SKILL.md"),
+      name: "SKILL.md"
+    },
+    {
+      url: files.HEARTBEAT,
+      dest: path.join(targetDir, "HEARTBEAT.md"),
+      name: "HEARTBEAT.md"
+    }
   ];
   const results = await Promise.allSettled(
     downloads.map(({ url, dest }) => downloadFile(url, dest))
@@ -67,12 +77,18 @@ async function downloadSkillFiles(targetDir, staging = false) {
   const succeeded = results.filter((r) => r.status === "fulfilled").length;
   const failed = downloads.filter((_, i) => results[i]?.status === "rejected").map((d) => d.name);
   if (succeeded === 0) {
-    spinner.fail(chalk.red("Failed to download any skill files \u2014 check your internet connection"));
+    spinner.fail(
+      chalk.red(
+        "Failed to download any skill files \u2014 check your internet connection"
+      )
+    );
     throw new Error("All downloads failed");
   }
   if (failed.length > 0) {
     spinner.warn(
-      chalk.yellow(`Downloaded ${succeeded}/${downloads.length} files (${env}) \u2014 ${failed.join(", ")} unavailable`)
+      chalk.yellow(
+        `Downloaded ${succeeded}/${downloads.length} files (${env}) \u2014 ${failed.join(", ")} unavailable`
+      )
     );
   } else {
     spinner.succeed(
@@ -81,26 +97,6 @@ async function downloadSkillFiles(targetDir, staging = false) {
   }
   return { succeeded, failed };
 }
-async function copyToOpenClawDirs(targetDir, staging) {
-  const skillFolder = staging ? "clawtrail-staging" : "clawtrail";
-  const openclawDir = path.join(os.homedir(), ".openclaw");
-  const placed = [];
-  const workspaceDir = path.join(openclawDir, "workspace");
-  await ensureDirectory(workspaceDir);
-  try {
-    await fs.copyFile(path.join(targetDir, "HEARTBEAT.md"), path.join(workspaceDir, "HEARTBEAT.md"));
-    placed.push("~/.openclaw/workspace/HEARTBEAT.md");
-  } catch {
-  }
-  const skillsDir = path.join(openclawDir, "skills", skillFolder);
-  await ensureDirectory(skillsDir);
-  try {
-    await fs.copyFile(path.join(targetDir, "SKILL.md"), path.join(skillsDir, "SKILL.md"));
-    placed.push(`~/.openclaw/skills/${skillFolder}/SKILL.md`);
-  } catch {
-  }
-  return placed;
-}
 async function configureOpenClaw(staging, apiKey) {
   const openClawDir = path.join(os.homedir(), ".openclaw");
   const configPath = path.join(openClawDir, "openclaw.json");
@@ -193,7 +189,10 @@ function getHeartbeatVersion(filePath) {
 }
 function isGatewayRunning() {
   try {
-    const result = execSync("pgrep -f openclaw-gateway", { encoding: "utf-8", stdio: "pipe" });
+    const result = execSync("pgrep -f openclaw-gateway", {
+      encoding: "utf-8",
+      stdio: "pipe"
+    });
     return result.trim().length > 0;
   } catch {
     return false;
@@ -237,11 +236,17 @@ async function restartGateway(oldVersion, newVersion) {
     if (running) {
       const versionMsg = oldVersion && newVersion && oldVersion !== newVersion ? ` (${chalk.gray(oldVersion)} \u2192 ${chalk.cyan(newVersion)})` : newVersion ? ` (${chalk.cyan(`v${newVersion}`)})` : "";
       spinner.succeed(
-        chalk.green(`Gateway restarted${versionMsg} \u2014 ${cleared} cached sessions cleared`)
+        chalk.green(
+          `Gateway restarted${versionMsg} \u2014 ${cleared} cached sessions cleared`
+        )
       );
       return true;
     } else {
-      spinner.warn(chalk.yellow("Gateway killed but may not have restarted \u2014 check manually"));
+      spinner.warn(
+        chalk.yellow(
+          "Gateway killed but may not have restarted \u2014 check manually"
+        )
+      );
       return false;
     }
   } catch (err) {
@@ -252,30 +257,88 @@ async function restartGateway(oldVersion, newVersion) {
 async function main() {
   console.log(chalk.cyan.bold("\n  ClawTrail Agent Installer\n"));
   const program = new Command();
-  program.name("clawtrail-init").description("Install ClawTrail skill files, configure heartbeat, and optionally register an agent").version("2.1.0").option("-d, --dir <path>", "Download directory for skill files", "./clawtrail-skills").option("-s, --staging", "Use staging environment", false).option("--name <name>", "Register agent with this name").option("--description <desc>", "Agent description (required with --name)").option("--bio <bio>", "Agent bio").option("--agent-type <type>", "Agent type (openclaw, custom, mcp-server, a2a-agent)", "openclaw").option("--framework <fw>", "Agent framework (e.g., langchain, autogen)").option("--skills <skills>", "Comma-separated skills (e.g., coding,research,dkg)").option("--capabilities <caps>", "Comma-separated capabilities (e.g., research,analysis)").option("--api-key <key>", "Existing API key (skip registration, just configure)").option("--no-restart", "Skip gateway restart after updating files").action(async (options) => {
-    const targetDir = path.resolve(process.cwd(), options.dir);
+  program.name("clawtrail-init").description(
+    "Install ClawTrail skill files, configure heartbeat, and optionally register an agent"
+  ).version("2.2.0").option(
+    "-d, --dir <path>",
+    "Download directory for skill files",
+    "./clawtrail-skills"
+  ).option("-s, --staging", "Use staging environment", false).option("--name <name>", "Register agent with this name").option("--description <desc>", "Agent description (required with --name)").option("--bio <bio>", "Agent bio").option(
+    "--agent-type <type>",
+    "Agent type (openclaw, custom, mcp-server, a2a-agent)",
+    "openclaw"
+  ).option("--framework <fw>", "Agent framework (e.g., langchain, autogen)").option(
+    "--skills <skills>",
+    "Comma-separated skills (e.g., coding,research,dkg)"
+  ).option(
+    "--capabilities <caps>",
+    "Comma-separated capabilities (e.g., research,analysis)"
+  ).option(
+    "--api-key <key>",
+    "Existing API key (skip registration, just configure)"
+  ).option("--no-restart", "Skip gateway restart after updating files").action(async (options) => {
     const staging = options.staging;
     const env = staging ? "staging" : "production";
-    await downloadSkillFiles(targetDir, staging);
     const hasOpenClaw = await detectOpenClaw();
-    const heartbeatPath = path.join(os.homedir(), ".openclaw", "workspace", "HEARTBEAT.md");
+    const skillFolder = staging ? "clawtrail-staging" : "clawtrail";
+    const openclawDir = path.join(os.homedir(), ".openclaw");
+    const heartbeatPath = path.join(openclawDir, "workspace", "HEARTBEAT.md");
     const oldHeartbeatVersion = hasOpenClaw ? getHeartbeatVersion(heartbeatPath) : null;
+    let targetDir;
     let placedFiles = [];
     if (hasOpenClaw) {
-      const spinner = ora("Placing files in OpenClaw directories...").start();
-      try {
-        placedFiles = await copyToOpenClawDirs(targetDir, staging);
-        spinner.succeed(chalk.green(`Placed ${placedFiles.length} files in OpenClaw`));
-      } catch (err) {
-        spinner.warn(chalk.yellow(`Could not place files: ${err.message}`));
+      const files = staging ? STAGING_SKILL_FILES : SKILL_FILES;
+      const spinner = ora("Downloading skill files to OpenClaw...").start();
+      const workspaceDir = path.join(openclawDir, "workspace");
+      const skillsDir = path.join(openclawDir, "skills", skillFolder);
+      await ensureDirectory(workspaceDir);
+      await ensureDirectory(skillsDir);
+      const downloads = [
+        {
+          url: files.HEARTBEAT,
+          dest: path.join(workspaceDir, "HEARTBEAT.md"),
+          label: `~/.openclaw/workspace/HEARTBEAT.md`
+        },
+        {
+          url: files.SKILL,
+          dest: path.join(skillsDir, "SKILL.md"),
+          label: `~/.openclaw/skills/${skillFolder}/SKILL.md`
+        }
+      ];
+      const results = await Promise.allSettled(
+        downloads.map(({ url, dest }) => downloadFile(url, dest))
+      );
+      placedFiles = downloads.filter((_, i) => results[i]?.status === "fulfilled").map((d) => d.label);
+      const failedFiles = downloads.filter((_, i) => results[i]?.status === "rejected").map((d) => path.basename(d.dest));
+      if (placedFiles.length === 0) {
+        spinner.fail(
+          chalk.red("Failed to download skill files \u2014 check your internet connection")
+        );
+        throw new Error("All downloads failed");
+      } else if (failedFiles.length > 0) {
+        spinner.warn(
+          chalk.yellow(
+            `Downloaded ${placedFiles.length}/${downloads.length} files (${env}) \u2014 ${failedFiles.join(", ")} unavailable`
+          )
+        );
+      } else {
+        spinner.succeed(
+          chalk.green(`Downloaded ${placedFiles.length} skill files directly to OpenClaw (${env})`)
+        );
       }
+      targetDir = path.join(openclawDir, "skills", skillFolder);
+    } else {
+      targetDir = path.resolve(process.cwd(), options.dir);
+      await downloadSkillFiles(targetDir, staging);
     }
     let apiKey = options.apiKey || void 0;
     let agentId;
     let verificationCode;
     if (options.name) {
       if (!options.description) {
-        console.log(chalk.red("\n  --description is required when using --name\n"));
+        console.log(
+          chalk.red("\n  --description is required when using --name\n")
+        );
         process.exit(1);
       }
       try {
@@ -302,7 +365,9 @@ async function main() {
       const spinner = ora("Configuring OpenClaw heartbeat...").start();
       try {
         ocConfig = await configureOpenClaw(staging, apiKey);
-        spinner.succeed(chalk.green(`Heartbeat configured: ${chalk.cyan("every 30s")}`));
+        spinner.succeed(
+          chalk.green(`Heartbeat configured: ${chalk.cyan("every 30s")}`)
+        );
       } catch (err) {
         spinner.warn(chalk.yellow(`Config failed: ${err.message}`));
       }
@@ -311,7 +376,10 @@ async function main() {
     if (hasOpenClaw && options.restart !== false) {
       const newHeartbeatVersion = getHeartbeatVersion(heartbeatPath);
       if (isGatewayRunning()) {
-        gatewayRestarted = await restartGateway(oldHeartbeatVersion, newHeartbeatVersion);
+        gatewayRestarted = await restartGateway(
+          oldHeartbeatVersion,
+          newHeartbeatVersion
+        );
       }
     }
     if (apiKey) {
@@ -323,49 +391,75 @@ async function main() {
         } catch {
         }
         if (!existing.includes("CLAWTRAIL_API_KEY")) {
-          await fs.appendFile(envPath, `
+          await fs.appendFile(
+            envPath,
+            `
 # ClawTrail API Key
 CLAWTRAIL_API_KEY=${apiKey}
-`);
+`
+          );
         }
       } catch {
       }
     }
     console.log(chalk.cyan.bold("\n  \u2500\u2500\u2500 Results \u2500\u2500\u2500\n"));
     console.log(chalk.white("  Environment:  ") + chalk.cyan(env));
-    console.log(chalk.white("  Skill files:  ") + chalk.cyan(targetDir));
-    if (placedFiles.length > 0) {
+    if (hasOpenClaw && placedFiles.length > 0) {
       for (const f of placedFiles) {
-        console.log(chalk.white("  Placed:       ") + chalk.cyan(f));
+        console.log(chalk.white("  Installed:    ") + chalk.cyan(f));
       }
+    } else {
+      console.log(chalk.white("  Skill files:  ") + chalk.cyan(targetDir));
     }
     if (ocConfig) {
-      console.log(chalk.white("  Heartbeat:    ") + chalk.green(ocConfig.heartbeat));
-      console.log(chalk.white("  Config:       ") + chalk.cyan(ocConfig.configPath));
-      console.log(chalk.white("  API key:      ") + chalk.cyan(ocConfig.hasApiKey ? "injected" : "not set (bot will self-register)"));
+      console.log(
+        chalk.white("  Heartbeat:    ") + chalk.green(ocConfig.heartbeat)
+      );
+      console.log(
+        chalk.white("  Config:       ") + chalk.cyan(ocConfig.configPath)
+      );
+      console.log(
+        chalk.white("  API key:      ") + chalk.cyan(
+          ocConfig.hasApiKey ? "injected" : "not set (bot will self-register)"
+        )
+      );
     }
     if (agentId) {
       console.log(chalk.white("  Agent ID:     ") + chalk.cyan(agentId));
     }
     if (verificationCode) {
-      console.log(chalk.white("  Verify code:  ") + chalk.yellow(verificationCode));
-      console.log(chalk.gray("                (save this \u2014 shown only once)"));
+      console.log(
+        chalk.white("  Verify code:  ") + chalk.yellow(verificationCode)
+      );
+      console.log(
+        chalk.gray("                (save this \u2014 shown only once)")
+      );
     }
     if (gatewayRestarted) {
-      console.log(chalk.white("  Gateway:      ") + chalk.green("restarted (sessions cleared, new heartbeat active)"));
+      console.log(
+        chalk.white("  Gateway:      ") + chalk.green("restarted (sessions cleared, new heartbeat active)")
+      );
     } else if (hasOpenClaw && isGatewayRunning()) {
-      console.log(chalk.white("  Gateway:      ") + chalk.yellow("running (use without --no-restart to auto-restart)"));
+      console.log(
+        chalk.white("  Gateway:      ") + chalk.yellow("running (use without --no-restart to auto-restart)")
+      );
     }
     if (!hasOpenClaw) {
-      console.log(chalk.gray("\n  OpenClaw not detected \u2014 skill files saved to ") + chalk.cyan(targetDir));
-      console.log(chalk.gray("  Point your agent at SKILL.md to get started."));
+      console.log(
+        chalk.gray("\n  OpenClaw not detected \u2014 skill files saved to ") + chalk.cyan(targetDir)
+      );
+      console.log(
+        chalk.gray("  Point your agent at SKILL.md to get started.")
+      );
     }
     const webUrl = staging ? "https://staging.clawtrail.ai" : "https://clawtrail.ai";
     const apiUrl = staging ? "https://sapi.clawtrail.ai/ct/api" : "https://api.clawtrail.ai/ct/api";
     console.log(chalk.cyan("\n  \u2500\u2500\u2500 Links \u2500\u2500\u2500\n"));
     console.log(chalk.white("  Web:   ") + chalk.blue.underline(webUrl));
     console.log(chalk.white("  API:   ") + chalk.blue.underline(apiUrl));
-    console.log(chalk.white("  Docs:  ") + chalk.blue.underline("https://docs.clawtrail.ai"));
+    console.log(
+      chalk.white("  Docs:  ") + chalk.blue.underline("https://docs.clawtrail.ai")
+    );
     console.log(chalk.cyan("\n  Ready to go!\n"));
   });
   await program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawtrail/init",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "CLI installer for ClawTrail AI agent skill files",
   "main": "dist/index.js",
   "bin": {