设置代理（请将 127.0.0.1:7890 替换为您自己代理服务器的地址和端口）

openclaw 中文openclaw 2026-04-09 2

设置代理是解决此问题的有效方法,以下是详细的代理设置教程，涵盖安装前和安装后两个阶段。

设置代理（请将 127.0.0.1:7890 替换为您自己代理服务器的地址和端口）-第1张图片-OpenClaw下载中文-AI中文智能体

核心思路

将代理配置在 系统环境变量 或 Python/conda 环境 中，让 git、pip、conda 以及 OpenClaw 运行时都能通过代理网络访问。

第一部分：安装前的代理设置（用于下载代码和依赖）

在克隆仓库和安装 pip 包之前设置好代理，可以极大提高成功率。

设置命令行终端代理（最常用）

打开你的终端（CMD, PowerShell, Git Bash, 或 Linux/Mac 的 Terminal），执行以下命令：

对于 HTTP/HTTPS 代理：

set https_proxy=http://127.0.0.1:7890
$env:HTTP_PROXY="http://127.0.0.1:7890"    # Windows PowerShell
$env:HTTPS_PROXY="http://127.0.0.1:7890"
export http_proxy=http://127.0.0.1:7890    # Linux / Mac / Git Bash
export https_proxy=http://127.0.0.1:7890

对于 SOCKS5 代理（如 Shadowsocks）：

export http_proxy=socks5://127.0.0.1:7891
export https_proxy=socks5://127.0.0.1:7891

取消代理设置：

unset http_proxy https_proxy  # Linux/Mac/Git Bash
set http_proxy=               # Windows CMD（设为空）
Remove-Item Env:HTTP_PROXY    # Windows PowerShell

验证代理是否生效：

curl -I https://github.com  # 或 ping github.com

如果返回的 HTTP 状态码是 200 或 301，说明代理成功。

为 Git 单独配置代理

如果不想设置全局代理,可以只为 git 命令设置：

# 设置全局 Git 代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
# 取消 Git 代理
git config --global --unset http.proxy
git config --global --unset https.proxy

为 Pip 和 Conda 设置代理

在安装 Python 包时单独指定代理：

对于 Pip：

pip install [package_name] --proxy=http://127.0.0.1:7890

或在 pip.ini 配置文件中永久设置（位于 ~/.pip/pip.conf 或 C:\Users\你的用户名\pip\pip.ini）：

[global]
proxy = http://127.0.0.1:7890

对于 Conda：

conda config --set proxy_servers.http http://127.0.0.1:7890
conda config --set proxy_servers.https http://127.0.0.1:7890

第二部分：OpenClaw 运行时的代理设置

即使安装成功,OpenClaw 在运行时（如下载模型、调用 API）也可能需要访问外部网络。

在 Python 代码中设置（推荐）

在调用 OpenClaw 相关功能的主脚本或 app.py 的开头，添加以下代码：

import os
os.environ['HTTP_PROXY'] = 'http://127.0.0.1:7890'
os.environ['HTTPS_PROXY'] = 'http://127.0.0.1:7890'
# 或者对于 SOCKS5
# os.environ['HTTP_PROXY'] = 'socks5://127.0.0.1:7891'
# os.environ['HTTPS_PROXY'] = 'socks5://127.0.0.1:7891'

在启动命令中设置

在启动 OpenClaw 应用时，直接在终端中设置环境变量并启动：

# Linux/Mac/Git Bash
HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 python app.py
# Windows CMD
set HTTP_PROXY=http://127.0.0.1:7890 && set HTTPS_PROXY=http://127.0.0.1:7890 && python app.py
# Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7890"; $env:HTTPS_PROXY="http://127.0.0.1:7890"; python app.py

修改项目配置文件

OpenClaw 项目有配置文件（如 .env， config.yaml, config.json），可以在其中添加代理设置：

# 示例 config.yaml
proxy:
  http: "http://127.0.0.1:7890"
  https: "http://127.0.0.1:7890"

第三部分：针对特定资源的解决方案

Hugging Face 模型下载加速
- 设置环境变量：export HF_ENDPOINT=https://hf-mirror.com
- 或者在代码中：os.environ['HF_ENDPOINT'] = 'https://hf-mirror.com'
- 这会将下载源切换到国内镜像站。

PyTorch 安装

使用清华源安装指定版本的 PyTorch，通常比走代理更快：

pip install torch torchvision torchaudio --index-url https://pypi.tuna.tsinghua.edu.cn/simple

GitHub 仓库克隆加速
- 使用 git clone 的镜像地址，将 github.com 替换为 hub.nuaa.cf 或 ghproxy.com。
- 示例：git clone https://hub.nuaa.cf/用户名/仓库名.git

第四部分：验证与排查

如何验证代理在工作？

import requests
# 测试1: 直接测试
print(requests.get('https://api.ipify.org').text) # 显示你的代理IP
# 测试2: 通过代理测试
proxies = {
    'http': 'http://127.0.0.1:7890',
    'https': 'http://127.0.0.1:7890',
}
try:
    r = requests.get('https://huggingface.co', proxies=proxies, timeout=5)
    print("成功通过代理访问！")
except Exception as e:
    print(f"代理连接失败: {e}")

常见问题排查
- 连接被拒绝：检查代理地址和端口是否正确，代理客户端（如 Clash、V2RayN）是否已启动并监听了该端口。
- 证书错误：如果使用 HTTPS 代理，可能需要关闭证书验证（不推荐，仅临时测试）：
```
import ssl
ssl._create_default_https_context = ssl._create_unverified_context
```
- 部分能连，部分不能连：检查代理规则（如 Clash 的规则模式），确保对目标网址（github.com, huggingface.co 等）走了代理。