国内下载 OpenClaw 太慢？换成国内镜像源，速度快 10 倍的方法

在国内安装 OpenClaw，有时候网速会慢到让人怀疑人生——npm install 卡在那里一动不动，或者下载到一半断掉，反复失败。

根源是 OpenClaw 通过 npm 分发，npm 默认源指向 registry.npmjs.org，这个地址在国内连接质量很不稳定，速度时好时坏，高峰期基本约等于不可用。

好消息是解决方法很直接——换源。本文把国内 OpenClaw 用户会遇到的几个慢的地方都列出来，对应的镜像换法一并给出。更多资源请访问 OpenClaw 中文版官网。

一、最根本的问题：npm 默认源在国外

OpenClaw 是一个 Node.js 应用，通过 npm（Node Package Manager）安装和更新。安装命令 npm install -g openclaw 实际上是从 registry.npmjs.org 下载包文件。

这个地址在国内访问很不稳定，表现为：

下载速度极慢（几 KB/s）
下载一半超时断连
偶尔完全无法连接

解决方案是把 npm 的下载源切换到国内镜像——淘宝 NPM 镜像（npmmirror.com）是目前同步最及时、最稳定的国内 npm 镜像，几乎实时同步官方源。

二、方案一：临时换源，只影响当次安装

如果不想永久改变 npm 配置，只想让这次安装快一点：

# 安装 OpenClaw 时临时指定国内源
npm install -g openclaw --registry https://registry.npmmirror.com

# 升级 OpenClaw 时同样加上
npm install -g openclaw@latest --registry https://registry.npmmirror.com

这种方式只对当次命令有效，不修改全局配置。适合偶尔用用、不想动系统设置的场景。

三、方案二：永久换源（推荐）

如果你经常要安装 npm 包，建议永久切换到国内源，一次设置，以后所有 npm 命令都走国内镜像：

# 切换到淘宝镜像源
npm config set registry https://registry.npmmirror.com

# 验证是否生效
npm config get registry
# 应输出：https://registry.npmmirror.com

切换之后，安装 OpenClaw 的命令不需要任何改变：

npm install -g openclaw

它会自动走国内镜像，速度通常能达到 1～10 MB/s，完成时间从可能的几十分钟缩短到几分钟甚至更快。

如果未来需要切回官方源

npm config set registry https://registry.npmjs.org

四、用 nrm 管理多个源（进阶可选）

如果你经常需要在不同源之间切换（比如公司有私有 npm 仓库），可以用 nrm 来管理：

# 安装 nrm
npm install -g nrm --registry https://registry.npmmirror.com

# 列出所有可用的源
nrm ls
# 输出示例：
#   npm    https://registry.npmjs.org/
# * taobao https://registry.npmmirror.com/
#   yarn   https://registry.yarnpkg.com/

# 切换到淘宝源
nrm use taobao

# 测试各源的速度（会实际发请求测延迟）
nrm test

五、Node.js 本身的安装也要换源

OpenClaw 需要 Node.js v22.16+ 或 v24（推荐）。如果你还没安装 Node.js，或者需要升级版本，官方安装源在国内同样很慢。

方案一：用 nvm 安装（推荐）

nvm（Node Version Manager）是管理 Node.js 版本最方便的工具，也可以配置国内镜像：

# 安装 nvm（如果还没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# ⚠️ 如果上面这条命令因为 GitHub 访问慢而卡住，
# 可以改用 gitee 镜像：
curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.0/install.sh | bash

nvm 安装好之后，设置 Node.js 的下载镜像：

# 在 ~/.zshrc 或 ~/.bashrc 里添加这一行
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

# 让设置生效
source ~/.zshrc

# 然后安装 Node.js v24
nvm install 24
nvm use 24
nvm alias default 24

# 验证
node --version   # 应显示 v24.x.x

方案二：直接从淘宝镜像下载 Node.js 安装包

如果不用 nvm，也可以直接从国内镜像下载 Node.js 安装包：

访问 npmmirror.com/mirrors/node/
选择对应版本（v24.x.x 最新稳定版）
下载对应系统的安装包（macOS 选 .pkg，Windows 选 .msi）

六、Docker 镜像加速（适用于 Docker 部署方式）

如果你用 Docker 方式部署 OpenClaw（docker compose up -d），Docker 镜像默认从 Docker Hub 拉取，同样在国内速度很慢。

配置 Docker 镜像加速

编辑 Docker 的 daemon.json 配置文件：

macOS（Docker Desktop）：

打开 Docker Desktop → Settings → Docker Engine
在 JSON 配置里添加 registry-mirrors：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com"
  ]
}

Linux：

# 编辑配置文件（不存在则新建）
sudo nano /etc/docker/daemon.json

# 内容如下：
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com"
  ]
}

# 重启 Docker 服务
sudo systemctl daemon-reload
sudo systemctl restart docker

配置好后，再次拉取 OpenClaw 镜像就会走国内加速节点：

docker compose pull
# 速度应该明显提升

注意：Docker 镜像加速服务的稳定性和可用性可能随时变化，如果某个地址失效，可以搜索”Docker 镜像加速”找到当前可用的镜像地址列表。

七、OpenClaw 技能包安装也可以加速

安装 OpenClaw 技能（Skills）时，底层同样走 npm 或 ClawHub，国内用户有时候会遇到技能安装缓慢或失败的问题。

如果已经按照第三节永久切换了 npm 源，技能安装通常会自动走国内镜像，不需要额外配置。

如果还是很慢，在安装技能时手动指定源：

# 通过 npm 安装技能时指定源
npm install openclaw-skill-weather --registry https://registry.npmmirror.com

# 或者临时设置环境变量
npm_config_registry=https://registry.npmmirror.com openclaw plugins install weather

八、pnpm 用户的配置

部分用户用 pnpm 代替 npm 管理包。pnpm 的源配置方式略有不同：

# pnpm 切换到淘宝源
pnpm config set registry https://registry.npmmirror.com

# 验证
pnpm config get registry

# 安装 OpenClaw
pnpm add -g openclaw

九、一次性检查当前源配置

不确定现在用的是什么源？一条命令看清楚：

# 检查 npm 当前源
npm config get registry

# 检查 pnpm 当前源（如果用了 pnpm）
pnpm config get registry

# 检查 nvm 的 Node.js 镜像
echo $NVM_NODEJS_ORG_MIRROR

如果 npm 输出的是 https://registry.npmjs.org/，说明还在用官方源，换成 https://registry.npmmirror.com 即可。

快速配置汇总

场景	一条命令解决
npm 永久换源	`npm config set registry https://registry.npmmirror.com`
单次安装走国内源	`npm install -g openclaw --registry https://registry.npmmirror.com`
nvm 下载 Node.js 走国内	`export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node`
pnpm 换源	`pnpm config set registry https://registry.npmmirror.com`
验证 npm 当前源	`npm config get registry`

总结

国内安装 OpenClaw 慢，根本原因是 npm 默认源在国外。两步解决：

永久切换 npm 源到 npmmirror.com：npm config set registry https://registry.npmmirror.com
如果用 Docker 部署，在 Docker daemon.json 里加上国内镜像加速地址

换完之后，npm install -g openclaw 的速度通常会有质的提升，几分钟内完成安装。后续每次 npm install -g openclaw@latest 升级也同样受益，不需要重复配置。

想了解更多 OpenClaw 安装和配置技巧，欢迎访问 OpenClaw 中文版官网。