@ckcloudai.com/clawrouter 0.0.1

package/openclaw.plugin.json

@@ -0,0 +1,25 @@
+{
+    "id": "ckcloud",
+    "name": "ckcloud",
+    "description": "Smart LLM router — 41+ models, x402 micropayments, 92% cost savings",
+    "configSchema": {
+        "type": "object",
+        "properties": {
+            "walletKey": {
+                "type": "string",
+                "description": "EVM wallet private key (0x...). Optional — auto-generated if not set."
+            },
+            "routing": {
+                "type": "object",
+                "description": "Override default routing configuration"
+            }
+        }
+    },
+    "uiHints": {
+        "walletKey": {
+            "label": "Wallet Private Key",
+            "sensitive": true,
+            "placeholder": "0x... (optional — auto-generated)"
+        }
+    }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@ckcloudai.com/clawrouter",
+  "version": "0.0.1",
+  "description": "openclaw plugin for ckcloud - save your llm cost",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ckcloud": "./dist/cli.js"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "lint": "eslint src/"
+  },
+  "keywords": [
+    "llm",
+    "router",
+    "openrouter",
+    "ai",
+    "openclaw",
+    "openai",
+    "anthropic",
+    "gemini",
+    "deepseek"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://git.ucloudadmin.com/yai/ckcloud/clawrouter"
+  },
+  "author": "",
+  "license": "ISC",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@scure/bip32": "^1.6.0",
+    "@scure/bip39": "^1.5.0",
+    "@solana/kit": "^5.0.0",
+    "@x402/evm": "^2.4.0",
+    "@x402/fetch": "^2.4.0",
+    "@x402/svm": "^2.4.0",
+    "ethers": "^6.16.0",
+    "viem": "^2.39.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}

package/scripts/reinstall.sh

