clawmacdo 0.9.0 → 0.10.0

package/README.md

@@ -0,0 +1,355 @@
+# clawmacdo
+
+[![Release](https://github.com/kenken64/clawmacdo/actions/workflows/release.yml/badge.svg)](https://github.com/kenken64/clawmacdo/actions/workflows/release.yml)
+[![Changelog](https://github.com/kenken64/clawmacdo/actions/workflows/changelog.yml/badge.svg)](https://github.com/kenken64/clawmacdo/actions/workflows/changelog.yml)
+
+Rust CLI tool for deploying [OpenClaw](https://openclaw.ai) to **DigitalOcean**, **AWS Lightsail**, **Tencent Cloud**, or **Microsoft Azure** — with Claude Code, Codex, and Gemini CLI pre-installed.
+
+## ✨ What's New in v0.9.0
+
+- **Deploy progress tracking** — All 16 deploy steps are now persisted to SQLite in real-time
+- **`clawmacdo track` command** — Query deploy progress by ID, hostname, or IP address
+- **Follow mode** (`--follow`) — Live-polling display that refreshes until deployment finishes
+- **JSON output** (`--json`) — NDJSON format for programmatic consumption
+- **Clap-based CLI** — Proper subcommand routing with `track` and `serve`
+
+### Previous highlights
+- **Modular workspace** — Each crate has a single responsibility with feature flags
+- **4 cloud providers** — DigitalOcean, AWS Lightsail, Tencent Cloud, Microsoft Azure
+- **npm distribution** — `npm install -g clawmacdo`
+
+## 🏗️ Project Structure
+
+```
+clawmacdo/
+├── Cargo.toml              # Workspace configuration
+├── crates/                 # All crates in workspace
+│   ├── clawmacdo-cli/      # 🖥️  Main CLI binary & command orchestration
+│   ├── clawmacdo-core/     # 🔧  Config, errors, shared types
+│   ├── clawmacdo-cloud/    # ☁️   Cloud provider implementations
+│   ├── clawmacdo-provision/# 🔨  Server provisioning & setup logic  
+│   ├── clawmacdo-db/       # 💾  Database operations & storage
+│   ├── clawmacdo-ssh/      # 🔑  SSH/SCP operations & key management
+│   └── clawmacdo-ui/       # 🎨  Web UI, progress bars, user prompts
+├── assets/                 # Static assets (mascot, etc.)
+└── README.md
+```
+
+### 📦 Crate Overview
+
+| Crate | Purpose | Dependencies |
+|-------|---------|--------------|
+| **clawmacdo-cli** | Main binary, command parsing, orchestration | All other crates |
+| **clawmacdo-core** | Configuration, errors, shared types | Minimal (serde, anyhow) |
+| **clawmacdo-cloud** | DigitalOcean, AWS Lightsail & Tencent Cloud APIs | reqwest, async-trait |
+| **clawmacdo-provision** | Server setup, package installation | SSH, Core, UI |
+| **clawmacdo-db** | SQLite operations, job tracking | rusqlite |
+| **clawmacdo-ssh** | SSH connections, file transfers | ssh2 |
+| **clawmacdo-ui** | Progress bars, web interface | indicatif, axum |
+
+## Features
+
+- **Multi-cloud**: Deploy to DigitalOcean, AWS Lightsail, or Tencent Cloud with `--provider` flag
+- **Backup** local `~/.openclaw/` config into a timestamped `.tar.gz`
+- **1-click deploy**: generate SSH keys, provision a cloud instance, install Node 24 + OpenClaw + Claude Code + Codex + Gemini CLI, restore config, configure `.env` (API + messaging), start the gateway, and auto-configure model failover
+- **Cloud-to-cloud migration**: SSH into a source instance, back up remotely, deploy to a new instance, restore
+- **Destroy**: delete an instance by name with confirmation, clean up SSH keys (cloud + local)
+- **Status**: list all openclaw-tagged instances with IPs
+- **List backups**: show local backup archives with sizes and dates
+- **Web UI**: Browser-based deploy interface with real-time SSE progress streaming (optional)
+- **Security groups**: Auto-create firewall rules on Tencent Cloud (SSH + HTTP/HTTPS)
+
+## Supported Cloud Providers
+
+| Provider | Flag | Credentials | Prerequisite |
+|----------|------|-------------|-------------|
+| DigitalOcean | `--provider=digitalocean` (default) | `--do-token` | — |
+| AWS Lightsail | `--provider=lightsail` (or `aws`) | `--aws-access-key-id` + `--aws-secret-access-key` | [AWS CLI](https://aws.amazon.com/cli/) installed |
+| Tencent Cloud | `--provider=tencent` | `--tencent-secret-id` + `--tencent-secret-key` | — |
+| Microsoft Azure | `--provider=azure` (or `az`) | `--azure-tenant-id` + `--azure-subscription-id` + `--azure-client-id` + `--azure-client-secret` | [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/) installed |
+
+## Download
+
+Pre-built binaries for every release are available on the [Releases page](https://github.com/kenken64/clawmacdo/releases):
+
+| Platform | Architecture | File |
+|----------|-------------|------|
+| Windows  | x86_64      | `clawmacdo-windows-amd64.zip` |
+| Linux    | x86_64      | `clawmacdo-linux-amd64.tar.gz` |
+| macOS    | Apple Silicon (arm64) | `clawmacdo-darwin-arm64.tar.gz` |
+
+## Installation
+
+### From npm (recommended)
+
+```bash
+npm install -g clawmacdo
+```
+
+### From release binary
+
+Download the archive for your platform from [Releases](https://github.com/kenken64/clawmacdo/releases), extract, and add to your `PATH`.
+
+### From source
+
+#### Full build (all features)
+```bash
+cargo build --release
+# Binary: target/release/clawmacdo (4.6MB)
+```
+
+#### Minimal build (CLI only, no web UI)
+```bash
+cargo build --release --no-default-features --features minimal
+# Binary: target/release/clawmacdo (3.1MB - 32% smaller!)
+```
+
+#### DigitalOcean-only build
+```bash
+cargo build --release --no-default-features --features digitalocean-only
+# Binary: target/release/clawmacdo (3.1MB, no Tencent Cloud)
+```
+
+#### AWS Lightsail-only build
+```bash
+cargo build --release --no-default-features --features aws-only
+# Binary: target/release/clawmacdo (Lightsail only, requires AWS CLI)
+```
+
+## Build Features
+
+| Feature | Description | Default |
+|---------|-------------|---------|
+| `web-ui` | Browser-based deployment interface | ✅ |
+| `lightsail` | AWS Lightsail provider support (via AWS CLI) | ✅ |
+| `tencent-cloud` | Tencent Cloud provider support | ✅ |
+| `azure` | Microsoft Azure provider support (via Azure CLI) | ✅ |
+| `digitalocean` | DigitalOcean provider support | ✅ |
+| `aws-only` | Lightsail-only build (no DO or Tencent) | ❌ |
+| `minimal` | CLI-only, no web UI or optional features | ❌ |
+
+## Usage
+
+### Deploy OpenClaw to DigitalOcean
+
+```bash
+# Set your DO token
+export DO_TOKEN="your_digitalocean_api_token"
+
+# Deploy with backup & restore
+clawmacdo deploy \
+  --customer-name "my-openclaw" \
+  --restore-from ~/backups/openclaw-backup-2024-03-09.tar.gz
+```
+
+### Deploy to AWS Lightsail
+
+> **Prerequisite:** [AWS CLI](https://aws.amazon.com/cli/) must be installed and accessible in your `PATH`.
+
+```bash
+# Set AWS credentials
+export AWS_ACCESS_KEY_ID="your_access_key_id"
+export AWS_SECRET_ACCESS_KEY="your_secret_access_key"
+export AWS_REGION="us-east-1"  # default region
+
+# Deploy to Lightsail
+clawmacdo deploy \
+  --provider lightsail \
+  --customer-name "my-openclaw" \
+  --customer-email "you@example.com" \
+  --aws-region us-east-1
+```
+
+#### Lightsail Instance Sizes
+
+| clawmacdo `--size` | Lightsail Bundle | vCPU | RAM | Price |
+|--------------------|-----------------|------|-----|-------|
+| `s-1vcpu-2gb` | `small_3_0` | 1 | 2 GB | ~$10/mo |
+| `s-2vcpu-4gb` *(default)* | `medium_3_0` | 2 | 4 GB | ~$20/mo |
+| `s-4vcpu-8gb` | `large_3_0` | 4 | 8 GB | ~$40/mo |
+
+### Deploy to Tencent Cloud
+
+```bash
+# Set Tencent credentials
+export TENCENT_SECRET_ID="your_secret_id"
+export TENCENT_SECRET_KEY="your_secret_key"
+
+# Deploy to Hong Kong region
+clawmacdo deploy \
+  --provider tencent \
+  --customer-name "my-openclaw-hk" \
+  --region ap-hongkong
+```
+
+### Track Deploy Progress
+
+```bash
+# Track by deploy ID, hostname, or IP
+clawmacdo track <deploy-id>
+
+# Follow mode — live refresh until complete
+clawmacdo track <deploy-id> --follow
+
+# JSON output (NDJSON)
+clawmacdo track <deploy-id> --json
+```
+
+### Web UI Mode
+
+```bash
+# Start browser interface
+clawmacdo serve --port 3456
+# Open http://localhost:3456
+```
+
+### Cloud Migration
+
+```bash
+# Migrate from one cloud to another
+clawmacdo migrate \
+  --source-ip 1.2.3.4 \
+  --source-ssh-key ~/.ssh/old_instance \
+  --target-provider tencent \
+  --customer-name "migrated-openclaw"
+```
+
+### Backup & Restore
+
+```bash
+# Create local backup
+clawmacdo backup
+
+# List backups
+clawmacdo list-backups
+
+# Deploy with specific backup
+clawmacdo deploy --restore-from ~/.openclaw/backups/openclaw-2024-03-09_14-30-15.tar.gz
+```
+
+## Examples
+
+### Full Deploy with All Options
+
+```bash
+clawmacdo deploy \
+  --provider digitalocean \
+  --customer-name "production-openclaw" \
+  --size s-2vcpu-4gb \
+  --region nyc1 \
+  --restore-from ~/openclaw-backup.tar.gz \
+  --claude-api-key "$CLAUDE_API_KEY" \
+  --openai-api-key "$OPENAI_API_KEY" \
+  --whatsapp-phone "+1234567890" \
+  --telegram-token "$TELEGRAM_TOKEN" \
+  --tailscale \
+  --tailscale-auth-key "$TAILSCALE_AUTH"
+```
+
+### Quick Status Check
+
+```bash
+# List all instances
+clawmacdo status
+
+# Check specific provider
+clawmacdo status --provider tencent
+```
+
+## Development
+
+### Workspace Commands
+
+```bash
+# Build all crates
+cargo build
+
+# Test all crates
+cargo test
+
+# Build specific crate
+cargo build -p clawmacdo-core
+
+# Run clippy on workspace
+cargo clippy --all
+
+# Update dependencies
+cargo update
+```
+
+### Adding Dependencies
+
+Add to workspace `Cargo.toml`:
+```toml
+[workspace.dependencies]
+new-crate = "1.0"
+```
+
+Then reference in individual crate:
+```toml
+[dependencies]
+new-crate = { workspace = true }
+```
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `DO_TOKEN` | DigitalOcean API token | For DO deploys |
+| `AWS_ACCESS_KEY_ID` | AWS IAM access key ID | For Lightsail deploys |
+| `AWS_SECRET_ACCESS_KEY` | AWS IAM secret access key | For Lightsail deploys |
+| `AWS_REGION` | AWS region (default: `us-east-1`) | For Lightsail deploys |
+| `TENCENT_SECRET_ID` | Tencent Cloud Secret ID | For Tencent deploys |
+| `TENCENT_SECRET_KEY` | Tencent Cloud Secret Key | For Tencent deploys |
+| `AZURE_TENANT_ID` | Azure AD tenant ID | For Azure deploys |
+| `AZURE_SUBSCRIPTION_ID` | Azure subscription ID | For Azure deploys |
+| `AZURE_CLIENT_ID` | Azure service principal client ID | For Azure deploys |
+| `AZURE_CLIENT_SECRET` | Azure service principal client secret | For Azure deploys |
+| `CLAUDE_API_KEY` | Anthropic Claude API key | Optional |
+| `OPENAI_API_KEY` | OpenAI API key | Optional |
+| `TELEGRAM_TOKEN` | Telegram bot token | Optional |
+| `TAILSCALE_AUTH_KEY` | Tailscale auth key | Optional |
+
+## Architecture Notes
+
+The refactored workspace follows a **dependency hierarchy**:
+
+1. **clawmacdo-core** - Foundation (no internal deps)
+2. **clawmacdo-ssh** - Depends on core
+3. **clawmacdo-db** - Depends on core  
+4. **clawmacdo-ui** - Depends on core
+5. **clawmacdo-cloud** - Depends on core
+6. **clawmacdo-provision** - Depends on core, ssh, ui, cloud
+7. **clawmacdo-cli** - Orchestration layer (depends on all)
+
+This prevents circular dependencies and enables clean testing.
+
+## Performance Optimizations
+
+- **LTO enabled** for release builds
+- **Panic = abort** for smaller binaries
+- **Symbol stripping** in release mode
+- **Feature gates** for optional components
+- **Minimal Tokio features** (not "full")
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new functionality  
+4. Run `cargo clippy` and `cargo test`
+5. Submit a pull request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history and breaking changes.
+
+---
+
+**Last updated:** March 14, 2026
+**Current version:** 0.9.0
+**Architecture version:** 2.0 (modular workspace)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmacdo",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "CLI tool for deploying OpenClaw to multiple cloud providers with pre-installed AI dev tools",
   "keywords": [
     "openclaw",
@@ -30,8 +30,8 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@clawmacdo/darwin-arm64": "0.9.0",
-    "@clawmacdo/linux-x64": "0.9.0",
-    "@clawmacdo/win32-x64": "0.9.0"
+    "@clawmacdo/darwin-arm64": "0.10.0",
+    "@clawmacdo/linux-x64": "0.10.0",
+    "@clawmacdo/win32-x64": "0.10.0"
   }
 }