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...
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 restartTest 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
references/model-catalog.md for all 100+ models with specsreferences/openclaw-config.md for JSON structure and examplesreferences/model-selection.md for task-based recommendationsreferences/image-generation.md for Gemini image gen usage, prompts, and code examplesKey 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