OpenClaw 接入 SiliconFlow 模型

很多人听到“联通某个模型/平台”会觉得很玄乎,其实原理很简单:

硅基流动(SiliconFlow)提供 OpenAI 兼容的 API;而 OpenClaw 支持把任何 OpenAI-compatible 接口接进来,当作一个“模型提供方(provider)”使用。

OpenClaw 与 SiliconFlow 联通架构示意

你需要准备什么?(3 件事)

  1. 一个 SiliconFlow API Key(在硅基流动控制台创建)
  2. OpenAI 兼容的 Base URLhttps://api.siliconflow.cn/v1
  3. 一个模型 ID(从硅基流动模型列表里复制,比如 Kimi / Qwen / DeepSeek 等)

核心配置:把 SiliconFlow 挂到 OpenClaw(已更正)

更正说明:此前我给的示例缺了鉴权字段,按你实际验证的写法,需要补上 auth: "api-key"

下面是一段可用的示例(把 apiKey 换成你自己的 key;示例里用 sk-... 作为占位):

models: {
  providers: {
    siliconflow: {
      baseUrl: "https://api.siliconflow.cn/v1",
      apiKey: "sk-...",
      auth: "api-key",
      api: "openai-completions",
      models: [
        {
          id: "Pro/moonshotai/Kimi-K2.5",
          name: "Kimi K2.5",
          reasoning: false,
          input: ["text"],
          cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
          contextWindow: 256000,
          maxTokens: 8192
        }
      ]
    }
  }
}

如何验证是否联通成功?

  • 配置生效后,发起一次普通对话请求。
  • 如果返回正常结果,说明已联通;如果报错,按下面“排错”检查即可。

常见排错

  • Base URL 是否带 /v1:必须是 https://api.siliconflow.cn/v1
  • auth 字段:确保是 "api-key"(否则可能出现鉴权失败)
  • 模型 ID 是否完全一致:大小写、斜杠前缀要和控制台一致
  • 401/403:通常是 API Key 无效、额度不足、或权限/白名单限制
  • 429:触发限流了,降低并发/重试,或升级套餐

如果你也在折腾“模型 + 工具链”的自动化,这类接入方式是最省心的:选一个 OpenAI 兼容接口,工具侧基本就能无痛迁移。

Categorized in:

个人日志,

Last Update: 7 2 月, 2026