Connecting OpenClaw with Custom AI Models

Constraints

Custom models only support OpenAI- and Anthropic-compatible API addresses, for example, https://api.openai.com/v1. Obtain the API addresses from model providers.

Prerequisites

You have purchased a FlexusL instance with the OpenClaw application image installed.

Procedure

1. Log in to the FlexusL console.
2. Click Configure Now on the target FlexusL instance. The application details page is displayed.

   If Configure Now is not displayed, click the resource card to go to the resource details page and choose Application Details from the left navigation pane.

   

   Some functions of the OpenClaw application image (such as querying gateway status and updating models and application configurations) depend on Cloud Operations Center (COC). You need to enable and authorize COC before using these functions. If the content in the following figure is displayed, enable and authorize COC as prompted.

   

3. In the Models card, select Custom from the model provider drop-down list.

   

4. Under the drop-down list, configure custom models in JSON or form format.

   JSON

   • Specify the model parameters in JSON format according to the following example:

     {
       "base_url": "https://api.openai.com/v1",
       "api_key": "your_api_key",
       "api": "openai-completions", 
       "model_ids": ["gpt-5.2","deepseek-v3.2"]
     }

     Table 1 JSON input parameters for custom models

     Parameter	Description	Example
     base_url	API address of the model.	https://api.siliconflow.cn/v1
     api_key	API key of the model provider.	your_api_key
     api	openai-completions: models compatible with the OpenAl Chat Completions API. anthropic-messages: models compatible with the Anthropic Messages API.	openai-completions
     model_ids	The unique identifier of the model. Multiple models can be added.	["deepseek-v3.2"]

     The following uses the SiliconFlow DeepSeek-V3.2 model as an example:

     {
       "base_url": "https://api.siliconflow.cn/v1",
       "api_key": "your_api_key",
       "api": "openai-completions", 
       "model_ids": ["deepseek-v3.2"]
     }

   Form

   • Specify the model parameters in form format according to the following table.

     Table 2 Form input parameters for custom models

     Parameter	Description	Example
     Model base_url	API address of the model.	https://api.siliconflow.cn/v1
     Model api_key	API key of the model provider.	your_api_key
     api	openai-completions: models compatible with the OpenAl Chat Completions API. anthropic-messages: models compatible with the Anthropic Messages API.	openai-completions
     Model ID	The unique identifier of the model. Multiple models can be added, separated by commas (,).	gpt-5.2,deepseek-v3.2

5. Click Check Connectivity. The system will check whether the models are connected and available based on the entered information.
6. Click Add Model. After the models are added successfully, you can view them in the list of added models.

   

7. Manage models as needed.

   Table 3 Model operations

   Operation	Description
   Modifying the model alias	Hover over on the right of the target model and click Modify Alias. In the displayed dialog box, specify a new alias that is easy to identify.
   Changing the default model	Click Set as Default on the right of the target model to set it as the new default model. The new default model will not be used unless you start a new session. You can enter /new model-alias (start a new session) or /model model-alias (retain the context) in the chat box. CAUTION: When you enter /new in the chat box to start a new session, the bot will lose its memory. Exercise caution when performing this operation.
   Deleting a model	Click Delete on the right of the target model. If the model to be deleted is the default model, you can choose to retain or forcibly delete it. If the default model is forcibly deleted, the system will randomly set another existing model as the new default model. You can change the default model if needed. CAUTION: After a model is deleted, the bot cannot use it anymore. To reuse the same model, add it again.

Helpful Links

• If you need to manage applications, configure channels, or install skills online for OpenClaw, see Configuring the OpenClaw Application.
• For OpenClaw FAQs, see OpenClaw FAQs.