| name | model-provider-manager |
| description | Unified LLM provider and model configuration, health monitoring, and key management |
Skill: Model & Provider Manager
触发条件
- "模型管理"、"供应商管理"、"provider 健康检查"
- "检查模型"、"模型可用性"、"哪个模型能用"
- "embedding 模型"、"推理模型"、"视觉模型"
- "API key 检查"、"key 过期"、"余额查询"
- "添加模型"、"删除模型"、"更新模型配置"
- "同步模型配置"、"sync agent models"
职责
统一维护所有 LLM 供应商和模型的配置、健康状态、密钥管理。
CEO 指定的专职模型管理 skill，所有模型相关查询和操作都通过此 skill。
⚙️ 配置更新铁律（env-first 三步同步）
任何模型/密钥/供应商变更，必须按以下顺序执行：
Step 1: 更新 pass 密钥仓库（唯一真相源）
pass insert api/<provider-name> # 新建
pass show api/<provider-name> # 验证
Step 2: 同步到 ~/.openclaw/.env（运行时环境变量）
添加/更新: echo 'NEW_API_KEY=<value>' >> ~/.openclaw/.env
或执行: ~/clawd/scripts/rebuild-env.sh # 如果存在
Step 3: 同步到 ~/.openclaw/openclaw.json（OpenClaw 配置）
确保模型引用 ${ENV_VAR_NAME} 而非硬编码
gateway restart 或 config.patch 生效
Step 4: 验证同步完整性
python3 ~/clawd/skills/model-provider-manager/scripts/health-check.py
python3 ~/clawd/skills/model-provider-manager/scripts/key-audit.py
Agent & Cron 模型同步
当全局模型配置变更时（新增/删除/切换 provider），需检查并同步：
- Agent 模型:
openclaw.json → agents.list[].model.primary/fallbacks
- Cron 任务模型:
cron list → 检查每个 cron 的 payload.model
- Cron fallback:
cron list → 检查 payload.fallbacks
同步检查脚本
python3 ~/clawd/skills/model-provider-manager/scripts/sync-check.py
配置文件位置
| 文件 | 路径 | 用途 |
|---|
| pass 仓库 | pass api/<name> | 密钥唯一真相源 |
| 运行时环境 | ~/.openclaw/.env | 环境变量（chmod 600） |
| 主配置 | ~/.openclaw/openclaw.json → models.providers | 供应商定义 |
| Agent 模型 | ~/.openclaw/openclaw.json → agents.list[].model | 各 agent 主模型+fallback |
| 全局默认 | ~/.openclaw/openclaw.json → agents.defaults.model | 默认模型 |
| Embedding | ~/.openclaw/openclaw.json → agents.defaults.memorySearch | Embedding 配置 |
当前供应商清单
Embedding 模型清单
| 位置 | 模型 | 维度 | 大小 | 状态 |
|---|
| Mac Studio Ollama | qwen3-embedding:0.6b | 1024 | 639MB | ✅ 推荐 |
| Mac Studio Ollama | qwen3-embedding:8b | 4096 | 4.7GB | ✅ |
| Mac Studio Ollama | nomic-embed-text:latest | 768 | 274MB | ✅ |
| 小m Ollama | qwen3-embedding:0.6b | 1024 | 639MB | ⚠️ 离线不稳定 |
| OpenClaw 内置 | embeddinggemma-300M | 384 | 300MB | ✅ fallback |
Agent 模型分配方案（待 Daniel 确认）
| Agent | 当前 | 建议主模型 | 建议Fallback |
|---|
| main (CEO) | opus-4-6 | shibacc/opus-4-6 ✅ | xsc/opus, zai/glm-5 |
| quant | opus-4-6 | shibacc/opus-4-6 ✅ | xsc/opus, zai/glm-5 |
| code | opus-4-6 | xingsuancode/sonnet-4-6 | shibacc/opus, aixn/gpt-5.2 |
| pm | opus-4-6 | xingsuancode/sonnet-4-6 | shibacc/opus, zai/glm-5 |
| content | opus-4-6 | xingsuancode/sonnet-4-6 | shibacc/opus, minimax/M2.5 |
| research | opus-4-6 | xingsuancode/sonnet-4-6 | shibacc/opus, aixn/gpt-5.2 |
| law | opus-4-6 | xingsuancode/sonnet-4-6 | shibacc/opus, minimax/M2.5 |
| data | opus-4-6 | zai/glm-5-turbo | xingsuancode/sonnet, minimax/M2.5 |
| ops | opus-4-6 | zai/glm-5-turbo | xingsuancode/sonnet, minimax/M2.5 |
| finance | opus-4-6 | zai/glm-5-turbo | xingsuancode/sonnet, minimax/M2.5 |
| market | opus-4-6 | zai/glm-5-turbo | xingsuancode/sonnet, minimax/M2.5 |
| product | opus-4-6 | zai/glm-5-turbo | xingsuancode/sonnet, minimax/M2.5 |
| sales | opus-4-6 | zai/glm-5-turbo | xingsuancode/sonnet, minimax/M2.5 |
| batch | opus-4-6 | zai/glm-5-turbo | xingsuancode/sonnet, minimax/M2.5 |
执行命令
| 命令 | 用途 |
|---|
health-check.py | 全量 provider 健康检查 |
health-check.py --type embedding | 只检查 embedding 模型 |
key-audit.py | 密钥审计（硬编码/缺pass/env缺失） |
sync-check.py | 检查 env→json→agent→cron 同步完整性 |
安全铁律
- pass 是唯一真相源 — 所有 key 必须先存 pass
- openclaw.json 用
${ENV_VAR} — 永不硬编码 key
- 换 key:
pass insert → 更新 .env → gateway restart
- provider 变更必须经 CEO 确认
更新记录
- 2026-03-29: 初版，覆盖 12 provider 84+ 模型，env-first 三步同步
