Model Manager

---

name: model-manager description: OpenClaw 模型配置管理技能。用于添加、删除、更新、查看、切换、检测模型配置。当用户需要：(1) 添加新模型到配置 (2) 删除模型 (3) 更新模型参数（contextWindow、maxTokens等）(4) 查看当前模型列表 (5) 切换主模型 (6) 检查模型可用状态（测试连接）(7) 修复模型配置问题时使用此技能。

---

Model Manager

OpenClaw 模型配置管理技能，用于统一维护 openclaw.json 中的模型与 provider 配置。

适用场景

适合以下场景：

添加新的模型或 provider

删除失效或不再使用的模型

修正模型参数（如 contextWindow、maxTokens、reasoning）

切换 OpenClaw 默认主模型

检查模型连通性与可用状态

排查 401 / 403 / 429 / 400 / 5xx 等模型调用问题

批量整理和优化模型配置

核心能力

添加模型

删除模型

更新模型参数

查看当前模型列表

切换主模型

检查模型可用状态

并行测试模型连接

辅助定位常见错误码问题

配置文件位置

C:\Users\Administrator\.openclaw\openclaw.json

常见用户请求示例

“把主模型改成 minmax/MiniMax-M2.7”

“检查所有模型状态”

“测试模型连接”

“给 bailian2/qwen3-max-2026-01-23 补上参数”

“删除一个不用的 provider”

“把不可用模型找出来”

“查看当前配置了哪些模型”

工作流程

1. 添加模型

当用户提供模型信息时：

1. 读取当前配置：gateway(action=config.get) 2. 编辑配置文件添加模型到 models.providers 3. 可选：添加别名到 agents.defaults.models 4. 重启生效：gateway(action=restart, note="...")

#### 添加格式

{
  "id": "model-id",
  "name": "Model Display Name",
  "reasoning": true,
  "input": ["text"],
  "contextWindow": 200000,
  "maxTokens": 8192
}

2. 删除模型

1. 读取配置 2. 从 models.providers..models 删除模型 3. 从 agents.defaults.models 删除别名 4. 重启生效

3. 更新模型参数

1. 读取配置 2. 修改目标模型的参数 3. 重启生效

4. 查看模型列表

直接使用：gateway(action=config.get) 查看完整配置。

5. 切换主模型

切换默认使用的模型：

1. 读取配置确认目标模型存在 2. 修改 agents.defaults.model.primary 为目标模型 ID 3. 重启生效：gateway(action=restart, note="主模型已切换为 xxx")

#### 切换前检查

在切换主模型前应确认：

目标模型在当前配置中存在

provider 配置完整

模型不是已知不可用状态（如果刚做过可用性检测）

#### 示例

用户说： > “把主模型改成 minmax/MiniMax-M2.7”

操作： 编辑 agents.defaults.model.primary 从当前值改为 "minmax/MiniMax-M2.7"

6. 检查模型可用状态

测试当前配置中每个模型的连接状态，并按 状态优先 + 能力排序 显示结果。

#### 测试流程

1. 读取配置获取所有模型和 provider API key 2. 并行测试：对所有模型同时发送 HTTP 测试请求（简单 completion，max_tokens=5） 3. 解析响应： - 200 OK = 可用 - 401/403 = 认证失败 / 权限问题 - 429 = 速率限制 - 400 = 参数、模型名或请求格式问题 - 5xx = 上游服务异常 4. 按 状态分组（可用 > RateLimit > 不可用），每组内按 能力排序（contextWindow 大 + reasoning=true 优先）

#### 并行测试实现

使用 PowerShell 的 Start-Job 或 OpenClaw 的 exec 工具并行执行：

$jobs = @()
foreach ($model in $models) {
    $job = Start-Job -ScriptBlock {
        $result = Test-ModelConnection($model)
        return "$modelId | $capability | $status"
    }
    $jobs += $job
}
$results = Receive-Job -Job $jobs -Wait

优势： 11 个模型的测试时间可从 ~30 秒减少到 ~5 秒。

#### 测试请求格式

根据提供商 API 类型选择格式：

| API 类型 | Header | Endpoint | |----------|--------|----------| | openai-completions | Authorization: Bearer | /v1/chat/completions | | anthropic-messages | x-api-key: | /v1/messages |

#### 排序规则

1. 状态优先：✅ 可用 > ⚠️ RateLimit > ❌ 不可用 2. 能力排序：contextWindow 大者优先，reasoning=true 优先

#### 输出格式

用户说： > “检查可用状态” 或 > “测试模型连接”

按照 模型名称 | 能力 | 状态 格式显示：

### ✅ 可用模型
bailian2/qwen3-max-2026-01-23 | 128K, reasoning | ✅ 可用
volcano/deepseek-v3.2 | 200K | ✅ 可用
volcano/glm-4.7 | 200K | ✅ 可用
bailian/glm-5 | 32K | ✅ 可用
bailian2/glm-5 | 32K | ✅ 可用
⚠️ RateLimit
minmax/MiniMax-M2.7 | 204K, reasoning | ⚠️ RateLimit
❌ 不可用
注册机/gpt-5-codex | 400K | ❌ 401
注册机/gpt-5.4 | 400K | ❌ 401
siliconflow/Pro/deepseek-ai/DeepSeek-V3.2 | 200K, reasoning | ❌ 401
siliconflow/zai-org/GLM-4.6 | 200K | ❌ 401
bailian/qwen1.5-32b-chat | 32K | ❌ 400

---

格式：模型名称 | 能力 | 状态

常见错误码解释

401 / 403：API key 无效、过期、无权限，或 provider 认证配置错误

429：达到速率限制，通常需要等待后重试

400：模型名错误、参数不兼容、请求格式不符合 provider 要求

5xx：上游服务异常，通常不是本地配置本身的问题

v1.0.1 增强点

本版本相对 v1.0.0 的增强主要包括：

1. 补全发布说明 - 增加适用场景 - 增加核心能力说明 - 增加典型用户请求示例

2. 增强并行检测说明 - 明确并行测试方式 - 明确排序规则 - 明确状态分组逻辑

3. 增强错误处理说明 - 补充常见错误码解释 - 强调切换主模型前的检查步骤 - 强调修改后需重启生效

常用模型参考

参见 references/model-info.md 获取各 provider 支持的模型列表。

注意事项

每次修改后需要重启 Gateway：gateway(action=restart)

JSON 文件不支持注释，编辑时注意移除 // 注释

contextWindow 和 maxTokens 单位是 tokens

reasoning: true 表示支持思考模式

修改主模型、provider、模型参数后，都应提醒用户重启生效