@analytix402/openclaw-skill 0.1.6 → 0.2.0

package/SKILL.md

@@ -14,9 +14,19 @@ Analytix402 gives your OpenClaw agent financial visibility and guardrails. Track
 - Sends heartbeats so you know your agent is alive and healthy
 - Provides a real-time dashboard at analytix402.com
 
+## Quick Start
+
+After installing, run the setup wizard:
+
+```bash
+npx @analytix402/openclaw-skill init
+```
+
+It will ask for your API key, validate it, and write your `.env` file.
+
 ## Configuration
 
-Add these to your OpenClaw agent's `.env` file:
+Or add these to your OpenClaw agent's `.env` file manually:
 
 ```yaml
 # Required

package/dist/index.js

@@ -47,7 +47,7 @@ function getClient() {
   if (!client) {
     if (!API_KEY) {
       throw new Error(
-        "ANALYTIX402_API_KEY is not set. Add it to your OpenClaw skill config."
+        'ANALYTIX402_API_KEY is not set. Run "npx @analytix402/openclaw-skill init" to configure.'
       );
     }
     client = (0, import_sdk.createClient)({
@@ -67,12 +67,13 @@ if (API_KEY) {
   } catch (err) {
     console.warn("[Analytix402] Failed to connect on startup:", err instanceof Error ? err.message : err);
   }
+} else {
+  console.warn('[Analytix402] No API key found. Run "npx @analytix402/openclaw-skill init" to set up.');
 }
 async function apiRequest(method, path, body) {
   const url = `${BASE_URL}/api${path}`;
   const headers = {
     "Content-Type": "application/json",
-    "Authorization": `Bearer ${API_KEY}`,
     "X-API-Key": API_KEY
   };
   const opts = { method, headers };

package/dist/index.mjs

@@ -16,7 +16,7 @@ function getClient() {
   if (!client) {
     if (!API_KEY) {
       throw new Error(
-        "ANALYTIX402_API_KEY is not set. Add it to your OpenClaw skill config."
+        'ANALYTIX402_API_KEY is not set. Run "npx @analytix402/openclaw-skill init" to configure.'
       );
     }
     client = createClient({
@@ -36,12 +36,13 @@ if (API_KEY) {
   } catch (err) {
     console.warn("[Analytix402] Failed to connect on startup:", err instanceof Error ? err.message : err);
   }
+} else {
+  console.warn('[Analytix402] No API key found. Run "npx @analytix402/openclaw-skill init" to set up.');
 }
 async function apiRequest(method, path, body) {
   const url = `${BASE_URL}/api${path}`;
   const headers = {
     "Content-Type": "application/json",
-    "Authorization": `Bearer ${API_KEY}`,
     "X-API-Key": API_KEY
   };
   const opts = { method, headers };

package/dist/setup.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/setup.ts
+var readline = __toESM(require("readline"));
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+function ask(question, fallback = "") {
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      resolve2(answer.trim() || fallback);
+    });
+  });
+}
+async function validateKey(apiKey, baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/api/agents/overview`, {
+      headers: { "X-API-Key": apiKey }
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+async function main() {
+  console.log("\n  Analytix402 \u2014 Setup\n");
+  const apiKey = await ask("  API key (ax_live_... or ax_test_...): ");
+  if (!apiKey) {
+    console.log("\n  No API key provided. Exiting.\n");
+    rl.close();
+    process.exit(1);
+  }
+  if (!apiKey.startsWith("ax_live_") && !apiKey.startsWith("ax_test_")) {
+    console.log("  Warning: key should start with ax_live_ or ax_test_\n");
+  }
+  const agentName = await ask("  Agent display name [OpenClaw Agent]: ", "OpenClaw Agent");
+  const dailyBudget = await ask("  Daily budget in USD (0 = unlimited) [0]: ", "0");
+  const baseUrl = await ask("  API endpoint [https://analytix402.com]: ", "https://analytix402.com");
+  rl.close();
+  console.log("\n  Validating API key...");
+  const valid = await validateKey(apiKey, baseUrl.replace(/\/$/, ""));
+  if (valid) {
+    console.log("  Connected successfully.\n");
+  } else {
+    console.log("  Could not reach the dashboard \u2014 the key may still be correct.");
+    console.log("  (The server might be starting up or unreachable right now.)\n");
+  }
+  const envPath = path.resolve(process.cwd(), ".env");
+  const lines = [];
+  if (fs.existsSync(envPath)) {
+    const existing = fs.readFileSync(envPath, "utf-8");
+    for (const line of existing.split("\n")) {
+      if (!line.startsWith("ANALYTIX402_")) {
+        lines.push(line);
+      }
+    }
+    while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
+      lines.pop();
+    }
+    if (lines.length > 0) {
+      lines.push("");
+    }
+  }
+  lines.push(`ANALYTIX402_API_KEY=${apiKey}`);
+  if (agentName !== "OpenClaw Agent") {
+    lines.push(`ANALYTIX402_AGENT_NAME=${agentName}`);
+  }
+  if (dailyBudget !== "0") {
+    lines.push(`ANALYTIX402_DAILY_BUDGET=${dailyBudget}`);
+  }
+  if (baseUrl !== "https://analytix402.com") {
+    lines.push(`ANALYTIX402_BASE_URL=${baseUrl}`);
+  }
+  lines.push("");
+  fs.writeFileSync(envPath, lines.join("\n"), "utf-8");
+  console.log(`  Wrote config to ${envPath}`);
+  console.log("  You're all set. The skill will connect automatically on next start.\n");
+}
+main().catch((err) => {
+  console.error("Setup failed:", err);
+  process.exit(1);
+});

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@analytix402/openclaw-skill",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "Analytix402 skill for OpenClaw — monitor, control, and optimize your AI agent's spend",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "bin": {
+    "openclaw-skill": "./dist/setup.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -13,10 +16,13 @@
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsup src/index.ts --format cjs,esm --dts && tsup src/setup.ts --format cjs --no-dts --outDir dist",
+    "build:index": "tsup src/index.ts --format cjs,esm --dts",
+    "build:setup": "tsup src/setup.ts --format cjs --no-dts --outDir dist",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "postinstall": "echo \"\n  Run 'npx @analytix402/openclaw-skill init' to configure your API key.\n\"",
+    "prepublishOnly": "npm run build:index && npm run build:setup"
   },
   "openclaw": {
     "tools": {