Skill: dr-xiaoming/blueai-models (version 1.1.0)

--- 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: ```bash 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: ```bash python3 scripts/test_model.py gemini-2.5-flash python3 scripts/test_model.py --all-configured ``` List available models: ```bash 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. ```bash # 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`

path: _meta.json
content: ownerId: kn7adb1sb9m0scbfdht8mhtax1839jvg
slug: blueai-models
version: 1.0.0
publishedAt: 1774421386803

path: references/image-generation.md
content: # BlueAI 图像生成指南

## 概述

BlueAI 代理支持多种图像生成模型，其中 Gemini 图像模型通过 **Chat Completions** 接口生图（非传统 Images API），使用方式与普通对话一致，模型在回复中直接返回 base64 编码的图片。

## Gemini 图像生成模型

| 模型ID | 上下文 | 特点 | 推荐场景 |
|--------|--------|------|---------|
| `gemini-3.1-flash-image-preview` | 131K | Flash 速度，成本低 | 快速原型、批量生图 |
| `gemini-3-pro-image-preview` | 65K | Pro 品质，细节更好 | 高质量创意图 |
| `gemini-2.5-flash-image` | 32K | 支持图编辑 | 图像编辑/修改 |

## 使用方式

### 通过 Chat Completions 接口

Gemini 图像模型走标准 `/v1/chat/completions` 端点，**不需要**用 `/v1/images/generations`。

```bash
curl -s https://bmc-llm-relay.bluemediagroup.cn/v1/chat/completions \
  -H "Authorization: Bearer $BLUEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "messages": [
      {"role": "user", "content": "画一只穿着宇航服的猫，卡通风格"}
    ],
    "max_tokens": 4096
  }'
```

### 响应格式

模型返回的 `content` 是 Markdown 格式，图片以 base64 嵌入：

```
![image](data:image/png;base64,iVBORw0KGgo...)
```

有时也会伴随文字描述。

### 提取图片（Python）

```python
import json, base64, re, urllib.request

def generate_image(prompt, model="gemini-3.1-flash-image-preview", api_key=""):
    """通过 Gemini 图像模型生成图片，返回 PNG bytes"""
    url = "https://bmc-llm-relay.bluemediagroup.cn/v1/chat/completions"
    payload = {
        "model": model,
        "messages": [{"role": "user", "content": prompt}],
        "max_tokens": 4096
    }
    req = urllib.request.Request(
        url,
        data=json.dumps(payload).encode(),
        headers={
            "Content-Type": "application/json",
            "Authorization": f"Bearer {api_key}"
        }
    )
    resp = urllib.request.urlopen(req, timeout=120)
    data = json.loads(resp.read())
    content = data["choices"][0]["message"]["content"]

    # 提取 base64 图片
    match = re.search(r'data:image/(png|jpeg|webp);base64,([A-Za-z0-9+/=]+)', content)
    if match:
        return base64.b64decode(match.group(2)), match.group(1)
    return None, None

# 用法
img_bytes, fmt = generate_image("一只穿宇航服的猫", [REDACTED_SECRET]")
if img_bytes:
    with open(f"output.{fmt}", "wb") as f:
        f.write(img_bytes)
```

## 与 OpenAI 图像模型的区别

| 特性 | Gemini 图像模型 | GPT Image / DALL-E |
|------|----------------|-------------------|
| 接口 | `/v1/chat/completions` | `/v1/images/generations` |
| 输入 | 对话消息（可多轮） | 单次 prompt |
| 输出 | Markdown 中嵌 base64 | JSON 中 b64_json 或 url |
| 图片编辑 | ✅ 发送图片+指令即可 | 需要 mask 参数 |
| 多轮对话 | ✅ 可基于上文迭代修改 | ❌ 每次独立 |
| 中文 prompt | ✅ 原生支持 | ⚠️ 效果一般 |

## Prompt 技巧

1. **明确风格**：「卡通风格」「写实照片」「水彩画风」「赛博朋克风」
2. **指定细节**：颜色、构图、光线、背景
3. **中文直接写**：Gemini 对中文 prompt 理解很好，不需要翻译成英文
4. **迭代修改**：可以在多轮对话中要求「把背景换成蓝色」「加一顶帽子」

