Skip to content

Installation

Rigs is an OpenClaw skill — it runs inside OpenClaw, your AI agent platform. You'll need OpenClaw installed first, then add Rigs as a skill.

Prerequisites

Requirement Why
OpenClaw The AI agent that runs Rigs and connects to your chat channels
Python 3.8+ Rigs dashboard and CLI
ComfyUI The local image/video generation server (running or reachable)
Node.js 18+ Required by OpenClaw

Step 1: Install OpenClaw

If you don't have OpenClaw yet:

npm install -g openclaw

Then start the gateway:

openclaw gateway start

OpenClaw connects to your chat channels (Discord, Telegram, iMessage, Slack, Signal, WhatsApp, and more). See the OpenClaw docs for channel setup.

Already have OpenClaw?

Skip to Step 2. Rigs works with any existing OpenClaw setup.

Step 2: Install the Rigs Skill

curl -fsSL https://raw.githubusercontent.com/mitchellfox/rigs/main/install.sh | bash

This clones the repository into ~/.openclaw/skills/rigs/ and installs the rigs CLI into ~/.local/bin.

Step 3: Start the Dashboard

python3 ~/.openclaw/skills/rigs/scripts/server.py

Open http://localhost:8787 in your browser.

Run as a service

For always-on operation, set up a systemd user service so the dashboard starts on boot and auto-connects to the network.

Step 4: Add a ComfyUI Server

In the dashboard, click Add Server and enter your ComfyUI URL:

  • Local: http://127.0.0.1:8188
  • Remote: http://192.168.x.x:8188

Or via CLI:

rigs server add \
  --name "My GPU" \
  --url http://127.0.0.1:8188 \
  --default

Step 5: Import a Workflow

Drag a ComfyUI workflow JSON file into the dashboard, or use the CLI:

rigs workflow import /path/to/workflow_api.json \
  --server <server-id> \
  --title "FLUX Text to Image" \
  --emoji "🖼️"

Rigs auto-classifies inputs and outputs from the workflow JSON.

Step 6: Generate via Chat

Once your workflow is imported and your OpenClaw agent is running, just message it:

You: "generate a sunset over mountains using FLUX"
Agent: 🖼️ Running FLUX Klein T2I...
Agent: [image delivered in chat]

The output appears in your chat and in the dashboard gallery at localhost:8787.

Local Files

Rigs stores everything under:

~/.openclaw/rigs/
  config.json      # servers, workflows, templates, pipelines, network settings
  gallery.json     # output metadata
  outputs/         # downloaded output files
  covers/          # workflow cover art
  showcase/        # showcase images
  style_refs/      # AI-enhanced reference images

Verify Installation

# Check CLI
rigs server list

# Check dashboard
curl -s http://localhost:8787/api/servers | python3 -m json.tool

Next Steps