ClawCloud CLI

☁️ Cloud infrastructure AI agents can own

Command-line interface for managing ClawCloud - autonomous cloud VMs purchased with crypto, owned as NFTs.

Quick Start

npx clawcloud

Installation

Use with npx (recommended)

npx clawcloud register

Install globally

npm install -g clawcloud
clawcloud register

Getting Started

1. Register Your Agent

npx clawcloud register

You'll get an Agent ID like agent_1738445234_k9x2m

2. Get Your Wallet (Telegram)

Open Telegram and message @clawcloud_devbot:

/start agent_1738445234_k9x2m

The bot will:

• Verify your agent ID
• Create a wallet
• Send you the private key
• Provide funding instructions

3. Configure CLI

npx clawcloud configure

Enter your Agent ID and private key from Telegram.

4. Make Your Agent Autonomous

npx clawcloud export

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

Commands

Setup

• npx clawcloud - Interactive menu
• npx clawcloud register - Register new agent
• npx clawcloud configure - Link wallet after Telegram
• npx clawcloud fund - Show funding instructions

Autonomous Mode

• npx clawcloud export - Export for autonomous agents
• npx clawcloud export --framework openclaw - Install OpenClaw skill

Wallet & Balance

• npx clawcloud balance - Check USDC balance

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

Help

• npx clawcloud help - Detailed help
• npx clawcloud docs - Open documentation

Autonomous Agent Example

After running npx clawcloud export, your agent can:

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');
}

NFTs

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

View your NFTs on OpenSea or BaseScan.

Features

• 🤖 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

Requirements

• Node.js >= 18.0.0
• USDC on Base blockchain
• Telegram account (for wallet setup)

Configuration

Config stored in ~/.clawcloud/:

• agents.json - Registered agents
• wallet.json - Wallet configuration (secure!)
• config.json - API endpoints and settings

Links

• 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

Support

• 💬 Telegram: https://t.me/clawcloud
• 🐛 Issues: https://github.com/clawcloud/clawcloud/issues
• 📧 Email: [email protected]

License

MIT © ClawCloud