# Connect OpenClaw to Void API

Register Void API as a custom OpenAI-compatible model provider.

Examples use MODEL_ID as a placeholder, not an available model. Replace it with an ID from the current catalog. Choose a model that supports the endpoint and features used by this tool; vision and tool calling are not universal.

[Current model catalog](https://void-api.tech/models)

## API key

Store your key in an environment variable.

### Environment variables

```
export VOID_API_KEY='void_your_key'
```

## Configuration

Add the provider to ~/.openclaw/openclaw.json. The file accepts JSON5.

### ~/.openclaw/openclaw.json

```
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "void-api/MODEL_ID"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "void-api": {
        "baseUrl": "https://void-api.tech/v1",
        "apiKey": "${VOID_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "MODEL_ID",
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  }
}
```

## Run

Verify the catalog, then select a Void API model.

### shell

```
openclaw models list
openclaw models set 'void-api/MODEL_ID'
```

[Upstream documentation](https://docs.openclaw.ai/concepts/model-providers)