常用镜像加速地址_OpenClaw入门基础教程

附录镜像页国内网络优化

这页不是“盲目换源大全”，而是最稳的加速策略：先诊断网络问题，再按 npm / Docker / GitHub 三类对象分别处理。

优先级原则

能直连官方就不换源；需要换源时优先可信镜像；社区代理仅作临时方案，不作为长期生产依赖。

先判断你卡在哪一步

安装时卡在依赖下载优先看 npm / pnpm 段落。

Docker 镜像拉取超时优先看 Docker 镜像加速段落。

GitHub clone / raw 文件慢优先看 GitHub 下载优化段落。

npm / pnpm 加速

资源	定位	链接
npm registry 文档	查看和恢复官方源	npm docs
npmmirror	国内常用社区镜像站	npmmirror.com

# 切换到国内镜像
npm config set registry https://registry.npmmirror.com
npm config get registry

# 恢复官方源
npm config set registry https://registry.npmjs.org
npm config get registry

Docker 镜像加速

资源	定位	链接
阿里云镜像加速器文档	国内常用 Docker 拉取加速方案	阿里云文档
华为云 SWR 文档	镜像托管和拉取指引	华为云文档
腾讯云 TCR	腾讯云镜像托管与分发	腾讯云 TCR

# /etc/docker/daemon.json
{
  "registry-mirrors": [
    "https://你的镜像加速地址"
  ]
}

# 修改后重启 Docker 服务

GitHub 下载优化（按优先顺序）

优先使用稳定代理网络或企业出口。
仓库操作优先用 Git over SSH（稳定性通常更好）。
最后再考虑社区代理或临时镜像下载。

安全提醒

第三方镜像和代理有供应链风险。涉及安装脚本、生产镜像、私有代码时，尽量回到官方源并做校验。

Node 二进制下载

如果 Node 下载慢，可临时使用 npmmirror Node 镜像；下载完成后建议回到官方渠道跟进版本安全更新。

加速后仍然失败怎么办

openclaw doctor
openclaw status --deep
openclaw logs --follow

延伸阅读：快捷命令合集、常见安装 / 启动 / 连接问题。