OpenCode Free Models v2.0

自动配置 opencode.ai Zen 免费模型到 OpenClaw。

触发词

• "配置 opencode 免费模型"
• "添加 opencode 模型"
• "opencode 免费"
• "free model"

架构

1. 网络层 — 重试 3 次，Cloudflare 拦截自动退避（2s/4s/6s）
2. 模型缓存 — ~/.openclaw/.opencode-free-cache.json，6 小时 TTL
3. 健康探测 — 逐模型调 /chat/completions 真实验证
4. 配置管理 — diff 检测跳过无变化写盘
5. Fallback 管理 — 自动替换失效模型，支持恢复已恢复的模型

CLI 命令

# 自动配置（探测 + 添加 provider + 更新 fallback）
opencode-free auto [--force] [--test] [--count N]

# 列出免费模型
opencode-free list [--refresh]

# 查看当前配置状态
opencode-free status

# 实时健康探测所有模型
opencode-free test [--refresh]

# 旋转 fallback 链（移除失效，--restore 恢复已恢复的）
opencode-free rotate [--restore]

# 强制刷新模型缓存
opencode-free refresh

# 更新 fallback 链（自定义数量）
opencode-free fallbacks [--test] [--count N] [--refresh]

标准流程

# 1. 自动配置（探测 + 添加 + fallback）
python scripts/configure-models.py auto --yes --test

# 2. 重启 Gateway
openclaw gateway restart

注意事项

• 无需 API Key：opencode.ai Zen 免费模型使用 public 凭据
• 端点：https://opencode.ai/zen/v1
• GBK 安全：所有日志输出用 ASCII 标记，无 emoji
• 幂等：多次运行不重复添加，配置无变化不写盘
• 环境变量：OPENCODE_API_KEY（默认 public）、OPENCODE_PROVIDER_KEY（默认 opencode-free）