前言
OpenClaw 是一款功能强大的集成化网关工具，适用于消息通道管理、插件扩展及服务部署。本文将详细讲解在 Windows 10（含 LTSC 版本）系统中安装 OpenClaw 的完整流程，涵盖系统依赖准备、服务配置、插件安装及常见问题排查，确保你在 Win10 LTSC 环境下也能零障碍完成安装。
OpenClaw官网：https://openclaw.ai
一、安装前准备：配置系统必要依赖
OpenClaw 的正常运行依赖于若干基础工具。请按顺序完成以下组件的安装，Win10 LTSC 用户需特别注意某些组件需手动下载。
1. 安装 Node.js
- 下载地址：Node.js 官网
- 版本选择：请下载 LTS 长期支持版（推荐 22.x 或 24.x，兼容性最佳），选择 Windows 64 位安装包。
安装步骤：
- 双击安装包，务必勾选 「Add to PATH」（自动添加至系统环境变量），其余选项保持默认，一路下一步完成安装。
验证安装：按下
Win + R，输入cmd打开命令提示符，执行以下命令检查版本：node -v npm -v若显示版本号，则表示安装成功。
2. 安装 Git
- 下载地址：Git 官网
- 版本选择：下载 Windows 64 位安装包（Win10 LTSC 直接选默认版本即可）。
安装步骤：
- 安装过程中保持默认选项，但请确保 「Git Bash Here」 和 「Add Git to PATH」 被勾选。
验证安装：在命令提示符中执行：
git --version显示版本号即成功。
3. 安装 Visual C++ Redistributable
Win10 LTSC 系统可能缺失必要的 Visual C++ 运行库，需手动安装：
- 下载地址：微软官方 Visual C++ Redistributable for Visual Studio 2015-2022（64位版本）。
- 选择版本：下载 x64 版本并安装。
4. 安装 CMake（可选，仅源码编译时需要）
如果你计划从源码编译 OpenClaw，则需安装 CMake 并配置环境变量：
- 下载地址：CMake 官网
- 版本选择：选择 Windows x64 Installer。
安装步骤：
- 安装时勾选 「Add CMake to the system PATH for all users」。
验证安装：在命令提示符中执行：
cmake --version显示版本号即配置成功。
二、配置 PowerShell 执行权限（关键！Win10 LTSC 必做）
Windows 10 默认限制 PowerShell 脚本执行，若未解除限制，一键安装脚本将无法运行。请按以下步骤操作：
- 以管理员身份打开 PowerShell：
按下Win + X，选择 「Windows PowerShell (管理员)」。 依次执行以下两条命令：
# 为当前用户设置执行策略为 RemoteSigned（允许本地脚本运行） Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # 临时为当前进程解除所有执行限制（避免脚本被拦截） Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass- 若弹出权限确认提示，输入
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 专属）
PowerShell 执行脚本提示权限不足
- 请确保已按“第二部分”以管理员身份运行 PowerShell，并正确执行了
Set-ExecutionPolicy RemoteSigned和Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass。
- 请确保已按“第二部分”以管理员身份运行 PowerShell，并正确执行了
npm 命令找不到
- 检查 Node.js 安装时是否勾选了 「Add to PATH」。若未勾选，请手动将 Node.js 安装目录（例如
C:\Program Files\nodejs）添加到系统环境变量Path中。
- 检查 Node.js 安装时是否勾选了 「Add to PATH」。若未勾选，请手动将 Node.js 安装目录（例如
Gateway 启动失败
- 确认 Visual C++ Redistributable 已安装且为最新版本（x64）。
- 检查 Node.js 版本是否为 16.x 或 18.x，过高版本可能存在兼容性问题。
总结
- 核心准备：安装 Node.js、Git、Visual C++ 运行库，并正确配置 PowerShell 执行权限（Win10 LTSC 必须执行的两条命令）。
- 安装流程：配置 npm 镜像 → 执行一键安装脚本 → 启动 Gateway 并完成初始化向导。
- 进阶建议：安装为系统服务实现开机自启，按需添加消息通道和插件。
- 特别提醒：Win10 LTSC 用户需重点检查运行库安装和权限配置，其余步骤与标准 Win10 一致。
按照本指南操作，你将在 Win10/Win10 LTSC 上顺利部署 OpenClaw，享受其强大的网关管理能力。如果在安装过程中遇到其他问题，欢迎查阅官方文档 OpenClaw 获取支持。
