如果你准备在自己电脑上装 OpenClaw多半已经见过那种让人想砸键盘的画面npm 进度条卡在某个包上半天不动安装脚本 curl 到一半直接超时Docker 基础镜像拉了几百 MB 就像在拨号上网。OpenClaw 本身是个很轻量的开源个人 AI 助手框架装起来并不复杂真正的麻烦全在下载链路——默认源都指向境外服务器这导致国内用户在做 OpenClaw 安装时往往一大半时间都耗在“等下载”上而不是“装软件”上。所以这篇指南要做的就一件事把 OpenClaw 安装过程中的每一条下载链路都用国内镜像提速按真实安装顺序走一遍——先切 Node.js 和 npm 的源再配 Docker 镜像加速然后完成本体安装、初始化、本地模型切换最后补充 Termux 手机端、卸载重装这些容易踩坑的场景。刚接触 OpenClaw、正被下载慢卡住的新手可以直接照抄已经在用、想换 Docker 方式或者换模型源的老人也能在中间几节找到对应方案。1. 先搞清楚OpenClaw 下载慢到底慢在哪1.1 打开安装链路看看到底要下载些什么很多人一上来就猛敲安装命令卡住之后又反复重试其实是对安装链路没有整体概念。OpenClaw 不是单个文件而是一个运行在 Node.js 上的程序典型安装至少要经过四类下载环节默认获取位置国内直连的典型表现Node.js 运行时官方站点 CDN几十 MB 的包半天下不完中断后从头再来OpenClaw 本体npm 官方源进度条卡死、报 ECONNRESETDocker 基础镜像Docker Hub明明不大却像在拨号上网本地模型权重Ollama / Hugging Face动不动超时下载完校验失败只要其中一环是慢的整个安装过程就是灾难。更麻烦的是安装脚本往往没有断点续传失败一次就得从头开始反复几次耐心就被耗光了。1.2 直连慢的底层原因先说个基本的网络常识默认源服务器部署在境外数据包要从国内跨越跨国骨干链路才能到达。物理距离摆在那里往返延迟天然就高再加上高峰期的链路拥塞丢包重传会让下载这种长连接任务雪上加霜。还有一些公共源会做限流连上了带宽也上不去。这几个因素叠在一起结果就是“下载慢”的体感被放大了好几倍。我这里不讨论任何绕过策略只讨论一个正规思路把下载地址换成国内的镜像站让数据包少走跨国链路速度自然就上来了。这也是国内做开源软件安装加速最通用、最合规的做法。1.3 镜像加速到底在加速什么镜像站本质上是官方内容的完整或部分拷贝定期同步放在国内网络上。你的安装工具把默认源地址换成镜像地址后物理距离从“跨大洋”变成“同城”带宽也充裕得多。用生活里的例子说你要买一种只有原厂才有的零件每次都得跨国下单等十天现在社区在国内开了个仓库提前把常用型号囤好货你下单当天就能拿到。镜像加速做的就是这件事。不过镜像也有两个先天限制一是不同步某个版本刚发布镜像站可能要晚几小时甚至几天才有二是某些私有仓库内容不开放没有公共镜像可用。理解这两点后文很多“奇怪的报错”就都能想通了。2. 动手前先把基础源配好四类镜像一次到位2.1 Node.js 与 npm优先级最高的两个源OpenClaw 跑在 Node.js 上所以第一件事是把 Node.js 运行时和 npm 包源都切到国内镜像。如果你还没装 Node.js建议直接用 nvm 安装并顺带把 nvm 的下载地址指向国内镜像export NVM_NODEJS_ORG_MIRRORhttps://npmmirror.com/mirrors/node/ nvm install 22 node -vnpm 的源切换更简单一条命令永久生效npm config set registry https://registry.npmmirror.com npm config get registry关键点npm config get registry必须能看到npmmirror.com的输出这一步很多人做完就忘了验证结果后面安装时还是走的官方源。补充一个细节npmmirror 这类公共镜像对主流包都同步得很勤但如果你要装某个刚发布半小时的新版本遇到 404 是正常的等同步或者临时切回官方源即可。2.2 Docker 基础镜像改一处配置一劳永逸如果你打算用 Docker 方式部署安装前先配好镜像加速。Docker 的仓库加速是修改守护进程配置在/etc/docker/daemon.json里加一段{ registry-mirrors: [ https://docker.m.daocloud.io, https://docker.1panel.live ] }然后重启 Docker 并确认配置生效sudo systemctl restart docker docker info | grep -A 5 Registry Mirrors我一般习惯重启后先拉一个 hello-world 测试确认加速配置生效再跑正式镜像。另外要提醒一句公共 registry 加速地址由社区维护哪天失效是常态失效后在社区搜“docker 镜像加速”找最新可用地址就行不用死磕某一个。2.3 模型权重Ollama / Hugging Face 的国内替代OpenClaw 接本地模型时最大头的下载是模型权重。Ollama 默认从自己的 registry 拉模型Hugging Face 的权重也都在境外这两个在直连状态下都算不上顺畅。我的做法是改走两个国内可用源一个是魔搭社区模型全、速度快另一个是社区维护的 HF 镜像设置一个环境变量就能用export HF_ENDPOINThttps://hf-mirror.com huggingface-cli download 模型仓库路径 --local-dir ./模型目录用魔搭社区下载权重则更直接pip install modelscope modelscope download --model 模型名 --local_dir ./模型目录注意 pip 本身也需要国内源不然第一步就卡住了具体配置我放在第 6 节。3. 正菜用镜像方案把 OpenClaw 完整装起来3.1 装之前花两分钟自检镜像配好之后先别急着安装花两分钟确认环境避免装到一半才发现前置条件没满足node -v npm -v npm config get registry git --version我见过不少人卡在最开始就是因为 Node.js 版本太低。OpenClaw 对运行时版本有要求一般需要较新的 LTS20 或 22 这个级别如果你node -v看到的版本很老先用第 2.1 节的方式升级别带着旧版本硬装。3.2 安装本体挂上国内 npm 源执行环境确认没问题本体安装就是一条命令npm install -g openclaw在 npmmirror 源下这一步通常一两分钟就能跑完。安装完成后先验证openclaw --version如果提示command not found多半是 npm 全局 bin 目录不在 PATH 里。用 nvm 管理 Node.js 时确认下~/.nvm下对应版本的 bin 路径有没有被加载别急着 sudo 重装先排查 PATH。还有一个高频坑是权限问题。如果你不是用 nvm 而是直接装的 Node.js全局安装可能报 EACCES 权限错误。解决办法不是 sudo而是把 npm 的全局目录改到用户目录下或者干脆换 nvm 重装 Node.js一劳永逸。3.3 初始化、启动、接入模型配置敲openclaw start第一次运行时系统会在用户目录生成配置目录和默认配置文件。目录位置一般是~/.openclaw配置文件是openclaw.config.json里面主要填模型服务的信息。配置模型时有两条路接入在线模型 API直接用各家服务商的接口填入 API key 和模型名优点是零本机资源占用缺点是每次调用有费用而且数据要经过接口服务。接入本地模型通过 Ollama 等在本地起模型服务OpenClaw 配置里把 provider 指向本地 Ollama 即可完全离线运行也不花钱。选择哪条路不看技术难度看你的机器配置和隐私要求。如果你只是想快速体验先接一个在线 API 跑通流程如果机器有独立显卡或者内存足够再切本地模型。3.4 把模型切到本地 Ollama接本地模型是目前社区讨论最多、也是问题最多的一步。先把 Ollama 装好确保服务在本地跑起来export OLLAMA_HOST127.0.0.1:11434 ollama serve接着解决模型文件的下载问题。ollama pull 模型名直连官方 registry 速度往往不理想更快的做法是从魔搭社区或 HF 镜像下载 GGUF 权重再通过 Modelfile 导入本地modelscope download --model 模型仓库路径 --local_dir ./models/my-model cat Modelfile EOF FROM ./models/my-model/model.gguf EOF ollama create mymodel -f Modelfile ollama list之后在 OpenClaw 配置里把模型 provider 切到 ollama模型名填mymodel重启服务即可。这一步常见错误是模型名拼错——ollama list里显示什么名字配置里就填什么名字不要凭记忆写。4. 换着姿势装Docker 部署与手机端加速要点4.1 Docker Compose 方式部署Docker 部署的优点是一次配好、环境干净、迁移方便。但前提是先把第 2.2 节的 registry 加速配好否则 compose 拉镜像那一步就能耗掉你半天。我的建议是不要直接docker compose up -d先手动docker pull把关键镜像拉下来确认成功后再 compose。这样能把“拉镜像慢”和“配置有问题”两个问题分开排查不会混在一起难定位。有一个容易忽略的点镜像不一定全在 Docker Hub。如果用到了 ghcr.io 这类仓库的镜像registry 加速不一定覆盖得到国内直连 ghcr.io 也很慢。遇到这种情况我更推荐换回 npm 本地部署方式省心很多。4.2 Termux 手机端安装 OpenClaw在手机上用 Termux 装 OpenClaw 完全是可行的但别忘了给 Termux 的包管理器也配上国内镜像。先执行官方提供的换源命令选择国内源pkg update pkg upgrade pkg install nodejs git npm config set registry https://registry.npmmirror.com npm install -g openclaw手机端内存和存储都有限我提醒两点一是 Termux 的后台进程容易被系统回收跑模型服务之前记得把后台限制关掉二是优先用小尺寸的量化模型否则手机跑起来又慢又烫。OpenClaw 也提供配套的安卓客户端安装包本身不大真正的耗时还是在模型下载和服务配置上。4.3 卸载、升级与重装有阵子社区里问卸载的人特别多主要是装完之后想换个方式重新部署。卸载其实很干净npm uninstall -g openclaw rm -rf ~/.openclaw~/.openclaw里装着配置、会话记录和技能文件删之前先备份。升级则用npm update -g openclaw重装时把第 3 节的流程再走一遍即可。我自己的习惯是卸载后用which openclaw再确认一次有时候旧版本的残余命令还在 PATH 里容易造成“卸载成功了但命令还能用”的错觉。5. 下载慢问题排查顺序与翻车自救5.1 按这个顺序排查别乱试安装过程报错时最忌讳的是病急乱投医。我建议按下面的顺序逐段定位每步只用一两条命令先看 npm 源是否生效npm config get registry如果还是官方地址说明前面第 2.1 步没生效。再看 Node.js 版本node -v不满足要求就升级。验证网络到镜像站是否通curl -I https://registry.npmmirror.com能返回响应头说明链路没问题。最后才是看安装日志里的具体报错比如 EACCES 是权限问题ENOTFOUND 是 DNS 解析问题。这套排查顺序能覆盖 90% 的下载类故障。很多“奇怪”的问题其实都是源没切干净或者版本太老。5.2 镜像源本身失效了怎么办镜像站不是永远可靠的。你会遇到三种典型情况返回 404、证书报错、以及某个包版本还没同步过来。处理思路很简单404 或版本没同步说明镜像滞后等一段时间或者临时切回官方源装完再切回来证书报错先看系统时间是否准确时间不对会引发各种证书问题镜像站整体不可用就换同类的其他备用镜像不要在一棵树上吊死。一个实用技巧把常用的几条镜像配置命令存成一个脚本换机器、重装系统后直接执行一遍省得每次都要重新查。5.3 高频报错速查症状常见原因处理办法安装时 ECONNRESETnpm 网络请求被中断确认 registry 已切到国内源重试安装提示 EACCES 权限错误npm 全局目录不可写用 nvm 重装 Node.js 或修改 npm 全局目录启动后连不上模型服务Ollama 没启动或 HOST 不对先curl 127.0.0.1:11434测通再启动 OpenClaw报 model not foundOllama 里没有该模型或名字写错ollama list核对名字配置里保持一致模型回答特别慢模型参数量超出硬件能力换更小的量化模型或改用 API 方式6. 镜像加速不是 OpenClaw 专属顺手解决其他下载慢场景6.1 pip 与 Anaconda 源装 OpenClaw 的技能或配套 Python 工具时pip 和 conda 的下载慢问题同理会遇到。pip 换源pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simpleconda 加国内频道conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ conda config --set show_channel_urls yes高校开源镜像站是这类场景最常用的资源速度快、同步频率高比直连官方源靠谱得多。6.2 Gradle / Maven 与前端 npm 依赖如果你在开发 OpenClaw 相关插件或用到 JVM 生态工具Gradle 和 Maven 的海外源同样让人头疼。Gradle 的发行包下载可以在gradle-wrapper.properties里把distributionUrl换成云厂商的发行包镜像Maven 依赖则在构建脚本里优先声明国内公共仓库repositories { maven { url https://maven.aliyun.com/repository/public } }前端项目的 npm 依赖就更好办了装上 pnpm 之后把 registry 指到国内源安装速度提升非常明显。6.3 ComfyUI / NLTK / 大模型权重最后提几个热门的下载慢场景思路完全一致。ComfyUI 下载模型慢别依赖内置下载功能自己去模型社区或镜像站下载后手动放进模型目录速度可控得多。NLTK 数据下载慢可以手动下载数据包并放到本地nltk_data目录避免每次跑脚本都卡在下载上。大模型权重则优先走魔搭社区这类国内平台比任何境外源的体验都好。我个人在实际操作中的体会是镜像加速这件事本质上就是“把默认源换掉”“确认换成功了”两个动作剩下的大多是被卡住后的心态问题。还有一个小技巧当你看到终端长时间没输出时先别急着按 CtrlC用curl -I或npm ping测一下当前源是否活着很多时候只是慢多等几十秒就过去了。把这份指南里的配置命令存成脚本下次换机器时你会感谢现在的自己。