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:
- OpenClaw installed on your device.
- A valid API key.
- The name of the model you want to use.
- 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 configPress Enter to start the configuration process.
Select the following option from the configuration menu:
LocalPress Enter.
This option applies the configuration to your local OpenClaw environment.
Next, select:
ModelPress Enter.
This option configures the model service used by OpenClaw.
Select:
Custom ProviderPress 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/v1Press 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_KEYIn 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_IDMake 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
Check that the API Base URL is correct:
https://api.wox.lol/v1Also confirm that your API key is valid.
Check that you entered the model name correctly.
Model IDs are usually case-sensitive. Copying the model name directly from the platform is recommended.
Check whether the API key has expired, whether your account has sufficient balance, and whether the key has permission to access the selected model.
Make sure your device can access the API address.
If the request cannot be completed, check your firewall, proxy, or VPN settings.
15. Notes
For OpenAI-compatible API services, the API Base URL usually ends with /v1.
Correct example:
https://api.wox.lol/v1You should generally avoid entering:
https://api.wox.lol/v1/chat/completionsunless OpenClaw explicitly asks for the complete API endpoint.