前言

OpenClaw 是一个功能强大的开源工具，结合硅基流动（SiliconFlow）的 API，可以让你在本地轻松运行和测试大语言模型。本教程将为你提供在 Windows 系统上从零开始安装和配置 OpenClaw 的完整步骤，即使是新手也能跟着一步步操作成功。

1. 环境准备

在开始安装 OpenClaw 之前，请确保你的 Windows 系统满足以下条件：

• 操作系统：Windows 10 或 Windows 11（64位）。
• Python：需要安装 Python 3.8 或更高版本。推荐使用 Python 3.10。
• Git：用于从 GitHub 克隆 OpenClaw 仓库。
• 网络：能够正常访问 GitHub 和硅基流动 API 服务。

1.1 安装 Python

1. 访问 Python 官网 下载 Windows 安装程序。
2. 运行安装程序，务必勾选 “Add Python to PATH”，然后点击 “Install Now”。
3. 安装完成后，打开命令提示符（CMD）或 PowerShell，输入 python --version 验证安装。如果显示版本号（如 Python 3.10.11），则安装成功。

1.2 安装 Git

1. 访问 Git 官网 下载 Windows 版 Git 安装程序。
2. 运行安装程序，大部分选项保持默认即可，一路点击 “Next” 完成安装。
3. 安装完成后，在命令提示符或 PowerShell 中输入 git --version 验证安装。

2. 安装 OpenClaw

我们将通过 Git 克隆项目并安装其依赖。

1. 打开 PowerShell：在开始菜单搜索 “PowerShell”，右键点击并选择 “以管理员身份运行”。
2. 克隆仓库：执行以下命令，将 OpenClaw 项目克隆到本地。

   git clone https://github.com/OpenClaw/OpenClaw.git
   cd OpenClaw
   

3. 创建虚拟环境（推荐）：为了避免污染系统 Python 环境，建议创建一个虚拟环境。

   python -m venv venv
   

4. 激活虚拟环境：

   .\venv\Scripts\activate
   

   激活后，命令行提示符前会出现 (venv) 标识。
5. 安装依赖：使用 pip 安装项目所需的所有 Python 包。

   pip install -r requirements.txt
   

   这个过程可能会持续几分钟，请耐心等待。

3. 配置硅基流动 API

OpenClaw 需要连接到硅基流动的 API 服务才能使用大模型能力。

1. 注册硅基流动账号：访问 硅基流动官网，注册并登录。
2. 获取 API Key：
   • 登录后，进入控制台。
   • 在 “API 密钥” 或类似页面，点击 “创建新的 API 密钥”。
   • 复制生成的密钥字符串，妥善保存。
3. 配置 OpenClaw：
   • 在 OpenClaw 项目根目录下，找到或创建一个名为 .env 的文件。
   • 用记事本或任何文本编辑器打开 .env 文件，添加以下内容（将 YOUR_API_KEY_HERE 替换为你刚才复制的真实 API 密钥）：

     SILICONFLOW_API_KEY=YOUR_API_KEY_HERE
     

   • 保存文件。

4. 运行与测试

完成安装和配置后，让我们启动 OpenClaw 并进行简单测试。

1. 启动 OpenClaw 服务：在项目根目录下（确保虚拟环境已激活），运行以下命令：

   python app.py
   

   或者根据项目 README 的指示运行主程序。
2. 访问 Web 界面：启动成功后，命令行会显示服务运行的地址，通常是 http://127.0.0.1:7860 或 http://localhost:7860。
3. 打开浏览器：在浏览器地址栏输入上述地址，即可看到 OpenClaw 的 Web 用户界面。
4. 进行测试：在界面的输入框中，尝试输入一个问题，例如 “请用 Python 写一个 Hello World 程序”，然后点击发送。如果配置正确，你将很快收到来自硅基流动模型的回复。

4.1 通过 Python API 直接调用硅基流动模型

除了使用 Web 界面，你也可以通过 Python 代码直接调用硅基流动的 API。以下是一个完整的示例：

import os
from openai import OpenAI

# 1. 设置 API 密钥（确保已在 .env 文件中配置）
api_key = os.getenv("SILICONFLOW_API_KEY")
if not api_key:
    print("错误：未找到 SILICONFLOW_API_KEY 环境变量")
    print("请检查 .env 文件或手动设置环境变量")
    exit(1)