## 图片编辑（gemini-2.5-flash-image / gemini-3-pro-image-preview）

支持发送图片 + 修改指令：

```json
{
  "model": "gemini-3-pro-image-preview",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "image_url", "image_url": {"url": "data:image/png;base64,<原图base64>"}},
        {"type": "text", "text": "把背景改成星空"}
      ]
    }
  ],
  "max_tokens": 4096
}
```

## OpenClaw 配置

添加到 `openclaw.json`：

```json
{
  "id": "gemini-3.1-flash-image-preview",
  "name": "Gemini 3.1 Flash Image",
  "api": "openai-completions",
  "reasoning": false,
  "input": ["text", "image"],
  "cost": {"input": 0.15, "output": 3.5},
  "contextWindow": 131072,
  "maxTokens": 32768
}
```

或使用脚本：
```bash
python3 scripts/add_model.py gemini-3.1-flash-image-preview
python3 scripts/add_model.py gemini-3-pro-image-preview
openclaw gateway restart
```

## 测试

```bash
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
```


path: references/model-catalog.md
content: # BlueAI 模型目录

> 来源：BlueAI模型统一代理服务文档 | 更新：2026-03-25

## 端点信息

| 项目 | 值 |
|------|-----|
| 国内API | `https://bmc-llm-relay.bluemediagroup.cn` |
| 国外API | `https://bmc-llm-relay.nextblue.ai` |
| OpenAI端点 | `/v1/chat/completions` |
| Claude端点 | `/v1/messages` |
| Responses端点 | `/v1/responses` |
| 图像生成 | `/v1/images/generations` |
| Embedding | `/v1/embeddings` |
| 语音转文字 | `/v1/audio/transcriptions` |
| 文字转语音 | `/v1/audio/speech` |

---

## Claude 系列（AWS Bedrock）

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| claude-opus-4-6-v1 | 200K | 128K | 文本+图片+PDF, 扩展思考, 代码, 函数调用, Agentic Coding | 超长输出、复杂编码、Agent |
| claude-opus-4-5-20251101 | 200K | 64K | 文本+图片+PDF, 推理, 代码, 函数调用 | 复杂决策、长文撰写 |
| claude-sonnet-4-6 | 200K | 64K | 同Opus但更快更便宜 | 日常任务、平衡性价比 |
| claude-sonnet-4-5-20250929 | 200K | 64K | 同上, 增强推理 | 需要推理的日常任务 |
| claude-sonnet-4-20250514 | 200K | 64K | 文本+图片+PDF, 代码, 函数调用 | 标准对话和代码 |
| claude-haiku-4-5-20251001 | 200K | 64K | 文本+图片+PDF, 代码, 快速响应 | 轻量快速、低延迟 |
| claude-3-7-sonnet-20250219 | 200K | 64K | 文本+图片+PDF, 扩展思考, 代码 | 兼容旧版workflow |

**请求端点**：Anthropic Messages (`/v1/messages`)

---

## GPT 系列（Azure）

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| gpt-5.4 | 400K | 128K | 最新旗舰 | 最强综合能力 |
| gpt-5.2 | 400K | 128K | 文本+图片+音频, 深度推理, 代码 | 高级推理+多模态 |
| gpt-5.2-codex | 400K | 128K | 代码专精, Agent编码 | 大型代码生成 |
| gpt-5.1 | 400K | 128K | 文本+图片+音频, 推理, 代码 | GPT-5迭代版 |
| gpt-5 | 400K | 12K | 文本+图片+音频, 推理, 代码, Agent | 400K超长上下文旗舰 |
| gpt-4.1 | 128K | 32K | 文本+图片, 代码, 函数调用 | 编码和指令遵循 |
| gpt-4.1-mini | 128K | 32K | 同4.1轻量版 | **性价比首选** |
| gpt-4.1-nano | 128K | 32K | 最轻量 | 速度最快、成本最低 |
| gpt-4o | 128K | 16K | 文本+图片+音频, 代码, JSON模式 | 全能多模态 |
| gpt-4o-mini | 128K | 16K | 文本+图片, 代码 | 经济版多模态 |
| o4-mini | 200K | 100K | 文本+图片, 深度推理, 工具调用 | 高效推理+工具 |
| o3 | 200K | 100K | 最强推理 | 复杂逻辑/数学 |
| o3-mini | 200K | 100K | 推理, 可调effort | 轻量推理 |
| o1 | 200K | 100K | 深度推理, 内部思维链 | 科学/数学问题 |
| gpt-image-1 | - | - | 文生图+图编辑 | 图像生成 |
| gpt-image-1.5 | - | - | 升级版文生图 | 更好的图像生成 |

