windows如何安装openClaw以及配置阿里云百炼(2026.3.19)

最近准备研究openClaw记录一下。1.安装前准备1.安装node.js目前对于openClaw安装需要的是大于 22版本的.本人这里是直接安装的是23.9.0C:\Users\Administratornode -vv23.9.02.记得安装好git2.安装openClaw报错打开 Windows PowerShell 开始进行安装。常规的安装命令为npm install -g openclawlatest2.1 Visual C 运行时库或系统环境不匹配而失败如果没有报错直接跳过报错的话就看这里。这个错误在deepSeek上的解释是预编译二进制加载失败textFailed to load a prebuilt binary ... A dynamic link library (DLL) initialization routine failed.这表明node-llama-cpp尝试加载针对 Windows x64 的预编译原生模块llama-addon.node时由于缺少 Visual C 运行时库或系统环境不匹配而失败。缺少构建工具在预编译二进制失败后安装脚本尝试从源码编译但需要 CMake 和xpm工具xpm命令未找到。进一步导致 CMake 下载失败最终构建过程退出。权限问题清理旧目录时出现EPERM操作不允许可能是当前命令行没有以管理员身份运行导致无法删除某些文件。然后我的解决方案是:1.安装官方构建工具1打开https://visualstudio.microsoft.com/zh-hans/downloads/2下载名为vs_BuildTools.exe的安装程序2.安装安装关键组件1运行下载好的 vs_BuildTools.exe。2在安装程序中你会看到一个工作负载列表。请务必勾选以下两个核心项 使用C的桌面开发这是编译原生Node.js模块所需编译器的来源。Windows 11 SDK (或适用于你系统的 Windows 10 SDK)这提供了编译必需的Windows头文件和库。3在右侧的“安装详细信息”窗格中确保 MSVC v143 - VS 2022 C x64/x86 生成工具(最新) 这个选项也被勾选上它通常是默认勾选的。4点击右下角的“安装”按钮等待下载和安装完成。这个过程可能需要几分钟时间请耐心等待。3.重启电脑1打开 Visual Studio Installer在开始菜单搜索 Visual Studio Installer 并打开找到已安装的 Visual Studio Build Tools 2026点击 修改2确保勾选以下所有组件✅ 使用C的桌面开发├── ✅ MSVC v143 - VS 2022 C x64/x86 生成工具最新├── ✅ Windows 11 SDK (10.0.22621.0 或更高)├── ✅ C CMake 工具├── ✅ 适用于 v143 生成工具的 C ATL可选建议装└── ✅ 适用于 v143 生成工具的 C MFC可选建议装3点击右下角 修改等待安装完成4重启电脑必须确保环境变量生效4.验证重启后在管理员 PowerShell 中运行# 应该能看到类似路径如 C:\Program Files\Microsoft Visual Studio\2026\BuildTools\VC\$env:VCToolsInstallDir# 检查 cl.exe 编译器Get-Command cl.exe -ErrorAction SilentlyContinue# 如果上面没输出尝试加载编译环境 C:\Program Files\Microsoft Visual Studio\2026\BuildTools\Common7\Tools\Launch-VsDevShell.ps15.清理缓存重新安装# 清理缓存 卸载旧版npm cache clean --force npm uninstall -g openclaw# 全局安装npm install -g openclawlatest2.2 TLS版本过旧按照2.1进行处理后如果还是报错PS D:\DEV\openclaw npm cache clean --force npm warn using --force Recommended protections disabled. PS D:\DEV\openclaw npm uninstall -g openclaw removed 1 package in 664ms PS D:\DEV\openclaw iwr -useb https://openclaw.ai/install.ps1 | iex iwr : 请求被中止: 未能创建 SSL/TLS 安全通道。 所在位置 行:1 字符: 1 iwr -useb https://openclaw.ai/install.ps1 | iex ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ CategoryInfo : InvalidOperation: (System.Net.HttpWebRequest:HttpWebRequest) [Invoke-WebRequest]WebExce ption FullyQualifiedErrorId : WebCmdletWebResponseException,Microsoft.PowerShell.Commands.InvokeWebRequestCommand PS D:\DEV\openclaw因为截图没了只能贴代码块错误分析iwr : 请求被中止: 未能创建 SSL/TLS 安全通道这个错误意味着你的 PowerShell 无法与openclaw.ai建立安全连接常见原因PowerShell 默认 TLS 版本过低你的系统可能只启用了旧版 TLS解决方案1.强制使用TLS1.2[Net.ServicePointManager]::SecurityProtocol [Net.SecurityProtocolType]::Tls122.3安装OpenClaw1.结束所有可能正在运行的 node 进程PS D:\DEV\openclaw taskkill /F /IM node.exe 2$null2. 强制删除之前安装失败的 openclaw 文件夹PS D:\DEV\openclaw Remove-Item -Recurse -Force $env:APPDATA\nvm\v23.9.0\node_modules\openclaw -ErrorAction SilentlyContinue3. 删除可能的命令链接PS D:\DEV\openclaw Remove-Item -Force $env:APPDATA\npm\openclaw* -ErrorAction SilentlyContinue4. 清理 npm 缓存PS D:\DEV\openclaw npm cache clean --force npm warn using --force Recommended protections disabled.5.设置国内镜像加速npm config set registry https://registry.npmmirror.com6.因为本人电脑编译有问题所有直接跳过编译直接进行安装了。如果大家没问题可以跳过这一步。设置环境变量跳过 llama.cpp 的下载和编译$env:NODE_LLAMA_CPP_SKIP_DOWNLOADtrue7. 使用 --ignore-scripts 参数进行全局安装 npm install -g openclawlatest --ignore-scriptsPS D:\DEV\openclaw npm install -g openclawlatest --ignore-scripts基本上就安装好了3.进行配置由于我是先进行了配置然后再去申请的api所以我这边很多都是跳过。大家可以复制出来给deepSeek/豆包等帮大家选择一下4.申请百炼因为百炼新用户有100w额度1.进入阿里云点击左上角大模型2.点击免费体验Qwen3.5进行申请3.创建API账号。点击权限管理然后新增按要求填写即可5.绑定API和调整日志目录在 Windows PowerShell 运行notepad $env:USERPROFILE\.openclaw\openclaw.json会打开一个文件{meta: {lastTouchedVersion: 2026.2.1,lastTouchedAt: 2026-03-11T00:00:00.000Z},models: {mode: merge,providers: {bailian: {baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey: 你的API-KEY放这里,api: openai-completions,models: [{id: qwen3.5-plus,name: qwen3.5-plus,reasoning: false,input: [text, image],contextWindow: 1000000,maxTokens: 65536},{id: qwen3-coder-plus,name: qwen3-coder-plus,reasoning: false,input: [text],contextWindow: 131072,maxTokens: 32768}]}}},agents: {defaults: {model: {primary: bailian/qwen3.5-plus},models: {bailian/qwen3.5-plus: {},bailian/qwen3-coder-plus: {}}}},gateway: {mode: local,auth: {mode: token,token: test123}}}将你的API放入其中即可。2.调整日志存放目录。在上面json文件中增加logging即可。logging: {file: D:\\DEV\\openclaw\\logs\\openclaw.log},后面会重启会看到即可以上就安装完成了。