概述

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

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

版本历史

共 2 个版本

v1.1.0 当前

2026-05-03 11:16 安全安全
v1.0.0

2026-03-31 10:22 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)