**请求端点**：OpenAI Completions (`/v1/chat/completions`)

---

## Gemini 系列（Google Cloud）

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| gemini-3.1-pro-preview | 1M | 65K | 文本+图片+视频+音频+PDF, 推理, Agent | **最新旗舰** |
| gemini-3-flash-preview | 1M | 65K | 同上但更快 | 速度与效果平衡 |
| gemini-2.5-pro | 1M | 65K | 文本+多模态, 深度思考, Grounding | 长上下文推理 |
| gemini-2.5-flash | 1M | 65K | 同上, 思维链推理 | **超便宜+100万上下文** |
| gemini-2.5-flash-image | 32K | 32K | 文生图+图编辑 | 图像生成/编辑 |
| gemini-3-pro-image-preview | 65K | 32K | 文生图+图编辑 | 3代图像生成 |
| gemini-3.1-flash-image-preview | 131K | 32K | 图像生成 | Flash版图像 |

**请求端点**：OpenAI Completions (`/v1/chat/completions`)
**⚠️ gemini-3-pro-preview 将于2026-03-26弃用，迁移至 gemini-3.1-pro-preview**

---

## DeepSeek 系列（火山引擎/百炼）

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| DeepSeek-R1 | 128K | 32K | 深度推理(CoT), 代码, 数学 | 复杂逻辑推理 |
| DeepSeek-V3 | 128K | 16K | 文本, 代码, 多语言, 函数调用 | 通用对话和代码 |
| DeepSeek-V3.1 | 128K | 32K | V3升级, 增强指令遵循 | 中文任务性价比 |
| DeepSeek-V3.2 | 128K | 32K | 最新版, 混合推理, 深度思考 | **中文最佳性价比** |

**请求端点**：OpenAI Completions
**注意**：纯文本模型，不支持图片/视频输入

---

## 豆包 Doubao 系列（火山引擎）

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| Doubao-Seed-2.0-pro | 256K | 128K | 最新旗舰 | 顶级中文能力 |
| Doubao-Seed-2.0-lite | 256K | 128K | 轻量版 | 经济版 |
| Doubao-Seed-2.0-mini | 256K | 128K | 最小版 | 低成本 |
| Doubao-Seed-2.0-Code | 256K | 128K | 代码专精 | 编程任务 |
| Doubao-Seed-1.8 | 256K | 32K | 文本, 推理, 代码 | 综合能力 |
| Doubao-Seed-1.6-thinking | 256K | 32K | 多模态+思维链 | 需要推理的多模态 |
| Doubao-Seed-1.6-vision | 256K | 32K | 图片+视频理解, OCR | 视觉理解 |
| Doubao-Seed-1.6-flash | 256K | 32K | 多模态, 速度优化 | 低延迟场景 |
| Doubao-1.5-vision-pro-32k | 128K | 16K | 图片+视频, OCR | 图像/视频理解 |
| Doubao-Seedream-5.0-lite | - | - | 文生图 | 图像生成 |
| Doubao-Seedream-4.5 | - | - | 文生图 | 图像生成 |
| Doubao-embedding | 4K | - | 文本向量化 | 语义搜索/RAG |

**请求端点**：OpenAI Completions

---

