Guide to Using OpenClaw with AGIPower

OpenClaw (formerly Moltbot, originally Clawdbot) is a powerful AI messaging gateway that connects multiple messaging platforms (WhatsApp, Telegram, Discord, Slack, Signal, iMessage, and more) to AI models. By integrating with AGIPower, you can access a wide range of models including GPT-5.2, Claude-4.5, Gemini-3, DeepSeek, and more.

Compatibility Note

AGIPower fully supports the OpenAI API protocol and can be used with OpenClaw through simple configuration.

Note that the OpenAI protocol base_url is https://api.agipower.ai/v1.

Prerequisites

Node.js 22 or later
A AGIPower API Key (see Step 0 below)

Integration Methods

There are two ways to use AGIPower with OpenClaw:

Method	Best For	Complexity
Method 1: Use the AGIPower PR	Full AGIPower integration with auto-discovery	Easy
Method 2: Manual Configuration	Stable releases, custom setups	Moderate

Step 0: Get a AGIPower API Key

Before configuring OpenClaw, you need a AGIPower API Key. AGIPower offers two billing options:

Subscription API Key (Recommended)Pay-as-you-go API Key

text

Best for: personal development, learning/exploration
Features: fixed monthly fee, predictable cost, 5-10x price leverage
API Key format: sk-ss-v1-xxx

How to get it:
1. Visit the subscription management page: https://agipower.ai/platform/subscription
2. Choose a plan (Pro $20/month, Max $100/month, Ultra $200/month)
3. After subscribing, create a subscription API Key on the page

For details, see: Subscription Plan Guide
https://agipower.ai/guide/subscription

text

Best for: production environments, commercial products, enterprise apps
Features: no rate limits, production-grade stability, billed by actual usage
API Key format: sk-xxx

How to get it:
1. Visit the pay-as-you-go page: https://agipower.ai/platform/pay-as-you-go
2. Top up your account (top-ups automatically include a 20% bonus credit)
3. Create an API Key in the "Pay As You Go API Keys" section

For details, see: Pay-as-you-go Guide
https://agipower.ai/guide/pay-as-you-go

Method 1: Use the AGIPower PR

The easiest way to use AGIPower with OpenClaw is to use the pending AGIPower integration PR #3305, which provides full auto-discovery of AGIPower models.

Step 1: Clone and Checkout the PR

bash

# Clone the OpenClaw repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Checkout PR #3305 (AGIPower integration)
git fetch origin pull/3305/head:agipower-integration
git checkout agipower-integration

# Install dependencies
pnpm install

# Build the project
pnpm build

Step 2: Run Onboarding with AGIPower

Run the onboarding wizard and select AGIPower as your auth provider:

bash

pnpm openclaw onboard --auth-choice agipower-api-key

Follow the prompts to enter your AGIPower API Key. The wizard will automatically:

Configure the AGIPower provider
Discover available models from the AGIPower API
Set a default model for you

Step 3: Verify the Setup

List the available models to verify the configuration:

bash

pnpm openclaw models list

You should see AGIPower models listed with the agipower/ prefix, such as:

agipower/deepseek/deepseek-chat
agipower/openai/gpt-5.2
agipower/google/gemini-3-pro-preview
agipower/anthropic/claude-sonnet-4.5

Step 4: Test the Integration

Send a test message to verify everything works:

bash

pnpm openclaw agent --local --agent main --message "Hello, respond with just 'Hi!'"

Method 2: Manual Configuration

If you prefer to use a stable release of OpenClaw or want more control over the configuration, you can manually configure AGIPower as an explicit provider in your openclaw.json config file.

Step 1: Install OpenClaw

Install OpenClaw globally via npm:

bash

npm install -g openclaw@latest

Or run the onboarding wizard to set up OpenClaw:

bash

openclaw onboard --install-daemon

Step 2: Configure AGIPower Provider

Add the AGIPower provider configuration to your ~/.openclaw/openclaw.json file:

json

{
  "models": {
    "mode": "merge",
    "providers": {
      "agipower": {
        "baseUrl": "https://api.agipower.ai/v1",
        "apiKey": "sk-ss-v1-your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek/deepseek-chat",
            "name": "DeepSeek Chat via AGIPower",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 64000,
            "maxTokens": 8192
          },
          {
            "id": "openai/gpt-5.2",
            "name": "GPT-5.2 via AGIPower",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "google/gemini-3-pro-preview",
            "name": "Gemini 3 Pro via AGIPower",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5 via AGIPower",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "agipower/openai/gpt-5.2"
      },
      "models": {
        "agipower/deepseek/deepseek-chat": {},
        "agipower/openai/gpt-5.2": {},
        "agipower/google/gemini-3-pro-preview": {},
        "agipower/anthropic/claude-sonnet-4.5": {}
      }
    }
  }
}

Important

Replace sk-ss-v1-your-api-key-here with your actual AGIPower API Key.

Step 3: Add More Models (Optional)

You can add more models to the models array. Check the AGIPower model list for available models and their capabilities.

Each model definition requires:

Field	Description
`id`	The model ID as shown in AGIPower (e.g., `openai/gpt-5.2`)
`name`	A display name for the model
`reasoning`	Whether the model supports reasoning mode
`input`	Input types: `["text"]` or `["text", "image"]`
`cost`	Cost configuration (set to 0 for subscription plans)
`contextWindow`	Maximum context window size in tokens
`maxTokens`	Maximum output tokens

