openclaw/docs/providers/pixelml.md

summary	read_when
Use PixelML multi-model API in Clawdbot	You want to use PixelML models in Clawdbot You need PixelML setup guidance

PixelML

PixelML provides a unified OpenAI-compatible API for accessing multiple AI models including GPT-4o, Claude, and more.

Features

• Multi-model access: Use GPT, Claude, and other models through a single API
• OpenAI-compatible: Standard /v1 endpoints for easy integration
• Streaming: Supported on all models
• Vision: Supported on models with vision capability

Setup

1. Get API Key

1. Sign up at platform.pixelml.com
2. Go to your account settings and create an API key
3. Copy your API key

2. Configure Clawdbot

Option A: Environment Variable

export PIXELML_API_KEY="your-api-key"

Option B: Interactive Setup (Recommended)

clawdbot onboard --auth-choice pixelml-api-key

This will:

1. Prompt for your API key (or use existing PIXELML_API_KEY)
2. Configure the provider automatically
3. Set the default model

Option C: Non-interactive

clawdbot onboard --non-interactive \
  --auth-choice pixelml-api-key \
  --pixelml-api-key "your-api-key"

3. Verify Setup

clawdbot chat --model pixelml/gpt-4o-mini "Hello, are you working?"

Available Models

Model ID	Name	Context	Features
gpt-4o-mini	GPT-4o Mini	128k	Vision
gpt-4o	GPT-4o	128k	Vision
claude-4.5-haiku	Claude 4.5 Haiku	200k	Vision
claude-4.5-sonnet	Claude 4.5 Sonnet	200k	Vision, Reasoning

Model Selection

Change your default model anytime:

clawdbot models set pixelml/gpt-4o-mini
clawdbot models set pixelml/claude-4.5-sonnet

List all available models:

clawdbot models list | grep pixelml

Usage Examples

# Use GPT-4o Mini (default)
clawdbot chat --model pixelml/gpt-4o-mini "Hello"

# Use Claude via PixelML
clawdbot chat --model pixelml/claude-4.5-sonnet "Write a poem"

# Use GPT-4o for vision tasks
clawdbot chat --model pixelml/gpt-4o

Config File Example

{
  env: { PIXELML_API_KEY: "your-api-key" },
  agents: { defaults: { model: { primary: "pixelml/gpt-4o-mini" } } },
  models: {
    mode: "merge",
    providers: {
      pixelml: {
        baseUrl: "https://ishi.pixelml.com/v1",
        apiKey: "${PIXELML_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-4o-mini",
            name: "GPT-4o Mini",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 16384
          }
        ]
      }
    }
  }
}

Troubleshooting

API key not recognized

echo $PIXELML_API_KEY
clawdbot models list | grep pixelml

Connection issues

PixelML API is at https://ishi.pixelml.com/v1. Ensure your network allows HTTPS connections.

Links

• PixelML