硅基流动（SiliconFlow）新手完全指南

面向零基础用户，从注册到配置 OpenClaw 的全流程教程。

一、硅基流动是什么？

硅基流动（SiliconFlow） 是国内领先的 AI 大模型云服务平台，提供一站式大模型 API 服务。

核心优势

  • 模型丰富：DeepSeek-R1、DeepSeek-V3、Qwen2.5、GLM-4 等主流开源模型全覆盖
  • 多模态支持：语言、语音、图片、视频模型一应俱全
  • 兼容 OpenAI 接口：所有语言模型均可通过 OpenAI SDK 直接调用，只需替换 base_url
  • 按量计费：用多少付多少，无需包年包月，部分小模型（如 Qwen2.5-7B）完全免费
  • 高速推理：自研推理加速引擎，语言模型速度提升 10x+，语音生成延迟低至 100ms
  • 高性价比：语言模型成本降低约 46%，生图模型降低约 66%
  • 国产算力支持：基于华为云昇腾云服务部署 DeepSeek 等模型，效果持平高端 GPU

一句话总结：一个 API Key 调用国内主流大模型，完美兼容 OpenAI 生态。

平台提供的主要模型类型

类型代表模型说明
语言模型DeepSeek-R1、DeepSeek-V3、Qwen2.5-72B、GLM-4对话、写作、代码、推理
语音模型CosyVoice2-0.5B语音合成
图片模型Kolors、FLUX、SD3 MediumAI 绘图、图生图
视频模型HunyuanVideo-HD、Wan2.1视频生成
向量/重排序BGE、BCERAG、语义搜索

二、🎁 新人福利活动

注册送 18 元

新用户注册硅基流动账号，即可获得 18 元 余额奖励。该余额可直接用于 API 调用消费，相当于免费体验额度。

推荐人送 16 元

通过推荐链接注册的新用户，推荐人可获得 16 元 奖励。你注册用推荐链接，推荐人拿奖励，你不吃亏。

⚠️ 活动金额和规则可能随平台政策调整，请以注册时页面显示为准。

👇 使用推荐链接注册，双赢 👇

推荐链接： https://cloud.siliconflow.cn/i/Ns9UTFJO

三、注册与获取 API Key

Step 1：注册账号

  1. 打开推荐链接：https://cloud.siliconflow.cn/i/Ns9UTFJO
  2. 也可以直接访问官网 https://siliconflow.cn，点击右上角**「登录」**按钮
  3. 进入注册/登录页面后，选择以下任一方式注册：
    • 📱 手机号登录：输入 +86 手机号 → 获取短信验证码 → 输入验证码
    • 📧 邮箱登录：输入邮箱 → 获取验证码 → 输入验证码
    • 🔗 GitHub 登录：点击 GitHub 图标跳转授权
    • 🔗 Google 登录：点击 Google 图标跳转授权
    • 💬 微信登录：扫码登录
  4. 勾选同意「用户协议」和「隐私政策」
  5. 点击**「注册/登录」**，完成账号创建

Step 2：实名认证（如需）

  • 部分功能（如充值）可能需要实名认证
  • 按平台提示上传身份证信息即可
  • 如果只是免费体验小模型，可能不需要实名

Step 3：获取 API Key

  1. 注册成功后，进入控制台首页：https://cloud.siliconflow.cn
  2. 点击左侧菜单栏的 「API 密钥」，或者直接访问：https://cloud.siliconflow.cn/account/ak
  3. 点击页面上的 「新建 API 密钥」 按钮
  4. 系统会生成一串以 sk- 开头的密钥
  5. ⚠️ 立即复制并妥善保存！密钥只显示一次，关闭后无法再查看！
  6. 建议保存到密码管理器或安全笔记中

🔒 安全提醒：API Key 等同于你的账户密码，拥有 Key 的人可以消费你账户的余额。绝对不要泄露给任何人，不要提交到 Git 仓库，不要写在公开代码里！

Step 4：查看和选择模型

  1. 进入 模型广场，浏览所有可用模型
  2. 每个模型会显示：模型名称、模型 ID、价格、速率限制等
  3. 点击模型可查看详情，部分模型可在「在线体验」中试用
  4. 复制你想要使用的模型的「模型 ID」（如 Pro/zai-org/GLM-4.7、deepseek-ai/DeepSeek-V3），后续配置需要

Step 5：验证 API 可用性

在终端中运行以下命令（将 YOUR_API_KEY 替换为你的实际密钥）：