Step 4: Verify the Configuration

List the available models:

bash

openclaw models list

You should see your configured AGIPower models:

Model                                      Input      Ctx      Local Auth  Tags
agipower/deepseek/deepseek-chat              text       63k      no    yes   configured
agipower/openai/gpt-5.2                      text+image 195k     no    yes   default,configured
agipower/google/gemini-3-pro-preview         text+image 195k     no    yes   configured
agipower/anthropic/claude-sonnet-4.5         text+image 195k     no    yes   configured

Step 5: Set the Default Model

Set your preferred default model:

bash

openclaw models set agipower/openai/gpt-5.2

Using AGIPower Models

Once configured, you can use AGIPower models in various ways:

Via CLI Agent

bash

# Run a quick agent command
openclaw agent --local --agent main --message "Explain quantum computing in simple terms"

Via Messaging Channels

Configure your messaging channels (WhatsApp, Telegram, Discord, etc.) and the gateway will automatically use your configured AGIPower model:

bash

# Start the gateway
openclaw gateway run

# Check channel status
openclaw channels status

Switching Models

You can switch models at any time:

bash

# Set a different default model
openclaw models set agipower/anthropic/claude-sonnet-4.5

# Or specify a model inline (Method 1 only)
openclaw agent --local --agent main --model agipower/deepseek/deepseek-chat --message "Hello"

Troubleshooting

Common Issues

API Key Error or Authentication Failure

Issue: You see an error indicating the API Key is invalid or unauthorized

Solutions:

Check the API Key format:
- Subscription API Keys should start with sk-ss-v1-
- Pay-as-you-go API Keys should start with sk-
- Make sure there are no extra spaces or newlines
Validate the API Key:
- Subscription: visit the Subscription management page to check subscription status and quotas
- Pay-as-you-go: visit the Pay-as-you-go page to ensure you have sufficient balance
Check config file syntax:
- Ensure the JSON is valid (no trailing commas, proper quoting)
- Verify the API key is correctly placed in the apiKey field

Model Not Found

Issue: OpenClaw reports that the model cannot be found

Solutions:

For Method 1 (PR branch):
- Ensure you're on the agipower-integration branch (checked out from PR #3305)
- Run pnpm build after pulling the latest changes
For Method 2 (Manual config):
- Verify the model is defined in models.providers.agipower.models
- Check that the model ID matches exactly (case-sensitive)
- Add the model to agents.defaults.models as well

Connection Failure

Issue: OpenClaw cannot connect to AGIPower

Solutions:

Check that your network connection is working
Verify baseUrl is set to https://api.agipower.ai/v1
Ensure your firewall is not blocking outbound HTTPS connections
Try running curl https://api.agipower.ai/v1/models to test connectivity

Cached Models Showing

Issue: Old models are still showing after config changes

Solutions:

Kill any running gateway process:
bash
```
pkill -9 -f openclaw-gateway
```
Rebuild the project (if using Method 1):
bash
```
pnpm build
```
List models again:
bash
```
openclaw models list
```

Supported Models

AGIPower provides access to a wide range of models. Here are some popular options for OpenClaw:

Model	ID	Best For
GPT-5.2	`openai/gpt-5.2`	General purpose, coding
Claude Sonnet 4.5	`anthropic/claude-sonnet-4.5`	Balanced performance
Claude Opus 4.5	`anthropic/claude-opus-4.5`	Complex reasoning
Gemini 3 Pro	`google/gemini-3-pro-preview`	Multimodal tasks
DeepSeek Chat	`deepseek/deepseek-chat`	Cost-effective coding
Qwen3 Coder	`alibaba/qwen3-coder-plus`	Code generation

For the full list of supported models, visit the AGIPower model list.

Contact Us

If you encounter any issues during use, or have suggestions and feedback, please contact us through the following channels:

Get Help

Official Website: https://agipower.ai
Technical Support Email: support@agipower.ai

For more contacts and details, visit our Contact Us page.

Guide to Using OpenClaw with AGIPower ​

Prerequisites ​

Integration Methods ​

Step 0: Get a AGIPower API Key ​

Method 1: Use the AGIPower PR ​

Step 1: Clone and Checkout the PR ​

Step 2: Run Onboarding with AGIPower ​

Step 3: Verify the Setup ​

Step 4: Test the Integration ​

Method 2: Manual Configuration ​

Step 1: Install OpenClaw ​

Step 2: Configure AGIPower Provider ​

Step 3: Add More Models (Optional) ​

Step 4: Verify the Configuration ​

Step 5: Set the Default Model ​

Using AGIPower Models ​

Via CLI Agent ​

Via Messaging Channels ​

Switching Models ​

Troubleshooting ​

Common Issues ​

Supported Models ​

Contact Us ​

Guide to Using OpenClaw with AGIPower

Prerequisites

Integration Methods

Step 0: Get a AGIPower API Key

Method 1: Use the AGIPower PR

Step 1: Clone and Checkout the PR

Step 2: Run Onboarding with AGIPower

Step 3: Verify the Setup

Step 4: Test the Integration

Method 2: Manual Configuration

Step 1: Install OpenClaw

Step 2: Configure AGIPower Provider

Step 3: Add More Models (Optional)

Step 4: Verify the Configuration

Step 5: Set the Default Model

Using AGIPower Models

Via CLI Agent

Via Messaging Channels

Switching Models

Troubleshooting

Common Issues

Supported Models

Contact Us