windows10本地部署openclaw

本文章主要是自己手动在windows10部署openclaw遇到的问题以及部署步骤总结
1. 前置依赖安装（核心工具：Node.js）

（1）Windows 10/11系统

• 管理员模式打开PowerShell，安装Node.js（v24.x稳定版，2026年最优适配）：
  1. # 国内镜像加速，避免下载超时
  2. iwr -useb https://npmmirror.com/mirrors/node/v24.5.0/node-v24.5.0-x64.msi -OutFile node-install.msi
  3. Start-Process .\node-install.msi -Wait

  复制代码
   
  
• 验证安装：
  1. node --version  # 需显示v24.x.x
  2. npm --version   # 需显示v10.x.x及以上

  复制代码
  这里特别要注意node版本得是v24以上
  
• 2. OpenClaw核心安装与初始化
  
• 全局安装OpenClaw：
  
• 1. npm install -g openclaw@latest

  复制代码
   
  
• 第三个需要注意的问题：由于 Windows 下编译`node-llama-cpp` 可能失败，建议使用`--ignore-scripts`跳过本地 LLM 编译(如需本地 LLM 支持，需先安装 Visual Studio Build Tools)
  powershell
  1. npm install -g openclaw@latest --ignore-scripts

  复制代码
• 遇到问题总结（1）：
  1. [openclaw] Unhandled promise rejection: TypeError: Invalid URL
  2.     at new URL (node:internal/url:826:25)
  3.     at #getUrl (C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\node_modules\undici\lib\dispatcher\proxy-agent.js:231:14)
  4.     at new ProxyAgent (C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\node_modules\undici\lib\dispatcher\proxy-agent.js:109:29)
  5.     at new EnvHttpProxyAgent (C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\node_modules\undici\lib\dispatcher\env-http-proxy-agent.js:28:31)
  6.     at file:///C:/Users/Administrator/AppData/Roaming/npm/node_modules/openclaw/node_modules/@mariozechner/pi-ai/dist/utils/http-proxy.js:11:29

  复制代码
  解决办法(1)：
  1. # powershell 命令
  2. $env:HTTP_PROXY = ""
  3. $env:HTTPS_PROXY = ""

  复制代码
  (2)Gateway 无法访问（127.0.0.1 refused）
  
  原因可能有两类：
  
  
  
  • Gateway 没启动
    
  • 端口未开放 / 被占用
    
  正确启动方式：
  1. openclaw gateway

  复制代码
   
  然后访问：
  http://127.0.0.1:18789
  或
  http://localhost:18789
  （端口可能随配置不同）
  若你启用了 dev 模式，端口变为 19001：
  1. openclaw --dev gateway

  复制代码
   
   
   
  
  
• 
  
  • 验证安装：
    1. openclaw --version  # 需显示2026.x.x及以上版本

    复制代码
     
    
  • 初始化工作空间：
    1. # 创建工作目录（存储配置、技能与数据）
    2. mkdir ~/OpenClaw-Workspace && cd ~/OpenClaw-Workspace
    3. # 初始化配置，按提示选择默认值（新手无需修改）
    4. openclaw init

    复制代码
     
    
  3. 启动服务与访问控制台
  
  
  
  
  • 启动Gateway服务：
    1. # 前台启动（测试用，关闭终端服务停止）
    2. openclaw gateway start
    3. # 后台启动（推荐，支持关闭终端后持续运行）
    4. # Windows（PowerShell）：Start-Job -ScriptBlock {openclaw gateway start}
    5. # MacOS/Linux：nohup openclaw gateway start &

    复制代码
     
    
  • 访问控制台：
    
    
    • 浏览器输入http://localhost:18788，无需登录直接进入操作界面，本地部署完成。
      
    • 
      
       
      
      
      
       
      
      
      
       
      
      
      
       
      
      
      
       
      
      
      
       
      
    
    
  
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

不错，里面软件多更新就更好了