Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agipower.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
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:
MethodBest ForComplexity
Method 1: Use the AGIPower PRFull AGIPower integration with auto-discoveryEasy
Method 2: Manual ConfigurationStable releases, custom setupsModerate

​
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)
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
Pay-as-you-go API Key
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

# 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: 
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: 
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: 
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: 
npm install -g openclaw@latest
Or run the onboarding wizard to set up OpenClaw: 
openclaw onboard --install-daemon

​
Step 2: Configure AGIPower Provider

Add the AGIPower provider configuration to your ~/.openclaw/openclaw.json file: 
{
  "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": {}
      }
    }
  }
}
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:
FieldDescription
idThe model ID as shown in AGIPower (e.g., openai/gpt-5.2)
nameA display name for the model
reasoningWhether the model supports reasoning mode
inputInput types: ["text"] or ["text", "image"]
costCost configuration (set to 0 for subscription plans)
contextWindowMaximum context window size in tokens
maxTokensMaximum output tokens

​
Step 4: Verify the Configuration

List the available models: 
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: 
openclaw models set agipower/openai/gpt-5.2

​
Using AGIPower Models

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

​
Via CLI Agent

# 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: 
# Start the gateway
openclaw gateway run

# Check channel status
openclaw channels status

​
Switching Models

You can switch models at any time: 
# 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:
  1. 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
  2. Validate the API Key:
  3. 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:
  1. 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
  2. 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:
  1. Kill any running gateway process: 
    pkill -9 -f openclaw-gateway
  2. Rebuild the project (if using Method 1): 
    pnpm build
  3. List models again: 
    openclaw models list

​
Supported Models

AGIPower provides access to a wide range of models. Here are some popular options for OpenClaw:
ModelIDBest For
GPT-5.2openai/gpt-5.2General purpose, coding
Claude Sonnet 4.5anthropic/claude-sonnet-4.5Balanced performance
Claude Opus 4.5anthropic/claude-opus-4.5Complex reasoning
Gemini 3 Progoogle/gemini-3-pro-previewMultimodal tasks
DeepSeek Chatdeepseek/deepseek-chatCost-effective coding
Qwen3 Coderalibaba/qwen3-coder-plusCode 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:
For more contacts and details, visit our Contact Us page.