clawcloud 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