sync-models — 模型同步
从本地配置提取 Claude/GPT 模型列表,注册到远端 provider + 加入白名单 + 重启 Gateway。一条命令搞定三道门。
./openclaw_model.sh sync-models
# 做了什么:
# 1. 从本地 config.yaml 提取模型列表
# 2. 远端注册到 models.providers
# 3. 加入 agents.defaults.models 白名单
# 4. 重启 Gateway
switch — 切换主力模型
改变当前使用的主力模型。立即生效(会自动重启 Gateway)。
# 切换到指定模型
./openclaw_model.sh switch proxy/gpt-5.3-codex
# 切换到 foxcode 直连
./openclaw_model.sh switch foxcode/claude-sonnet-4-5-thinking
fallback — 设置降级链
定义主力模型挂了之后的降级顺序。至少配两层 fallback。
# 设置 fallback 链
./openclaw_model.sh fallback "cliproxy/gpt-5.3-codex,cliproxy/claude-sonnet-4-20250514,zai/glm-4.7"
# 典型降级链:
# foxcode/claude-sonnet-4-5-thinking (主力,直连官方)
# → cliproxy/gpt-* (备选,多站点)
# → zai/glm-* (终极兜底)
status / list — 查看状态
# 查看远端完整状态
./openclaw_model.sh status
# 列出所有已注册模型
./openclaw_model.sh list
模型选择原则
覆盖 5 个站点的模型 > 只在 1 个站点可用的模型。单站点独占的名字是单点故障。有官方直连能力的 provider(如 foxcode)优先于中转站点。直连有独立 rate limit,不受其他用户影响。
实操清单
✓推荐做法
- 用
sync-models做全量同步,不要手动一个个注册 - 切换模型前先
list确认可用性 - fallback 至少配两层,主力 → 备选 → 兜底
- 新模型上线后发几条测试消息验证路由
✗不推荐
- 不要选只有单站点覆盖的模型做主力
- 不要同时切换多个模型,一个一个来
- 不要跳过
list验证直接switch
⚠常见误区
- 模型名大小写敏感,
Claude-Sonnet不等于claude-sonnet - 某些站点对同一个模型用不同名字(如加了站点前缀),导致
list看不到 - 远端 IP 级限流:本地能用不代表远端能用,在远端测试
- cooldown 后自动恢复不等于立即可用,有等待时间