windows10本地部署openclaw

(1)Windows 10/11系统
  1. 管理员模式打开PowerShell,安装Node.js(v24.x稳定版,2026年最优适配):

    复制代码
    # 国内镜像加速,避免下载超时
    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
  2. 验证安装:

    复制代码
    node --version  # 需显示v24.x.x
    npm --version   # 需显示v10.x.x及以上

    这里特别要注意node版本得是v24以上

    1. OpenClaw核心安装与初始化
  3. 全局安装OpenClaw:

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

    powershell

    复制代码
    npm install -g openclaw@latest --ignore-scripts
  2. 遇到问题总结(1):

    复制代码
    [openclaw] Unhandled promise rejection: TypeError: Invalid URL
        at new URL (node:internal/url:826:25)
        at #getUrl (C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\node_modules\undici\lib\dispatcher\proxy-agent.js:231:14)
        at new ProxyAgent (C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\node_modules\undici\lib\dispatcher\proxy-agent.js:109:29)
        at new EnvHttpProxyAgent (C:\Users\Administrator\AppData\Roaming\npm\node_modules\openclaw\node_modules\undici\lib\dispatcher\env-http-proxy-agent.js:28:31)
        at file:///C:/Users/Administrator/AppData/Roaming/npm/node_modules/openclaw/node_modules/@mariozechner/pi-ai/dist/utils/http-proxy.js:11:29

    解决办法(1):

    复制代码
    # powershell 命令
    $env:HTTP_PROXY = ""
    $env:HTTPS_PROXY = ""

    (2)Gateway 无法访问(127.0.0.1 refused)

    原因可能有两类:

    1. Gateway 没启动
    2. 端口未开放 / 被占用

    正确启动方式:

    复制代码
    openclaw gateway

    然后访问:

    http://127.0.0.1:18789

    或
    http://localhost:18789

    (端口可能随配置不同)

    若你启用了 dev 模式,端口变为 19001:

    复制代码
    openclaw --dev gateway
    1. 验证安装:

      复制代码
      openclaw --version  # 需显示2026.x.x及以上版本
    2. 初始化工作空间:

      复制代码
      # 创建工作目录(存储配置、技能与数据)
      mkdir ~/OpenClaw-Workspace && cd ~/OpenClaw-Workspace
      # 初始化配置,按提示选择默认值(新手无需修改)
      openclaw init
    3. 启动服务与访问控制台
    1. 启动Gateway服务:

      复制代码
      # 前台启动(测试用,关闭终端服务停止)
      openclaw gateway start
      # 后台启动(推荐,支持关闭终端后持续运行)
      # Windows(PowerShell):Start-Job -ScriptBlock {openclaw gateway start}
      # MacOS/Linux:nohup openclaw gateway start &
    2. 访问控制台:

      1. 浏览器输入http://localhost:18788,无需登录直接进入操作界面,本地部署完成。
相关推荐
科研邪修法34 分钟前
PDF新增页面文字与文本批注怎么区分?以双版本培训讲义为例
前端·css·pdf
wuyk5552 小时前
Python办公自动化-第01讲-环境搭建与自动化认知
python·自动化·pyqt
Lanwarf-前端开发2 小时前
Vue3 + Canvas/WebGL 雷达扫描可视化实战:PPI、RHI、VOL、SVOL 四种模式原理与实现
前端·javascript·vue.js·webgl
高洁012 小时前
数字孪生与计算机视觉:让机器看懂现场
人工智能·python·机器学习·transformer·迁移学习
ComPDFKit2 小时前
RAG 回答只显示 PDF 文件名?用 Python 保留引用页码
开发语言·python·pdf·rag
FRing033 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
yz_aiks4 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
锋行天下4 小时前
langgraph 全栈项目(三)
前端·人工智能·后端
锋行天下5 小时前
langgraph 全栈项目(二)
前端·人工智能·后端