明白了,你想要一个 Windows 上安装 OpenClaw 并使用硅基流动 API(SiliconFlow API)的保姆级教程,我给你整理一个详细、循序渐进的指南,适合新手一步步操作。
手把手教你在 Windows 上安装 OpenClaw 并使用硅基流动 API【保姆级教程】
本教程适合 Windows 10/11 用户,无需 Linux 或云服务器经验。我们会覆盖环境准备、OpenClaw 安装、API 配置和简单测试。
一、环境准备
- 安装 Python 3.11(或 3.10+)
- 下载地址:Python 官方网站
- 安装时勾选 “Add Python to PATH”
- 验证:
python --version pip --version
- 安装 Git
- 下载地址:Git 官方网站
- 验证:
git --version
- 安装 Visual Studio C++ Build Tools
- 作用:编译部分 Python 包依赖
- 下载地址:Visual Studio Build Tools
二、创建虚拟环境(推荐)
虚拟环境可以避免系统 Python 冲突:
python -m venv openclaw_env
cd openclaw_env\Scripts
activate
激活后,命令提示符会显示
(openclaw_env)。
三、安装 OpenClaw
- 从 GitHub 克隆项目
git clone https://github.com/OpenClaw/OpenClaw-Core.git cd OpenClaw-Core - 安装依赖
pip install --upgrade pip pip install -r requirements.txt
注意:如果出现编译错误,可先确认已安装 C++ Build Tools。
四、配置硅基流动 API(SiliconFlow API)
- 获取 API Key
- 前往硅基流动官网注册账号,生成 个人 API Key。
- 保存在安全位置,稍后使用。
- 配置 API Key
- 在 OpenClaw 配置文件中添加:
{ "siliconflow": { "api_url": "https://api.siliconflow.ai/v1", "api_key": "你的API_KEY" } } - 文件路径通常在
OpenClaw-Core/config.json。
- 在 OpenClaw 配置文件中添加:
- 环境变量方式(可选)
set SILICONFLOW_API_KEY=你的API_KEYWindows 上环境变量只在当前终端生效,如果要长期生效,需要在系统环境变量中添加。
五、测试连接
在 OpenClaw Core 目录下运行示例 Python 脚本:
import requests
API_URL = "https://api.siliconflow.ai/v1/predict"
API_KEY = "你的API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
payload = {
"input": "Hello, OpenClaw + SiliconFlow!"
}
response = requests.post(API_URL, headers=headers, json=payload)
print("状态码:", response.status_code)
print("返回内容:", response.json())
- 正常返回
200和生成结果表示成功。 - 返回
401→ 检查 API Key 是否正确。 - 返回
403→ 检查账户权限是否开通 API 访问。
六、使用 OpenClaw 执行任务
- 文本生成示例
from openclaw import OpenClawClient client = OpenClawClient(api_key="你的API_KEY") result = client.generate_text("写一段 Windows 安装 OpenClaw 的教程") print(result) - 图像生成示例
result = client.generate_image("1920x1080,科幻风格 AI 工作站") result.save("output.png") - 多模型选择
result = client.generate_text("生成摘要", model="OpenClaw-Large")
七、常见问题及解决方案
| 问题 | 解决方案 |
|---|---|
| pip 安装报错 | 升级 pip,安装 C++ Build Tools |
| HTTP 401 | 检查 API Key 是否正确或过期 |
| 模型加载慢 | 使用小模型或低精度模式 |
| Windows 防火墙阻止 | 在防火墙允许 Python/终端访问网络 |
八、实战小技巧
- 降低 Token 消耗
- 使用
max_tokens限制输出长度。 - 缓存重复请求结果。
- 使用
- 多任务分步执行
- 文本生成、摘要、图像分开调用,减少单次请求负载。
- 模板化 Prompt
- 对重复任务用模板占位符,避免每次写完整指令。
✅ 到这里,你已经可以在 Windows 上 安装 OpenClaw、配置硅基流动 API 并开始使用,无需 Linux 经验。
发表回复