curl https://api.siliconflow.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen/Qwen2.5-7B-Instruct",
    "messages": [{"role": "user", "content": "你好"}]
  }'

返回正常的 JSON 响应（包含 choices 字段）即表示 API Key 配置成功 ✅

四、在 OpenClaw 中配置硅基流动

以下提供三种配置方式，选择最适合你的一种即可。

方法一：交互式命令配置（推荐 ✅）

最简单的方式，跟着引导走就行。

  1. 打开终端（Windows 用 PowerShell / CMD，macOS 用 Terminal）
  2. 运行配置命令：
openclaw config
  1. 按照交互式引导逐步填写：
    • 选择/添加 Provider：选择添加新的 provider
    • 填写 Base URL：输入 https://api.siliconflow.cn/v1
    • 填写 API Key：粘贴你从硅基流动获取的 sk- 开头密钥
    • 填写 Model ID：从硅基流动模型广场复制的模型 ID（如 Pro/zai-org/GLM-4.7）
  2. 回车继续，系统会自动验证连接是否正常
  3. 验证通过后配置即生效

方法二：编辑配置文件（进阶用户）

适合需要一次配置多个模型、或者批量部署的场景。

找到配置文件

OpenClaw 的配置文件为 openclaw.json，位于 .openclaw 目录下：

  • Windows：C:\Users\<你的用户名>\.openclaw\openclaw.json
  • macOS / Linux：~/.openclaw/openclaw.json
  • 找不到就在文件管理器中全盘搜索 openclaw.json

⚠️ 修改前务必备份！ 复制一份 openclaw.json.bak 以防万一。

添加 Provider

用文本编辑器打开 openclaw.json，找到 models → providers 节点，在其中添加 siliconflow：

"models": {
  "providers": {
    "siliconflow": {
      "baseUrl": "https://api.siliconflow.cn/v1",
      "apiKey": "sk-替换为你的硅基流动API密钥",
      "api": "openai-completions",
      "models": [
        {
          "id": "Pro/zai-org/GLM-4.7",
          "name": "Silicon GLM 4.7",
          "contextWindow": 128000,
          "maxTokens": 8192
        },
        {
          "id": "deepseek-ai/DeepSeek-V3",
          "name": "DeepSeek V3",
          "contextWindow": 64000,
          "maxTokens": 4096
        }
      ]
    }
  }
}

字段说明：

字段说明
baseUrl硅基流动 API 地址，固定为 https://api.siliconflow.cn/v1
apiKey你的硅基流动 API 密钥
apiAPI 协议类型，填 openai-completions
models可用模型列表，可添加多个
id模型 ID，从硅基流动模型广场复制
name显示名称，自定义即可
contextWindow上下文窗口大小（token 数），参考模型文档
maxTokens单次输出最大 token 数，参考模型文档

常用模型参数参考：

模型 IDcontextWindowmaxTokens说明
Pro/zai-org/GLM-4.71280008192智谱 GLM 最新模型
deepseek-ai/DeepSeek-V3640004096DeepSeek 通用模型
Pro/deepseek-ai/DeepSeek-R1640008192DeepSeek 推理模型
Qwen/Qwen2.5-72B-Instruct327688192阿里通义旗舰模型
Qwen/Qwen2.5-7B-Instruct327688192免费，适合测试

以上参数仅供参考，请以硅基流动模型广场实际标注为准。

配置 Agent 默认模型

在同一个 openclaw.json 中，找到 agents → defaults 节点，设置默认模型和别名：

"agents": {
  "defaults": {
    "model": {
      "primary": "siliconflow/Pro/zai-org/GLM-4.7"
    },
    "models": {
      "siliconflow/Pro/zai-org/GLM-4.7": {
        "alias": "glm"
      },
      "siliconflow/deepseek-ai/DeepSeek-V3": {
        "alias": "deepseek"
      },
      "siliconflow/Pro/deepseek-ai/DeepSeek-R1": {
        "alias": "r1"
      }
    }
  }
}

关键规则：

  • primary 的值格式为 siliconflow/ + 模型 ID（siliconflow 是你在 providers 中配置的名字）
  • alias 是模型的简写别名，方便切换使用
  • 要添加更多模型，在 models 下继续增加条目即可
保存配置并使其生效
  1. 保存 openclaw.json 文件
  2. 执行以下操作确保配置生效：
