spawn/fly
A 0f4df7be71
feat: pre-built Docker image for OpenClaw on Fly.io (#1686)
Eliminates the slow waitForCloudInit() + bun install phase by booting
a pre-built image with Node.js, bun, and openclaw already installed.
The image is rebuilt daily via GitHub Actions to pick up new releases.

Other agents are unaffected — they still use ubuntu:24.04 + cloud-init.

Co-authored-by: spawn-bot <spawn-bot@openrouter.ai>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 02:50:46 -05:00
..
docker feat: pre-built Docker image for OpenClaw on Fly.io (#1686) 2026-02-22 02:50:46 -05:00
claude.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
codex.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
kilocode.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
openclaw.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
opencode.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
README.md refactor: convert fly/ cloud provider from bash to TypeScript (#1601) (#1602) 2026-02-21 10:41:34 -08:00
zeroclaw.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00

Fly.io

Fly.io Machines via REST API and flyctl CLI. Fly.io

Architecture

The Fly.io provider is implemented in TypeScript (Bun runtime). Each .sh agent script is a thin shim that ensures bun is installed, downloads the TS sources if running via bash <(curl ...), and delegates to main.ts.

fly/
  main.ts               # Orchestrator: auth → provision → install → launch
  lib/
    fly.ts              # Core provider: API client, auth, orgs, provisioning
    agents.ts           # Agent configs (all 6) + shared install/config helpers
    oauth.ts            # OpenRouter OAuth flow (Bun.serve), key validation
    ui.ts               # Logging (ANSI), prompts (readline), browser open
  {agent}.sh            # Thin bash shim → bun run main.ts {agent}

No external dependencies — all modules use built-in Bun/Node APIs only. The fly/ directory has no package.json.

Agents

Claude Code

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/claude.sh)

OpenClaw

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/openclaw.sh)

ZeroClaw

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/zeroclaw.sh)

Codex CLI

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/codex.sh)

OpenCode

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/opencode.sh)

Kilo Code

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/kilocode.sh)

Non-Interactive Mode

FLY_APP_NAME=dev-mk1 \
FLY_API_TOKEN=your-token \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/claude.sh)

Environment Variables

Variable Description Default
FLY_API_TOKEN Fly.io API token (prompted or from flyctl auth)
FLY_APP_NAME App name (prompted)
FLY_REGION Deployment region iad
FLY_VM_SIZE VM size shared-cpu-1x
FLY_VM_MEMORY VM memory (MB) 1024
FLY_ORG Organization slug personal
OPENROUTER_API_KEY OpenRouter API key (OAuth or prompted)