# 2. 初始化客户端（硅基流动兼容 OpenAI API）
client = OpenAI(
    api_key=api_key,
    base_url="https://api.siliconflow.cn/v1"  # 硅基流动 API 地址
)

# 3. 准备对话消息
messages = [
    {"role": "system", "content": "你是一个乐于助人的 AI 助手。"},
    {"role": "user", "content": "请用 Python 写一个函数，计算斐波那契数列的前 n 项。"}
]

# 4. 调用硅基流动模型（这里以 Qwen2.5-7B-Instruct 为例）
try:
    response = client.chat.completions.create(
        model="Qwen/Qwen2.5-7B-Instruct",  # 硅基流动支持的模型
        messages=messages,
        temperature=0.7,
        max_tokens=500
    )
    
    # 5. 提取并打印回复
    reply = response.choices[0].message.content
    print("=== 硅基流动模型回复 ===")
    print(reply)
    print("========================")
    
except Exception as e:
    print(f"API 调用失败: {e}")

预期输出结果示例：

=== 硅基流动模型回复 ===
当然，以下是一个计算斐波那契数列前 n 项的 Python 函数：

```python
def fibonacci(n):
    """
    计算斐波那契数列的前 n 项
    
    参数:
        n (int): 要计算的项数
    
    返回:
        list: 包含前 n 项斐波那契数的列表
    """
    if n <= 0:
        return []
    elif n == 1:
        return [0]
    elif n == 2:
        return [0, 1]
    
    fib_sequence = [0, 1]
    for i in range(2, n):
        next_num = fib_sequence[-1] + fib_sequence[-2]
        fib_sequence.append(next_num)
    
    return fib_sequence

# 使用示例
if __name__ == "__main__":
    n = 10
    result = fibonacci(n)
    print(f"斐波那契数列前 {n} 项: {result}")

这个函数首先处理边界情况（n <= 0, n == 1, n == 2），然后使用循环计算后续的项。时间复杂度为 O(n)，空间复杂度为 O(n)。

你可以通过调用 fibonacci(10) 来获取前 10 项斐波那契数：[0, 1, 1, 2, 3, 5, 8, 13, 21, 34]。

**代码说明：**

1.  **环境检查**：代码首先检查是否已设置 `SILICONFLOW_API_KEY` 环境变量。
2.  **客户端初始化**：使用 `openai` 库（兼容硅基流动 API）创建客户端。
3.  **模型选择**：示例中使用 `Qwen/Qwen2.5-7B-Instruct` 模型，你可以根据需要替换为硅基流动支持的其他模型。
4.  **参数调整**：`temperature` 控制回复的随机性（0-1），`max_tokens` 限制回复的最大长度。
5.  **错误处理**：使用 try-except 块捕获可能的 API 调用错误。

要运行此代码，请确保：
- 已安装 `openai` 库：`pip install openai`
- 已在 `.env` 文件中正确配置 `SILICONFLOW_API_KEY`
- 在 OpenClaw 项目目录下运行（或确保虚拟环境已激活）

## 5. 常见问题与解决

*   **`pip install` 速度慢或失败**：可以尝试使用国内镜像源加速，例如：
    ```powershell
    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
    ```
*   **虚拟环境激活失败**：如果 PowerShell 提示无法运行脚本，可能是执行策略限制。可以临时更改策略（仅当前会话）：
    ```powershell
    Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
    ```
    然后再执行激活命令。
*   **服务启动报错（端口占用）**：如果默认端口 7860 被占用，可以在启动命令中指定其他端口，例如 `python app.py --port 7861`，然后访问 `http://localhost:7861`。
*   **API 调用无响应或报错**：请检查 `.env` 文件中的 `SILICONFLOW_API_KEY` 是否正确，以及网络是否能正常连接到硅基流动服务。

## 结语

恭喜！你已经成功在 Windows 上搭建了 OpenClaw 环境，并接入了硅基流动的 AI 能力。现在你可以开始探索它的更多功能，如模型切换、对话历史、文件上传处理等。祝你使用愉快！

如果在操作过程中遇到本教程未涵盖的问题，建议查阅 OpenClaw 项目的官方 GitHub Issues 或硅基流动的文档。