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 后自动恢复不等于立即可用,有等待时间