纯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 + 阿里百炼大模型。
夜雨聆风