Skip to main content

​
1. Overview

This guide explains how to configure a custom model provider in OpenClaw. After the configuration is complete, OpenClaw can call models through the specified API endpoint and use them for local Agent tasks.

​
2. Prerequisites

Before you start, make sure you have the following:
  1. OpenClaw installed on your device.
  2. A valid API Key.
  3. The model name you want to use.
  4. A network environment that can access the API service normally.
1

Open Terminal or Console

Open a terminal or command-line tool on your local device.macOS or Linux users can use Terminal.Windows users can use Command Prompt, PowerShell, or the terminal inside their development environment.
2

Open the OpenClaw Configuration Interface

Run the following command in the terminal:
Press Enter to enter the configuration process.
3

Select Local Configuration

In the configuration menu, select:
Press Enter.This option means the configuration will be applied to your local OpenClaw environment.
4

Enter Model Configuration

Continue by selecting:
Press Enter.This option is used to configure the model service used by OpenClaw.
5

Select Custom Provider

Select:
Press Enter.Choose this option when you want to connect OpenClaw to a custom OpenAI-Compatible API service.
6

Configure the API Base URL

When prompted to enter the API Base URL, input:
Press Enter.This address tells OpenClaw to send model requests to the Agnes AI API Gateway.
7

Enter the API Key

When prompted to enter the API Key, input your actual API Key.Example:
In most cases, you do not need to manually add the Bearer prefix unless OpenClaw explicitly asks you to enter the full Authorization Header.
8

Enter the Model Name

When prompted to enter the model name, input the model ID you want to use.Example:
Make sure to enter the full model ID provided by the platform.
9

Save the Configuration

After completing all required fields, confirm and save the configuration.Once saved successfully, OpenClaw will use this custom provider for local model calls.

​
12. Configuration Example

Provider Type: Custom Provider API Base URL: https://apihub.agnes-ai.com/v1 API Key: YOUR_API_KEY Model: agnes-2.0-flash

​
13. Verify the Configuration

After completing the configuration, you can run an OpenClaw task or start a test session. If the configuration is correct, OpenClaw should be able to send requests to the API service and return model responses normally.

​
14. Troubleshooting

Check whether the API Base URL is correct:
Also confirm that your API Key is valid.
Check whether the model name is entered correctly.Model IDs are usually case-sensitive. It is recommended to copy the model name directly from the platform.
Check whether the API Key has expired, whether the account has sufficient balance, and whether the Key has permission to access the target model.
Make sure your device can access the API address normally.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:
It is usually not recommended to enter:
unless OpenClaw explicitly asks you to enter the full API endpoint.