核心用法
Model Manager Skill 通过 Python 脚本 manage_models.py 与 OpenRouter API 交互,提供两大核心功能:
1. 模型列表查询:执行 list models(或简写 ls models/列出模型)从 https://openrouter.ai/api/v1/models 获取公开模型数据,按上下文窗口、价格或热度排序,输出格式化的表格视图。
2. 一键启用配置:通过 enable <model_id>(或 启用 <model_id>)将选定模型写入 OpenClaw 配置,自动更新 agents.defaults.models 及 fallback 链路,无需用户手动编辑 JSON/YAML。
显著优点
- 零门槛接入:OpenRouter API 为公开端点,无需 API Key 即可查询模型元数据,降低新用户探索成本。
- 自动化配置:生成
config.patch直接修改 OpenClaw 运行时配置,避免手写模型 ID 导致的拼写错误。 - 成本透明化:并列展示上下文长度与输入/输出定价,便于根据任务规模选型。
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **来源可信度** | OpenRouter 为第三方聚合平台(非模型官方),价格与可用性数据可能存在同步延迟。 |
| **配置覆盖** | `enable` 命令直接修改 defaults 与 fallbacks,若未做配置备份,可能意外覆盖用户自定义链路。 |
| **运行时依赖** | 需本地 Python 环境及网络连通性,离线场景不可用。 |
| **API 稳定性** | OpenRouter 公开端点虽无需鉴权,但存在速率限制或变更 Schema 的风险。 |
适合人群
- 频繁切换模型以对比效果的多模型用户
- 不熟悉 OpenClaw 配置语法、希望“命令行即配置”的开发者
- 需要快速估算推理成本的项目管理者
常规风险
- 配置漂移:自动补丁可能与用户手动维护的其他配置片段冲突,建议启用前 git commit 配置目录。
- 模型可用性:OpenRouter 返回的模型并非全部区域可用,
enable后仍需验证实际调用连通性。 - 数据时效:价格与上下文数据以 API 返回为准,若 OpenRouter 未及时更新,可能导致预算误判。