适用于HTTP/HTTPS代理（根据您的代理软件端口修改，通常是7890或10809）

openclaw OpenClaw手册 2026-04-09 2

这是一个通用的配置指南,请根据您的具体情况选择方法。

适用于HTTP/HTTPS代理（根据您的代理软件端口修改，通常是7890或10809）-第1张图片-OpenClaw 开源免费 -中文免费安装

核心问题分析

下载失败通常是因为：

从 Hugging Face 下载模型权重时被限制或速度极慢。
从 GitHub 克隆代码或下载发布包时连接不稳定。
项目依赖的 Python包 源（PyPI）下载慢。

解决方案总览（建议按顺序尝试）

flowchart TD
    A[OpenClaw下载/安装失败] --> B{网络环境判断}
    B --> C[公司/学校网络<br>有标准代理]
    B --> D[个人网络<br>使用科技工具]
    B --> E[任何网络<br>通用备选方案]
    C --> F[配置系统/终端全局代理]
    F --> G[使用项目提供的<br>国内镜像/网盘链接]
    D --> H[对Git：使用SSH或Ghproxy镜像]
    D --> I[对HF：使用镜像站或<br>代码中设置endpoint]
    E --> J[手动下载<br>放入指定目录]
    G & H & I & J --> K[完成配置<br>顺利运行]

以下是具体操作步骤：

配置系统/命令行代理（最有效）

如果您有可用的网络代理服务（如Clash、V2Ray等）,这是最佳方案。

在命令行中临时设置代理（推荐） 在启动下载命令的终端中,先设置环境变量：

set https_proxy=http://127.0.0.1:7890
# 对于Git，单独设置
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

对于Linux/macOS系统：

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

为Python pip设置代理

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

或在 ~/.pip/pip.conf 中永久配置。

使用国内镜像源

PyPI镜像（加速Python包安装）

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Hugging Face镜像（关键！） OpenClaw很可能需要下载HF模型,修改代码或环境变量：

# 在您的Python代码中，加载模型之前设置环境变量
import os
os.environ['HF_ENDPOINT'] = 'https://hf-mirror.com'
# 然后执行原来的下载代码
from transformers import AutoModel
model = AutoModel.from_pretrained("模型名")

或者使用命令行工具 huggingface-cli：

export HF_ENDPOINT=https://hf-mirror.com
huggingface-cli download --resume-download 模型名 --local-dir ./模型目录

Git镜像 如果项目本身在GitHub上,可以使用代理地址：

# 将原地址
https://github.com/用户名/OpenClaw.git
# 替换为
https://ghproxy.com/https://github.com/用户名/OpenClaw.git

或者使用 git clone 时配置：

git config --global url."https://hub.fgit.ml/".insteadOf "https://github.com/"

手动下载 + 本地加载（终极方案）

当自动下载始终失败时：

找到下载链接：查看项目文档或代码，找到模型、数据集的原始URL。
使用浏览器/下载工具：用能正常访问的方式手动下载文件。
放置到正确目录：
- Hugging Face模型：默认会下载到 ~/.cache/huggingface/hub/，找到对应模型的文件夹,替换文件。
- 项目自定义路径：通常代码会指定 pretrained_model_path 参数,放入该路径即可。
修改代码：在加载模型时，将路径指向本地文件。
```
model = AutoModel.from_pretrained("./local_models/your_model")
```