**OpenClaw**（开源AI助手框架）与**硅基流动**（国内AI模型推理平台）结合

要将OpenClaw （开源AI助手框架）与硅基流动 （国内AI模型推理平台）结合使用，核心是通过API配置 将硅基流动的模型接入OpenClaw，实现智能对话、自动化工作流等功能。以下是完整、分步的实操指南 ，覆盖准备工作 、两种配置方式 （新手/进阶）、验证方法 及常见问题解决，确保你能快速完成集成。

一、前置准备：获取硅基流动API密钥

要使用硅基流动的模型，首先需要从平台获取API密钥 （sk-开头），这是OpenClaw连接硅基流动的身份凭证。
步骤：

1. 注册/登录硅基流动：访问硅基流动官网（https://cloud.siliconflow.cn/），用手机号或邮箱注册账号。
2. 实名认证：登录后进入「控制台」→「API密钥」，完成实名认证（需上传身份证或扫脸），否则无法获取免费额度（新用户送16元代金券+2000万免费Tokens）。
3. 创建API密钥 ：点击「新建API密钥」，给密钥命名（如"openclaw"），复制生成的sk-xxxxxxxx格式的密钥（仅显示一次，务必保存）。
4. 确认API端点 ：硅基流动的标准API地址为https://api.siliconflow.cn/v1（所有模型均兼容此端点）。

二、配置OpenClaw连接硅基流动

OpenClaw支持两种配置方式 ：交互式向导 （适合新手，无需手动编辑文件）和手动编辑配置文件（适合进阶用户，需自定义复杂设置）。以下是两种方式的详细步骤：

方式A：交互式配置向导（推荐新手）

OpenClaw自带配置向导 ，可自动处理base_url、apiKey等参数，避免JSON语法错误，适合初次配置的用户。
步骤：

1. 启动配置向导 ：打开终端（Windows用PowerShell，Mac/Linux用Terminal），运行以下命令：

   openclaw configure

   或仅配置模型部分：

   openclaw configure --section model

2. 跟随向导操作 ：

   • 选择**Model（模型）**配置项；
   • 选择custom-api作为提供商类型（硅基流动兼容OpenAI接口，属于"自定义API"）；
   • 输入硅基流动API密钥 （sk-开头）；
   • 输入base_url ：https://api.siliconflow.cn/v1；
   • 选择要使用的模型 （如DeepSeek-V3.2、Qwen2.5-72B，可在硅基流动「模型广场」查看所有可用模型）；
   • 确认保存，向导会自动将配置写入OpenClaw的配置文件（无需手动修改文件）。

优点：

• 无需手动编辑文件，避免JSON语法错误；
• 自动设置正确的配置文件路径；
• 适合初次配置的用户，操作简单。

方式B：手动编辑配置文件（适合进阶用户）

如果你需要自定义复杂配置 （如同时配置多个模型、调整上下文窗口），可直接编辑OpenClaw的配置文件。
步骤：

1. 找到配置文件 ：OpenClaw的主配置文件位于~/.openclaw/agents/main/agent/models.json（~表示用户目录，如Windows的C:\Users\你的用户名\.openclaw\agents\main\agent\models.json）。

2. 备份原文件（可选但建议）：

   cp ~/.openclaw/agents/main/agent/models.json ~/backup/

3. 编辑配置文件 ：用文本编辑器（如VS Code、Notepad++）打开models.json，添加或修改硅基流动的配置：

   {
     "providers": {
       "custom-api-siliconflow-cn": {  // 自定义提供商名称（可任意命名）
         "baseUrl": "https://api.siliconflow.cn/v1",  // 硅基流动API端点
         "apiKey": "你的API密钥",  // 替换为你的硅基流动API密钥（sk-开头）
         "api": "openai-completions",  // 硅基流动兼容OpenAI接口，固定值
         "models": [  // 要使用的模型列表
           {
             "id": "Pro/deepseek-ai/DeepSeek-V3.2",  // 模型ID（从硅基流动复制）
             "name": "硅基流动-DeepSeek-V3.2",  // 模型名称（自定义，便于识别）
             "reasoning": false,  // 是否启用推理功能（根据模型支持情况设置）
             "input": ["text"],  // 输入类型（固定为text）
             "contextWindow": 16000,  // 上下文窗口大小（根据模型调整，如DeepSeek-V3.2为128000）
             "maxTokens": 4096  // 最大输出 tokens（根据模型调整）
           }
         ]
       }
     }
   }

   注意：

   • id必须与硅基流动「模型广场」中的模型ID完全一致（如Pro/deepseek-ai/DeepSeek-V3.2）；
   • baseUrl和api字段固定，不要修改；
   • contextWindow和maxTokens可根据模型文档调整（如Qwen2.5-72B的上下文窗口为32768）。

4. 保存文件 ：修改后保存models.json。

5. 重启OpenClaw服务：使配置生效：

   openclaw gateway restart

适合场景：

• 需要自定义复杂配置（如多个模型、调整上下文窗口）；
• 同时配置多个提供商（如硅基流动+阿里百炼）；
• 在多个环境间同步配置（如开发环境→生产环境）。

