OpenClaw 本身不提供模型,要用硅基流动当大脑,走的是一条比想象中窄的路:在 ~/.openclaw/openclaw.json 里加一个 OpenAI 兼容的 provider,baseUrl 填 https://api.siliconflow.cn/v1,再把模型 id 挂到 agents.defaults.model 上。全程不用装额外插件,五分钟能配完。配置写法、当前价格、报错排查放在一起,顺带把官方两份文档互相矛盾的两处讲清楚。 硅基流动和OpenClaw是什么关系
先分清两个东西。OpenClaw 是一个自托管的网关(Gateway),官网写法是"a self-hosted gateway that connects your favorite chat apps to AI coding agents",MIT 协议,跑在你自己机器或服务器上,一个进程接上 Telegram、Discord、Slack、飞书等一堆聊天入口。它自己没有模型。 硅基流动是模型供给方,官方说法是"1 个 API,100+ 主流模型轻松调用",一个 Key 能调到 DeepSeek、GLM、Qwen、Kimi 等厂家的对话、生图、语音、视频模型。 所以"部署"这个词容易让人误会。不必在硅基流动的服务器上装 OpenClaw,也不是把模型下载下来本地跑。真实链路是OpenClaw 跑在你自己的机器上,推理请求发到硅基流动的 API:硅基流动出模型,OpenClaw 出聊天入口、会话、工具调用和定时任务。
OpenClaw 官方 provider 目录列了七十多家供应商,没有 SiliconFlow。接入只能走"自定义 provider + OpenAI 兼容",没有内置选项可以点一下了事。
接入前要准备的三样东西
硅基流动文档把前置条件列成三条,备齐了基本不会卡在第一步:
- API Key:以 sk- 开头的字符串。登录后进「API 密钥」页新建,注意 Key 只在创建时完整显示一次,关掉页面就找不回来了,只能删掉重建。
- Base URL:https://api.siliconflow.cn/v1。末尾的 /v1 必须带上,官方文档专门用加粗标了这一点,漏掉是最常见的 404 来源。
- 模型名称(model id):去模型广场复制完整名称,形如 deepseek-ai/DeepSeek-V3.2、zai-org/GLM-5.3。注意要连厂商前缀一起复制,只写 GLM-5.3 会报模型不存在。
海外网络环境可以换国际站端点 https://api.siliconflow.com/v1,两者 Key 不通用,注册的站不同就得用对应的域名。
openclaw.json怎么配硅基流动模型
配置文件固定在 ~/.openclaw/openclaw.json,Windows 下是 C:\Users\你的用户名\.openclaw\openclaw.json。用编辑器打开,把下面这段合并进去(如果已有 models.providers,从 siliconflow 这一层开始加,别把原来的覆盖掉):
字段里有几个地方容易填错:
- api: "openai-completions" 不能省。硅基流动对外提供的是 OpenAI 兼容接口,这个字段告诉 OpenClaw 用哪套协议去说话。硅基流动官方文档里也写了同一个值。
- models[].id 必须与硅基流动模型广场的完整 id 一字不差,包括大小写和斜杠。
- agents.defaults.model.primary 的写法是「provider 名 + 斜杠 + 模型 id」,即 siliconflow/deepseek-ai/DeepSeek-V3.2。这里有两层斜杠,不是笔误。
- input: ["text"] 表示纯文本模型。要用 GLM-4.5V 这类支持图片的模型,改成 ["text","image"],否则聊天窗口发图会被当成纯文本附件处理。
- contextWindow 和 maxTokens 建议按模型的真实参数填,填大了容易在上游被截断或报超长。
配好之后跑一条命令验证:
能看到 siliconflow/... 开头的条目就算通了。临时换模型不用改文件,在 Web 控制台或已接入的聊天软件里输入 /model siliconflow/zai-org/GLM-5.3 即可。
官方两份文档写法不一致,按哪个来
硅基流动目前有两份和 OpenClaw 相关的材料:一份是文档站的接入指引(更新于 2026 年 2 月 12 日),一份是社区教程《"龙虾"养成记》(2026 年 3 月 4 日)。两份在配置键名上并不一致:
| | | |
|---|
| | | 前者。OpenClaw 官方文档明确用 models.providers |
| | | 一致,官方实际结构为 agents.defaults.model.primary |
| | | 官方要求 Node 24.22.1+ 或 26.12.1+,建议装 24 以上的 LTS |
键名这条不是小事。写错顶层键不会报语法错误,OpenClaw 启动一切正常,只是那个 provider 根本不生效,最后表现为模型列表里查不到、对话一直失败。对照 OpenClaw 官方"Custom providers"文档,正确的容器就是 models.providers.<id>,社区教程里的 modelProviders 属于早期版本遗留写法。
Node 版本这条更值得留意。教程里写的 22.0 是 2026 年 3 月当时的要求,而 OpenClaw 官网现在写明推荐 Node 26,可选 24.22.1+ 或 26.12.1+。按教程装 Node 22 大概率会卡在安装或启动阶段,直接装当前 LTS 更省事。
OpenClaw装好后接硅基流动的完整顺序
先把 OpenClaw 装起来,再回头配模型,顺序别反。官方推荐的安装方式是一条脚本:
也可以用 npm:npm install -g openclaw@latest,国内网络慢的话加 --registry=https://registry.npmmirror.com。装完 openclaw -v 看版本号确认成功。
接着跑初始化向导:
向导会依次问安全提示确认、快速开始还是自定义、要不要保留已有配置、选哪个模型供应商、接哪个聊天渠道。在"模型服务选择"这一步建议直接跳过,因为内置列表里没有硅基流动,与其在这里纠结不如跳过,初始化结束后再手改 json 文件。同理,API Key 和默认模型那两步也可以留空。
跳过模型不等于跳过渠道。OpenClaw 的价值就在于能从飞书、Telegram 里直接发消息给它,这一步选好渠道再填 App ID / App Secret(飞书要在飞书开放平台建自建应用拿)。国内选飞书顺,海外 Telegram 配得最快。
初始化结束后装后台服务,让它开机自启:
dashboard 会在浏览器打开控制台,默认地址是 http://127.0.0.1:18789/。到这里再去改前文的 json,保存后重启网关,模型就挂上了。
部署OpenClaw的注意事项
- 权限比想象中大:OpenClaw 能读文件、执行命令、操作浏览器。硅基流动在官方教程开头就提醒"运行时操作权限极大,建议在隔离环境中运行"。个人电脑上跑可以接受,公司内网或存有敏感数据的机器上跑,先想清楚它能看到什么。
- Key 只显示一次:硅基流动的 API Key 创建后不再完整展示,丢了只能删除重建。项目里用建议写进环境变量或在密钥管理里存一份,别直接贴在聊天记录里。
- 余额为零会直接报错:硅基流动是预付费,账户余额扣完请求会被拒,报错信息指向额度而非配置。排查半天配置之前,先去控制台看一眼余额。
- 别把 openclaw.json 提交到代码仓库:文件里明文存着 Key,要版本管理就用 ${SILICONFLOW_API_KEY} 这类环境变量占位。
- 上下文别填虚高:contextWindow 填得比模型实际支持的还大,短对话看不出问题,一旦历史变长就会被上游截断,表现为回答突然变敷衍或报长度错误。
硅基流动模型价格一览
下面是 2026 年 11 月从硅基流动价格页实抓的口径,单位统一为「元 / 百万 Tokens」。OpenClaw 这类长会话场景输出量大,选模型时不要只看输入价。
| | | | |
|---|
deepseek-ai/DeepSeek-V4.1-Flash | | | | |
deepseek-ai/DeepSeek-V3.2 | | | | |
deepseek-ai/DeepSeek-V4-Pro | | | | |
| | | | |
| | | | |
moonshotai/Kimi-K2.7-Code | | | | |
| | | | |
分时计价在硅基流动是个实在的省钱点。DeepSeek-V4.1-Flash 在 2 点到 8 点这段时间,输入从 2 元降到 1 元、输出从 8 元降到 4 元,等于对折。整夜跑批量任务的,把定时任务排到凌晨能省一半。
缓存对 OpenClaw 这种场景影响更大。OpenClaw 每轮对话都要重发系统提示词、技能描述和历史上下文,这部分高度重复。价格表里缓存命中价大约是未命中的十分之一(V3.2 是 0.40 对 4.00),硅基流动官方也提到多款高速版模型缓存命中率平均在 80% 左右,实际输入成本相当于打了三折。这也解释了为什么 cost 字段别乱填——它影响 OpenClaw 自己算不算得清账。
表格是 11 月初的抓取值,模型上下架和调价都挺频繁,真要下单前在模型广场再看一眼。
硅基流动接入OpenClaw的常见报错
硅基流动的 API 错误不用 HTTP 状态码体系,而是返回一个 JSON 体,字段是 code / message / data。拿一个不存在的 Key 直接请求,返回的是:
实际排查时对应的几种情况:
| | |
|---|
| Key 复制漏字符、被空格污染,或用了国际站的 Key 请求国内站端点 | |
| baseUrl 少了末尾 /v1,或写成了 api.siliconflow.com 却用国内 Key | 补全为 https://api.siliconflow.cn/v1 |
| | |
openclaw models list 里没有 siliconflow | 顶层键写成了 modelProviders,或 JSON 有语法错误 | 改成 models.providers,用 openclaw doctor 校验配置 |
| | |
| contextWindow 填得比模型真实上下文大,历史被截断 | |
| | 升级到 Node 24.22.1+ 或 26.12.1+ |
快速自检可以用一条 curl,能通说明 Key 和网络没问题,问题就在 openclaw.json 里:
硅基流动部署OpenClaw常见问题
Q:一定要部署在硅基流动的服务器上吗?
A:不用。OpenClaw 跑在你自己机器或云主机上,硅基流动只提供模型推理,数据流是单向的 API 调用。
Q:能白嫖吗,免费额度多少?
A:模型广场里有几款免费模型(如 bge 系列向量模型、部分小参数对话模型)可以零成本跑通链路。注册赠送的代金券金额会调整,以控制台当期展示为准。
Q:为什么 OpenClaw 里找不到 SiliconFlow 选项?
A:官方 provider 目录里确实没有这一项,只能走自定义 OpenAI 兼容 provider,这不是你的安装出了问题。
Q:一个 Key 能不能同时给 Claude Code 和其他工具用?
A:可以。同一个 Key 支持多个应用,只是接口协议不同——Claude Code 走 Anthropic Messages 格式,OpenClaw 走 OpenAI Completions 格式,配置里填对 api 字段就行。 Q:支持图片输入吗?
A:支持,但要选多模态模型(如 GLM-4.5V),并且在 models[] 里把 input 写成 ["text","image"],否则附件会按纯文本处理。
Q:模型 id 里的 Pro/ 前缀是什么?
A:Pro/ 是硅基流动单独列出的一档模型通道,价格和限量政策与普通版不一定相同,以模型广场标注为准。填 id 时连前缀一起复制,别自己删。
Q:跑起来 Token 掉得很快怎么办?
A:先确认缓存有没有命中(重复的系统提示词应该走 0.1 倍档),再把定时任务挪到凌晨 2 点到 8 点的折扣时段,最后考虑换 Flash 类小模型承担日常对话。
Q:能接飞书以外的渠道吗?
A:可以。OpenClaw 支持 Telegram、Discord、Slack、Signal、WhatsApp、iMessage 等,飞书在国内最顺,Telegram 配置最快。
Q:把 Key 写进 openclaw.json 安全吗?
A:文件在本机还算可控,但这个文件一旦进了 Git 就等于泄露。团队协作统一用环境变量占位。
模型这一端被硅基流动压得很轻:一个 Key、一个兼容端点。剩下的复杂度全在 OpenClaw 的配置文件里,键名、provider 前缀、上下文参数,任何一处写偏都不报错,只是安静地不生效。先按 models.providers 的结构把链路跑通,再回头调模型和渠道,比照着两份写法打架的教程反复试要省事。硅基流动部署 OpenClaw的难点从来不在模型本身,在于别被过时的版本号和键名带偏。