前言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-vnpm-v若显示版本号则表示安装成功。2. 安装 Git下载地址Git 官网版本选择下载 Windows 64 位安装包Win10 LTSC 直接选默认版本即可。安装步骤安装过程中保持默认选项但请确保「Git Bash Here」和「Add Git to PATH」被勾选。验证安装在命令提示符中执行git--version显示版本号即成功。3. 安装 Visual C RedistributableWin10 LTSC 系统可能缺失必要的 Visual C 运行库需手动安装下载地址微软官方 Visual C Redistributable for Visual Studio 2015-202264位版本。选择版本下载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-ExecutionPolicyRemoteSigned-Scope CurrentUser# 临时为当前进程解除所有执行限制避免脚本被拦截Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass若弹出权限确认提示输入Y并回车确认。三、配置 npm 镜像大幅提升下载速度国内访问 npm 官方源速度较慢建议切换至淘宝镜像源# 设置 npm 镜像为淘宝源npmconfigsetregistry https://registry.npmmirror.com/# 查看配置是否生效npmconfig list若输出中包含registry https://registry.npmmirror.com/则配置成功。四、一键安装 OpenClaw 核心程序完成以上准备后即可执行 OpenClaw 官方提供的一键安装脚本适用于 Win10 及 Win10 LTSCiwr-useb https://openclaw.ai/install.ps1|iex等待脚本自动运行期间将自动下载并安装 OpenClaw 核心组件无需手动干预。五、基础配置与启动1. 启动 Gateway 服务# 启动 OpenClaw Gateway 核心服务openclaw gateway start2. 初始化配置向导首次安装建议执行重置并运行配置向导# 重置 onboard 配置首次安装推荐openclaw onboard--reset# 仅运行配置向导如已重置或需修改配置openclaw onboard3. 查看 Gateway 状态# 检查 Gateway 服务是否正常运行openclaw gateway status若输出Running表示服务启动成功若为Stopped请检查依赖安装是否完整。4. 打开可视化控制面板# 启动 OpenClaw 控制面板自动打开浏览器openclaw dashboard执行后浏览器将自动打开进入 OpenClaw 图形化管理界面。六、进阶配置安装系统服务与扩展插件1. 安装系统服务实现开机自启Win10 LTSC 推荐将 OpenClaw 安装为系统服务免去每次手动启动的麻烦# 完整安装向导并配置为系统服务开机自启openclaw onboard --install-daemon2. 添加消息通道# 新增自定义消息通道openclaw channelsadd根据提示输入通道名称、类型及配置信息即可完成添加。3. 安装插件以企业微信插件为例OpenClaw 支持丰富的插件扩展例如安装企业微信插件# 安装企业微信插件openclaw pluginsinstallwecom/wecom-openclaw-plugin七、常见问题排查Win10 LTSC 专属PowerShell 执行脚本提示权限不足请确保已按“第二部分”以管理员身份运行 PowerShell并正确执行了Set-ExecutionPolicy RemoteSigned和Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass。npm 命令找不到检查 Node.js 安装时是否勾选了「Add to PATH」。若未勾选请手动将 Node.js 安装目录例如C:\Program Files\nodejs添加到系统环境变量Path中。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 在 Windows 10 / Win10 LTSC 下的完整安装指南
前言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-vnpm-v若显示版本号则表示安装成功。2. 安装 Git下载地址Git 官网版本选择下载 Windows 64 位安装包Win10 LTSC 直接选默认版本即可。安装步骤安装过程中保持默认选项但请确保「Git Bash Here」和「Add Git to PATH」被勾选。验证安装在命令提示符中执行git--version显示版本号即成功。3. 安装 Visual C RedistributableWin10 LTSC 系统可能缺失必要的 Visual C 运行库需手动安装下载地址微软官方 Visual C Redistributable for Visual Studio 2015-202264位版本。选择版本下载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-ExecutionPolicyRemoteSigned-Scope CurrentUser# 临时为当前进程解除所有执行限制避免脚本被拦截Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass若弹出权限确认提示输入Y并回车确认。三、配置 npm 镜像大幅提升下载速度国内访问 npm 官方源速度较慢建议切换至淘宝镜像源# 设置 npm 镜像为淘宝源npmconfigsetregistry https://registry.npmmirror.com/# 查看配置是否生效npmconfig list若输出中包含registry https://registry.npmmirror.com/则配置成功。四、一键安装 OpenClaw 核心程序完成以上准备后即可执行 OpenClaw 官方提供的一键安装脚本适用于 Win10 及 Win10 LTSCiwr-useb https://openclaw.ai/install.ps1|iex等待脚本自动运行期间将自动下载并安装 OpenClaw 核心组件无需手动干预。五、基础配置与启动1. 启动 Gateway 服务# 启动 OpenClaw Gateway 核心服务openclaw gateway start2. 初始化配置向导首次安装建议执行重置并运行配置向导# 重置 onboard 配置首次安装推荐openclaw onboard--reset# 仅运行配置向导如已重置或需修改配置openclaw onboard3. 查看 Gateway 状态# 检查 Gateway 服务是否正常运行openclaw gateway status若输出Running表示服务启动成功若为Stopped请检查依赖安装是否完整。4. 打开可视化控制面板# 启动 OpenClaw 控制面板自动打开浏览器openclaw dashboard执行后浏览器将自动打开进入 OpenClaw 图形化管理界面。六、进阶配置安装系统服务与扩展插件1. 安装系统服务实现开机自启Win10 LTSC 推荐将 OpenClaw 安装为系统服务免去每次手动启动的麻烦# 完整安装向导并配置为系统服务开机自启openclaw onboard --install-daemon2. 添加消息通道# 新增自定义消息通道openclaw channelsadd根据提示输入通道名称、类型及配置信息即可完成添加。3. 安装插件以企业微信插件为例OpenClaw 支持丰富的插件扩展例如安装企业微信插件# 安装企业微信插件openclaw pluginsinstallwecom/wecom-openclaw-plugin七、常见问题排查Win10 LTSC 专属PowerShell 执行脚本提示权限不足请确保已按“第二部分”以管理员身份运行 PowerShell并正确执行了Set-ExecutionPolicy RemoteSigned和Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass。npm 命令找不到检查 Node.js 安装时是否勾选了「Add to PATH」。若未勾选请手动将 Node.js 安装目录例如C:\Program Files\nodejs添加到系统环境变量Path中。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享受其强大的网关管理能力。