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

# OpenClaw

> Add Spiral to OpenClaw as a remote MCP server: one command, sign in, no API key.

**1. Add the server**

On the machine that runs OpenClaw's Gateway:

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

This saves the server in `~/.openclaw/openclaw.json`. It does not sign in yet. In the Control UI you can do the
same under **Settings › MCP** (`openclaw dashboard` opens it).

**2. Sign in**

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

From the terminal instead, run:

```bash theme={null}
openclaw mcp login spiral
```

It prints a link. Open it, sign in to Spiral and click **Authorize**, then finish with the code OpenClaw asks for:

```bash theme={null}
openclaw mcp login spiral --code YOUR_CODE
```

**3. Reload and check**

```bash theme={null}
openclaw mcp reload
openclaw mcp doctor spiral --probe
```

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

**4. Try a starter prompt**

Ask your OpenClaw agent, in the Control UI or any chat channel it runs in:

```text theme={null}
Find a text-to-image tool, tell me what one image costs, then generate a lighthouse at dawn.
```

> [accordion] Manual configuration
>
> The same server, written straight into `~/.openclaw/openclaw.json`. Then run `openclaw mcp login spiral`:
>
> ```json5 theme={null}
> {
>   mcp: {
>     servers: {
>       spiral: {
>         url: "https://api.spiral.ai/mcp",
>         transport: "streamable-http",
>         auth: "oauth",
>       },
>     },
>   },
> }
> ```

`openclaw mcp status --verbose` shows whether Spiral needs a new sign-in; `openclaw mcp logout spiral` signs out and
keeps the server.

If something does not work, see [Troubleshooting](/docs/mcp-server.md#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.