How to Connect APIs in OpenClaw

What Is an API?

An API (Application Programming Interface) allows different software systems to communicate with one another. In OpenClaw, APIs serve as the bridge between the local agent running on your machine and the external intelligence, services, and tools it needs to perform tasks.

Why APIs Matter in OpenClaw

APIs are essential to OpenClaw’s flexibility and functionality. They enable the platform to operate as a powerful, extensible AI agent in the following ways:

• Access to AI Intelligence
  
  OpenClaw is model-agnostic, meaning it can work with different large language models (LLMs). Through APIs, it can connect to providers such as OpenAI (GPT), Anthropic (Claude), and Google (Gemini), allowing the agent to reason, plan tasks, and understand user intent.
   
• Autonomous Actions
  
  Using tool‑calling APIs, OpenClaw can interact with both digital and physical systems. For example, REST APIs can be used to manage calendars, organize inboxes, execute workflows, or control connected hardware.
   
• Multi-Platform Messaging
  
  Messaging APIs allow OpenClaw to communicate with users across platforms such as WhatsApp, Telegram, Slack, and Discord, enabling seamless cross‑platform interaction.
   
• Direct API Consumption
  
  OpenClaw follows an API‑first approach, consuming APIs directly rather than relying on intermediary protocols like the Model Context Protocol (MCP). This makes OpenClaw a universal agent capable of integrating with nearly any existing API.
   
• Scalability and Flexibility
  
  APIs make it easy to switch between providers based on cost, performance, or features without changing the core agent logic. Services like OpenRouter allow access to multiple models through a single unified API.
   

How to Connect OpenClaw to an AI Provider

To enable your agent to generate responses, you must connect at least one AI model provider. The setup process typically takes about five minutes.

Step 1: Get an API Key

Obtain an API key from your preferred provider:

• Anthropic (Claude)
• OpenAI (GPT)
• Google Gemini

You may also use any other supported LLM provider.

Step 2: Open the Config Editor

1. Sign in to your OpenClaw dashboard.
2. Go to Config in the left sidebar under Settings.
3. Click Raw in the top-right corner.

This opens the JSON configuration editor.

Step 3: Add Your API Key

At the top level of the configuration file (before the acp or agents section), add an env block:

env: {
ANTHROPIC_API_KEY: "sk-ant-your-key-here"
}

Replace ANTHROPIC_API_KEY with the correct variable name for your provider:

• OpenAI: OPENAI_API_KEY
• Google Gemini: GEMINI_API_KEY
• OpenRouter: OPENROUTER_API_KEY

Step 4: Set a Default Model

Inside the agents → defaults section, define the primary model:

1 |   
2 | model: { 
3 |   primary: "anthropic/claude-opus-4-6" 
4 | } 
5 | `` 
6 |   

Popular model options include:

• anthropic/claude-opus-4-6
• openai/gpt-4o
• google/gemini-3-flash-preview

You may use any supported model that best fits your needs.

Step 5: Add Additional Models (Optional)

To make multiple models available, add a models allowlist under agents → defaults. This allows you to switch models using the /model command in chat.

1 | 
2 | models: { 
3 |   "anthropic/claude-sonnet-4-5": {}, 
4 |   "anthropic/claude-haiku-4-5": {} 
5 | } 
6 | ``  

Notes for your model(s) and OpenClaw:

• Once one model is configured, you can ask OpenClaw to set up additional models from the same provider.
• If you add models from different providers (for example, Claude and Gemini), you must add an API key for each provider.

Step 6: Save and Apply Changes

Click Save, then select Apply to update your configuration.

Your final JSON for 'agents:' folder should look like this (note the models chosen are only for reference), you can choose models based on your needs and convenience:

Note: Once you have one model set up, you can also ask OpenClaw to set up another model of the same provider. Like, yeah, just literally ask OpenClaw, "Hey, can you set up the Claude Sonnet model for me?" And it will do it!

Note: If you are adding models for different providers (e.g. Gemini, Claude. Etc. — you will have to add API key for each provider respectively).

Step 7: Test Your Setup

Go to Chat and send a test message to confirm that your agent is responding correctly.

Note: If you encounter issues, ensure the JSON configuration is visible by clicking the eye icon in the Raw editor. For security reasons, OpenClaw hides the configuration by default.

Summary

Connecting APIs in OpenClaw unlocks its full potential as a flexible, autonomous AI agent. By following the steps above, you can integrate your preferred AI models and services, enabling advanced reasoning, tool use, and cross-platform communication.