最近OpenClaw这个开源AI智能体框架热度上来了它是腾讯开源的项目社区里习惯叫它“龙虾”。简单说它能帮你把大模型接进微信、Slack、Telegram这些聊天渠道再挂上一堆Skill和MCP工具让AI不只会聊天还能真正去执行任务。但大量Windows用户卡在了安装这一步环境依赖多、网络下载慢、镜像源不通经常折腾一下午还没跑起来。这篇文章就是把我在Windows上反复安装OpenClaw的整套经验整理出来核心思路是“一键安装脚本 国内镜像源加速”让从零到能跑的过程尽量压缩到十几分钟。想在本机快速把OpenClaw跑起来做二次开发的朋友这套流程可以直接抄作业。1. 先搞清楚OpenClaw是什么再决定怎么装1.1 从Clawdbot到OpenClaw这个项目解决什么问题OpenClaw前身叫Clawdbot后来项目改名并逐步完善成现在的形态。它是一个偏“个人AI助手底座”的开源框架定位是让你用一套配置就把多个大模型、多个渠道、多套工具组合起来。比如你可以让它在微信里帮你记待办在Slack里自动回复消息在Telegram上定时拉取RSS然后生成摘要发给你这些能力都通过“Skill”和“MCP工具”来扩展。它和普通聊天机器人最大的区别在于它有一个“记忆”概念可以把历史对话、任务状态、用户偏好存下来下次交互时自动调用。对于经常和AI打交道的人来说这相当于一个能积累上下文、能主动执行任务的中枢。很多人把它类比成开源的“Jarvis”虽然夸张了点但从能力边界来看确实在往那个方向走。部署方式上OpenClaw支持源码运行、Docker运行、远程服务器部署。Windows用户最常见的问题是官方脚本默认面向Linux/macOS环境直接丢到Windows的PowerShell里跑会碰壁。Docker Desktop能解决一部分问题但Docker镜像拉取在国内网络环境下又常常卡住。这就是为什么需要一套针对Windows、并且接入国内镜像源的安装方案。1.2 Windows部署的三个典型痛点和一个通用解法我帮不同朋友装过好几台Windows机器几乎每次都踩同样的坑。第一个痛点是依赖环境太碎。OpenClaw依赖Git、Node.js、Python 3.10、Docker如果用容器方式每个都要单独下载安装版本不匹配直接编译失败。对不常折腾环境的人来说光是把这几个大件装齐就够喝一壶。第二个痛点是源码下载和依赖安装非常慢。项目本身在GitHub上国内直连经常只有几十KB/s而安装脚本要从GitHub的main分支检出源码还要拉大量npm包和Python包默认源都在国外整个过程完全就是考验耐心。第三个痛点是配置文件没有图形界面全是JSON和命令行参数。新手不知道去哪里填API Key不知道模型provider怎么配更不知道微信/Slack频道的token填在哪个字段里。装完之后面对黑框框依然一脸懵。通用解法其实就一句话把“环境检查、依赖安装、源码拉取、镜像替换、配置生成”这些重复劳动全部写进一个脚本用户只需要确认参数脚本自己判断哪些步骤该做、用哪个镜像源做。这也是现在社区里fishros一键安装ROS这类工具受欢迎的原因——脚本把复杂的、容易出错的流程变成确定性的、可重复的步骤。OpenClaw的一键安装脚本思路也是一样的只是针对这个项目和Windows环境做了定制。2. 一键安装脚本的思路拆解与镜像加速选型2.1 安装脚本到底帮你干了哪几件事我整理的Windows一键安装脚本不是一个“万能神器”它的本质是一系列前置检查加上顺序执行的命令集合。脚本运行后会按顺序完成五件事检查系统环境确认Windows版本、是否启用WSL2、Docker Desktop是否安装、Git/Node/Python是否可用。安装缺失组件根据检查结果自动安装缺失的依赖并在装完后重新校验。拉取OpenClaw源码默认从GitHub main分支检出如果检测到网络异常会切换到国内可用的Git镜像地址。配置镜像源把pip源切换为清华源或阿里云源npm源切换为npmmirrorDocker拉取使用容器镜像加速器。生成初始配置文件引导填入模型API Key、选择频道类型然后输出启动命令。每一步都会打印清晰的日志哪一步失败会明确提示不会像官方脚本一样直接崩掉就没了下文。脚本里还封装了“幂等”逻辑同一台机器重复执行不会重复安装已经存在的依赖也不会生成两份冲突配置。这里有个容易被忽略的点一键脚本最大的价值不是“少打几条命令”而是“减少不确定性”。手工安装时每一步的先后顺序、参数选择、版本匹配都可能出问题出了问题又不好排查。脚本把全部流程固化下来出了问题可以直接看日志定位成功路径也是可重复的。2.2 国内镜像加速的五个关键节点既然标题里写了“国内镜像加速版”镜像这块就是核心。我实测下来OpenClaw在Windows上安装时最值得替换的镜像源有五个整理成表格方便你对照加速节点默认源国内镜像方案加速效果Git源码拉取github.com 直接clone使用gitclone.com或镜像站作为Git替代地址解决clone失败、速度慢问题pip依赖pypi.org清华TUNA或阿里云pip源从几KB/s提升到几MB/snpm依赖registry.npmjs.orgnpmmirror.com安装时间明显缩短Docker镜像Docker Hub阿里云/腾讯云容器镜像加速器拉取openclaw镜像不再超时HuggingFace模型文件huggingface.cohf-mirror.com模型和Embedding文件能正常下载gitclone.com这个服务我用了挺久它能将GitHub仓库以镜像方式克隆下来用法是把原来git clone https://github.com/xxx/yyy.git里的github.com替换成gitclone.com/github.com/xxx/yyy.git实测clone的大仓库速度能提升很多。如果项目文件很大还可以考虑用--depth1只拉最新提交进一步减少下载量。pip和npm的加速操作比较直接pip在用户目录下创建pip.ini写入清华源地址npm执行npm config set registry https://registry.npmmirror.com。Docker Desktop则是在设置里的Docker Engine配置中加入registry-mirrors字段。这几个配置写进脚本后新机器部署基本不用再手动碰。最后是HuggingFace镜像。OpenClaw有些内置模型或Skill需要从HuggingFace拉权重文件默认源在国内很难连通。配置环境变量HF_ENDPOINThttps://hf-mirror.com后相关文件下载就会走镜像省掉很多麻烦。2.3 版本选择脚本安装、Docker安装还是源码安装OpenClaw在Windows上的安装方式大致有三种我建议你在跑一键脚本前先确认自己该走哪条路线。第一种是Docker安装这也是官方推荐的方式。OpenClaw仓库里提供了docker-compose配置会把运行环境和依赖一起打包宿主机的污染最小。缺点是Windows上必须先装Docker Desktop而且Docker Desktop本身依赖WSL2老机器或家庭版Windows配置起来比较费劲。一键脚本如果检测到Docker Desktop已安装默认就会走Docker路线。第二种是源码安装适合要改OpenClaw源码、做深度二次开发的场景。脚本从GitHub main分支检出新源码创建Python虚拟环境然后通过pip和npm把依赖装好。这种方式启动速度比Docker快调试也方便但环境容易受系统Python和Node版本影响。官方安装脚本支持通过--git参数指定这种安装方式本质上就是绕过容器直接用本机环境运行。第三种是纯集成包方式社区里有人打包了Windows离线整合包把Python、Node、OpenClaw依赖都打好包解压即用甚至有人传到网盘分享。这种方式省事但缺点是版本锁定、升级困难而且来源不明不建议作为主力方案最多是用来快速体验一下界面。我的建议很直接只是想体验和日常使用用Docker路线准备长期开发或改动源码用源码安装。一键脚本会同时兼容这两条路根据你机器上的环境自动选择优先方式。3. Windows环境实操从准备到跑通3.1 环境自检Windows版本、WSL2与Docker Desktop开始安装之前建议先花两分钟确认三件事能避免后面一大半的坑。操作系统方面OpenClaw的Docker模式要求Windows 10 2004以上或Windows 11并且必须开启WSL2。在PowerShell里执行wsl --status可以看到WSL版本如果显示是WSL 1需要运行wsl --set-default-version 2升级。如果提示找不到WSL命令说明系统组件没装全执行wsl --install先装上。Docker Desktop方面装完后确认右下角小鲸鱼图标是否稳定运行。注意在Docker Desktop的Settings - Resources - WSL Integration里要确保“Enable integration with my default WSL distro”是勾选状态否则后面docker命令在WSL里可能找不到daemon。Git和Node.js方面至少要有Git 2.30、Node.js 18。在PowerShell里执行git --version和node -v就能看到版本。如果没装脚本会提示你安装但我建议提前装好因为有些Windows用户机器上Git的PATH没配对脚本调用git时会直接报错。一个容易踩的细节如果你以前装过旧版Python或者多个版本的Node系统PATH里可能存在冲突。打开“设置 - 系统 - 关于 - 高级系统设置 - 环境变量”把不用的Python路径清掉只保留一个版本。我见过好几个案例脚本执行到一半调用的pip是另一个Python版本的导致依赖装错位置服务死活起不来。3.2 一键脚本的下载、执行与参数说明环境自检没问题后就可以跑一键脚本了。脚本以PowerShell脚本形式提供下载到本地后右键选择“使用PowerShell运行”或者打开PowerShell窗口切换到脚本目录执行Set-ExecutionPolicy -Scope Process Bypass .\install-openclaw.ps1 -Mode docker -ModelProvider openai-Mode参数用来指定安装路线可选docker或source-ModelProvider用来指定默认模型供应商比如openai、anthropic、ollama等。脚本会先读取这些参数再结合机器上的环境自动决定后续步骤。如果你是第一次运行脚本会在拉取源码之前弹出确认提示让你看清楚即将执行的命令。这一步建议别直接跳过它会显示当前机器缺少哪些依赖、准备用哪个镜像源方便你及时发现异常。比如脚本检测到Docker Desktop没装它会在屏幕上提示“Docker未安装切换到源码安装模式”而不是傻等超时。如果只想用默认配置快速跑通可以直接不带参数执行.\install-openclaw.ps1脚本会默认选择Docker模式如果Docker可用模型供应商默认读取本机已配置的Ollama服务。我个人建议第一次装用Ollama作为provider因为不需要申请额外的API Key本地跑一个小模型就能体验OpenClaw的核心流程。脚本执行过程中日志里会出现类似[STEP 3/8]的进度标识每步结束还会显示耗时。我实测过在一台网络正常的Windows 11机器上全部步骤跑完大概需要8到15分钟时间主要花在拉取源码和Docker镜像上。如果中途某一步失败脚本不会继续往下走而是直接停在出错的步骤并给出错误日志的文件路径方便排查。3.3 初始化配置模型接入、频道接入与验证运行安装完成只是第一步真正让OpenClaw“开口说话”的是配置文件。脚本结束后会在用户目录下生成.openclaw文件夹里面有一份config.json这是整个框架的核心配置。如果你选择Ollama作为provider配置里最主要的内容是本地模型名称和Ollama服务地址{ provider: ollama, model: qwen2.5:7b, ollama_base_url: http://localhost:11434, memory: { enabled: true, type: local }, channels: { cli: { enabled: true } } }确认Ollama本地服务在跑并且已经拉取了qwen2.5:7b模型后执行openclaw serve启动服务再开一个窗口执行openclaw进入交互界面就能在终端里直接和OpenClaw对话了。如果你想把OpenClaw接进微信或Telegram需要在channels节点下相应位置填入Bot Token等信息。微信的接入相对复杂一些依赖网页版协议有风控风险我不建议把它作为第一个练手项目Telegram的Bot接入则非常简单在BotFather创建一个Bot拿到Token填进配置后重启服务就能在Telegram里和它对话了。验证运行的关键点是看日志里是否出现started或者listening字样。如果只看到进程在跑但没有监听任何端口多半是配置里的channel没配对或者API Key无效。这时候优先看日志输出不要盲目重启服务。4. 常见问题与排查技巧实录4.1 失败场景速查表这段时间帮人排查安装问题我整理了一份高频问题速查表。遇到问题时先对照这张表能少走不少弯路。现象直接原因解决方法Docker命令提示无法连接到daemonDocker Desktop没启动或WSL集成没开启动Docker Desktop确认WSL Integration勾选git clone时报SSL证书错误Git的SSL验证受公司网络/安全软件影响临时执行git config --global http.sslVerify false测试pip安装依赖时超时未配置pip国内镜像或镜像失效检查pip.ini配置切换为阿里云镜像npm install时卡在node-gyp缺少Visual Studio Build Tools组件安装VS Build Tools或换用Docker模式安装openclaw启动后立即退出config.json格式错误或缺失API Key用openclaw --debug启动查看具体报错OLLAMA服务连接失败Ollama没启动或端口冲突访问http://localhost:11434确认服务在线Docker镜像拉取超时镜像加速器配置错误到Docker Engine配置里检查registry-mirrors字段这里特别提醒一点如果是一键脚本已经成功执行但OpenClaw启动时报缺模块或者编译错误最可能的原因是Python版本不匹配。OpenClaw对Python版本要求比较严格官方推荐3.10到3.12之间。Windows上如果装了Python 3.13某些依赖包还没有预编译的wheel会现场编译然后失败。换成3.11版本大概率能解决问题。还有一次遇到的情况比较少见脚本执行到一半时断电重启后Docker Desktop的镜像加速器配置丢失了。原因是Docker Desktop的设置文件在用户目录下异常退出可能导致配置文件回滚。解决办法是重新在Settings里加上镜像加速地址再执行一次docker info确认配置生效。4.2 版本升级与维护别让“一键”变成“一次性”很多一键安装脚本“装完就完升级靠人肉”这是我最不喜欢的地方。OpenClaw迭代速度很快隔几天就有新Skill或新功能发布所以把这套安装脚本的升级能力也讲一下。如果你用的是源码安装模式升级非常简单。OpenClaw仓库提供了一个更新脚本也可以手动进入源码目录执行git pull origin main pip install -r requirements.txt npm install如果你想重新跑一遍一键安装脚本来升级脚本里也加了-Update参数。执行.\install-openclaw.ps1 -Update脚本会跳过环境检查直接拉取最新源码并更新依赖比手动执行上面三条命令更省心。Docker模式升级则是拉取新的Docker镜像然后重建容器docker compose pull docker compose up -d这里有个细节OpenClaw的记忆和历史数据是以文件或SQLite形式存储在数据卷里的正常升级不会清空数据。但如果你手动删除了容器一定要先把~/.openclaw目录备份出来否则聊天记录、任务状态这些全部归零。维护方面最需要注意的就是缓存目录越来越占空间。npm和pip的缓存、Docker镜像的历史层都会悄悄吃掉几个GB。建议每隔一两个月清理一次清理pip缓存pip cache purge清理npm缓存npm cache clean --force清理Docker悬空镜像docker image prune我在实际使用中发现另一个坑Windows的Defender有时会把OpenClaw的某些Skill文件当成威胁直接隔离导致Skill加载失败。遇到这种情况需要在“病毒和威胁防护 - 排除项”里把.openclaw目录和源码目录加进去同时确认自己下载的安装脚本来源可靠。最后分享一个小技巧如果你在Windows上装的是源码版本使用Windows Terminal比PowerShell原生窗口体验好很多不仅支持复制粘贴更顺手日志滚动也更流畅。把OpenClaw的启动命令保存为一个.bat文件放在桌面双击就能启动不用每次打开终端手动敲命令。到了升级的时候再执行一遍-Update参数整个过程就很顺滑了。