windows10上本地部署openclaw
创始人
2026-03-12
0

在 Windows 10 上部署 OpenClaw 的过程已经在 2026 年进一步简化,官方和社区都提供了“一键脚本”方案,您可以通过 PowerShell 快速完成安装、配置和启动。以下是基于最新信息(2026 年)的详细部署指南:

1. 环境准备(硬件与软件要求)

在开始之前,请确认您的电脑符合以下基本要求:

  • 系统:Windows 10 (64位) 或 Windows 11

  • 内存:建议 8GB 以上(如果您计划运行本地大模型,建议 16GB 以上)

  • 磁盘空间:至少 20GB(推荐 50GB 以上,尤其是需要下载模型文件时)

2. 安装基础依赖

OpenClaw 主要基于 Node.js 环境运行,您需要先安装 Node.js、Git 和 PowerShell 权限。

2.1 安装 Node.js (建议 22.x LTS 版)

  1. 方式 A(推荐)‍:直接下载官方 MSI 安装包

    • 访问 Node.js 官网(nodejs.org),下载 22.x LTS 版本的 Windows Installer(.msi 文件)。

    • 安装时务必勾选 ‍“Add to PATH”‍(添加到环境变量)选项。

  2. 方式 B:使用 Windows 包管理器 (winget)

    winget install OpenJS.NodeJS.LTS --version 22.1.0 -y
    • 打开 PowerShell,执行以下命令:

2.2 安装 Git

  • 访问 Git 官方网站(git-scm.com),下载并安装 64 位版本的 Git 客户端。

2.3 配置 PowerShell 执行策略

由于 OpenClaw 的一键安装脚本是 PowerShell 脚本,您需要解除系统的安全限制:

  1. 右键开始菜单图标,选择 ‍“Windows PowerShell(管理员)”‍ 以管理员身份打开终端。

  2. 执行以下命令以允许运行本地脚本:

    Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

3. 执行一键安装脚本

OpenClaw 官方提供了非常强大的“一键安装”脚本,您只需要在 PowerShell 中执行一条命令即可自动完成下载、安装和基础配置。

3.1 执行安装命令

在管理员 PowerShell 中输入以下命令并回车:

iwr -useb https://openclaw.ai/install.ps1 | iex

此命令会从官方服务器拉取安装脚本并执行。

3.2 处理可能的网络问题

  • Code 128 错误:如果在执行过程中出现 code 128 错误,通常是因为网络环境不佳(如下载依赖被墙)。建议更换网络环境或使用加速器重试。

  • 下载速度慢:如果下载 Node.js 或依赖时速度很慢,您可以尝试使用国内镜像源(如 cnpm)安装 Node.js 或 Git,然后重新运行脚本。

4. 完成安装后的初始化配置

一键脚本执行完毕后,您需要进行一次快速的“引导”(Onboarding)来配置大模型和使用界面。

4.1 启动配置向导

在同一个 PowerShell 窗口中,执行以下命令:

openclaw onboard
  • 此命令会启动一个交互式的配置向导。

  • 模型选择:如果您已经有本地的大模型(如 Ollama),请选择对应的模型名称;如果没有,系统会建议您使用在线模型(需要联网)。

  • 技能安装:系统通常会默认安装一些基础技能,您可以根据需要选择安装更多技能。

4.2 启动 OpenClaw 服务

配置完成后,启动 OpenClaw 服务:

openclaw start

默认情况下,OpenClaw 会在本地启动一个 Web UI 服务,监听 http://127.0.0.1:1878 。

5. 验证部署成功

打开您常用的浏览器(Chrome、Edge 等),在地址栏输入:

http://127.0.0.1:1878

如果看到 OpenClaw 的控制台界面,并且可以发送消息进行对话,说明部署成功了。


常见问题排查

  1. ‍“node” 不是内部或外部命令:说明 Node.js 未正确添加到环境变量。请重新安装 Node.js 并勾选 “Add to PATH” 选项。

  2. ‍“npm -v” 提示错误:可能是 Git 未安装或 PowerShell 权限不足。确保 Git 已安装且 PowerShell 以管理员身份运行。

  3. 本地模型下载过慢:如果您打算运行本地大模型(如 Qwen3.5:9b),下载模型文件可能需要很长时间(甚至超过 10GB)。建议使用高速网络或在网络条件允许的情况下下载。

参考来源

  • 一键脚本:iwr -useb https://openclaw.ai/install.ps1  | iex

  • Node.js 安装:建议下载 22.x LTS 版本

  • PowerShell 配置:Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force


【版权声明】
本站部分内容来源于互联网,本站不拥有所有权,不承担相关法律责任。如果发现本站有侵权的内容,欢迎发送邮件至masing@13sy.com 举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。

相关内容

热门资讯

windows10上本地部署o... 在 Windows 10 上部署 OpenClaw 的过程已经在 2026 年进一步简化,官方和社区...
Cursor、Dify、n8... 对 Cursor、Dify、n8n 三个工具在核心定位、功能特性、定价模型、适用场景等多个维度进行了...
openclaw部署到本地wi... 在 Windows 10 个人电脑上部署 OpenClaw(2026 版)通常有两种路径:原生 Wi...
openclaw官方版本安装后... 在成功安装 OpenClaw 官方版本后,添加飞书 Bot 通常需要经过 插件安装 与 飞书端配置 ...