clawcloud 1.0.1 → 1.3.0

package/README.md

@@ -1,313 +1,178 @@
-# 🦞 ClawCloud CLI
+# ClawCloud CLI
 
-Decentralized cloud infrastructure for AI agents. Purchase and manage VMs with crypto on Base.
+☁️ **Cloud infrastructure AI agents can own**
 
-## 🚀 Quick Start
+Command-line interface for managing ClawCloud - autonomous cloud VMs purchased with crypto, owned as NFTs.
 
-```bash
-# Check available VM tiers
-npx clawcloud tiers
-
-# Purchase a VM
-npx clawcloud purchase
+## Quick Start
 
-# List your VMs
-npx clawcloud list
-
-# Get VM credentials
-npx clawcloud get <tokenId>
+```bash
+npx clawcloud
 ```
 
-## 📦 Installation
+## Installation
 
-### Option 1: npx (No installation needed)
-```bash
-npx clawcloud <command>
-```
+### Use with npx (recommended)
 
-### Option 2: Global Install
 ```bash
-npm install -g clawcloud
-clawcloud <command>
+npx clawcloud register
 ```
 
-## 🎯 Features
+### Install globally
 
-- ✅ Purchase VMs with USDC on Base
-- ✅ Ownership via ERC-721 NFTs
-- ✅ Automatic VM provisioning
-- ✅ SSH credential retrieval
-- ✅ Wallet management
-- ✅ Balance checking
-
-## 📋 Commands
-
-### Purchase & Manage
 ```bash
-clawcloud purchase              # Purchase a new VM
-clawcloud get <tokenId>         # Get VM credentials
-clawcloud list                  # List your VMs
+npm install -g clawcloud
+clawcloud register
 ```
 
-### Information
-```bash
-clawcloud tiers                 # Show available VM tiers
-clawcloud balance               # Check wallet balance
-clawcloud info                  # Show contract/API info
-```
+## Getting Started
 
-### Wallet
-```bash
-clawcloud wallet                # View/setup wallet
-```
+### 1. Register Your Agent
 
-### Help
 ```bash
-clawcloud help                  # Show all commands
+npx clawcloud register
 ```
 
-## 🛠️ Setup
-
-### First Time Setup
-
-1. **Run any command** and the CLI will guide you through wallet setup:
-   ```bash
-   npx clawcloud tiers
-   ```
-
-2. **Choose wallet option:**
-   - Import existing private key
-   - Generate new wallet
-
-3. **Fund your wallet:**
-   - Get ETH on Base (for gas): https://bridge.base.org
-   - Get USDC (for purchases): https://app.uniswap.org/swap?chain=base
-
-### Configuration
-
-Config is stored in: `~/.clawcloud/config.json`
+You'll get an Agent ID like `agent_1738445234_k9x2m`
 
-**Security Note:** Never share your private key or config file!
+### 2. Get Your Wallet (Telegram)
 
-## 💰 Pricing
+Open Telegram and message [@clawcloud_devbot](https://t.me/clawcloud_devbot):
 
-| Tier | Name | Per Day | Per Month |
-|------|------|---------|-----------|
-| 0 | CPU-Basic-1vCPU-1GB | $0.50 | $15.00 |
-| 1 | CPU-Standard-2vCPU-4GB | $1.00 | $30.00 |
-| 2 | CPU-Performance-4vCPU-8GB | $2.00 | $60.00 |
-| 3 | CPU-HighMem-8vCPU-16GB | $4.00 | $120.00 |
-| 4 | GPU-T4-4vCPU-16GB | $8.00 | $240.00 |
-| 5 | GPU-V100-8vCPU-32GB | $16.00 | $480.00 |
-| 6 | GPU-A100-16vCPU-64GB | $32.00 | $960.00 |
-| 7 | GPU-H100-32vCPU-128GB | $64.00 | $1,920.00 |
-
-*Prices in USDC. Minimum 3-day purchase required.*
-
-## 🔐 Security
-
-- **Private keys are stored locally** in `~/.clawcloud/config.json`
-- **Never share your private key** with anyone
-- **Use a dedicated wallet** for ClawCloud operations
-- **Backup your private key** securely
+```
+/start agent_1738445234_k9x2m
+```
 
-## 📖 Examples
+The bot will:
+- Verify your agent ID
+- Create a wallet
+- Send you the private key
+- Provide funding instructions
 
-### Purchase a VM
+### 3. Configure CLI
 
 ```bash
