clawcloud 1.0.1 → 1.3.0

package/src/commands/status.js

@@ -0,0 +1,5 @@
+import chalk from 'chalk';
+export async function status(nftId, options = {}) {
+  console.log(chalk.gray(`\nFetching NFT #${nftId} details...\n`));
+  console.log(chalk.yellow('Coming soon!\n'));
+}

package/src/commands/terminate.js

@@ -0,0 +1,5 @@
+import chalk from 'chalk';
+export async function terminate(nftId, options = {}) {
+  console.log(chalk.gray(`\nTerminating VM (NFT #${nftId})...\n`));
+  console.log(chalk.yellow('Coming soon!\n'));
+}

package/src/commands/transfer.js

@@ -0,0 +1,5 @@
+import chalk from 'chalk';
+export async function transfer(nftId, options = {}) {
+  console.log(chalk.gray(`\nTransferring NFT #${nftId}...\n`));
+  console.log(chalk.yellow('Coming soon!\n'));
+}

package/src/utils/banner.js

@@ -0,0 +1,9 @@
+import chalk from 'chalk';
+import { getVersion } from './version.js';
+
+export function displayBanner() {
+  const version = getVersion();
+  
+  console.log(chalk.cyan('\n   ☁️  ClawCloud CLI ') + chalk.gray(`v${version}`));
+  console.log(chalk.gray('   Cloud infrastructure AI agents can own\n'));
+}

package/src/utils/config.js

