夜雨聆风纯Windows原生、零门槛、全流程一步到位，新手照着做即可。
一、系统要求（必看）
•Windows 10 1903+ / Windows 11（64位）
•内存 ≥4GB（推荐8GB+）
•磁盘 ≥1GB剩余空间
•稳定外网（国内用镜像加速）
二、安装Git（必装，拉取代码/依赖）
1. 下载Git
https://release-assets.githubusercontent.com/github-production-release-asset/23216272/6bb4833a-507b-49e5-8490-e79102763cfc?sp=r&sv=2018-11-09&sr=b&spr=https&se=2026-03-11T06%3A20%3A53Z&rscd=attachment%3B+filename%3DGit-2.53.0-64-bit.exe&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2026-03-11T05%3A20%3A22Z&ske=2026-03-11T06%3A20%3A53Z&sks=b&skv=2018-11-09&sig=O1bRvf7dorlVy27whWSXDSmFeYpz4CEr9OKMrsBhuzs%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc3MzIwODU1NSwibmJmIjoxNzczMjA2NzU1LCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ.egDdjX6x927enyX2m2Hab45aQoXiQNb3XdjwlwACveY&response-content-disposition=attachment%3B%20filename%3DGit-2.53.0-64-bit.exe&response-content-type=application%2Foctet-stream2. 安装Git（关键设置）
•安装路径：默认即可（避免中文/空格）
•组件：勾选Git Bash Here、Git GUI Here
•PATH环境：选Git from the command line and also from 3rd-party software（必须）
•其余默认 → Install → Finish
3. 验证Git
打开普通PowerShell：
git --version |
输出版本号 → 成功。
三、安装Node.js（含npm，运行环境）
1. 下载Node.js（v22 LTS，必须≥22）
国内镜像：
https://registry.npmmirror.com/binary.html?path=node/latest-v22.x/下载node-v22.x.x-x64.msi
2. 安装Node.js（关键设置）
•勾选同意 → Next
•安装路径：默认即可
•务必勾选：Automatically install necessary tools（防编译报错）
•Next → Install → Finish
3. 验证Node/npm
关闭终端重开，执行：
node -v# ≥v22.0.0 npm -v# 自动安装 |
输出版本号 → 成功。
4. 配置npm国内镜像（加速，必做）
npm config set registry https://registry.npmmirror.com |
四、解锁PowerShell脚本权限（首次必做）
1.Win+X → 打开终端(管理员)
2.执行，输入Y确认：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force |
3.验证：Get-ExecutionPolicy → 显示RemoteSigned即成功。
五、一键安装OpenClaw（国内镜像）
关闭管理员终端，打开普通PowerShell，粘贴执行：
# 国内专用，解决超时/下载慢 iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex |
•自动安装pnpm、下载OpenClaw、配置国内源
•等待5–10分钟，出现Installation completed successfully → 完成。
六、验证OpenClaw安装
openclaw --version |
输出版本号（如2026.3.12）→ 成功。
七、首次初始化（onboard）
openclaw onboard --flow quickstart |
按提示选择（新手直接照抄）：
4.是否理解高风险能力？→ yes
5.选择通信通道？→ web（网页端）
6.端口默认：18789（不要改）
7.模型选择：先选自定义（后续对接阿里百炼）
八、启动OpenClaw网关
openclaw gateway start |
•成功提示：Gateway running on http://127.0.0.1:18789
•浏览器打开：http://127.0.0.1:18789 → 进入后台。
九、对接阿里百炼大模型（核心）
1. 准备阿里百炼AK/SK
•登录阿里云 → 进入百炼平台（https://www.aliyun.com/product/bailian）
•左侧：密钥管理 → 创建API Key
•复制保存AccessKey ID和AccessKey Secret（⚠️ 不要泄露）
2. 一键配置百炼（命令行，直接复制）
打开普通PowerShell，替换你的AK/SK后执行：
# 1. 配置百炼密钥 openclaw config set models.providers.bailian.accessKeyId "你的AccessKey ID" openclaw config set models.providers.bailian.accessKeySecret "你的AccessKey Secret" # 2. 配置国内接口地址（必设） openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1" # 3. 设置默认模型（推荐qwen3.5，免费额度充足） openclaw config set models.default "bailian/qwen3.5-turbo" # 4. 优化超时（可选） openclaw config set models.providers.bailian.timeout 60000 # 5. 重启网关生效 openclaw gateway restart |
3. 验证百炼连接
openclaw model test |
提示Model test passed → 对接成功。
十、常用命令（收藏）
# 启动网关 openclaw gateway start # 停止网关（Ctrl+C 也可） openclaw gateway stop # 重启网关 openclaw gateway restart # 查看状态 openclaw gateway status # 查看版本 openclaw --version # 开机自启（推荐） openclaw onboard --install-daemon # 测试模型连接 openclaw model test |
十一、常见问题（避坑）
•命令找不到：关闭终端重开，再验证node -v/git --version
•安装超时：用国内镜像命令（上面已给）
•端口占用：改端口openclaw config set gateway.port 18790
•权限不足：始终用管理员PowerShell执行权限/安装命令
•旧版冲突：
npm uninstall -g clawdbot moltbot openclaw |
再重新安装
•百炼连接失败：检查AK/SK是否正确、是否有免费额度、网络是否正常
十二、下一步
打开http://127.0.0.1:18789 → 开始使用OpenClaw + 阿里百炼大模型。