操作目的命令说明
重启 Gateway 服务Windows：先 openclaw gateway stop，再 schtasks /Run /TN "openclaw Gateway"让配置文件重新加载
macOS/Linux：openclaw gateway restart
测试模型连接openclaw agent --agent main --message "你好"正常回复说明配置成功
修复环境问题openclaw doctor --fix自动检测并修复常见问题
查看运行日志openclaw logs --follow排查问题时查看实时日志

方法三：Web UI 配置

适合不喜欢命令行的用户。

  1. 打开终端，运行：
openclaw dashboard
  1. 浏览器会自动打开 OpenClaw 的 Web 管理界面
  2. 在界面中找到 Provider / 模型配置 相关设置
  3. 填写：
    • Base URL：https://api.siliconflow.cn/v1
    • API Key：你的硅基流动密钥
    • 模型 ID：从硅基流动模型广场复制粘贴
  4. 配置 Agent 使用哪个大模型作为默认模型
  5. 保存即可

五、常见问题排查

现象可能原因解决方案
对话返回 403API 余额不足登录控制台充值，或切换到免费模型
显示 Unknown model模型 ID 配置错误检查模型 ID 是否和硅基流动模型广场完全一致，注意大小写
返回 401 / UnauthorizedAPI Key 无效重新复制密钥，确认没有多余空格或换行
连接超时 / 无响应网络问题检查能否访问 api.siliconflow.cn，尝试 ping api.siliconflow.cn
配置后没有效果配置未重新加载执行 openclaw gateway restart 重启服务
回复内容截断maxTokens 设置过小在配置文件中增大对应模型的 maxTokens 值
免费模型也无法调用账号未激活检查是否完成注册流程，尝试重新登录

六、在其他工具中使用硅基流动

硅基流动兼容 OpenAI 接口协议，几乎所有支持 OpenAI API 的工具都能直接接入。

Python（OpenAI SDK）

pip install --upgrade openai

from openai import OpenAI

client = OpenAI(
    api_key="你的API密钥",
    base_url="https://api.siliconflow.cn/v1"
)

# 非流式调用
response = client.chat.completions.create(
    model="Qwen/Qwen2.5-7B-Instruct",
    messages=[{"role": "user", "content": "你好，请介绍一下自己"}]
)
print(response.choices[0].message.content)

# 流式调用
stream = client.chat.completions.create(
    model="Qwen/Qwen2.5-7B-Instruct",
    messages=[{"role": "user", "content": "写一首关于春天的诗"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Cursor 编辑器

  1. 打开设置 → Models → OpenAI API Key
  2. 填写：
    • API Key：你的硅基流动密钥
    • Base URL：https://api.siliconflow.cn/v1
    • Model：选择或输入硅基流动上的模型名（如 deepseek-ai/DeepSeek-V3）

Continue（VS Code 插件）

在 config.json 中添加：

{
  "models": [
    {
      "title": "SiliconFlow DeepSeek",
      "provider": "openai",
      "model": "deepseek-ai/DeepSeek-V3",
      "apiBase": "https://api.siliconflow.cn/v1",
      "apiKey": "你的API密钥"
    }
  ]
}

通用 OpenAI 兼容工具

任何支持自定义 OpenAI Base URL 的工具，只需：

  • Base URL：https://api.siliconflow.cn/v1
  • API Key：你的硅基流动密钥
  • 模型名：硅基流动上的模型 ID

七、费用与充值

  • 计费方式：按 Token 用量计费，输入和输出分别计价
  • 免费模型：Qwen2.5-7B、部分向量模型等可免费使用
  • 充值方式：控制台 → 充值，支持支付宝等支付方式
  • 余额查询：控制台首页可查看当前余额和消费明细
  • 费用控制：可在控制台设置消费上限，防止意外超额

八、相关链接汇总

名称链接
官网https://siliconflow.cn
控制台https://cloud.siliconflow.cn
官方文档https://docs.siliconflow.cn
模型广场https://cloud.siliconflow.cn/models
API 密钥管理https://cloud.siliconflow.cn/account/ak
体验中心 Playgroundhttps://cloud.siliconflow.cn
价格方案https://siliconflow.cn/pricing
⭐ 推荐注册链接https://cloud.siliconflow.cn/i/Ns9UTFJO
# 算法 # 人工智能 # python # 自动化
Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

深度 | Claude 11 天「验完」费马大定理：AI 没证明新数学，但把验算工业化了一脚

avatar AI编程社区
cover

状态丢失排障：Claude 持久记忆的跨会话局限与知芽 Notebook Skill 单元记忆如何沉淀可复用知识资产

avatar AI编程社区
cover

vs code 下载安装 以及 如何配置 claude code 和codex

avatar AI编程社区