aAAaqwq 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 配置 |
当前供应商清单
| Provider | baseUrl | API类型 | 模型数 | Key来源 | 状态 |
|---|---|---|---|---|---|
| shibacc | http://8.148.217.100:6543 | anthropic-messages | 3 | 🔴硬编码 | ⚠️ key未存pass |
| xingsuancode | https://cn.xingsuancode.com | anthropic-messages | 1 | env | ❌ 9账号全挂 |
| zai | https://open.bigmodel.cn/api/coding/paas/v4 | openai-completions | 5 | 🔴硬编码 | ⚠️ key未存pass |
| minimax | https://api.minimaxi.com/anthropic | anthropic-messages | 1 | env | ✅ |
| xingjiabiapi | https://xingjiabiapi.com/v1 | openai-completions | 4 | env | ✅ |
| xai | https://api.x.ai/v1 | openai-completions | 10 | env | ✅ |
| wow | https://linuxdoapi-api-wow.223387.xyz/v1 | openai-completions | 3 | env | ⚠️ 503偶发 |
| xinyuan | https://api-i.xykjy.com | auto | 4 | env | ✅ |
| aixn | https://ai.xn--vuq861bvij35ps8cv0uohm.com/v1 | openai-completions | 1 | env | ✅ |
| moonshot | https://api.moonshot.cn/v1 | openai-completions | 1 | env | ✅ |
| ollama | http://100.65.110.126:11434 | ollama | 12 | env | ✅ |
| github-copilot | https://api.githubcopilot.com | openai-completions | 17 | env | ✅ |
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 三步同步