## 通义千问 Qwen 系列（百炼）

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| qwen3-235b-a22b | 131K | 16K | MoE旗舰, 混合推理 | 中文推理最强 |
| qwen3-32b | 131K | 16K | Dense架构 | 通用中文任务 |
| qwen3-14b | 131K | 8K | 中等规模 | 轻量中文 |
| qwen3-8b | 131K | 8K | 轻量级 | 最低成本 |
| qwen3-vl-plus | 262K | 32K | 图片+视频理解, OCR | 视觉理解 |
| qwen-vl-max-latest | 131K | 8K | 视觉旗舰 | 最强视觉理解 |
| qwen-vl-ocr-latest | 32K | 2K | OCR专用 | 文字识别 |
| qwen-omni-turbo-latest | 32K | 2K | 全模态(图片+视频+音频)+语音输出 | 语音对话 |
| qwen-max | 32K | 8K | 旗舰文本 | 通用对话 |
| qwen-plus | 131K | 16K | 长上下文 | 长文档 |
| text-embedding-v4 | 8K | - | 中英文向量化 | RAG/搜索 |
| gte-rerank-v2 | 4K | - | 重排序 | 搜索结果优化 |

**请求端点**：OpenAI Completions

---

## Kimi / 月之暗面

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| kimi-k2.5 | 262K | - | 最新版 | 中文+Agent |
| kimi-k2-thinking | 262K | - | 深度思考, Agent | 长上下文推理+编码 |
| moonshot-v1-128k | 128K | - | 超长文本, 代码 | 长文档分析 |
| moonshot-v1-128k-vision-preview | 128K | - | 多模态 | 128K+图片 |
| moonshot-v1-32k | 32K | - | 文本, 代码 | 标准对话 |

---

## Grok 系列（Oracle/xAI）

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| xai.grok-4 | 128K | 16K | 文本+图片, 深度推理, 代码 | 最强推理 |
| xai.grok-4-fast-reasoning | 2M | 16K | 推理+速度优化 | 超长上下文推理 |
| xai.grok-4-fast-non-reasoning | 2M | 16K | 极速回答, 跳过推理 | **2M上下文+最快** |
| xai.grok-code-fast-1 | 256K | 16K | 代码专精 | 大型代码库 |
| xai.grok-3 | 131K | 16K | 推理, 代码 | 标准版 |
| xai.grok-3-fast | 131K | 16K | 速度优化 | 快速版 |

---

## MiniMax 系列

| 模型ID | 上下文 | 最大输出 | 能力 | 推荐场景 |
|--------|--------|---------|------|---------|
| MiniMax-M2.7 | 204K | 2K | 最新版 | 编程+Agent |
| MiniMax-M2.5 | 204K | 2K | 编程+Agent | 通用 |
| MiniMax-M2.1-lightning | 204K | 2K | 极速版 | 低延迟 |

**⚠️ 不支持Claude端点，必须使用OpenAI端点**

---

## Embedding / 向量模型

| 模型ID | 维度 | 提供商 | 推荐场景 |
|--------|------|--------|---------|
| text-embedding-3-large | 3072 | OpenAI | 最强向量化 |
| text-embedding-3-small | 1536 | OpenAI | 轻量向量化 |
| text-embedding-ada-002 | 1536 | OpenAI | 旧版兼容 |
| text-embedding-v4 | - | 阿里 | 中英双语 |
| Doubao-embedding | - | 火山 | 中文向量化 |

---

## 图像生成模型

| 模型ID | 提供商 | 推荐场景 |
|--------|--------|---------|
| gpt-image-1.5 | OpenAI | 最佳文生图 |
| gpt-image-1 | OpenAI | 标准文生图 |
| dall-e-3 | OpenAI | 经典文生图 |
| gemini-2.5-flash-image | Google | 图像生成+编辑 |
| gemini-3-pro-image-preview | Google | 3代图像 |
| Doubao-Seedream-5.0-lite | 火山 | 中文文生图 |
| Doubao-Seedream-4.5 | 火山 | 中文文生图 |

---

## 语音模型

| 端点 | 用途 |
|------|------|
| `/v1/audio/speech` | 文字转语音 |
| `/v1/audio/transcriptions` | 语音转文字（whisper-1） |
| `/v1/audio/translations` | 语音翻译 |


path: references/model-selection.md
content: # BlueAI 模型选型决策树

## 按任务类型选模型

