WOX AI

OpenClaw Integration Guide

Configure WOX models in OpenClaw

OpenClaw Integration Guide

Configure WOX models in OpenClaw

1. Overview

This guide explains how to configure a custom model provider in OpenClaw.

Once configured, OpenClaw can call models through the specified API endpoint and use them for local agent tasks.

2. Prerequisites

Before you begin, make sure you have:

  1. OpenClaw installed on your device.
  2. A valid API key.
  3. The name of the model you want to use.
  4. A network connection that can access the API service.

Open a terminal or command-line tool on your device.

On macOS or Linux, you can use Terminal.

On Windows, you can use Command Prompt, PowerShell, or the terminal in your development environment.

Run the following command in your terminal:

openclaw config

Press Enter to start the configuration process.

Select the following option from the configuration menu:

Local

Press Enter.

This option applies the configuration to your local OpenClaw environment.

Next, select:

Model

Press Enter.

This option configures the model service used by OpenClaw.

Select:

Custom Provider

Press Enter.

Choose this option when you want to connect OpenClaw to a custom OpenAI-compatible API service.

When prompted for the API Base URL, enter:

https://api.wox.lol/v1

Press Enter.

This address tells OpenClaw to send model requests to the WOX API gateway.

When prompted for an API key, enter your actual API key.

Example:

YOUR_API_KEY

In most cases, you do not need to add the Bearer prefix manually unless OpenClaw explicitly asks for the complete Authorization header.

When prompted for a model name, enter the ID of the model you want to use.

Example:

YOUR_MODEL_ID

Make sure you enter the complete model ID provided by the platform.

After completing all required fields, confirm and save the configuration.

Once saved, OpenClaw will use this custom provider for local model calls.

12. Configuration Example

Provider type: Custom Provider API Base URL: https://api.wox.lol/v1 API key: YOUR_API_KEY Model: YOUR_MODEL_ID

13. Verify the Configuration

After completing the configuration, run an OpenClaw task or start a test session.

If everything is configured correctly, OpenClaw should send requests to the API service and return model responses successfully.

14. Troubleshooting

15. Notes

For OpenAI-compatible API services, the API Base URL usually ends with /v1.

Correct example:

https://api.wox.lol/v1

You should generally avoid entering:

https://api.wox.lol/v1/chat/completions

unless OpenClaw explicitly asks for the complete API endpoint.