【保姆级教程】OpenClaw 在 Windows 10 / Win10 LTSC 下的完整安装指南

百万运营Pro
0 阅读5分钟

前言

OpenClaw 是一款功能强大的集成化网关工具，适用于消息通道管理、插件扩展及服务部署。本文将详细讲解在 Windows 10（含 LTSC 版本）系统中安装 OpenClaw 的完整流程，涵盖系统依赖准备、服务配置、插件安装及常见问题排查，确保你在 Win10 LTSC 环境下也能零障碍完成安装。

OpenClaw官网：openclaw.ai

一、安装前准备：配置系统必要依赖

OpenClaw 的正常运行依赖于若干基础工具。请按顺序完成以下组件的安装，Win10 LTSC 用户需特别注意某些组件需手动下载。

1. 安装 Node.js

  • 下载地址：Node.js 官网
  • 版本选择：请下载 LTS 长期支持版（推荐 22.x 或 24.x，兼容性最佳），选择 Windows 64 位安装包。
  • 安装步骤：

    1. 双击安装包，务必勾选 「Add to PATH」（自动添加至系统环境变量），其余选项保持默认，一路下一步完成安装。

    2. 验证安装：按下 Win + R，输入 cmd 打开命令提示符，执行以下命令检查版本：

      node -v
npm -v

      若显示版本号，则表示安装成功。

2. 安装 Git

  • 下载地址：Git 官网
  • 版本选择：下载 Windows 64 位安装包（Win10 LTSC 直接选默认版本即可）。
  • 安装步骤：

    1. 安装过程中保持默认选项，但请确保 「Git Bash Here」 和 「Add Git to PATH」 被勾选。

    2. 验证安装：在命令提示符中执行：

      git --version

      显示版本号即成功。

3. 安装 Visual C++ Redistributable

Win10 LTSC 系统可能缺失必要的 Visual C++ 运行库，需手动安装：

4. 安装 CMake（可选，仅源码编译时需要）

如果你计划从源码编译 OpenClaw，则需安装 CMake 并配置环境变量：

  • 下载地址：CMake 官网
  • 版本选择：选择 Windows x64 Installer。
  • 安装步骤：

    1. 安装时勾选 「Add CMake to the system PATH for all users」。

    2. 验证安装：在命令提示符中执行：

      cmake --version

      显示版本号即配置成功。

二、配置 PowerShell 执行权限（关键！Win10 LTSC 必做）

Windows 10 默认限制 PowerShell 脚本执行，若未解除限制，一键安装脚本将无法运行。请按以下步骤操作：

  1. 以管理员身份打开 PowerShell：
    按下 Win + X，选择 「Windows PowerShell (管理员)」。

  2. 依次执行以下两条命令：

    # 为当前用户设置执行策略为 RemoteSigned（允许本地脚本运行）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 临时为当前进程解除所有执行限制（避免脚本被拦截）
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

  3. 若弹出权限确认提示，输入 Y 并回车确认。

三、配置 npm 镜像（大幅提升下载速度）

国内访问 npm 官方源速度较慢，建议切换至淘宝镜像源：

# 设置 npm 镜像为淘宝源
npm config set registry https://registry.npmmirror.com/

# 查看配置是否生效
npm config list

若输出中包含 registry = "https://registry.npmmirror.com/"，则配置成功。

四、一键安装 OpenClaw 核心程序

完成以上准备后，即可执行 OpenClaw 官方提供的一键安装脚本（适用于 Win10 及 Win10 LTSC）：

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

等待脚本自动运行，期间将自动下载并安装 OpenClaw 核心组件，无需手动干预。

五、基础配置与启动

1. 启动 Gateway 服务

# 启动 OpenClaw Gateway 核心服务
openclaw gateway start

2. 初始化配置向导

首次安装建议执行重置并运行配置向导：

# 重置 onboard 配置（首次安装推荐）
openclaw onboard --reset

# 仅运行配置向导（如已重置或需修改配置）
openclaw onboard

3. 查看 Gateway 状态

# 检查 Gateway 服务是否正常运行
openclaw gateway status

若输出 Running 表示服务启动成功；若为 Stopped，请检查依赖安装是否完整。

4. 打开可视化控制面板

# 启动 OpenClaw 控制面板（自动打开浏览器）
openclaw dashboard

执行后浏览器将自动打开，进入 OpenClaw 图形化管理界面。

六、进阶配置：安装系统服务与扩展插件

1. 安装系统服务（实现开机自启）

Win10 LTSC 推荐将 OpenClaw 安装为系统服务，免去每次手动启动的麻烦：

# 完整安装向导并配置为系统服务（开机自启）
openclaw onboard --install-daemon

2. 添加消息通道

# 新增自定义消息通道
openclaw channels add

根据提示输入通道名称、类型及配置信息即可完成添加。

3. 安装插件（以企业微信插件为例）

OpenClaw 支持丰富的插件扩展，例如安装企业微信插件：

# 安装企业微信插件
openclaw plugins install @wecom/wecom-openclaw-plugin

七、常见问题排查（Win10 LTSC 专属）

  1. PowerShell 执行脚本提示权限不足

    • 请确保已按“第二部分”以管理员身份运行 PowerShell，并正确执行了 Set-ExecutionPolicy RemoteSigned 和 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass。

  2. npm 命令找不到

    • 检查 Node.js 安装时是否勾选了 「Add to PATH」。若未勾选，请手动将 Node.js 安装目录（例如 C:\Program Files\nodejs）添加到系统环境变量 Path 中。

  3. Gateway 启动失败

    • 确认 Visual C++ Redistributable 已安装且为最新版本（x64）。
    • 检查 Node.js 版本是否为 16.x 或 18.x，过高版本可能存在兼容性问题。

总结

  1. 核心准备：安装 Node.js、Git、Visual C++ 运行库，并正确配置 PowerShell 执行权限（Win10 LTSC 必须执行的两条命令）。
  2. 安装流程：配置 npm 镜像 → 执行一键安装脚本 → 启动 Gateway 并完成初始化向导。
  3. 进阶建议：安装为系统服务实现开机自启，按需添加消息通道和插件。
  4. 特别提醒：Win10 LTSC 用户需重点检查运行库安装和权限配置，其余步骤与标准 Win10 一致。

按照本指南操作，你将在 Win10/Win10 LTSC 上顺利部署 OpenClaw，享受其强大的网关管理能力。如果在安装过程中遇到其他问题，欢迎查阅官方文档 OpenClaw 或关注公众号 百万教程 获取支持。

avatar
文章
阅读
粉丝