一文教你openclaw快速对接硅基流动的大模型

OpenClaw 可通过硅基流动SiliconFlow的 OpenAI 兼容接口接入其上百种大模型。以下将介绍两种核心配置方法并提供进阶技巧与排错指南。 准备工作获取硅基流动 API Key注册与认证访问硅基流动官网并注册完成实名认证后可领取代金券或免费 Token。创建 API Key在「API 密钥」页面新建一个 Key格式为sk-开头的字符串请妥善保存。⚙️ 核心配置接入硅基流动方案一命令行配置 (推荐)此方法通过openclaw config命令完成会自动校验并写入配置适合新手。配置模型服务商 (Provider)执行以下命令将sk-xxxx替换为你的 API Key。bashopenclaw config set models.providers.siliconflow --json {baseUrl: https://api.siliconflow.cn/v1,apiKey: sk-xxxx,api: openai-completions,models: [{id: Qwen/Qwen3-8B,name: 通义千问 3 8B},{id: Pro/deepseek-ai/DeepSeek-V3.2,name: DeepSeek-V3.2}]}设置默认模型配置主用模型和备用模型fallback当主模型不可用时将自动切换。bash设置主模型openclaw config set agents.defaults.model.primary siliconflow/Qwen/Qwen3-8B设置备用模型openclaw config set agents.defaults.model.fallbacks [siliconflow/Pro/deepseek-ai/DeepSeek-V3.2]创建模型别名 (可选)为模型设置简短别名方便后续切换使用。bashopenclaw models aliases add qwen siliconflow/Qwen/Qwen3-8Bopenclaw models aliases add deepseek siliconflow/Pro/deepseek-ai/DeepSeek-V3.2重启并验证重启 OpenClaw 网关使配置生效然后测试连接。bashopenclaw gateway restartopenclaw model test若输出Model connection successful则表示配置成功。方案二手动编辑配置文件此方法直接修改openclaw.json文件适合需要精细控制的用户。找到配置文件本地部署:~/.openclaw/openclaw.jsonDocker 部署: 进入容器后通常在/app/config/openclaw.json。修改models.providers在文件中添加siliconflow配置块。json{models: {providers: {siliconflow: {baseUrl: https://api.siliconflow.cn/v1,apiKey: sk-xxxx,api: openai-completions,models: [{id: Qwen/Qwen3-8B,name: 通义千问 3 8B},{id: Pro/deepseek-ai/DeepSeek-V3.2,name: DeepSeek-V3.2}]}}}}修改agents.defaults指定默认使用的模型。json{agents: {defaults: {model: {primary: siliconflow/Qwen/Qwen3-8B,fallbacks: [siliconflow/Pro/deepseek-ai/DeepSeek-V3.2]}}}}重启并验证保存文件后执行以下命令重启服务并测试。bashopenclaw gateway restartopenclaw model test 进阶技巧使用模型别名在对话中使用/model 别名可快速切换模型如/model qwen。别名通过openclaw models aliases add命令设置。在 Web 控制台配置部分部署方式提供 Web 控制台可在「模型管理」中直接填写硅基流动的provider、base_url、api_key和model.id等信息保存后重启即可。 常见问题排查401 Unauthorized: API Key 错误或为空。请检查apiKey的值是否为完整的sk-字符串且无多余空格。404 Not Found:baseUrl或model.id错误。请确保baseUrl为https://api.siliconflow.cn/v1且model.id与硅基流动模型广场中的完全一致注意大小写和Pro/前缀。429 Too Many Requests: 请求频率超限或账户余额不足。请检查硅基流动的账户余额和限流策略。连接超时/网络错误: 服务器网络不通。请检查服务器的出站网络策略或尝试ping api.siliconflow.cn测试连通性。