【OpenClaw】Windows 安装OpenClaw

OpenClaw系统环境准备与安装条件

在正式部署OpenClaw之前，请仔细核对以下系统配置要求，确保运行环境满足条件，以避免后续安装和运行过程中可能出现的兼容性问题，让安装更顺利。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

首先，核心运行环境需要Node.js 22或更高版本。若系统中尚未安装，后续的自动安装脚本通常会协助完成此步骤。当然，您也可以选择提前手动安装以更好地控制版本。

在操作系统方面，OpenClaw支持跨平台运行，兼容macOS、Linux及Windows系统。对于Windows用户，我们强烈推荐使用WSL2（Windows Subsystem for Linux）环境进行部署。虽非强制要求，但这能显著提升安装成功率并优化后续使用体验，是经过社区验证的最佳实践。

此外，包管理器pnpm是可选依赖。如果您计划从源代码构建或深度定制OpenClaw项目，则需要安装它。对于大多数通过脚本安装的用户，可先了解此信息。

OpenClaw详细安装步骤

第一步：下载并执行自动化安装脚本

安装过程始于终端命令行。请打开您系统的终端（如PowerShell、bash等），并根据说明执行相应命令。

若希望安装完毕后立即启动交互式配置向导，请复制并执行以下PowerShell命令：

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

若您倾向于先完成基础安装，稍后再进行详细配置，则可以使用以下“仅安装”模式的命令：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

命令执行后，终端将显示实时安装进度，如下图所示，表明安装程序正在正常运行。

第二步：启动交互式初始配置向导

若选择了包含向导的安装方式，安装完成后将自动进入此引导环节。整个过程为交互式问答，请根据屏幕提示操作。

首先，系统会显示一个安全须知。请仔细阅读后，输入 yes 确认并进入下一步。

第三步：选择初始化配置模式

接下来需要选择配置模式。为了以最快速度体验OpenClaw的核心功能，建议新手用户直接选择 QuickStart（快速开始）模式。此模式将采用最简化的默认配置启动服务。

第四步：添加并配置AI大模型供应商

OpenClaw支持集成多种主流大语言模型。在供应商选择界面，我们以配置 Qwen（通义千问）为例进行演示。

选择Qwen后，终端会显示一个OAuth授权链接。请完整地复制该链接，并将其粘贴到您常用浏览器的地址栏中访问。

第五步：在浏览器中完成模型账号授权

浏览器打开链接后，将跳转至通义千问的官方授权页面。请根据页面指引登录您的账号并完成授权流程。

授权成功后，请返回命令行终端。向导会列出所有可用的Qwen模型列表，对于初次配置，直接选择系统默认推荐的模型版本是最为简单可靠的选择。

模型确认后，终端将显示成功添加的提示，这标志着您已成功配置了第一个AI模型接入。

第六步：配置通信渠道与功能技能

下一步是配置Channel（渠道/通道）。Channel定义了AI与外界交互的方式（如API、即时通讯工具等）。在快速入门阶段，建议选择 Skip for now 暂时跳过，后续可按需添加。

接着配置Skills（技能集）。Skills是增强AI特定能力的插件模块。同样，为简化初次配置，此处选择 No 跳过。

第七步：配置事件钩子并完成安装

最后是配置Hooks（钩子）。Hooks允许您在AI处理流程的关键节点插入自定义代码逻辑。使用键盘的空格键勾选 Skip for now 选项，然后按回车确认。

完成以上“跳过”操作后，恭喜！所有核心初始化配置已完成。向导会展示一个最终配置摘要供您确认。

按回车确认后，系统将自动拉取所需的Docker镜像并启动所有后台服务。此过程可能需要数分钟，请耐心等待，并观察终端输出的服务启动日志。

当看到“Setup completed successfully!”的最终提示时，表示OpenClaw已成功安装并启动。终端会明确给出Web管理界面的访问地址。

安装后验证与基本运维管理

安装完成后，建议首先检查所有服务的运行状态。在终端中输入以下命令：

openclaw status

此命令将列出OpenClaw所有核心微服务（如API服务、模型网关等）的详细状态，确保一切运行正常。

故障排除：解决Web界面“未授权”错误

如果访问Web管理界面时遇到“未授权”(Unauthorized)错误，通常是由于浏览器会话问题。最快捷的解决方法是返回服务器终端，执行以下命令：

openclaw dashboard

该命令会重新生成或显示Web控制台的访问链接及认证令牌，帮助您快速重新登录系统。

扩展阅读与官方文档

若需深入了解安装细节或进行高级配置，请务必查阅OpenClaw官方文档：

详细安装指南：https://docs.openclaw.ai/install

快速入门教程：https://docs.openclaw.ai/start/getting-started