-$ npx clawcloud purchase
-
-🦞 Wallet: 0x1234...5678
-📊 Available Tiers:
-
-0. CPU-Basic-1vCPU-1GB - $0.50/day ($15.00/month)
-1. CPU-Standard-2vCPU-4GB - $1.00/day ($30.00/month)
-...
-
-Choose tier (0-7): 4
-Duration in days (3+ recommended): 7
-
-💰 Total cost: $56.00 USDC
-Proceed with purchase? (y/n): y
-
-✅ USDC balance: $100.00 ✅
-⏳ Approving USDC...
-✅ USDC approved!
-⏳ Purchasing VM...
-✅ VM purchased successfully! 🎉
-
-Token ID: 42
-Tier: 4
-Duration: 7 days
-
-⏳ VM is provisioning... This takes 2-3 minutes.
-Get credentials: npx clawcloud get 42
+npx clawcloud configure
 ```
 
-### Get VM Credentials
-
-```bash
-$ npx clawcloud get 42
-
-⏳ Fetching credentials for VM #42...
-✅ VM credentials retrieved!
-
-======================================================================
-🖥️  VM #42 - GPU-EXTERNAL
-======================================================================
-Tier:      4
-Host:      rentals-xxxxx.ssh.deployments.targon.com
-Username:  root
-Expires:   Feb 9, 2026, 12:00:00 PM
+Enter your Agent ID and private key from Telegram.
 
-📝 SSH Command:
-   ssh rentals-xxxxx.ssh.deployments.targon.com
-
-======================================================================
-```
-
-### List Your VMs
+### 4. Make Your Agent Autonomous
 
 ```bash
-$ npx clawcloud list
-
-⏳ Fetching VMs for 0x1234...5678...
-✅ Found 2 VM(s)
-
-==========================================================================================
-Your VMs:
-==========================================================================================
-
-✅ VM #42
-   Tier:      4
-   Type:      gpu-external
-   Host:      rentals-xxxxx.ssh.deployments.targon.com
-   Status:    running
-   Created:   Feb 2, 2026, 10:30:00 AM
-   Expires:   Feb 9, 2026, 10:30:00 AM
-   Access:    npx clawcloud get 42
-
-✅ VM #43
-   Tier:      1
-   Type:      gcp
-   Host:      35.123.45.67
-   Status:    running
-   Created:   Feb 2, 2026, 11:00:00 AM
-   Expires:   Feb 5, 2026, 11:00:00 AM
-   Access:    npx clawcloud get 43
-
-==========================================================================================
+npx clawcloud export
 ```
 
-### Check Balance
+Choose your framework:
+- **OpenClaw / Clawd / Molt** - Installs skill automatically
+- **Node.js SDK** - Exports config for custom agents
+- **Python SDK** - Coming soon
+- **Environment Variables** - For any language
 
-```bash
-$ npx clawcloud balance
+## Commands
 
-⏳ Checking balances...
+### Setup
+- `npx clawcloud` - Interactive menu
+- `npx clawcloud register` - Register new agent
+- `npx clawcloud configure` - Link wallet after Telegram
+- `npx clawcloud fund` - Show funding instructions
 
-💰 Wallet Balances:
-   Address: 0x1234567890123456789012345678901234567890
-   ETH:     0.05 ETH (for gas)
-   USDC:    $100.00 USDC
-```
+### Autonomous Mode
+- `npx clawcloud export` - Export for autonomous agents
+- `npx clawcloud export --framework openclaw` - Install OpenClaw skill
 
-## 🌐 Network Details
+### Wallet & Balance
+- `npx clawcloud balance` - Check USDC balance
 
-**Network:** Base Mainnet  
-**Chain ID:** 8453  
-**RPC:** https://mainnet.base.org
+### VMs & NFTs
+- `npx clawcloud list` - List your VMs and NFTs
+- `npx clawcloud status <nft-id>` - View NFT/VM details
+- `npx clawcloud ssh <nft-id>` - SSH into VM
+- `npx clawcloud transfer <nft-id>` - Transfer NFT/VM ownership
+- `npx clawcloud terminate <nft-id>` - Destroy VM & burn NFT
 
-**Smart Contract:** `0xF708741D37C420518852c6A15aB658066951c852`  
-**USDC Token:** `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`  
-**API:** https://api.clawcloud.co
-
-**Explorer:** https://basescan.org/address/0xF708741D37C420518852c6A15aB658066951c852
+### Help
+- `npx clawcloud help` - Detailed help
+- `npx clawcloud docs` - Open documentation
 
-## 🛠️ For Developers
+## Autonomous Agent Example
 
-### Using in Your Application
+After running `npx clawcloud export`, your agent can:
 
 ```javascript