@@ -0,0 +1,92 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.clawcloud');
+const AGENTS_FILE = path.join(CONFIG_DIR, 'agents.json');
+const WALLET_FILE = path.join(CONFIG_DIR, 'wallet.json');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+// Ensure config directory exists
+if (!fs.existsSync(CONFIG_DIR)) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+}
+
+export function saveAgent(agentData) {
+  let agents = {};
+  
+  if (fs.existsSync(AGENTS_FILE)) {
+    agents = JSON.parse(fs.readFileSync(AGENTS_FILE, 'utf-8'));
+  }
+  
+  agents[agentData.agentId] = agentData;
+  fs.writeFileSync(AGENTS_FILE, JSON.stringify(agents, null, 2));
+}
+
+export function getAgent(agentId) {
+  if (!fs.existsSync(AGENTS_FILE)) {
+    return null;
+  }
+  
+  const agents = JSON.parse(fs.readFileSync(AGENTS_FILE, 'utf-8'));
+  return agents[agentId] || null;
+}
+
+export function saveWallet(agentId, privateKey, address) {
+  const walletData = {
+    agentId,
+    privateKey,
+    address,
+    network: 'base',
+    configuredAt: new Date().toISOString()
+  };
+  
+  fs.writeFileSync(WALLET_FILE, JSON.stringify(walletData, null, 2));
+  fs.chmodSync(WALLET_FILE, 0o600); // Secure permissions
+}
+
+export function getWalletConfig() {
+  if (!fs.existsSync(WALLET_FILE)) {
+    return null;
+  }
+  
+  return JSON.parse(fs.readFileSync(WALLET_FILE, 'utf-8'));
+}
+
+export function getConfig() {
+  const defaultConfig = {
+    API_URL: 'https://api.clawcloud.co',
+    API_VERSION: '1.3.0',
+    CONTRACT_ADDRESS: '0xF708741D37C420518852c6A15aB658066951c852',
+    USDC_ADDRESS: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    RPC_URL: 'https://mainnet.base.org',
+    TELEGRAM_BOT: 'clawcloud_devbot',
+    NETWORK: 'base',
+    CHAIN_ID: 8453
+  };
+  
+  if (!fs.existsSync(CONFIG_FILE)) {
+    return defaultConfig;
+  }
+  
+  const userConfig = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+  return { ...defaultConfig, ...userConfig };
+}
+
+export function saveConfig(config) {
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+// Tier configurations with new naming (v1.3.0)
+export function getTierInfo() {
+  return {
+    0: { name: 'ClawCloud VM Tier 0', type: 'vm', cpu: '1vCPU', ram: '1GB', provider: 'Vultr' },
+    1: { name: 'ClawCloud VM Tier 1', type: 'vm', cpu: '1vCPU', ram: '2GB', provider: 'Vultr' },
+    2: { name: 'ClawCloud VM Tier 2', type: 'vm', cpu: '2vCPU', ram: '4GB', provider: 'Vultr' },
+    3: { name: 'ClawCloud VM Tier 3', type: 'vm', cpu: '4vCPU', ram: '8GB', provider: 'Vultr' },
+    4: { name: 'ClawCloud GPU Tier 4', type: 'gpu', gpu: 'RTX 4090', provider: 'RunPod' },
+    5: { name: 'ClawCloud GPU Tier 5', type: 'gpu', gpu: 'A100 40GB', provider: 'RunPod' },
+    6: { name: 'ClawCloud GPU Tier 6', type: 'gpu', gpu: 'A100 80GB', provider: 'RunPod' },
+    7: { name: 'ClawCloud GPU Tier 7', type: 'gpu', gpu: 'H100 PCIe', provider: 'RunPod' }
+  };
+}

package/src/utils/help.js

@@ -0,0 +1,85 @@
+import chalk from 'chalk';
+import boxen from 'boxen';
+
+export function displayHelp() {
+  console.log(chalk.cyan.bold('\n☁️  ClawCloud CLI - Complete Guide\n'));
+  
+  console.log(boxen(
+    chalk.white.bold('GETTING STARTED\n\n') +
+    chalk.cyan('1. Register Agent:\n') +
+    chalk.gray('   npx clawcloud register\n\n') +
+    chalk.cyan('2. Get Wallet (Telegram):\n') +
+    chalk.gray('   https://t.me/clawcloud_devbot\n') +
+    chalk.gray('   /start <agent-id>\n\n') +
+    chalk.cyan('3. Configure CLI:\n') +
+    chalk.gray('   npx clawcloud configure\n\n') +
+    chalk.cyan('4. Make Agent Autonomous:\n') +
+    chalk.gray('   npx clawcloud export'),
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'round',
+      borderColor: 'cyan'
+    }
+  ));
+  
+  console.log(chalk.white.bold('\n📚 COMMANDS\n'));
+  
+  const commands = [
+    ['Setup & Configuration', ''],
+    ['  register', 'Register a new AI agent'],
+    ['  configure', 'Link wallet after Telegram setup'],
+    ['  fund', 'Show funding instructions'],
+    ['', ''],
+    ['Autonomous Mode (Primary)', ''],
+    ['  export', 'Export config for autonomous agents'],
+    ['', ''],
+    ['Wallet & Balance', ''],
+    ['  balance, bal', 'Check USDC balance'],
+    ['', ''],
+    ['NFT & VM Management', ''],
+    ['  list, ls', 'List your VMs and NFTs'],
+    ['  nfts', 'View NFT collection'],
+    ['  status <nft-id>', 'View NFT/VM details'],
+    ['  buy', 'Purchase VM (manual mode)'],
+    ['  renew <nft-id>', 'Extend VM duration'],
+    ['  ssh <nft-id>', 'SSH into VM'],
+    ['  transfer <nft-id>', 'Transfer NFT/VM ownership'],
+    ['  terminate <nft-id>', 'Destroy VM & burn NFT'],
+    ['', ''],
+    ['Documentation', ''],
+    ['  docs', 'Open documentation'],
+    ['  help', 'Show this help'],
+    ['', '']
+  ];
+  
+  commands.forEach(([cmd, desc]) => {
+    if (cmd === '') {
+      console.log('');
+    } else if (desc === '') {
+      console.log(chalk.yellow.bold(cmd));
+    } else {
+      console.log(chalk.cyan(`  ${cmd.padEnd(25)}`) + chalk.gray(desc));
+    }
+  });
+  
+  console.log(chalk.white.bold('\n🚀 EXAMPLES\n'));
+  
+  console.log(chalk.gray('  # Interactive mode'));
+  console.log(chalk.cyan('  npx clawcloud\n'));
+  
+  console.log(chalk.gray('  # Check balance'));
+  console.log(chalk.cyan('  npx clawcloud balance\n'));
+  
+  console.log(chalk.gray('  # List VMs'));
+  console.log(chalk.cyan('  npx clawcloud list\n'));
+  
+  console.log(chalk.gray('  # Make agent autonomous (OpenClaw)'));
+  console.log(chalk.cyan('  npx clawcloud export --framework openclaw\n'));
+  
+  console.log(chalk.white.bold('\n🔗 LINKS\n'));
+  console.log(chalk.gray('  Docs:     ') + chalk.blue('https://docs.clawcloud.co'));
+  console.log(chalk.gray('  Telegram: ') + chalk.blue('https://t.me/clawcloud_devbot'));
+  console.log(chalk.gray('  GitHub:   ') + chalk.blue('https://github.com/clawcloud/clawcloud'));
+  console.log(chalk.gray('  Website:  ') + chalk.blue('https://clawcloud.co\n'));
+}

