@clawcard/cli 0.1.0

package/bin/setup.mjs

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+const OPENCLAW_DIR = join(homedir(), ".openclaw");
+const SKILLS_DIR = join(OPENCLAW_DIR, "skills", "clawcard");
+const CONFIG_PATH = join(OPENCLAW_DIR, "openclaw.json");
+const SKILL_PATH = join(SKILLS_DIR, "SKILL.md");
+
+const DEFAULT_BASE_URL = "https://clawcard.sh";
+
+const SKILL_MD = `---
+name: clawcard
+description: Email, SMS, virtual cards, and credential vault for autonomous agents
+metadata: {"openclaw":{"primaryEnv":"CLAWCARD_API_KEY","emoji":"\\ud83d\\udd11"}}
+---
+
+You have access to ClawCard — a platform that gives you a real email address, phone number, virtual debit cards, and an encrypted credential vault.
+
+**Authentication:** All requests use your API key as a Bearer token.
+
+## Getting Started
+
+Base URL: $CLAWCARD_BASE_URL (default: https://clawcard.sh)
+Auth header: Authorization: Bearer $CLAWCARD_API_KEY
+
+**Step 1: Discover your identity.** Call GET /api/me first — it returns your keyId, email, phone, and budget. Use the keyId for all other endpoints.
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" $CLAWCARD_BASE_URL/api/me
+
+Response: { "keyId": "agt_...", "name": "...", "email": "...", "phone": "...", "spendLimitCents": ... }
+
+## Endpoints
+
+Use the keyId from /api/me as KEY_ID in all endpoints below.
+
+### Identity
+
+**Get full identity details:**
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" $CLAWCARD_BASE_URL/api/agents/KEY_ID
+
+### Email
+
+**Read inbox:**
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" "$CLAWCARD_BASE_URL/api/agents/KEY_ID/emails?limit=20"
+
+**Send email:**
+
+curl -X POST -H "Authorization: Bearer $CLAWCARD_API_KEY" -H "Content-Type: application/json" \\
+  -d '{"to":"recipient@example.com","subject":"Hello","body":"Message text"}' \\
+  $CLAWCARD_BASE_URL/api/agents/KEY_ID/emails/send
+
+### SMS
+
+**Read messages:**
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" "$CLAWCARD_BASE_URL/api/agents/KEY_ID/sms?limit=20"
+
+**Send SMS:**
+
+curl -X POST -H "Authorization: Bearer $CLAWCARD_API_KEY" -H "Content-Type: application/json" \\
+  -d '{"to":"+15551234567","body":"Message text"}' \\
+  $CLAWCARD_BASE_URL/api/agents/KEY_ID/sms/send
+
+### Virtual Cards
+
+**List cards:**
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" $CLAWCARD_BASE_URL/api/agents/KEY_ID/cards
+
+**Create a card (returns PAN, CVV, expiry):**
+
+curl -X POST -H "Authorization: Bearer $CLAWCARD_API_KEY" -H "Content-Type: application/json" \\
+  -d '{"amountCents":1000,"memo":"Hosting payment","type":"single_use"}' \\
+  $CLAWCARD_BASE_URL/api/agents/KEY_ID/cards
+
+Card types: single_use (closes after one txn), merchant_locked (locks to first merchant).
+
+**Get card details (PAN, CVV):**
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" $CLAWCARD_BASE_URL/api/agents/KEY_ID/cards/CARD_ID
+
+**Close a card:**
+
+curl -X PATCH -H "Authorization: Bearer $CLAWCARD_API_KEY" -H "Content-Type: application/json" \\
+  -d '{"action":"close"}' \\
+  $CLAWCARD_BASE_URL/api/agents/KEY_ID/cards/CARD_ID
+
+### Credentials Vault
+
+**Store a credential:**
+
+curl -X POST -H "Authorization: Bearer $CLAWCARD_API_KEY" -H "Content-Type: application/json" \\
+  -d '{"service":"aws","key":"access_key","value":"AKIA..."}' \\
+  $CLAWCARD_BASE_URL/api/agents/KEY_ID/credentials
+
+**Retrieve a credential:**
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" $CLAWCARD_BASE_URL/api/agents/KEY_ID/credentials/SERVICE/KEY
+
+### Budget
+
+**Check remaining budget:**
+
+curl -H "Authorization: Bearer $CLAWCARD_API_KEY" $CLAWCARD_BASE_URL/api/agents/KEY_ID/budget
+
+**Allocate budget (moves funds from account balance to this key):**
+
+curl -X POST -H "Authorization: Bearer $CLAWCARD_API_KEY" -H "Content-Type: application/json" \\
+  -d '{"amountCents":1000}' \\
+  $CLAWCARD_BASE_URL/api/agents/KEY_ID/budget
+`;
+
+// ── Helpers ──────────────────────────────────────────────────────
+
+function log(msg) {
+  console.log(`  ${msg}`);
+}
+
+function success(msg) {
+  console.log(`  \x1b[32m✓\x1b[0m ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`  \x1b[33m!\x1b[0m ${msg}`);
+}
+
+function error(msg) {
+  console.error(`  \x1b[31m✗\x1b[0m ${msg}`);
+}
+
+function readJson(path) {
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+
+function writeJson(path, data) {
+  writeFileSync(path, JSON.stringify(data, null, 2) + "\n");
+}
+
+// ── Main ─────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const apiKey = args[0];
+const baseUrl = args[1] || DEFAULT_BASE_URL;
+
+console.log();
+console.log("  \x1b[1m🦞 ClawCard Setup\x1b[0m");
+console.log();
+
+if (!apiKey || apiKey.startsWith("-")) {
+  log("Usage: npx clawcard <API_KEY> [BASE_URL]");
+  log("");
+  log("Example:");
+  log("  npx clawcard ak_live_abc123...");
+  log("  npx clawcard ak_live_abc123... http://localhost:3000");
+  console.log();
+  process.exit(1);
+}
+
+if (!apiKey.startsWith("ak_live_")) {
+  warn("API key doesn't start with 'ak_live_' — are you sure this is correct?");
+}
+
+// Check OpenClaw is installed
+if (!existsSync(OPENCLAW_DIR)) {
+  error("OpenClaw directory not found at ~/.openclaw");
+  log("Install OpenClaw first: https://openclaw.dev");
+  console.log();
+  process.exit(1);
+}
+
+// 1. Write skill file
+mkdirSync(SKILLS_DIR, { recursive: true });
+writeFileSync(SKILL_PATH, SKILL_MD);
+success(`Skill written to ${SKILL_PATH}`);
+
+// 2. Update openclaw.json with env vars
+const config = readJson(CONFIG_PATH);
+if (!config) {
+  error(`Could not read ${CONFIG_PATH}`);
+  process.exit(1);
+}
+
+// Ensure skills.entries.clawcard.env exists
+if (!config.skills) config.skills = {};
+if (!config.skills.entries) config.skills.entries = {};
+
+const existing = config.skills.entries.clawcard;
+if (existing?.env?.CLAWCARD_API_KEY && existing.env.CLAWCARD_API_KEY !== "YOUR_API_KEY_HERE") {
+  warn("Existing ClawCard config found — updating API key");
+}
+
+config.skills.entries.clawcard = {
+  ...existing,
+  env: {
+    ...(existing?.env || {}),
+    CLAWCARD_API_KEY: apiKey,
+    CLAWCARD_BASE_URL: baseUrl,
+  },
+};
+
+writeJson(CONFIG_PATH, config);
+success(`Config updated in ${CONFIG_PATH}`);
+
+// 3. Done
+console.log();
+log("\x1b[1mSetup complete!\x1b[0m Your agent now has access to:");
+log("  📧 Email inbox");
+log("  📱 Phone number & SMS");
+log("  💳 Virtual debit cards");
+log("  🔐 Encrypted credential vault");
+console.log();
+log("Tell your agent to \x1b[1m\"refresh skills\"\x1b[0m or restart the gateway.");
+log("Then try: \x1b[36m\"Use ClawCard to check your identity\"\x1b[0m");
+console.log();

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@clawcard/cli",
+  "version": "0.1.0",
+  "description": "Set up ClawCard for your OpenClaw agent in one command",
+  "bin": {
+    "clawcard": "./bin/setup.mjs"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "bin/"
+  ]
+}