OpenClaw 可通过硅基流动（SiliconFlow）的 OpenAI 兼容接口接入其上百种大模型。以下将介绍两种核心配置方法，并提供进阶技巧与排错指南。

📝 准备工作：获取硅基流动 API Key

1. 注册与认证：访问硅基流动官网并注册，完成实名认证后可领取代金券或免费 Token。

2. 创建 API Key：在「API 密钥」页面新建一个 Key，格式为 sk-开头的字符串，请妥善保存。

⚙️ 核心配置：接入硅基流动

方案一：命令行配置 (推荐)

此方法通过 openclaw config命令完成，会自动校验并写入配置，适合新手。

1. 配置模型服务商 (Provider)

   执行以下命令，将 sk-xxxx替换为你的 API Key。

   bash

   openclaw 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"

   }

   ]

   }'

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"]'

3. 创建模型别名 (可选)

   为模型设置简短别名，方便后续切换使用。

   bash

   openclaw models aliases add qwen "siliconflow/Qwen/Qwen3-8B"

   openclaw models aliases add deepseek "siliconflow/Pro/deepseek-ai/DeepSeek-V3.2"

4. 重启并验证

   重启 OpenClaw 网关使配置生效，然后测试连接。

   bash

   openclaw gateway restart

   openclaw model test

   若输出 Model connection successful，则表示配置成功。

方案二：手动编辑配置文件

此方法直接修改 openclaw.json文件，适合需要精细控制的用户。

1. 找到配置文件

   • 本地部署: ~/.openclaw/openclaw.json

   • Docker 部署: 进入容器后，通常在 /app/config/openclaw.json。

2. 修改 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"

   }

   ]

   }

   }

   }

   }

3. 修改 agents.defaults

   指定默认使用的模型。

   json

   {

   "agents": {

   "defaults": {

   "model": {

   "primary": "siliconflow/Qwen/Qwen3-8B",

   "fallbacks": ["siliconflow/Pro/deepseek-ai/DeepSeek-V3.2"]

   }

   }

   }

   }

4. 重启并验证

   保存文件后，执行以下命令重启服务并测试。

   bash

   openclaw gateway restart

   openclaw 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测试连通性。