🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Blueai Models

by @dr-xiaoming

Configure and manage AI models from BlueAI unified proxy service for OpenClaw. Use when: (1) adding new models to openclaw.json, (2) choosing the right model...

Versionv1.1.0
Downloads339
TERMINAL
clawhub install blueai-models

πŸ“– About This Skill


name: blueai-models description: | Configure and manage AI models from BlueAI unified proxy service for OpenClaw. Use when: (1) adding new models to openclaw.json, (2) choosing the right model for a task, (3) setting up multi-model strategy, (4) switching or comparing models, (5) troubleshooting model connectivity, (6) user asks about available models or pricing, (7) generating images via Gemini image models or GPT image models. Covers: Claude, GPT, Gemini, DeepSeek, Qwen, Doubao, Kimi, Grok, MiniMax via BlueAI relay. Image generation: Gemini 3.1 Flash Image, Gemini 3 Pro Image, Gemini 2.5 Flash Image (chat-based), GPT Image 1/1.5, DALL-E 3 (images API).

BlueAI Models for OpenClaw

Quick Start

Add a model to OpenClaw:

python3 scripts/add_model.py gemini-2.5-flash --alias flash
python3 scripts/add_model.py claude-sonnet-4-6 --alias sonnet
openclaw gateway restart

Test connectivity:

python3 scripts/test_model.py gemini-2.5-flash
python3 scripts/test_model.py --all-configured

List available models:

python3 scripts/add_model.py --list

Image Generation

Gemini image models generate images via Chat Completions (/v1/chat/completions), not the Images API. Send a prompt as a normal message; the model returns base64-encoded images in Markdown.

# Add image models
python3 scripts/add_model.py gemini-3.1-flash-image-preview
python3 scripts/add_model.py gemini-3-pro-image-preview
openclaw gateway restart

Test image generation

python3 scripts/test_model.py gemini-3.1-flash-image-preview --image-gen python3 scripts/test_model.py gemini-3-pro-image-preview --image-gen --save ./test-output

| Model | Speed | Quality | Edit Support | Best For | |-------|-------|---------|-------------|----------| | gemini-3.1-flash-image-preview | ⚑ Fast | Good | ❌ | Quick prototypes, batch | | gemini-3-pro-image-preview | Medium | ⭐ Best | βœ… | High-quality creative | | gemini-2.5-flash-image | ⚑ Fast | Good | βœ… | Image editing |

For detailed usage, prompt tips, Python examples, and edit workflows: read references/image-generation.md.

Endpoints

| Type | Base URL | Note | |------|----------|------| | Claude (Anthropic) | https://bmc-llm-relay.bluemediagroup.cn | No /v1 | | Everything else (OpenAI) | https://bmc-llm-relay.bluemediagroup.cn/v1 | With /v1 |

Same API key works for all models.

Model Selection Quick Guide

| Need | Model | Why | |------|-------|-----| | Cheapest + good | gemini-2.5-flash | $0.15/M in, 1M context | | Best Chinese | DeepSeek-V3.2 | Top Chinese quality, cheap | | Vision + cheap | gpt-4o-mini or gemini-2.5-flash | Image input, low cost | | Strong reasoning | o4-mini or DeepSeek-R1 | CoT reasoning | | Best overall | claude-opus-4-6-v1 | 128K output, Agent coding | | Balanced | claude-sonnet-4-6 | 1/5 Opus price, most tasks | | Code specialist | gpt-5.2-codex | 128K output, code focused | | Ultra-long context | xai.grok-4-fast-non-reasoning | 2M tokens | | Image gen (fast) | gemini-3.1-flash-image-preview | Chat-based, cheap | | Image gen (quality) | gemini-3-pro-image-preview | Best Gemini quality | | Image edit | gemini-2.5-flash-image | Send image + edit instruction |

References

  • Full model catalog: Read references/model-catalog.md for all 100+ models with specs
  • OpenClaw config guide: Read references/openclaw-config.md for JSON structure and examples
  • Model selection decision tree: Read references/model-selection.md for task-based recommendations
  • Image generation guide: Read references/image-generation.md for Gemini image gen usage, prompts, and code examples
  • Key Rules

    1. Claude models use api: "anthropic-messages", baseUrl without /v1 2. All other models use api: "openai-completions", baseUrl with /v1 3. DeepSeek/Qwen text models: set input: ["text"] only (no image) 4. MiniMax: must use OpenAI endpoint, does not support Claude endpoint 5. gemini-3-pro-preview deprecated 2026-03-26 β†’ use gemini-3.1-pro-preview 6. Gemini image models use chat completions, not images API β€” output is base64 in Markdown 7. After config changes: openclaw gateway restart

    πŸ’‘ Examples

    Add a model to OpenClaw:

    python3 scripts/add_model.py gemini-2.5-flash --alias flash
    python3 scripts/add_model.py claude-sonnet-4-6 --alias sonnet
    openclaw gateway restart
    

    Test connectivity:

    python3 scripts/test_model.py gemini-2.5-flash
    python3 scripts/test_model.py --all-configured
    

    List available models:

    python3 scripts/add_model.py --list