> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shuttleai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run OpenClaw with ShuttleAI

> Connect OpenClaw to ShuttleAI in minutes — one API for Claude, GPT, and more.

[OpenClaw](https://openclaw.com) is a powerful open-source AI agent. It can browse the web, manage files, run terminal commands, and connect to apps like Discord or WhatsApp.

ShuttleAI gives you **one API** for Claude, GPT, and other top models — so you don't have to juggle multiple providers. One subscription. One endpoint. Simple.

## Why use ShuttleAI with OpenClaw?

OpenClaw supports any LLM provider. ShuttleAI makes it easier by unifying everything under one API:

* **ShuttleAI Auto** — Smart router that picks the best model for each task
* **Claude Opus 4.6** — Deep reasoning and complex agent workflows
* **Claude Sonnet 4.6** — Fast, high-quality responses
* **GPT-5.2** — Latest GPT-5 series
* **GPT-OSS 120B** — Free, high-performance open-source model
* And more at [shuttleai.com/models](https://shuttleai.com/models)

No switching dashboards. No juggling API keys from different companies.

## Step 1 — Create a ShuttleAI account

<Steps>
  <Step title="Sign up">
    Go to [shuttleai.com](https://shuttleai.com) and click **Get API Key** to create your account.
  </Step>

  <Step title="Choose a plan">
    Pick a plan based on the models you need:

    | Plan        | Best for          | Key models                                |
    | ----------- | ----------------- | ----------------------------------------- |
    | **Free**    | Testing           | GPT-OSS 20B, GPT-OSS 120B                 |
    | **Basic**   | Light usage       | ShuttleAI Auto, GPT-5.2, Claude Haiku 4.5 |
    | **Premium** | Agent workflows   | Claude Opus 4.6, Claude Sonnet 4.6        |
    | **Scale**   | Production agents | All models + priority                     |

    For serious agent workflows with Claude Opus or Sonnet, choose **Premium** or **Scale**.
  </Step>

  <Step title="Copy your API key">
    Go to the [Dashboard](https://shuttleai.com/keys) and copy your API key.
  </Step>
</Steps>

## Step 2 — Locate your OpenClaw config

OpenClaw stores its configuration at:

```
~/.openclaw/openclaw.json
```

This file controls your providers and models.

<Note>
  You can override the default location using environment variables: `OPENCLAW_HOME`, `OPENCLAW_STATE_DIR`, or `OPENCLAW_CONFIG_PATH`.
</Note>

The workspace directory for agent memory is usually:

```
~/openclaw/workspace
```

## Step 3 — Edit openclaw\.json

Open the config file:

```bash theme={null}
nano ~/.openclaw/openclaw.json
```

Add ShuttleAI as a provider:

```json theme={null}
{
  "models": {
    "mode": "merge",
    "providers": {
      "shuttleai": {
        "baseUrl": "https://api.shuttleai.com/v1",
        "apiKey": "YOUR_API_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "shuttleai/auto",
            "name": "ShuttleAI API",
            "reasoning": false,
            "input": ["text"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "shuttleai/auto"
      }
    }
  }
}
```

Replace `YOUR_API_KEY_HERE` with your actual ShuttleAI API key. Save and exit.

## Step 4 — Restart OpenClaw

Restart the agent to apply the new config:

```bash theme={null}
openclaw restart
```

Verify the connection:

```bash theme={null}
openclaw gateway health
```

If it returns healthy, ShuttleAI is connected.

## Adding more models

You can add additional models under the ShuttleAI provider:

```json theme={null}
{
  "models": {
    "mode": "merge",
    "providers": {
      "shuttleai": {
        "baseUrl": "https://api.shuttleai.com/v1",
        "apiKey": "YOUR_API_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "shuttleai/auto",
            "name": "ShuttleAI Auto",
            "reasoning": false,
            "input": ["text"]
          },
          {
            "id": "openai/gpt-5.2",
            "name": "GPT-5.2"
          },
          {
            "id": "anthropic/claude-opus-4.6",
            "name": "Claude Opus 4.6"
          },
          {
            "id": "anthropic/claude-sonnet-4.6",
            "name": "Claude Sonnet 4.6"
          }
        ]
      }
    }
  }
}
```

Now your agent can:

* Use **Opus** for deep reasoning
* Use **Sonnet** for fast tasks
* Use **Auto** for the most cost-efficient routing
* Use **GPT-OSS** for lightweight, free work

All from one API.

## Why teams choose ShuttleAI for OpenClaw

<CardGroup cols={2}>
  <Card title="Simple pricing" icon="tag">
    No token math. Predictable monthly plans instead of per-token billing.
  </Card>

  <Card title="Unified API" icon="plug">
    One endpoint, one key — access Claude, GPT, and more without switching providers.
  </Card>

  <Card title="Clean scaling" icon="arrow-up-right">
    Upgrade your plan as your agent usage grows. No infrastructure changes needed.
  </Card>

  <Card title="Production ready" icon="shield-check">
    Reliable infrastructure built for always-on agents and bots.
  </Card>
</CardGroup>