package/src/utils/version.js

@@ -0,0 +1,15 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export function getVersion() {
+  try {
+    const packagePath = join(__dirname, '..', '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(packagePath, 'utf-8'));
+    return pkg.version;
+  } catch {
+    return '1.0.0';
+  }
+}

package/templates/SKILL.md

@@ -0,0 +1,215 @@
+---
+name: clawcloud
+version: 1.0.0
+description: Autonomous cloud infrastructure. Buy VMs with crypto, deploy code, own compute.
+homepage: https://clawcloud.co
+repository: https://github.com/clawcloud/clawcloud
+metadata:
+  openclaw:
+    category: infrastructure
+    api_base: https://api.clawcloud.co/v1
+    wallet_address: {{WALLET_ADDRESS}}
+    agent_id: {{AGENT_ID}}
+---
+
+# ClawCloud Skill
+
+**You can autonomously purchase and control cloud VMs using cryptocurrency.**
+
+## What You Can Do
+
+- Check your USDC balance on Base
+- Purchase VMs when you need compute
+- Deploy code to your VMs
+- Scale infrastructure based on your needs
+- Own VMs as NFTs in your wallet
+
+## Your Wallet
+
+Address: `{{WALLET_ADDRESS}}`  
+Agent ID: `{{AGENT_ID}}`  
+Network: Base  
+Currency: USDC
+
+**IMPORTANT:** Your private key is configured. Keep this skill secure.
+
+## Commands
+
+### Check Balance
+
+```bash
+# Check USDC balance
+curl https://api.clawcloud.co/v1/wallet/balance \
+  -H "Authorization: Bearer {{AGENT_ID}}"
+```
+
+Example response:
+```json
+{
+  "balance_usdc": "25.50",
+  "wallet_address": "{{WALLET_ADDRESS}}",
+  "network": "base"
+}
+```
+
+### List VM Tiers
+
+```bash
+# See available VM tiers and pricing
+curl https://api.clawcloud.co/v1/packages
+```
+
+Example response:
+```json
+{
+  "packages": [
+    {
+      "tier": "MICRO",
+      "tier_index": 0,
+      "price_monthly": 5,
+      "price_hourly": 0.007,
+      "vcpu": 1,
+      "ram": "1GB",
+      "storage": "20GB"
+    },
+    {
+      "tier": "SMALL",
+      "tier_index": 1,
+      "price_monthly": 10,
+      "price_hourly": 0.014,
+      "vcpu": 2,
+      "ram": "2GB",
+      "storage": "40GB"
+    }
+  ]
+}
+```
+
+### Purchase VM (Mints NFT)
+
+To purchase a VM, you need to interact with the smart contract on Base:
+
+```bash
+# Purchase SMALL VM for 1 month
+# This mints an NFT to your wallet!
+
+CONTRACT_ADDRESS="0x..." # ClawCloud VMs contract
+PRIVATE_KEY="{{PRIVATE_KEY}}"
+TIER=1 # 0=MICRO, 1=SMALL, 2=MEDIUM, 3=LARGE, 4=XLARGE
+MONTHS=1
+
+cast send $CONTRACT_ADDRESS \
+  "purchaseVM(uint8,uint256)" $TIER $MONTHS \
+  --private-key $PRIVATE_KEY \
+  --rpc-url https://mainnet.base.org
+```
+
+After purchase:
+1. An NFT is minted to your wallet (token ID = VM ID)
+2. Backend provisions VM (~2 minutes)
+3. You can fetch credentials and deploy code
+
+### List Your VMs
+
+```bash
+# List all VMs you own (as NFTs)
+curl https://api.clawcloud.co/v1/vms?address={{WALLET_ADDRESS}}
+```
+
+Example response:
+```json
+{
+  "vms": [
+    {
+      "nft_id": 42,
+      "tier": "SMALL",
+      "status": "active",
+      "ip_address": "34.123.45.67",
+      "expires_at": "2026-02-28T00:00:00Z",
+      "expires_in_days": 28
+    }
+  ]
+}
+```
+
+### Get VM Credentials
+
+```bash
+# Get SSH access for your VM
+curl https://api.clawcloud.co/v1/vms/vm_42/credentials \
+  -H "Authorization: Bearer {{AGENT_ID}}"
+```
+
+Example response:
+```json
+{
+  "vm_id": "vm_42",
+  "ip_address": "34.123.45.67",
+  "username": "agent",
+  "ssh_private_key": "-----BEGIN PRIVATE KEY-----\n...",
+  "ssh_command": "ssh agent@34.123.45.67"
+}
+```
+
+### Deploy Code to VM
+
+Once you have the SSH key, you can deploy code:
+
+```bash
+# Save SSH key
+echo "$SSH_PRIVATE_KEY" > /tmp/vm_key.pem
+chmod 600 /tmp/vm_key.pem
+
+# Copy your code to VM
+scp -i /tmp/vm_key.pem -r ./my-code agent@34.123.45.67:~/
+
+# Execute commands
+ssh -i /tmp/vm_key.pem agent@34.123.45.67 "cd ~/my-code && npm install && npm start"
+```
+
+## Example Decision Flow
+
+**You:** "I need to backtest a trading strategy"
+
+**Your thought process:**
+1. Check balance: Do I have enough USDC?
+2. Determine compute needs: How much CPU/RAM?
+3. Purchase VM: Buy MEDIUM tier for 1 month
+4. Wait for provisioning: ~2 minutes
+5. Deploy code: Copy strategy to VM
+6. Run backtest: Execute and monitor
+7. Retrieve results: Download output
+8. Terminate VM if done: Save costs
+
+## NFT Ownership
+
+When you purchase a VM:
+- An ERC-721 NFT is minted to `{{WALLET_ADDRESS}}`
+- The NFT token ID = VM identifier (e.g., NFT #42 = VM #42)
+- Owning the NFT = Owning the VM
+- Transfer NFT = Transfer VM ownership
+- Burn NFT = Destroy VM
+
+View your NFTs:
+- BaseScan: https://basescan.org/token/0x.../{{WALLET_ADDRESS}}
+- OpenSea: https://opensea.io/{{WALLET_ADDRESS}}?search[chains][0]=BASE
+
+## Cost Management
+
+- VMs are pay-as-you-go starting at $0.08/hour
+- Monitor your balance regularly
+- Set up notifications in the Telegram bot
+- Terminate VMs when not needed
+
+## Safety
+
+- Your private key is stored in this skill
+- Only you can access this workspace
+- Never share this skill file
+- The Telegram bot can send alerts when you spend
+
+## Resources
+
+- Documentation: https://docs.clawcloud.co
+- Contract: https://basescan.org/address/0x...
+- Support: https://t.me/clawcloud