### 日常对话 / 问答
- 预算充足 → `claude-sonnet-4-6` 或 `gpt-4.1`
- 追求性价比 → `DeepSeek-V3.2`（中文）或 `gpt-4.1-mini`（中英）
- 最低成本 → `gpt-4.1-nano` 或 `gemini-2.5-flash`

### 复杂推理 / 数学 / 逻辑
- 最强推理 → `claude-opus-4-6-v1` 或 `o3`
- 性价比推理 → `o4-mini` 或 `DeepSeek-R1`
- 中文推理 → `qwen3-235b-a22b` 或 `DeepSeek-R1`

### 编码 / 代码生成
- Agent级编码 → `claude-opus-4-6-v1`（128K输出）
- 代码专精 → `gpt-5.2-codex` 或 `Doubao-Seed-2.0-Code`
- 轻量代码 → `claude-sonnet-4-6` 或 `gpt-4.1-mini`

### 图片/视觉理解
- 最强视觉 → `claude-opus-4-6-v1` 或 `gemini-3.1-pro-preview`
- 性价比视觉 → `gemini-2.5-flash`（100万上下文+图片）
- 中文OCR → `qwen-vl-ocr-latest`
- 视频理解 → `gemini-3.1-pro-preview` 或 `Doubao-Seed-1.6-vision`

### 超长文档处理
- 100万token → `gemini-2.5-flash`/`gemini-2.5-pro`
- 200万token → `xai.grok-4-fast-non-reasoning`
- 400K token → `gpt-5` 系列
- 262K token → `kimi-k2.5` 或 `qwen3-vl-plus`

### 图像生成
- 最佳质量（OpenAI） → `gpt-image-1.5`（Images API）
- 标准（OpenAI） → `gpt-image-1` 或 `dall-e-3`（Images API）
- **快速生图（Gemini）** → `gemini-3.1-flash-image-preview`（Chat Completions，速度快成本低）
- **高质量生图（Gemini）** → `gemini-3-pro-image-preview`（Chat Completions，Pro级品质）
- **图像编辑** → `gemini-2.5-flash-image` 或 `gemini-3-pro-image-preview`（发送图片+指令）
- 中文理解 → `Doubao-Seedream-5.0-lite`
- ⚡ Gemini 图像模型走 `/v1/chat/completions`，不走 Images API，详见 image-generation.md

### RAG / 语义搜索
- Embedding → `text-embedding-3-large`（英文）或 `text-embedding-v4`（中英）
- Rerank → `gte-rerank-v2`

---

## 按成本分层

### 💰 旗舰级（最贵，最强）
`claude-opus-4-6-v1`, `o3`, `gpt-5.2`, `xai.grok-4`

### 💵 专业级（均衡）
`claude-sonnet-4-6`, `gpt-4.1`, `gemini-2.5-pro`, `DeepSeek-R1`

### 💲 经济级（性价比）
`gpt-4.1-mini`, `gemini-2.5-flash`, `DeepSeek-V3.2`, `claude-haiku-4-5-20251001`

### 🆓 超低成本
`gpt-4.1-nano`, `qwen3-8b`, `Doubao-lite-4k`

---

## OpenClaw 分层策略建议

| 用途 | 推荐模型 | 理由 |
|------|---------|------|
| 主Agent（primary） | claude-opus-4-6-v1 | 最强综合+128K输出 |
| 子Agent任务 | claude-sonnet-4-6 或 gemini-2.5-flash | 省成本，大部分任务够用 |
| 截图/图片识别 | gemini-2.5-flash 或 gpt-4o-mini | 视觉+便宜 |
| 中文内容生成 | DeepSeek-V3.2 或 qwen3-235b-a22b | 中文质量高 |
| 批量/重复操作 | gpt-4.1-nano | 最低成本 |
| Heartbeat/文案 | gemini-3.1-pro-preview | 1M上下文+强推理 |


path: references/openclaw-config.md
content: # OpenClaw 模型配置指南

## openclaw.json 配置结构

OpenClaw 通过 `~/.openclaw/openclaw.json` 的 `models` 字段配置模型。

### 基本结构

