Skip to main content
Version: v1.9

Quickstart

This guide walks you through installing the Obol Stack, setting up an AI agent, and optionally deploying a blockchain network.

Prerequisites​

  • Docker installed and running on your machine.
  • macOS or Linux operating system.
  • At least 8 GB of RAM available.
info

Ensure Docker is running before proceeding. You can verify this by running docker info in your terminal.

Step 1: Install Obol Stack​

Run the bootstrap installer:

bash <(curl -s https://stack.obol.org)

The installer will:

  1. Validate that Docker is running.
  2. Install the obol CLI binary and dependencies (kubectl, helm, k3d, helmfile, k9s).
  3. Configure your PATH and add obol.stack to /etc/hosts.
  4. Offer to start the cluster immediately.
bash <(curl -s https://stack.obol.org)

Files are installed to:

  • Config: ~/.config/obol/
  • Data: ~/.local/share/obol/
  • Binaries: ~/.local/bin/

Step 2: Start the stack​

obol stack init
obol stack up
info

The first startup may take a few minutes as Docker pulls the required images.

Step 3: Set up the AI agent​

Initialize an OpenClaw agent instance:

obol agent init

This walks you through choosing a model provider:

  • Ollama (local, free) - if Ollama is detected on your machine
  • Anthropic or OpenAI - routed through the in-cluster llmspy gateway

Once complete, open the agent dashboard:

obol openclaw dashboard

Each agent is automatically provisioned with an Ethereum signing wallet (via the remote-signer service). The wallet address is displayed during setup.

tip

You can reconfigure the model provider at any time with obol openclaw setup.

Step 4: Deploy a blockchain network (optional)​

Install an Ethereum node on the Hoodi testnet:

obol network install ethereum --network=hoodi

Deploy it to the cluster (replace with your deployment ID):

obol network sync ethereum/<your-id>
warning

Replace the ID with the actual deployment ID shown in your terminal output (e.g., knowing-wahoo).

Check the deployment:

obol kubectl get pods -n ethereum-<your-id>

Step 5: Explore​

# Interactive cluster UI
obol k9s

# View all pods
obol kubectl get pods -A

# Check tunnel status (public URL)
obol tunnel status

# Configure model provider globally
obol model setup

Stopping and cleaning up​

# Stop the cluster (preserves data)
obol stack down

# Restart
obol stack up

# Remove everything including data
obol stack purge -f
warning

obol stack purge -f is irreversible. It removes all cluster data and configuration.

Next steps​