@@ -0,0 +1,343 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+kill_port_processes() {
+  local port="$1"
+  local pids=""
+
+  if command -v lsof >/dev/null 2>&1; then
+    pids="$(lsof -ti :"$port" 2>/dev/null || true)"
+  elif command -v fuser >/dev/null 2>&1; then
+    pids="$(fuser "$port"/tcp 2>/dev/null || true)"
+  elif command -v ss >/dev/null 2>&1; then
+    pids="$(ss -lptn "sport = :$port" 2>/dev/null | sed -n 's/.*pid=\([0-9]\+\).*/\1/p' | sort -u)"
+  elif command -v netstat >/dev/null 2>&1; then
+    pids="$(netstat -nlpt 2>/dev/null | awk -v p=":$port" '$4 ~ p"$" {split($7,a,"/"); if (a[1] ~ /^[0-9]+$/) print a[1]}' | sort -u)"
+  else
+    echo "  Warning: could not find lsof/fuser/ss/netstat; skipping proxy stop"
+    return 0
+  fi
+
+  if [ -n "$pids" ]; then
+    echo "$pids" | xargs kill -9 2>/dev/null || true
+  fi
+}
+
+echo "🦞 ckcloud Reinstall"
+echo ""
+
+# 0. Back up wallet key BEFORE removing anything
+WALLET_FILE="$HOME/.openclaw/ckcloud/wallet.key"
+WALLET_BACKUP=""
+
+echo "→ Backing up wallet..."
+if [ -f "$WALLET_FILE" ]; then
+  WALLET_KEY=$(cat "$WALLET_FILE" | tr -d '[:space:]')
+  KEY_LEN=${#WALLET_KEY}
+  if [[ "$WALLET_KEY" == 0x* ]] && [ "$KEY_LEN" -eq 66 ]; then
+    WALLET_BACKUP="$HOME/.openclaw/ckcloud/wallet.key.bak.$(date +%s)"
+    cp "$WALLET_FILE" "$WALLET_BACKUP"
+    chmod 600 "$WALLET_BACKUP"
+    echo "  ✓ Wallet backed up to: $WALLET_BACKUP"
+  else
+    echo "  ⚠ Wallet file exists but has invalid format — skipping backup"
+  fi
+else
+  echo "  ℹ No existing wallet found"
+fi
+echo ""
+
+# 1. Remove plugin files
+echo "→ Removing plugin files..."
+rm -rf ~/.openclaw/extensions/ckcloud
+
+# 2. Clean config entries
+echo "→ Cleaning config entries..."
+node -e "
+const f = require('os').homedir() + '/.openclaw/openclaw.json';
+const fs = require('fs');
+if (!fs.existsSync(f)) {
+  console.log('  No openclaw.json found, skipping');
+  process.exit(0);
+}
+
+let c;
+try {
+  c = JSON.parse(fs.readFileSync(f, 'utf8'));
+} catch (err) {
+  const backupPath = f + '.corrupt.' + Date.now();
+  console.error('  ERROR: Invalid JSON in openclaw.json');
+  console.error('  ' + err.message);
+  try {
+    fs.copyFileSync(f, backupPath);
+    console.log('  Backed up to: ' + backupPath);
+  } catch {}
+  console.log('  Skipping config cleanup...');
+  process.exit(0);
+}
+
+// Clean plugin entries
+if (c.plugins?.entries?.ckcloud) delete c.plugins.entries.ckcloud;
+if (c.plugins?.installs?.ckcloud) delete c.plugins.installs.ckcloud;
+// Clean plugins.allow (removes stale ckcloud reference)
+if (Array.isArray(c.plugins?.allow)) {
+  c.plugins.allow = c.plugins.allow.filter(p => p !== 'ckcloud' && p !== '@ckcloudai.com/clawrouter');
+}
+// Remove deprecated model aliases from picker
+const deprecated = ['ckcloud/mini', 'ckcloud/nvidia', 'ckcloud/gpt', 'ckcloud/o3', 'ckcloud/grok'];
+if (c.agents?.defaults?.models) {
+  for (const key of deprecated) {
+    if (c.agents.defaults.models[key]) {
+      delete c.agents.defaults.models[key];
+      console.log('  Removed deprecated alias: ' + key);
+    }
+  }
+}
+fs.writeFileSync(f, JSON.stringify(c, null, 2));
+console.log('  Config cleaned');
+"
+
+# 3. Kill old proxy
+echo "→ Stopping old proxy..."
+kill_port_processes 8402
+
+# 3.1. Remove stale models.json so it gets regenerated with apiKey
+echo "→ Cleaning models cache..."
+rm -f ~/.openclaw/agents/main/agent/models.json 2>/dev/null || true
+
+# 4. Inject auth profile (ensures ckcloud provider is recognized)
+echo "→ Injecting auth profile..."
+node -e "
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const authDir = path.join(os.homedir(), '.openclaw', 'agents', 'main', 'agent');
+const authPath = path.join(authDir, 'auth-profiles.json');
+
+// Create directory if needed
+fs.mkdirSync(authDir, { recursive: true });
+
+// Load or create auth-profiles.json with correct OpenClaw format
+let store = { version: 1, profiles: {} };
+if (fs.existsSync(authPath)) {
+  try {
+    const existing = JSON.parse(fs.readFileSync(authPath, 'utf8'));
+    // Migrate if old format (no version field)
+    if (existing.version && existing.profiles) {
+      store = existing;
+    } else {
+      // Old format - keep version/profiles structure, old data is discarded
+      store = { version: 1, profiles: {} };
+    }
+  } catch (err) {
+    console.log('  Warning: Could not parse auth-profiles.json, creating fresh');
+  }
+}
+
+// Inject ckcloud auth if missing (OpenClaw format: profiles['provider:profileId'])
+const profileKey = 'ckcloud:default';
+if (!store.profiles[profileKey]) {
+  store.profiles[profileKey] = {
+    type: 'api_key',
+    provider: 'ckcloud',
+    key: 'x402-proxy-handles-auth'
+  };
+  fs.writeFileSync(authPath, JSON.stringify(store, null, 2));
+  console.log('  Auth profile created');
+} else {
+  console.log('  Auth profile already exists');
+}
+"
+
+# 5. Ensure apiKey is present for /model picker (but DON'T override default model)
+echo "→ Finalizing setup..."
+node -e "
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+
+if (fs.existsSync(configPath)) {
+  try {
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    let changed = false;
+
+    // Ensure ckcloud provider has apiKey (required by ModelRegistry for /model picker)
+    if (config.models?.providers?.ckcloud && !config.models.providers.ckcloud.apiKey) {
+      config.models.providers.ckcloud.apiKey = 'x402-proxy-handles-auth';
+      console.log('  Added apiKey to ckcloud provider config');
+      changed = true;
+    }
+
+    if (changed) {
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+  } catch (e) {
+    console.log('  Could not update config:', e.message);
+  }
+} else {
+  console.log('  No openclaw.json found, skipping');
+}
+"
+
+# 6. Install plugin (config is ready, but no allow list yet to avoid validation error)
+echo "→ Installing ckcloud..."
+
+openclaw plugins install @ckcloudai.com/clawrouter
+
+# 6.1. Verify installation (check dist/ files exist)
+echo "→ Verifying installation..."
+DIST_PATH="$HOME/.openclaw/extensions/ckcloud/dist/index.js"
+if [ ! -f "$DIST_PATH" ]; then
+  echo "  ⚠️  dist/ files missing, clearing npm cache and retrying..."
+  npm cache clean --force 2>/dev/null || true
+  rm -rf ~/.openclaw/extensions/ckcloud
+
+  openclaw plugins install @ckcloudai.com/clawrouter
+
+  if [ ! -f "$DIST_PATH" ]; then
+    echo "  ❌ Installation failed - dist/index.js still missing"
+    echo "  Please report this issue"
+    exit 1
+  fi
+fi
+echo "  ✓ dist/index.js verified"
+
+# 6.2. Populate model allowlist so top ckcloud models appear in /model picker
+echo "→ Populating model allowlist..."
+node -e "
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+
+const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+if (!fs.existsSync(configPath)) {
+  console.log('  No openclaw.json found, skipping');
+  process.exit(0);
+}
+
+try {
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  let changed = false;
+
+  // Ensure provider exists with apiKey
+  if (!config.models) config.models = {};
+  if (!config.models.providers) config.models.providers = {};
+  if (!config.models.providers.ckcloud) {
+    config.models.providers.ckcloud = { api: 'openai-completions', models: [] };
+    changed = true;
+  }
+  if (!config.models.providers.ckcloud.apiKey) {
+    config.models.providers.ckcloud.apiKey = 'x402-proxy-handles-auth';
+    changed = true;
+  }
+
+  // models for the /model picker
+  const TOP_MODELS = [
+    'auto', 'free', 'eco', 'premium',
+    'moonshot/kimi-k2.5'
+  ];
+
+  if (!config.agents) config.agents = {};
+  if (!config.agents.defaults) config.agents.defaults = {};
+  if (!config.agents.defaults.models || typeof config.agents.defaults.models !== 'object') {
+    config.agents.defaults.models = {};
+    changed = true;
+  }
+
+  const allowlist = config.agents.defaults.models;
+  // Clean out old ckcloud entries not in TOP_MODELS
+  const topSet = new Set(TOP_MODELS.map(id => 'ckcloud/' + id));
+  for (const key of Object.keys(allowlist)) {
+    if (key.startsWith('ckcloud/') && !topSet.has(key)) {
+      delete allowlist[key];
+      changed = true;
+    }
+  }
+  let added = 0;
+  for (const id of TOP_MODELS) {
+    const key = 'ckcloud/' + id;
+    if (!allowlist[key]) {
+      allowlist[key] = {};
+      added++;
+    }
+  }
+  if (added > 0) {
+    changed = true;
+    console.log('  Added ' + added + ' models to allowlist (' + TOP_MODELS.length + ' total)');
+  } else {
+    console.log('  Allowlist already up to date');
+  }
+  if (changed) {
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  }
+} catch (err) {
+  console.log('  Could not update config:', err.message);
+}
+"
+
+# 7. Add plugin to allow list (done AFTER install so plugin files exist for validation)
+echo "→ Adding to plugins allow list..."
+node -e "
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+
+if (fs.existsSync(configPath)) {
+  try {
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+
+    // Ensure plugins.allow exists and includes ckcloud
+    if (!config.plugins) config.plugins = {};
+    if (!Array.isArray(config.plugins.allow)) {
+      config.plugins.allow = [];
+    }
+    if (!config.plugins.allow.includes('ckcloud') && !config.plugins.allow.includes('@ckcloudai.com/clawrouter')) {
+      config.plugins.allow.push('ckcloud');
+      console.log('  Added ckcloud to plugins.allow');
+    } else {
+      console.log('  Plugin already in allow list');
+    }
+
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  } catch (e) {
+    console.log('  Could not update config:', e.message);
+  }
+} else {
+  console.log('  No openclaw.json found, skipping');
+}
+"
+
+# Final: verify wallet survived reinstall
+echo "→ Verifying wallet integrity..."
+if [ -f "$WALLET_FILE" ]; then
+  CURRENT_KEY=$(cat "$WALLET_FILE" | tr -d '[:space:]')
+  CURRENT_LEN=${#CURRENT_KEY}
+  if [[ "$CURRENT_KEY" == 0x* ]] && [ "$CURRENT_LEN" -eq 66 ]; then
+    echo "  ✓ Wallet key intact"
+  else
+    if [ -n "$WALLET_BACKUP" ] && [ -f "$WALLET_BACKUP" ]; then
+      cp "$WALLET_BACKUP" "$WALLET_FILE"
+      chmod 600 "$WALLET_FILE"
+      echo "  ✓ Wallet restored from backup"
+    fi
+  fi
+else
+  if [ -n "$WALLET_BACKUP" ] && [ -f "$WALLET_BACKUP" ]; then
+    mkdir -p "$(dirname "$WALLET_FILE")"
+    cp "$WALLET_BACKUP" "$WALLET_FILE"
+    chmod 600 "$WALLET_FILE"
+    echo "  ✓ Wallet restored from backup: $WALLET_BACKUP"
+  fi
+fi
+
+echo ""
+echo "✓ Done! Smart routing enabled by default."
+echo ""
+echo "Run: openclaw gateway restart"
+echo ""
+
+echo "To uninstall: bash ~/.openclaw/extensions/ckcloud/scripts/uninstall.sh"

package/scripts/uninstall.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+set -e
+
+kill_port_processes() {
+  local port="$1"
+  local pids=""
+
+  if command -v lsof >/dev/null 2>&1; then
+    pids="$(lsof -ti :"$port" 2>/dev/null || true)"
+  elif command -v fuser >/dev/null 2>&1; then
+    pids="$(fuser "$port"/tcp 2>/dev/null || true)"
+  elif command -v ss >/dev/null 2>&1; then
+    pids="$(ss -lptn "sport = :$port" 2>/dev/null | sed -n 's/.*pid=\([0-9]\+\).*/\1/p' | sort -u)"
+  elif command -v netstat >/dev/null 2>&1; then
+    pids="$(netstat -nlpt 2>/dev/null | awk -v p=":$port" '$4 ~ p"$" {split($7,a,"/"); if (a[1] ~ /^[0-9]+$/) print a[1]}' | sort -u)"
+  else
+    echo "  Warning: could not find lsof/fuser/ss/netstat; skipping proxy stop"
+    return 0
+  fi
+
+  if [ -n "$pids" ]; then
+    echo "$pids" | xargs kill -9 2>/dev/null || true
+  fi
+}
+
+echo "🦞 ckcloud plugin uninstall"
+echo ""
+
+# 1. Stop proxy
+echo "→ Stopping proxy..."
+kill_port_processes 8402
+
+# 2. Remove plugin files
+echo "→ Removing plugin files..."
+rm -rf ~/.openclaw/extensions/ckcloud
+
+# 3. Clean openclaw.json
+echo "→ Cleaning openclaw.json..."
+node -e "
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+
+if (!fs.existsSync(configPath)) {
+  console.log('  No openclaw.json found, skipping');
+  process.exit(0);
+}
+
+try {
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  let changed = false;
+
+  // Remove ckcloud provider
+  if (config.models?.providers?.ckcloud) {
+    delete config.models.providers.ckcloud;
+    console.log('  Removed ckcloud provider');
+    changed = true;
+  }
+
+  // Remove plugin entries
+  if (config.plugins?.entries?.ckcloud) {
+    delete config.plugins.entries.ckcloud;
+    changed = true;
+  }
+  if (config.plugins?.installs?.ckcloud) {
+    delete config.plugins.installs.ckcloud;
+    changed = true;
+  }
+
+  // Remove from plugins.allow
+  if (Array.isArray(config.plugins?.allow)) {
+    const before = config.plugins.allow.length;
+    config.plugins.allow = config.plugins.allow.filter(
+      p => p !== 'ckcloud' && p !== '@ckcloudai.com/clawrouter'
+    );
+    if (config.plugins.allow.length !== before) {
+      console.log('  Removed from plugins.allow');
+      changed = true;
+    }
+  }
+
+  // Reset default model if it's ckcloud/auto
+  if (config.agents?.defaults?.model?.primary === 'ckcloud/auto') {
+    delete config.agents.defaults.model.primary;
+    console.log('  Reset default model (was ckcloud/auto)');
+    changed = true;
+  }
+
+  // Remove ckcloud models from allowlist
+  if (config.agents?.defaults?.models) {
+    const models = config.agents.defaults.models;
+    let removedCount = 0;
+    for (const key of Object.keys(models)) {
+      if (key.startsWith('ckcloud/')) {
+        delete models[key];
+        removedCount++;
+      }
+    }
+    if (removedCount > 0) {
+      console.log('  Removed ' + removedCount + ' ckcloud models from allowlist');
+      changed = true;
+    }
+  }
+
+  if (changed) {
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log('  Config cleaned');
+  } else {
+    console.log('  No changes needed');
+  }
+} catch (err) {
+  console.error('  Error:', err.message);
+}
+"
+
+# 4. Clean auth-profiles.json
+echo "→ Cleaning auth profiles..."
+node -e "
+const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const agentsDir = path.join(os.homedir(), '.openclaw', 'agents');
+
+if (!fs.existsSync(agentsDir)) {
+  console.log('  No agents directory found');
+  process.exit(0);
+}
+
+const agents = fs.readdirSync(agentsDir, { withFileTypes: true })
+  .filter(d => d.isDirectory())
+  .map(d => d.name);
+
+for (const agentId of agents) {
+  const authPath = path.join(agentsDir, agentId, 'agent', 'auth-profiles.json');
+  if (!fs.existsSync(authPath)) continue;
+
+  try {
+    const store = JSON.parse(fs.readFileSync(authPath, 'utf8'));
+    if (store.profiles?.['ckcloud:default']) {
+      delete store.profiles['ckcloud:default'];
+      fs.writeFileSync(authPath, JSON.stringify(store, null, 2));
+      console.log('  Removed ckcloud auth from ' + agentId);
+    }
+  } catch {}
+}
+"
+
+# 5. Clean models cache
+echo "→ Cleaning models cache..."
+rm -f ~/.openclaw/agents/*/agent/models.json 2>/dev/null || true
+
+echo ""
+echo "✓ ckcloud uninstalled"
+echo ""
+echo "Restart OpenClaw to apply changes:"
+echo "  openclaw gateway restart"