```json
{
  "models": {
    "mode": "merge",
    "providers": {
      "<provider-name>": {
        "baseUrl": "<api-endpoint>",
        "apiKey": "<api-key>",
        "api": "<api-type>",
        "models": [ ... ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "<provider>/<model-id>" },
      "models": {
        "<provider>/<model-id>": { "alias": "<short-name>" }
      }
    }
  }
}
```

### API 类型（api 字段）

| api 值 | 用于 | 端点 |
|--------|------|------|
| `anthropic-messages` | Claude 系列 | `https://bmc-llm-relay.bluemediagroup.cn` (无/v1) |
| `openai-completions` | GPT/Gemini/DeepSeek/Qwen等 | `https://bmc-llm-relay.bluemediagroup.cn/v1` (带/v1) |

**关键区别**：
- Anthropic 端点的 `baseUrl` **不带** `/v1`
- OpenAI 端点的 `baseUrl` **必须带** `/v1`

### 模型定义字段

```json
{
  "id": "模型ID（必须与API文档一致）",
  "name": "显示名称",
  "api": "anthropic-messages 或 openai-completions",
  "reasoning": true/false,
  "input": ["text"] 或 ["text", "image"],
  "cost": {
    "input": 0.001,
    "output": 0.005,
    "cacheRead": 0.0001,
    "cacheWrite": 0.00125
  },
  "contextWindow": 200000,
  "maxTokens": 64000
}
```

- `reasoning: true` 表示模型支持思维链/扩展思考
- `input` 数组决定模型能否处理图片
- `cost` 单位为 $/1K tokens（用于 OpenClaw dashboard 估算费用）
- `cacheRead`/`cacheWrite` 仅 Anthropic 模型需要

### 别名配置

在 `agents.defaults.models` 中设置别名，方便通过 `/model <alias>` 快速切换：

```json
"models": {
  "blueai/gemini-2.5-flash": { "alias": "flash" },
  "anthropic/claude-sonnet-4-6": { "alias": "sonnet" }
}
```

---

## 完整配置示例

### 场景1：仅添加一个轻量模型（最小改动）

在 `models.providers` 中添加一个 provider：

```json
"blueai": {
  "baseUrl": "https://bmc-llm-relay.bluemediagroup.cn/v1",
  "apiKey": "sk-xxx",
  "api": "openai-completions",
  "models": [
    {
      "id": "gemini-2.5-flash",
      "name": "Gemini 2.5 Flash",
      "api": "openai-completions",
      "reasoning": true,
      "input": ["text", "image"],
      "cost": {"input": 0.00015, "output": 0.0035},
      "contextWindow": 1048576,
      "maxTokens": 65535
    }
  ]
}
```

### 场景2：分层策略（推荐）

```json
"providers": {
  "anthropic": {
    "baseUrl": "https://bmc-llm-relay.bluemediagroup.cn",
    "api": "anthropic-messages",
    "models": [
      {"id": "claude-sonnet-4-6", "name": "Sonnet 4.6", ...},
      {"id": "claude-haiku-4-5-20251001", "name": "Haiku 4.5", ...}
    ]
  },
  "blueai": {
    "baseUrl": "https://bmc-llm-relay.bluemediagroup.cn/v1",
    "apiKey": "sk-xxx",
    "api": "openai-completions",
    "models": [
      {"id": "gemini-2.5-flash", ...},
      {"id": "gpt-4.1-mini", ...},
      {"id": "DeepSeek-V3.2", ...}
    ]
  }
}
```

---

## 常见问题

### MiniMax 模型必须用 OpenAI 端点
MiniMax-M2.x 系列不支持 Claude 端点，`api` 必须设为 `openai-completions`。

### gemini-3-pro-preview 即将弃用
2026-03-26 起弃用，应迁移至 `gemini-3.1-pro-preview`。

### DeepSeek 是纯文本模型
`input` 只能设 `["text"]`，不支持图片。

### 价格查询
访问 `https://bmc-llm-relay.bluemediagroup.cn/pricing` 获取最新价格。

### API Key 申请
通过飞书多维表格申请：搜索"BlueAI 模型代理API Key申请"。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)