- 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. 添加模型
当用户提供模型信息时：
- 读取当前配置：
gateway(action=config.get) - 编辑配置文件添加模型到
models.providers - 可选：添加别名到
agents.defaults.models - 重启生效：
gateway(action=restart, note="...")
添加格式
{
"id": "model-id",
"name": "Model Display Name",
"reasoning": true,
"input": ["text"],
"contextWindow": 200000,
"maxTokens": 8192
}2. 删除模型
- 读取配置
- 从
models.providers.<provider>.models删除模型 - 从
agents.defaults.models删除别名 - 重启生效
3. 更新模型参数
- 读取配置
- 修改目标模型的参数
- 重启生效
4. 查看模型列表
直接使用：gateway(action=config.get) 查看完整配置。
5. 切换主模型
切换默认使用的模型：
- 读取配置确认目标模型存在
- 修改
agents.defaults.model.primary为目标模型 ID - 重启生效：
gateway(action=restart, note="主模型已切换为 xxx")
切换前检查
在切换主模型前应确认：
- 目标模型在当前配置中存在
- provider 配置完整
- 模型不是已知不可用状态（如果刚做过可用性检测）
示例
用户说：
“把主模型改成 minmax/MiniMax-M2.7”操作： 编辑 agents.defaults.model.primary 从当前值改为 "minmax/MiniMax-M2.7"
6. 检查模型可用状态
测试当前配置中每个模型的连接状态，并按 状态优先 + 能力排序 显示结果。
测试流程
- 读取配置获取所有模型和 provider API key
- 并行测试：对所有模型同时发送 HTTP 测试请求（简单 completion，
max_tokens=5） - 解析响应：
- 200 OK = 可用 - 401/403 = 认证失败 / 权限问题 - 429 = 速率限制 - 400 = 参数、模型名或请求格式问题 - 5xx = 上游服务异常
- 按 状态分组（可用 > 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 <key> | /v1/chat/completions |
| anthropic-messages | x-api-key: <key> | /v1/messages |
排序规则
- 状态优先：✅ 可用 > ⚠️ RateLimit > ❌ 不可用
- 能力排序：
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 的增强主要包括：
- 补全发布说明
- 增加适用场景 - 增加核心能力说明 - 增加典型用户请求示例
- 增强并行检测说明
- 明确并行测试方式 - 明确排序规则 - 明确状态分组逻辑
- 增强错误处理说明
- 补充常见错误码解释 - 强调切换主模型前的检查步骤 - 强调修改后需重启生效
常用模型参考
参见 references/model-info.md 获取各 provider 支持的模型列表。
注意事项
- 每次修改后需要重启 Gateway：
gateway(action=restart) - JSON 文件不支持注释，编辑时注意移除
//注释 contextWindow和maxTokens单位是 tokensreasoning: true表示支持思考模式- 修改主模型、provider、模型参数后，都应提醒用户重启生效