windows10本地部署openclaw
澳盒教恍前置依赖安装（核心工具：Node.js）
（1）Windows 10/11系统
正确的安装始于一个稳定的运行环境。在Windows 10或11上，请右键点击PowerShell，选择“以管理员身份运行”进行后续操作。Node.js是本项目的核心依赖，你必须安装v24.x长期支持版（LTS）以确保最佳的兼容性与稳定性。
为优化下载速度并避免网络问题，建议通过以下命令使用国内镜像进行安装：
iwr -useb https://npmmirror.com/mirrors/node/v24.5.0/node-v24.5.0-x64.msi -OutFile node-install.msi
Start-Process .\node-install.msi -Wait
安装向导结束后，务必进行环境验证。新开一个命令行窗口，依次执行以下命令：
node --version # 输出应为 v24.x.x
npm --version # 输出应为 v10.x.x 或更高
Node.js的版本正确是后续一切操作的基础，版本不符将直接导致依赖解析失败或运行时错误。
2. OpenClaw核心安装与初始化
基础环境就绪后，开始安装OpenClaw本体。通过npm全局安装其最新稳定版本：
npm install -g openclaw@latest
Windows环境下，安装过程可能因编译`node-llama-cpp`原生模块而中断。若你暂不需要本地大语言模型功能，最稳妥的方式是使用`--ignore-scripts`参数跳过此环节。反之，你需要预先安装好完整的Visual Studio Build Tools以提供编译支持。
因此，通用的安装命令如下：
npm install -g openclaw@latest --ignore-scripts
安装时可能遇到的典型报错与修复方案：
常见错误（1）：
[openclaw] Unhandled promise rejection: TypeError: Invalid URL...
解决方案(1)：
此错误通常源于系统残留的代理配置。在PowerShell中运行以下命令清除环境变量：
$env:HTTP_PROXY = ""
$env:HTTPS_PROXY = ""
（2）Gateway 无法访问（127.0.0.1 refused）
无法访问本地控制台，通常意味着Gateway服务未成功启动，或端口被占用、被防火墙拦截。
请使用以下命令启动服务：
openclaw gateway
服务启动后，在浏览器地址栏输入：
http://127.0.0.1:18789 或 http://localhost:18789
（请注意，实际端口号取决于你的具体配置）
若以开发模式启动，则默认端口为19001：
openclaw --dev gateway
安装完成后，立即验证安装版本：
openclaw --version # 应显示 2026.x.x 或更高版本
最后，为你的项目初始化一个独立的工作空间：
# 创建专属工作目录，用于存放配置文件、技能插件及数据
mkdir ~/OpenClaw-Workspace && cd ~/OpenClaw-Workspace
# 运行初始化向导，初次使用可全部接受默认配置
openclaw init
3. 启动服务与访问控制台
完成所有配置后，即可启动服务。启动Gateway有两种模式：
前台启动模式，便于调试和查看实时日志，终端关闭则服务停止：
openclaw gateway start
后台守护进程模式，适用于生产环境，服务在后台持续运行：
- Windows（PowerShell）:
Start-Job -ScriptBlock {openclaw gateway start} - MacOS/Linux:
nohup openclaw gateway start &
服务成功运行后，在浏览器中访问 http://localhost:18788。默认无需身份验证，你将直接进入OpenClaw的Web管理控制台。至此，本地部署流程全部完成。
934697070286ced332721fe857d8534
621ccf5a92179bca9a4ab2323c0c1c8
75c2b59f8e53d8b3b841853c4e50c25
e5fac8051a02fb4f65eecd26d15e8ac
56ec506b8d2c60c529e256f9edd2789
41a35a33b7411805c10b046c089e61f