硅基流动（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 Medium	AI 绘图、图生图
视频模型	HunyuanVideo-HD、Wan2.1	视频生成
向量/重排序	BGE、BCE	RAG、语义搜索

---

二、🎁 新人福利活动

注册送 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

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

---

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

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

找到配置文件

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 密钥
api	API 协议类型，填 openai-completions
models	可用模型列表，可添加多个
id	模型 ID，从硅基流动模型广场复制
name	显示名称，自定义即可
contextWindow	上下文窗口大小（token 数），参考模型文档
maxTokens	单次输出最大 token 数，参考模型文档

常用模型参数参考：

模型 ID	contextWindow	maxTokens	说明
Pro/zai-org/GLM-4.7	128000	8192	智谱 GLM 最新模型
deepseek-ai/DeepSeek-V3	64000	4096	DeepSeek 通用模型
Pro/deepseek-ai/DeepSeek-R1	64000	8192	DeepSeek 推理模型
Qwen/Qwen2.5-72B-Instruct	32768	8192	阿里通义旗舰模型
Qwen/Qwen2.5-7B-Instruct	32768	8192	免费，适合测试

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

配置 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

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

---

五、常见问题排查

现象	可能原因	解决方案
对话返回 403	API 余额不足	登录控制台充值，或切换到免费模型
显示 Unknown model	模型 ID 配置错误	检查模型 ID 是否和硅基流动模型广场完全一致，注意大小写
返回 401 / Unauthorized	API 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
体验中心 Playground	https://cloud.siliconflow.cn
价格方案	https://siliconflow.cn/pricing
⭐ 推荐注册链接	https://cloud.siliconflow.cn/i/Ns9UTFJO