三、验证配置是否成功

配置完成后，需验证OpenClaw是否能正常连接硅基流动的模型。
方法1：查看当前模型 ：

运行以下命令，查看OpenClaw已配置的模型：

openclaw models list

如果配置成功，会显示硅基流动的模型（如"硅基流动-DeepSeek-V3.2"），状态为"Active"。

方法2：实际对话测试 ：

通过OpenClaw的聊天界面（如Telegram Bot、Web UI）发送一条消息（如"你好，请介绍一下自己"），如果能收到模型的回复，说明配置生效。

四、常见问题及解决方法

在配置过程中，可能会遇到以下问题，以下是快速解决思路：

1. 对话返回"403 Forbidden"

• 原因：API密钥无效（如未实名认证、密钥复制错误）或余额不足（免费额度用完）。
• 解决方法 ：
  • 检查硅基流动API密钥是否正确（重新复制sk-开头的密钥）；
  • 登录硅基流动控制台，确认实名认证已完成（未实名无法使用免费额度）；
  • 查看硅基流动余额（https://cloud.siliconflow.cn/balance），如果余额为0，需充值或领取更多免费额度。

2. 显示"Unknown model"（未知模型）

• 原因：模型ID错误（与硅基流动「模型广场」中的ID不一致）。
• 解决方法 ：
  • 登录硅基流动控制台，进入「模型广场」，复制要使用的模型的完整ID （如Pro/deepseek-ai/DeepSeek-V3.2）；
  • 修改OpenClaw配置文件中的models[0].id字段，确保与硅基流动的模型ID一致。

3. 配置后无法连接（超时或无法访问）

• 原因：网络问题（如硅基流动API端点被墙，或本地网络限制）。
• 解决方法 ：
  • 检查本地网络是否能访问https://api.siliconflow.cn/v1（可通过浏览器访问该地址，查看是否能打开）；
  • 如果使用代理，确保代理设置正确（如终端代理或系统代理）；
  • 尝试更换网络（如手机热点），排除本地网络限制。

4. 交互式向导无法找到"custom-api"选项

• 原因：OpenClaw版本过旧（不支持"custom-api"提供商类型）。
• 解决方法 ：
  • 升级OpenClaw到最新版本：npm update -g openclaw@latest；
  • 或使用手动编辑配置文件的方式（方式B）。

五、高级技巧（可选）

如果你想进一步优化配置，可尝试以下高级技巧：

1. 使用环境变量存储API密钥

为了避免API密钥泄露（如配置文件被他人访问），可使用环境变量存储密钥：

• 设置环境变量 ：

  • Windows（PowerShell）：$env:SILICONFLOW_API_KEY="你的API密钥"；
  • Mac/Linux（Terminal）：export SILICONFLOW_API_KEY="你的API密钥"。

• 在配置文件中引用环境变量 ：
  修改models.json中的apiKey字段为：

  "apiKey": "${SILICONFLOW_API_KEY}"

  这样，OpenClaw会从环境变量中读取API密钥，无需在配置文件中明文存储。

2. 备份配置文件

定期备份models.json文件，避免配置丢失：

cp ~/.openclaw/agents/main/agent/models.json ~/backup/models-$(date +%Y%m%d).json

其中$(date +%Y%m%d)会自动生成当前日期（如20260325），方便区分不同时间的备份。

3. 配置多个模型

如果需要同时使用多个硅基流动模型（如DeepSeek-V3.2+Qwen2.5-72B），可在models数组中添加多个模型定义：

"models": [
  {
    "id": "Pro/deepseek-ai/DeepSeek-V3.2",
    "name": "硅基流动-DeepSeek-V3.2",
    "reasoning": false,
    "input": ["text"],
    "contextWindow": 128000,
    "maxTokens": 8192
  },
  {
    "id": "qwen/qwen2.5-72b-instruct",
    "name": "硅基流动-Qwen2.5-72B",
    "reasoning": false,
    "input": ["text"],
    "contextWindow": 32768,
    "maxTokens": 4096
  }
]

配置后，可通过openclaw models switch命令切换模型（如openclaw models switch siliconflow-qwen2.5-72b）。

六、总结：核心步骤回顾

1. 获取硅基流动API密钥：注册→实名认证→创建密钥；
2. 选择配置方式 ：
   • 新手：用openclaw configure交互式向导；
   • 进阶：手动编辑models.json配置文件；
3. 验证配置 ：用openclaw models list查看模型，或用对话测试；
4. 解决问题：根据常见错误（如403、Unknown model）调整配置。

通过以上步骤，你可以快速将硅基流动的模型接入OpenClaw，实现智能对话、自动化工作流、多平台集成（如Telegram、WhatsApp）等功能。相比直接使用硅基流动的API，OpenClaw提供了更友好的界面和更丰富的功能（如持久记忆、多渠道交互），适合个人用户或小型团队使用。

如果需要更高级的功能（如团队协作、自定义技能），可参考OpenClaw的官方文档（https://docs.openclaw.ai/）或硅基流动的API文档（https://cloud.siliconflow.cn/docs）。