用途:将 OpenRouter 上 OpenClaw 应用排行榜中的模型同步到当前 openclaw 安装的配置中。
主要能力:从 OpenRouter 应用页提取模型 ID,校验后转换为 openclaw 格式(上下文窗口、价格、推理、模态),写入配置并生成别名,写入前创建带时间戳的备份。
使用方式:第一步用浏览器工具打开 https://openrouter.ai/apps?url=https%3A%2F%2Fopenclaw.ai%2F(profile: openclaw),快照后点击 Show more 展开排行榜,再从链接 href 中提取形如 /<provider>/<model-name> 的模型 ID,过滤掉 /docs、/chat、/rankings、/pricing 等非模型链接。第二步运行 python3 scripts/sync-openrouter-models.py --models "model/id1,model/id2,...",支持 --dry-run 预览、--json 输出,也接受 stdin(每行一个模型 ID)。脚本会对照 OpenRouter /api/v1/models 目录校验,未通过的不写入。第三步执行 openclaw gateway restart。
环境变量:OPENCLAW_DIR(默认 ~/.openclaw)、OPENCLAW_AGENT_DIR(自动检测)、OPENROUTER_API_KEY(回退到配置)。别名可编辑 references/aliases.json,缺失时用内置默认值。
更新内容:~/.openclaw/agents/main/agent/models.json 与 ~/.openclaw/openclaw.json 中的 openrouter 提供商模型及别名,写入前生成 <file>.bak.<timestamp> 备份。
限制:仅增量添加,不删除已下架模型;推理检测使用启发式;第一步必须用浏览器工具,因为应用页是 JS 渲染的 SPA。