Drive Hub AI

One-command installer for Drive Hub (multi-account cloud dashboard) and NanoClaw (AI agent with container isolation).

What It Does

• Drive Hub — Next.js dashboard for managing Google Drive, OneDrive, Gmail, and Outlook accounts in one place
• NanoClaw — AI agent that automates file operations across your cloud accounts with container isolation

Quick Start

npx drive-hub-ai install --license YOUR-LICENSE-KEY

The installer clones, builds, and configures both services, then offers to run the setup wizard automatically. That's it.

Requirements

• macOS 10.15+ or Linux (Ubuntu 20.04+, Debian 11+, RHEL 8+)
• Node.js 20+
• Git
• Docker (for NanoClaw container isolation)

CLI Commands

drivehub-ai install --license <key>   Install Drive Hub + NanoClaw
drivehub-ai setup                     Run full setup (OAuth + AI agent)
drivehub-ai wizard                    Configure Google/Microsoft OAuth
drivehub-ai wizard-nanoclaw           Configure NanoClaw (AI, Docker, WhatsApp)
drivehub-ai start                     Start all services
drivehub-ai stop                      Stop all services
drivehub-ai restart                   Restart all services
drivehub-ai status                    Show service status and health
drivehub-ai update                    Update to latest version
drivehub-ai validate <key>            Validate a license key
drivehub-ai uninstall                 Remove everything

Installation Options

# Custom directory (default: ~/.drivehub-ai)
npx drive-hub-ai install --license YOUR-KEY --dir /opt/drivehub-ai

# Custom ports (default: 3000 / 3001)
npx drive-hub-ai install --license YOUR-KEY --drivehub-port 8080 --nanoclaw-port 8081

Setup Wizards

After installation, you'll be prompted to run the full setup automatically. You can also run each wizard separately:

OAuth Setup (drivehub-ai wizard)

Configures Google and Microsoft OAuth credentials for Drive Hub.

NanoClaw Setup (drivehub-ai wizard-nanoclaw)

Interactive wizard that configures:

• Docker — detects and auto-starts Docker if needed
• AI Provider — choose Anthropic (Claude), with OpenAI, Gemini, and Ollama coming soon
• API Key — validates your key against the provider's API
• WhatsApp — optional connection via pairing code (uses your phone as a linked device)

OAuth Configuration

Google

1. Go to Google Cloud Console
2. Create OAuth client ID (Web application)
3. Add redirect URI: http://localhost:3000/api/auth/callback/google
4. Copy Client ID and Secret into the wizard

Microsoft

1. Go to Azure App Registrations
2. New registration:
   • Supported account types: Accounts in any organizational directory and personal Microsoft accounts
   • Redirect URI: Web → http://localhost:3000/api/auth/callback/microsoft
3. Copy Application ID and create a Client Secret
4. Use consumers as Tenant ID for personal accounts

File Structure

~/.drivehub-ai/
├── drive-hub/           # Next.js dashboard
│   ├── .env.local       # OAuth credentials
│   └── dev.db           # SQLite database
├── nanoclaw/            # AI agent
│   ├── .env             # AI provider + API config
│   └── store/auth/      # WhatsApp session (if connected)
└── logs/
    ├── drivehub.log
    └── nanoclaw.log

Service Management

Services are installed as system services automatically:

• macOS — launchd (~/Library/LaunchAgents/com.drivehub.*.plist)
• Linux — systemd user services (~/.config/systemd/user/)

Use drivehub-ai start/stop/restart/status to manage them.

Troubleshooting

Services won't start

drivehub-ai status
tail -f ~/.drivehub-ai/logs/drivehub.log
tail -f ~/.drivehub-ai/logs/nanoclaw.log

OAuth authentication fails

1. Verify redirect URIs match exactly (including port)
2. Check OAuth consent screen is published (not testing mode)
3. Restart after changing credentials: drivehub-ai restart

Port already in use

Reinstall with custom ports or edit .env.local / .env manually, then restart.

Docker not running (NanoClaw)

The wizard auto-starts Docker, but if it fails:

# macOS
open -a Docker

# Linux
sudo systemctl start docker

Updating

drivehub-ai update

Pulls latest code, rebuilds, and restarts services.

Security

• License keys use Ed25519 asymmetric signatures (public key verification only)
• OAuth credentials stored locally with 0600 permissions
• API keys auto-generated with crypto.randomBytes
• NanoClaw runs operations in isolated Docker containers
• All cloud API calls use HTTPS

License

MIT — see LICENSE for details.

Links

• Drive Hub — dashboard source
• NanoClaw — AI agent source
• Issues