> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.gbnetwork.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# OpenClaw Model Management Guide

This guide explains how to manage the AI provider assigned to your OpenClaw agent; specifically, how to change your primary model or delete models you no longer need.

### Why Setting a Primary Model Matters

Your primary model is the default AI engine your agent uses to respond to conversations and handle tasks. Choosing the right primary model affects:

* **Response Quality:** Different models excel at different tasks, some are better for reasoning, others for speed or creativity.
* **Fallback Chain:** If the primary model is unavailable, your agent automatically uses the next available model in your list.
* **Testing & Optimization:** Switching primary models lets you experiment to find which works best for your specific needs.

|| **Tip:** Think of your primary model as your agent's "default brain." Change it whenever you need different capabilities or better performance.

###  How to Change Your Primary Model

Follow these steps to select a new primary model from your existing list.


1. Run setup command: `setup-ai`.

2. When prompted, you will see several options. Enter the letter **`p`** to proceed with changing the primary model.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/setup-ai11_ge6ukc.png =497x401)

3. The system will display a numbered list of all models you have currently assigned. Enter the number corresponding to the model you want as your new primary.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/change-primary-22_60fw61.png =497x283)

4. The OpenClaw service will automatically restart to apply the change. 

5. After the restart, the setup tool will prompt you again. You may type **`q`** to quit.

### How to Delete a Model

1. Run setup command: `setup-ai`.

2. When prompted, enter the letter **`r`** to proceed with removing a model.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/setup-ai11_twt0c3.png =497x401)

3. The system will display a numbered list of all your assigned models. Enter the number of the model you wish to delete.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/delete-ai-22_dxn35c.png =497x269)

###### Special Case: Deleting the Primary Model

4. If you select the current primary model for deletion, the system will warn you and prompt you to choose a new primary model immediately.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/delete-ai-primary_1mgw6h8.png =497x428)

5. The OpenClaw service will automatically restart to apply the change.

6. After the restart, the setup tool will prompt you again. You may type **`q`** to quit.

---

### Important: Start a New Session to Apply Changes

After any change to your models (whether changing the primary or deleting a model), you must start a new session in your chat interfaces for the agent to recognize the updated configuration.

* Web Chat - Click the 'New Session' button in the chat window.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/webchat_2n95fs.png =800xauto)

* Telegram - Type `/new` in the bot chat.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/telegram_1nzip9w.png =497x228)

* WhatsApp - Type `/new` in the conversation.
![](https://storage.crisp.chat/users/helpdesk/website/-/6/7/9/3/67938060e89a4400/whatsapp_5w35zl.png =600xauto)

|| **Why?** Each conversation session caches the model configuration at the start. Typing `/new` forces a fresh session that picks up your latest changes.
---

### Need Further Assistance?

If you face any issues or need assistance, don’t hesitate to reach out — **our support team is always ready to help!**

🔧 **Need help?** [**Submit a Support Ticket**](https://secure.gbnetwork.com/submitticket.php)
💬 **Chat with us on Live Chat via our** [**website**](https://www.gbnetwork.my/)