Skip to content

Setting Up Your AI Provider

Last updated: March 2026

Provider overview

OneClickClaw supports 23+ AI providers out of the box, giving you access to over 780 models. There is no allowlist or restriction on which models you can use. Every provider supported by OpenClaw is available to you, and you can switch between them at any time from your dashboard.

When you open the provider dropdown in your Agent Control Panel, you see official brand logos (SVG) for each provider, including OpenAI, Anthropic, Google, xAI, Mistral, DeepSeek, OpenRouter, Cohere, Meta, and many more. The logos make it easy to identify each provider at a glance.

AI Provider Selection

Provider Dropdown

Scrollable list with official SVG brand logos next to each provider name. 23+ providers available. Currently selected provider highlighted.

API Key Field

Paste your key here. Real-time validation with green checkmark on success or red error message on failure.

Model Selector

Dropdown showing all models for the selected provider. Search/filter support. 780+ models total across all providers.

Step-by-step setup

Setting up your AI provider takes about two minutes. Follow these steps:

1

Navigate to the Agent Control Panel

From your dashboard, click on your instance, then select the Agent tab. The AI Provider section is at the top of the page.

2

Open the provider dropdown

Click the provider dropdown to see all available providers with their official brand logos. Scroll through the list or start typing to filter.

3

Select your provider

Click on the provider you want to use. The logo and name appear in the dropdown to confirm your selection.

4

Paste your API key

Paste your API key into the key field. The system validates your key automatically in real time. You see a green checkmark if the key is valid, or an error message if something is wrong.

5

Select a model

Once the key validates, the model dropdown populates with all available models for your chosen provider. Select the model you want your agent to use.

6

Save your configuration

Click Save. Your agent immediately starts using the new provider and model for all future messages. There is no downtime or restart required.

Tip

If you are new to AI, start with OpenRouter. One API key gives you access to 780+ models from all major providers. You can experiment with different models without creating separate accounts with each provider.

Where to get API keys

Before you can connect a provider, you need an API key from that provider. Here is how to get one from the most popular providers:

OpenAI

1

Create an OpenAI account

Visit platform.openai.com and sign up or log in.

2

Go to API Keys

Click your profile icon in the top-right corner, then select API keys from the dropdown menu.

3

Create a new secret key

Click Create new secret key, name it (for example, "OneClickClaw Agent"), and copy the key immediately. OpenAI only displays the full key once.

Anthropic

1

Create an Anthropic account

Visit console.anthropic.com and sign up or log in.

2

Navigate to API Keys

Open the Settings page and click API Keys.

3

Create a new key

Click Create Key, give it a descriptive name, and copy the key immediately. Anthropic only shows the full key once.

OpenRouter (recommended for beginners)

1

Create an OpenRouter account

Visit openrouter.ai and sign up. OpenRouter supports Google, GitHub, and email sign-in.

2

Generate an API key

Navigate to Keys in your account settings and create a new key. OpenRouter uses credits that you top up as needed. Some models (like Llama 3.3 70B) are completely free.

Google (Gemini)

1

Open Google AI Studio

Visit aistudio.google.com and sign in with your Google account.

2

Create an API key

Click Get API key in the left sidebar. Create a new key or use an existing one. Google provides a generous free tier for Gemini models.

xAI (Grok)

1

Create an xAI account

Visit console.x.ai and sign up or log in.

2

Create an API key

Navigate to the API Keys section and generate a new key. Copy it and store it securely.

ProviderWebsiteBest For
OpenAIplatform.openai.comGeneral purpose, vision, most widely supported
Anthropicconsole.anthropic.comReasoning, safety, long context windows
OpenRouteropenrouter.aiBeginners, model exploration, 780+ models with one key
Googleaistudio.google.comLong context, research, free tier available
xAIconsole.x.aiReal-time knowledge, conversational style

Warning

Never share your API key publicly or commit it to a code repository. Treat it like a password. If you suspect a key has been compromised, revoke it immediately from your provider's dashboard and generate a new one. For more on how your key is protected, see API Key Security.

Switching providers

You can switch your AI provider at any time. When you select a different provider, your agent begins using the new provider for all future messages. Here is what to keep in mind:

  • Your previous API key is removed from the server when you switch providers. It is not stored after the switch.
  • You need to enter a valid API key for the new provider.
  • The model selection updates to show models available for the new provider.
  • Your system prompt, agent name, and channel connections are not affected. Only the AI backend changes.
  • Existing conversation context resets because different providers do not share session history.

Note

Switching providers takes effect immediately. There is no downtime. Your agent responds to the next incoming message using the new provider and model.

API key security

OneClickClaw takes API key security seriously. Here is how your key is protected on your dedicated server:

  • Encrypted at rest. Your API key is encrypted using AES-256 encryption before it is written to disk. The encryption key is unique to your instance.
  • Never logged. API keys are never written to application logs, error reports, or monitoring data. Our support team cannot see your key.
  • Stored only on your server. Your key lives on your dedicated VPS and is not stored in our central database. If you delete your instance, the key is destroyed along with the server.
  • File permissions locked down. The configuration file containing your key has restricted permissions (chmod 600), readable only by the service account running your agent.

For a comprehensive overview of our security practices, see the API Key Security article. For information on BYOK and why you control your own key, see BYOK (Bring Your Own Key).