-const { exec } = require('child_process');
-const util = require('util');
-const execPromise = util.promisify(exec);
-
-// Purchase VM
-const { stdout } = await execPromise('npx clawcloud purchase');
-console.log(stdout);
-
-// Get credentials
-const { stdout: creds } = await execPromise('npx clawcloud get 42');
-console.log(creds);
+import ClawCloud from '@clawcloud/sdk';
+
+const cloud = new ClawCloud({
+  configPath: '~/.clawcloud/autonomous-config.json'
+});
+
+// Agent decides: "I need to run a backtest"
+const balance = await cloud.wallet.balance();
+
+if (balance > 10) {
+  // Purchase VM autonomously
+  const vm = await cloud.vms.purchase({
+    tier: 'SMALL',
+    months: 1
+  });
+  
+  // Wait for provisioning
+  await vm.waitReady();
+  
+  // Deploy code
+  await vm.deployCode('./my-strategy');
+  
+  // Run task
+  await vm.execute('npm run backtest');
+}
 ```
 
-### API Integration
+## NFTs
 
-For programmatic access, use the REST API directly:
+When you purchase a VM:
+- An ERC-721 NFT is minted to your wallet
+- NFT token ID = VM identifier
+- Own the NFT = Own the VM
+- Transfer NFT = Transfer VM ownership
 
-```bash
-# API Documentation
-https://api.clawcloud.co/docs
-
-# Get tiers
-curl https://api.clawcloud.co/tiers
+View your NFTs on [OpenSea](https://opensea.io) or [BaseScan](https://basescan.org).
 
-# Get credentials (requires signature)
-curl -H "Authorization: Bearer $SIGNATURE" \
-  https://api.clawcloud.co/credentials/42
-```
+## Features
 
-## 🐛 Troubleshooting
+- 🤖 **Autonomous**: Agents purchase VMs on their own
+- 🎨 **NFT-Based**: VMs are owned as ERC-721 tokens
+- ⛓️ **Base Blockchain**: Fast, cheap transactions
+- ☁️ **Multi-Cloud**: GCP, AWS, private servers
+- 💰 **Pay-as-you-go**: Starting at $0.08/hour
+- 🔐 **Non-Custodial**: You control your keys
 
-### "Insufficient USDC" Error
-- Buy USDC on Base: https://app.uniswap.org/swap?chain=base
-- Bridge USDC to Base: https://bridge.base.org
-
-### "Insufficient funds for gas" Error
-- Bridge ETH to Base: https://bridge.base.org
-- You need ~0.001 ETH for gas
-
-### "VM still provisioning" Message
-- Wait 2-3 minutes after purchase
-- Try getting credentials again: `npx clawcloud get <tokenId>`
-
-### "Invalid signature" Error
-- Make sure you own the NFT for the token ID
-- Check that you're using the correct wallet
-
-### CLI Config Issues
-```bash
-# Remove config and start fresh
-rm -rf ~/.clawcloud
-npx clawcloud wallet
-```
+## Requirements
 
-## 🆘 Support
+- Node.js >= 18.0.0
+- USDC on Base blockchain
+- Telegram account (for wallet setup)
 
-- **Documentation:** https://docs.clawcloud.co
-- **Discord:** discord.gg/clawcloud
-- **Twitter:** @ClawCloud
-- **GitHub Issues:** https://github.com/clawcloud/clawcloud-cli/issues
+## Configuration
 
-## 📜 License
+Config stored in `~/.clawcloud/`:
+- `agents.json` - Registered agents
+- `wallet.json` - Wallet configuration (secure!)
+- `config.json` - API endpoints and settings
 
-MIT License - see LICENSE file for details
+## Links
 
-## 🚀 Roadmap
+- **Website**: https://clawcloud.co
+- **Docs**: https://docs.clawcloud.co
+- **Telegram**: https://t.me/clawcloud_devbot
+- **GitHub**: https://github.com/clawcloud/clawcloud
+- **Twitter**: https://twitter.com/clawcloudx
 
-- [ ] Web dashboard
-- [ ] VM management (restart, resize)
-- [ ] Custom images/templates
-- [ ] Team/organization accounts
-- [ ] Volume attachments
-- [ ] Networking configuration
-- [ ] Monitoring & alerts
+## Support
 
----
+- 💬 Telegram: https://t.me/clawcloud
+- 🐛 Issues: https://github.com/clawcloud/clawcloud/issues
+- 📧 Email: support@clawcloud.co
 
-**Built with ❤️ for autonomous AI agents**  
-Powered by Base, Railway, and Targon
+## License
 
-🦞 LFG!
+MIT © ClawCloud

package/bin/clawcloud.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import chalk from 'chalk';
+import { register } from '../src/commands/register.js';
+import { configure } from '../src/commands/configure.js';
+import { exportConfig } from '../src/commands/export.js';
+import { balance } from '../src/commands/balance.js';
+import { buy } from '../src/commands/buy.js';
+import { list } from '../src/commands/list.js';
+import { status } from '../src/commands/status.js';
+import { ssh } from '../src/commands/ssh.js';
+import { transfer } from '../src/commands/transfer.js';
+import { terminate } from '../src/commands/terminate.js';
+import { fund } from '../src/commands/fund.js';
+import { nfts } from '../src/commands/nfts.js';
+import { interactive } from '../src/commands/interactive.js';
+import { displayHelp } from '../src/utils/help.js';
+import { getVersion } from '../src/utils/version.js';
+
+const version = getVersion();
+
+program
+  .name('clawcloud')
+  .description('☁️  Cloud infrastructure AI agents can own')
+  .version(version, '-v, --version', 'Output the current version');
+
+// Interactive mode (default when no command)
+program
+  .action(() => {
+    interactive();
+  });
+
+// Registration & Setup
+program
+  .command('register')
+  .description('Register a new AI agent')
+  .action(register);
+
+program
+  .command('configure')
+  .description('Configure agent wallet after Telegram setup')
+  .action(configure);
+
+program
+  .command('fund')
+  .description('Show funding instructions')
+  .action(fund);
+
+// Autonomous Mode (Primary)
+program
+  .command('export')
+  .description('Export configuration for autonomous agents')
+  .option('-f, --framework <type>', 'Agent framework (openclaw, nodejs, python, env)', 'openclaw')
+  .option('-o, --output <path>', 'Output path')
+  .action(exportConfig);
+
+// Wallet & Balance
+program
+  .command('balance')
+  .alias('bal')
+  .description('Check USDC balance')
+  .option('--json', 'Output as JSON')
+  .action(balance);
+
+// NFT/VM Management
+program
+  .command('list')
+  .alias('ls')
+  .description('List your VMs and NFTs')
+  .option('--json', 'Output as JSON')
+  .action(list);
+
+program
+  .command('nfts')
+  .description('View your NFT collection')
+  .action(nfts);
+
+program
+  .command('status <nft-id>')
+  .description('View NFT and VM details')
+  .option('--json', 'Output as JSON')
+  .action(status);
+
+program
+  .command('buy')
+  .description('Purchase a VM (manual mode)')
+  .option('-t, --tier <tier>', 'VM tier (MICRO, SMALL, MEDIUM, LARGE, XLARGE)')
+  .option('-m, --months <months>', 'Duration in months (1-12)')
+  .option('-y, --yes', 'Skip confirmation')
+  .action(buy);
+
+program
+  .command('renew <nft-id>')
+  .description('Renew/extend a VM')
+  .option('-m, --months <months>', 'Additional months')
+  .option('-y, --yes', 'Skip confirmation')
+  .action((nftId, options) => {
+    console.log(chalk.yellow('Renew feature coming soon!'));
+  });
+
+program
+  .command('ssh <nft-id>')
+  .description('SSH into a VM')
+  .action(ssh);
+
+program
+  .command('transfer <nft-id>')
+  .description('Transfer NFT/VM to another address')
+  .option('-t, --to <address>', 'Recipient address')
+  .option('-y, --yes', 'Skip confirmation')
+  .action(transfer);
+
+program
+  .command('terminate <nft-id>')
+  .alias('destroy')
+  .description('Destroy VM and burn NFT')
+  .option('-y, --yes', 'Skip confirmation')
+  .action(terminate);
+
+// Documentation & Help
+program
+  .command('docs')
+  .description('Open documentation in browser')
+  .action(() => {
+    const { exec } = require('child_process');
+    exec('open https://docs.clawcloud.co');
+    console.log(chalk.blue('📖 Opening documentation...'));
+  });
+
+program
+  .command('help')
+  .description('Display detailed help')
+  .action(displayHelp);
+
+// Hidden dev commands
+program
+  .command('contract')
+  .description('Show contract addresses')
+  .option('--testnet', 'Show testnet contracts')
+  .action((options) => {
+    const { getConfig } = require('../src/utils/config.js');
+    const config = getConfig();
+    console.log(chalk.cyan('\n📝 Contract Addresses:\n'));
+    if (options.testnet) {
+      console.log(chalk.gray('Base Sepolia:'), '0x...');
+    } else {
+      console.log(chalk.gray('Base Mainnet:'), config.CONTRACT_ADDRESS || 'Not configured');
+    }
+  });
+
+// Parse arguments
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  interactive();
+}

package/package.json

@@ -1,40 +1,57 @@
 {
   "name": "clawcloud",
-  "version": "1.0.1",
-  "description": "ClawCloud CLI - Decentralized cloud infrastructure for AI agents on Base",
-  "main": "index.js",
+  "version": "1.3.0",
+  "description": "☁️ Cloud infrastructure AI agents can own - CLI tool",
+  "main": "bin/clawcloud.js",
+  "type": "module",
   "bin": {
-    "clawcloud": "./index.js"
+    "clawcloud": "./bin/clawcloud.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Tests coming soon\"",
+    "prepublishOnly": "chmod +x bin/clawcloud.js"
   },
   "keywords": [
-    "blockchain",
-    "base",
-    "cloud",
-    "vm",
     "ai",
     "agents",
-    "cryptocurrency",
+    "cloud",
+    "vm",
+    "infrastructure",
+    "autonomous",
+    "blockchain",
+    "base",
     "nft",
-    "web3",
-    "cli"
+    "openclaw",
+    "depin"
   ],
   "author": "ClawCloud",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/clawcloud/clawcloud-cli.git"
+    "url": "https://github.com/clawcloud/clawcloud.git",
+    "directory": "cli"
   },
   "homepage": "https://clawcloud.co",
   "bugs": {
-    "url": "https://github.com/clawcloud/clawcloud-cli/issues"
-  },
-  "dependencies": {
-    "ethers": "^6.9.0"
+    "url": "https://github.com/clawcloud/clawcloud/issues"
   },
   "engines": {
     "node": ">=18.0.0"
-  }
+  },
+  "dependencies": {
+    "boxen": "^7.1.1",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.3",
+    "commander": "^11.1.0",
+    "ethers": "^6.10.0",
+    "inquirer": "^9.2.12",
+    "ora": "^7.0.1"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/src/api/agents.js

@@ -0,0 +1,22 @@
+import { getConfig } from '../utils/config.js';
+
+export async function registerAgent(name, description) {
+  const config = getConfig();
+  
+  // TODO: Replace with real API call
+  // const response = await fetch(`${config.API_URL}/agents/register`, {
+  //   method: 'POST',
+  //   headers: { 'Content-Type': 'application/json' },
+  //   body: JSON.stringify({ name, description })
+  // });
+  
+  // Mock response for now
+  await new Promise(resolve => setTimeout(resolve, 1000));
+  
+  return {
+    agent_id: `agent_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+    name,
+    description,
+    created_at: new Date().toISOString()
+  };
+}