fly-machines for Openclaw

A powerful developer tool for programmatically managing Fly.io Machines and containerized infrastructure using the Openclaw Skills framework.

mrgoodb
v1.0.0
Jan 30, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install fly-machines

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install fly-machines using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is fly-machines?

The fly-machines skill enables seamless interaction with the Fly.io Machines API, allowing users to deploy, monitor, and scale independent Firecracker microVMs. This integration within the Openclaw Skills library empowers developers to manage containerized apps globally with high precision and low latency.

By leveraging this skill, developers can automate the lifecycle of their infrastructure, from creating apps and provisioning regional volumes to managing secrets and scaling workloads to zero. It provides a structured way to handle everything from simple app deployments to complex multi-tenant orchestration, ensuring your infrastructure is as dynamic as your code.

fly-machines Use Cases

  • Deploying containerized bot instances dynamically based on user demand.
  • Automating the lifecycle of ephemeral environments for testing or CI/CD.
  • Orchestrating multi-region workloads to minimize latency for global users.
  • Managing persistent storage through regional Fly.io volumes.
  • Scaling applications to zero to optimize costs during idle periods.

How fly-machines Works

  1. Authenticate using a Fly.io API token stored in local configuration or environment variables.
  2. Create or select a Fly.io application to act as a logical container for your machines.
  3. Define and provision new Machines (microVMs) using specific Docker images, CPU/memory guest configurations, and regional settings.
  4. Manage the machine lifecycle by issuing start, stop, or delete commands via the Machines API.
  5. Monitor machine states and health checks to ensure high availability and performance across the fleet.

fly-machines Setup

Get a Fly.io API token from the Fly.io dashboard and configure your environment to use this skill:

mkdir -p ~/.config/fly
echo "your_token_here" > ~/.config/fly/token

Alternatively, set the environment variable directly:

export FLY_API_TOKEN="your_token_here"

fly-machines Data Schema & Taxonomy

The skill interacts with several key entities defined by the Fly.io Machines API. Below is the taxonomy of the data handled:

Entity Primary Attributes
App app_name, org_slug, status
Machine id, name, region, image, state, config (guest, env, services)
Volume id, name, size_gb, region, attached_machine_id
Secret key, value (exposed as environment variables to all machines)

fly-machines Advanced Features

  • Auto-Stop/Start: Configure machines to automatically shut down after an idle timeout and wake up instantly upon receiving requests.
  • Regional Orchestration: Deploy machines to specific global regions like iad, lax, cdg, or sin for localized performance.
  • Private Networking: Enable secure communication between machines using internal .internal DNS entries.
  • Persistent Volumes: Attach and manage regional storage that persists across machine restarts and re-provisions.
  • Secret Management: Securely inject sensitive configuration data into all app instances at runtime via the secrets API.

SKILL.md


Loading

METADATA

Github Stars: 0
forks: 0

Featured*