核心用法
此技能为 OpenClaw 系统配置 SiliconFlow(硅基流动) 作为国内模型推理 provider。SiliconFlow 提供 98+ 个 chat 模型,采用标准 openai-completions 协议,配置流程包含:
1. Provider 注册:设置 baseUrl 为 https://api.siliconflow.cn/v1,使用 Bearer Token 认证
2. 模型定义:推荐配置 8 个精选模型,涵盖免费层(Qwen3-8B、DeepSeek-R1-8B)、性价比层(Qwen3-30B MoE、DeepSeek-V3.2)和旗舰层(DeepSeek-R1、Kimi-K2.5)
3. 别名配置:为每个模型设置易用别名(如 sf-qwen3-8b、sf-r1、sf-kimi)
4. Fallback 链接入:将免费/低价模型加入降级链,提升服务稳定性
5. 验证流程:通过 openclaw doctor 校验配置,gateway restart 生效
显著优点
- 成本优势突出:免费模型无限使用(Qwen3-8B、DeepSeek-R1-8B 等);付费模型价格为官方 30-50%,Qwen3-30B 仅 ¥0.7/百万 tokens
- 协议兼容性强:原生 OpenAI 协议,无需适配代码,即配即用
- 模型覆盖全面:一个 API Key 访问 Qwen、DeepSeek、Kimi、GLM、MiniMax 等全系列主流中文模型
- 配置流程标准化:提供完整 JSON patch 模板,含 cost、contextWindow、reasoning 等完整元数据
- 国内网络友好:服务部署于国内,延迟低、稳定性高,无需代理
潜在缺点与局限性
- 免费模型 QPS 受限:免费模型并发能力有限,不适合高吞吐生产场景
- Pro 版本溢价:带
Pro/前缀的模型速度更快但价格更高,需权衡性能成本 - 模型 ID 严格区分大小写:配置时必须精确匹配,易因大小写错误导致调用失败
- 余额管理需求:付费模型需预充值,余额耗尽会导致服务中断
- 供应商锁定风险:配置深度绑定 SiliconFlow 生态,迁移至其他 provider 需重新适配
适合人群
- 预算敏感的个人开发者/小团队:依赖免费模型或极低单价完成日常开发
- 需要中文模型优先的业务场景:Qwen、Kimi 等中文理解能力优于海外模型
- OpenClaw 系统管理员:需要快速扩展模型源、构建多 provider 降级体系
- 国内网络环境受限用户:无法稳定访问海外 API,需国产替代方案
常规风险
- API Key 泄露风险:
sk-xxx密钥需妥善保管,泄露可能导致余额被盗刷 - 配置错误导致服务崩溃:
agents.defaults.models.<id>字段若包含非alias属性会引发 Gateway 故障 - 免费服务政策变动风险:免费模型额度可能调整,生产环境建议配置付费模型作为 backup
- 供应商服务中断:需配置 fallback 至其他 provider(如 OpenRouter、官方 API)保障可用性