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

# Connect OpenClaw to APIONE

> Add APIONE as a custom OpenClaw model provider.

## Initialize OpenClaw

Follow the [official documentation](https://docs.openclaw.ai/) to install and initialize OpenClaw, and confirm the gateway starts. Prepare an APIONE key and a tool-capable model.

## Merge the provider configuration

Back up `~/.openclaw/openclaw.json` and merge these fields without replacing existing channels, gateway settings, or permissions:

```json theme={null}
{
  "models": {
    "mode": "merge",
    "providers": {
      "apione": {
        "baseUrl": "https://api.apione.ai/v1",
        "apiKey": "YOUR_APIONE_KEY",
        "api": "openai-completions",
        "models": [
          {"id": "YOUR_APIONE_MODEL_ID", "name": "APIONE model"}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "apione/YOUR_APIONE_MODEL_ID"}
    }
  }
}
```

Replace the key and both model placeholders. The apione/ prefix belongs to OpenClaw's provider selection, not the APIONE model ID. Restrict access to the credential file and keep it out of repositories. Set context, output, and image capabilities according to the selected model.

## Apply and verify

```bash theme={null}
openclaw models list
openclaw gateway restart
openclaw gateway status
```

Confirm APIONE in the model list and send a simple message through an existing chat entry point. Test tools and channels after inference works.

## Windows local operation

First confirm the installed version and current configuration file location in PowerShell.

```powershell theme={null}
openclaw --version
openclaw config file
```

The default configuration is usually in the user's `.openclaw/openclaw.json`, based on the actual output of `openclaw config file`. Back up this file before modifying, then merge the APIONE provider configuration above.

```powershell theme={null}
$openclawConfigPath = Join-Path $env:USERPROFILE ".openclaw/openclaw.json"
$openclawBackupPath = "$openclawConfigPath.backup-$(Get-Date -Format yyyyMMdd-HHmmss)"
Copy-Item -LiteralPath $openclawConfigPath -Destination $openclawBackupPath
```

If the actual configuration is in another directory, change `$openclawConfigPath` to that path first. After saving, validate the configuration and view the models.

```powershell theme={null}
openclaw config validate
openclaw models list
```

After confirming the APIONE model is listed, set it as the default model. Replace the placeholder with the actual model ID from the configuration above.

```powershell theme={null}
openclaw models set "apione/YOUR_APIONE_MODEL_ID"
openclaw gateway restart
openclaw gateway status
```

### Verify actual replies

Send "Reply only OK" in an existing chat entry point, and check the model and status in APIONE request details. To verify from the local command line, use a local Agent call.

```powershell theme={null}
openclaw agent --local --agent main --message "Reply only OK." --timeout 120
```

This command will call the model and produce corresponding usage. Model visibility, gateway running, and actual replies are three checkpoints; confirm them in order. If the interface indicates the key is expired but the backend shows it is valid, follow the [authentication troubleshooting](https://apione.ai/docs/en/support/faq.md) and provide the request identifier for verification.

## Troubleshoot

If configuration is ignored, check the home directory of the user running the gateway. If text works but tools fail, check model support and parameter compatibility. Keep gateway authentication and tool permissions intact while diagnosing inference.

See [OpenClaw custom providers](https://github.com/openclaw/openclaw/blob/main/docs/concepts/model-providers/custom-providers.md). For cloud deployment, follow [Alibaba Cloud OpenClaw](https://apione.ai/docs/en/guides/openclaw-alibaba.md).

***

[Integration directory](https://apione.ai/docs/en/guides/clients.md) · [Choose a model](https://apione.ai/docs/en/models/catalog.md) · [Troubleshooting](https://apione.ai/docs/en/support/errors.md)


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