[Integrations](https://spiral.ai/integrations) › [OpenClaw](https://spiral.ai/integrations/openclaw) › [Aion 3.0](https://spiral.ai/integrations/openclaw/aion-3-0)

# How to Use Aion 3.0 in OpenClaw

Aion 3.0 is built for roleplay and fiction that needs stronger plot structure, tension, and conflict. Multiple specialized models contribute to each response, making collaborative storytelling its defining focus.

|  |  |
| --- | --- |
| Model | Aion 3.0 |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.032086 per run at the default inputs. $3.90 per 1M input tokens, $7.80 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Aion 3.0 in OpenClaw

- Every Monday, use Aion 3.0 to draft five tabletop encounter ideas from the campaign recap supplied for that run. Include a motive, an obstacle, and two possible resolutions for each.
- Each morning, use Aion 3.0 to create one 200-word fiction exercise about conflicting loyalties. Include a setting, two competing goals, and a decision for the writer to resolve.
- Every Friday, use Aion 3.0 to draft a 700-word serial installment from the latest approved recap. Preserve established events and end with one unresolved choice.
- Once a week, use Aion 3.0 to propose three escalating complications for the current story outline supplied with the run. Explain which character decision triggers each complication.
- Each evening, use Aion 3.0 with reasoning enabled to draft a short conversation between two fictional rivals from the supplied character descriptions. Keep it under 400 words and give both a reason to compromise.

## How to set up Aion 3.0 in OpenClaw

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send OpenClaw this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Add the server**: On the machine that runs OpenClaw's Gateway:

```bash
openclaw mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --transport streamable-http \
  --auth oauth
```

2. **Sign in**: In Settings › MCP, select Sign in on the Spiral server, sign in to Spiral and click Authorize. No API key.

```bash
openclaw mcp login spiral
```

3. **Reload and check**: A running Gateway may keep its old tool list: restart it, or Save & Publish in the Control UI.

```bash
openclaw mcp reload
openclaw mcp doctor spiral --probe
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Aion 3.0**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "openrouter",
    "model": "aion-labs/aion-3.0",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: OpenClaw finds Aion 3.0 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/openclaw

## Aion 3.0 tools and prices

- [AionLabs: Aion-3.0](https://spiral.ai/tools/openrouter/aion-labs/aion-3.0) (OpenRouter): Up to $0.032086 per run at the default inputs. $3.90 per 1M input tokens, $7.80 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tools |  | — |  |
| top_p | 0 to 1 | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 1 to 32768 | — | The most output tokens to generate. |
| temperature | 0 to 2 | — |  |
| tool_choice |  | — |  |

## What can you do with Aion 3.0 in OpenClaw?

Aion 3.0 can supply recurring drafts for a fiction serial, roleplay campaign, or writing practice. Give each run the current recap and constraints, and collect the results for review.

### Interactive character conversations

Use Aion 3.0 to play a fictional character with a clear goal, a secret, and a reason to resist the reader.

### Branching game dialogue

Ask Aion 3.0 for dialogue choices with distinct consequences, then review each branch against the game's established events.

### Scene revisions

Give Aion 3.0 a scene and request a revision that raises the stakes while preserving its point of view and ending.

### Tabletop encounters

Have Aion 3.0 draft an encounter with competing motives, a time constraint, and several possible resolutions.

### Plot outlines

Use Aion 3.0 to turn a premise into escalating story beats, with a concrete consequence attached to each major choice.

### Serialized fiction drafts

Ask Aion 3.0 to draft one installment from a supplied recap, ending on an unresolved decision for editorial review.

## Overview

- [OpenRouter](https://spiral.ai/providers/openrouter)
- [All OpenClaw guides](https://spiral.ai/integrations/openclaw)

## Aion 3.0 in other agents

- [Amp](https://spiral.ai/integrations/amp/aion-3-0)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/aion-3-0)
- [Claude](https://spiral.ai/integrations/claude-desktop/aion-3-0)
- [Claude Code](https://spiral.ai/integrations/claude-code/aion-3-0)
- [Cline](https://spiral.ai/integrations/cline/aion-3-0)
- [Codex](https://spiral.ai/integrations/codex/aion-3-0)
- [Cursor](https://spiral.ai/integrations/cursor/aion-3-0)
- [Devin](https://spiral.ai/integrations/devin/aion-3-0)
- [dots](https://spiral.ai/integrations/dots/aion-3-0)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/aion-3-0)
- [Gemini](https://spiral.ai/integrations/gemini/aion-3-0)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/aion-3-0)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/aion-3-0)
- [goose](https://spiral.ai/integrations/goose/aion-3-0)
- [Grok](https://spiral.ai/integrations/grok/aion-3-0)
- [Grok Build](https://spiral.ai/integrations/grok-build/aion-3-0)
- [Hermes](https://spiral.ai/integrations/hermes/aion-3-0)
- [Instinct](https://spiral.ai/integrations/instinct/aion-3-0)
- [Manus](https://spiral.ai/integrations/manus/aion-3-0)
- [Muse](https://spiral.ai/integrations/muse/aion-3-0)
- [Muse Code](https://spiral.ai/integrations/muse-code/aion-3-0)
- [n8n](https://spiral.ai/integrations/n8n/aion-3-0)
- [Notion](https://spiral.ai/integrations/notion/aion-3-0)
- [opencode](https://spiral.ai/integrations/opencode/aion-3-0)
- [Perplexity](https://spiral.ai/integrations/perplexity/aion-3-0)
- [Raycast](https://spiral.ai/integrations/raycast/aion-3-0)
- [VS Code](https://spiral.ai/integrations/vscode/aion-3-0)
- [Windsurf](https://spiral.ai/integrations/windsurf/aion-3-0)
- [Zapier](https://spiral.ai/integrations/zapier/aion-3-0)

## More OpenClaw guides

- [Aion 2.0](https://spiral.ai/integrations/openclaw/aion-2-0)
- [Aion 3.0 Mini](https://spiral.ai/integrations/openclaw/aion-3-0-mini)
- [bible-api.com random Bible verse](https://spiral.ai/integrations/openclaw/bible-api-com-random-bible-verse)
- [Aion 3.5](https://spiral.ai/integrations/openclaw/aion-3-5)
- [bible-api.com Bible translations](https://spiral.ai/integrations/openclaw/bible-api-com-bible-translations)
- [Aion 3.5 Mini](https://spiral.ai/integrations/openclaw/aion-3-5-mini)

## Questions about Aion 3.0 in OpenClaw

**Can OpenClaw use Aion 3.0?**

Yes. Add Spiral to OpenClaw as an MCP server, and OpenClaw can find and run Aion 3.0 like any built-in tool.

**How much does Aion 3.0 cost in OpenClaw?**

Up to $0.032086 per run at the default inputs. $3.90 per 1M input tokens, $7.80 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your OpenClaw plan is separate.

**Do I need an OpenRouter account to use Aion 3.0 in OpenClaw?**

No. Spiral runs Aion 3.0 on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Aion 3.0 in OpenClaw?**

About two minutes: add the server, then sign in, then reload and check.

**Does OpenClaw wait while Aion 3.0 runs?**

Aion 3.0 runs in the background. OpenClaw starts the run, checks on it and gives you the text, json when it's ready.

**What is Aion 3.0 good at?**

Aion 3.0 focuses on roleplay and storytelling, especially narrative structure, tension, and conflict. Try it for character conversations, scene drafts, and branching story choices.

**How much text can Aion 3.0 handle?**

Aion 3.0 has a 131,072-token context window and a maximum completion of 32,768 tokens. Internal reasoning shares the completion allowance with the visible answer.

**Should I leave reasoning enabled?**

Yes. Aion Labs says its models are tuned for reasoning and that disabling it can reduce output quality.

**Why might Aion 3.0 return no visible answer?**

Reasoning can consume the entire completion budget before visible text begins. Allow room for both reasoning and the requested answer, or request a shorter answer.

**Can Aion 3.0 return story data as JSON?**

Yes, but JSON output does not enforce a JSON schema. Validate required keys and value types before using generated dialogue or quest data in an application.

