Windows 系统 OpenClaw 部署指南
在本地搭建你的专属AI助手：OpenClaw完整部署指南
想在自己电脑上部署一个智能助理，又担心过程复杂、网络不畅？今天，我们就来详细拆解OpenClaw这款开源本地AI助手框架的部署全流程。它支持接入多种主流模型，能帮你实现对话、内容生成甚至代码辅助，关键是完全运行在你的个人计算机上。整个过程，我们将采用官方推荐的一站式脚本和国内友好的资源，即便是入门用户，也能跟着指南一步步搞定。
部署前置条件
系统与硬件需求
在开始前，先确认你的电脑是否满足这些基础条件：
操作系统：至少是Windows 10的2004版本，或者Windows 11，这是稳定运行的基石。
硬件规格：内存最好有8GB或以上（最低4GB也能跑），同时保证磁盘有超过5GB的可用空间来存放必要组件。
网络要求：只需一个普通的稳定互联网连接即可，整个过程无需任何特殊的网络工具。
基础组件部署
好了，接下来是三个必须提前装好的“地基”软件。
1. Node.js 环境配置
为了保证最佳的兼容性，这里需要安装指定的v24.11.1版本。操作很简单：以管理员身份打开PowerShell窗口，然后依次输入并执行下面这两条命令：
powershell
Invoke-WebRequest -Uri https://nodejs.org/dist/v24.11.1/node-v24.11.1-x64.msi -OutFile $env:TEMP\node-v24.11.1-x64.msi
Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-v24.11.1-x64.msi /qn" -Wait安装完成后，记得关闭并重新打开一个终端窗口。输入node -v敲下回车，如果屏幕上显示v24.11.1，恭喜你，第一步已经成功了。
2. Git 工具安装
继续在同一个PowerShell窗口里，执行以下命令来获取Git：
powershell
Invoke-WebRequest -Uri https://github.com/git-for-windows/git/releases/download/v2.53.0.windows.1/Git-2.53.0-64-bit.exe -OutFile $env:TEMP\Git-2.53.0-64-bit.exe
Start-Process $env:TEMP\Git-2.53.0-64-bit.exe -ArgumentList "/VERYSILENT /NORESTART /SP- /SUPPRESSMSGBOXES" -Wait3. PowerShell 执行权限设置
最后，还需要调整一下PowerShell的执行策略。输入下面的命令，当系统询问是否更改时，输入Y并回车确认。
powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser至此，所有的预备工作就全部完成了。
系统环境配置
API 密钥准备
OpenClaw本身是一个框架，它的“大脑”需要接入外部的AI模型服务。因此，你得提前去注册并获取一个API密钥。对于国内用户来说，下面这两个选择速度和稳定性都更有保障：
阿里云Qwen：访问DashScope百炼平台，注册后创建一个API-KEY。
智普GLM：前往智普AI开放平台，完成注册流程同样可以获取密钥。
建议先把密钥复制保存到记事本里，待会儿配置时会用上。
系统环境变量验证
通常，上述软件安装时会自动配置好环境变量。但如果后续操作中，系统提示“openclaw 不是内部命令”，那很可能需要手动处理一下。这时，你需要找到npm的全局安装路径（一般位于C:\Users\[你的用户名]\AppData\Roaming\npm），然后手动将这个路径添加到系统的PATH环境变量中。
框架安装流程
OpenClaw 快速部署
真正的“一键安装”环节来了。再次以管理员身份打开PowerShell，运行下面这条官方部署脚本命令：
powershell
irm -useb https://openclaw.ai/install.ps1 | iex这个脚本非常智能，它会自动帮你做一系列检查和工作：验证PowerShell版本、检查并安装（或升级）Node.js与Git、全局部署OpenClaw软件包、配置系统变量，最后还会运行一个诊断程序。当屏幕上出现“OpenClaw installed successfully”的提示时，就表示安装成功了。
这里有个关键步骤：关闭当前的PowerShell窗口，然后重新打开一个新的，这样所有新的环境配置才会生效。
安装结果验证
在新的终端窗口里，输入验证命令：
powershell
openclaw --version如果正确显示了版本号，那么恭喜，OpenClaw框架已经稳稳地坐在你的电脑里了。
初始配置步骤
配置向导启动
接下来，通过一个交互式向导来初始化你的AI助手。执行以下命令：
powershell
openclaw onboard --install-daemon然后，跟着屏幕上的提示一步步来：
- 用户协议确认：输入
yes接受协议。 - 部署模式选择：对于大多数用户，直接选择
QuickStart（快速启动）模式就行。 - 模型服务选择：国内用户这里就选
Qwen（阿里云）或Z.AI（智普）。 - API 密钥配置：这时，请打开浏览器登录你刚才选择的平台，把准备好的API-KEY复制下来，粘贴到终端里。
- 默认模型设置：直接按回车，使用系统推荐的模型（比如
qwen-max或GLM-5）即可。 - 界面启动方式：选择
WebUI，这样它会自动为你启动图形管理界面。
配置完成后，服务会自动运行起来。记下这个地址：http://127.0.0.1:18789，它就是你的AI助手管理后台的入口。
功能验证方法
服务启动操作
如果配置完成后服务没有自动启动，或者以后需要手动启动，只需要执行一个简单的命令：
powershell
openclaw gateway start核心功能测试
打开你常用的浏览器，在地址栏输入http://127.0.0.1:18789并访问。你能看到一个简洁的聊天界面。在输入框里试着发一句“你好”。如果很快能收到AI的回复，那么，一个完全运行在你本地的智能助理就已经正式上岗了！
常见故障排除
部署过程虽然顺畅，但偶尔也会遇到些“小插曲”。这里列举几个常见问题及解决方法：
中文用户名导致的部署失败
故障表现：安装时报“spawn EINVAL”错误，或者路径显示一堆乱码。
解决方法：这通常是系统用户名包含中文导致的。解决方法是把npm的全局路径改到一个纯英文的目录。在PowerShell中执行：
powershell
npm config set prefix "D:\npm-global"
npm config set cache "D:\npm-cache"操作完成后，别忘了将D:\npm-global这个目录手动添加到系统的PATH环境变量里。
Node.js 版本不兼容问题
故障表现：启动时提示各种语法错误。
解决方法：先用node -v命令检查一下版本。如果不是v24.11.1，请务必按照本指南第一部分的方法，重新安装指定版本。
模型连接异常
故障表现：AI助手提示“API key 无效”或者“连接超时”。
解决方法：首先，双重检查你配置的API-KEY是否正确无误。对于国内用户，优先使用Qwen或GLM这类国内模型服务，并确保你的网络连接是正常的。
WebUI 无法访问问题
故障表现：浏览器访问http://127.0.0.1:18789没反应，一直打不开。
解决方法：尝试执行openclaw gateway restart命令重启服务。如果还不行，检查一下18789这个端口是不是被电脑上其他软件（比如某些虚拟机或开发工具）占用了。
走完以上所有步骤，你的OpenClaw本地AI助手就已经部署完毕，可以投入使用了。后续，你完全可以通过Web管理界面安装更多技能插件来扩展它的能力，或者配置集成到飞书等办公平台，实现随时随地调用你的私人AI顾问。