在 Windows 中安装并配置OpenClaw

Windows 系统安装与配置 OpenClaw 完整指南

测试环境：Windows 11 25H2 + WSL2 (Ubuntu)，OpenClaw 版本 2026.3.2

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

OpenClaw 安装方式全面对比

针对不同使用场景和用户习惯，OpenClaw 官方提供了多种安装方案。如何选择最适合自己的方式？以下对比表格将帮助您快速决策。

Windows 平台安装方案详细对比

下表系统分析了每种安装方式的适用情况、核心优势与潜在限制：

官方推荐安装方案详解

OpenClaw 官方明确推荐使用 安装脚本（Installer Script） 进行安装（即上述方式①或②）。

官方文档中的建议原文如下：

“The installer script is the recommended way to install OpenClaw. It handles Node detection, installation, and onboarding in one step.”

官方优先推荐安装脚本主要基于以下三大核心优势：

• 全流程自动化：脚本会自动检测系统中是否已安装 Node.js，若未安装则会自动下载并配置。彻底省去手动安装与配置依赖的繁琐步骤，对新用户极其友好。
• 集成开机引导：安装过程结束后，脚本会自动启动初始配置向导（onboarding）。此步骤至关重要，能系统性引导用户完成必要设置，大幅降低因配置遗漏导致后续运行时出错的风险。
• 环境兼容性优先：官方多次强调，在 Windows 平台上运行 OpenClaw，“我们强烈建议优先使用 WSL2 环境”。原因在于 WSL2 环境下，systemd 守护进程管理更为完善，且 sharp、node-llama-cpp 等 Node.js 原生模块的兼容性显著优于 Windows 原生环境，从而确保了更高的系统整体稳定性和运行体验。

接下来，我们将依据官方最佳实践，详细介绍在 WSL2 环境中逐步安装并配置 OpenClaw 的具体流程。

安装前环境准备

开始安装前，请确保您的 Windows 11 操作系统已完成 WSL2 的安装与启用，并且已安装 Ubuntu 作为 Linux 发行版。

若尚未安装 WSL2，请参考 Microsoft 官方文档完成安装与基础配置。

详细安装步骤

步骤一：执行 OpenClaw 安装命令

启动 WSL2 中的 Ubuntu 终端，执行以下安装命令：

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

此脚本将自动完成 Node.js 运行时及所有必要依赖项的安装。安装成功后，系统会自动进入初始配置向导。根据网络状况差异，此过程通常需要 20 到 40 分钟，请耐心等待。

步骤二：完成初始配置向导

如果安装结束后向导未自动启动，可通过手动执行以下命令来开启：

openclaw onboard --install-daemon

请注意 --install-daemon 参数，其作用是将 OpenClaw Gateway 核心服务注册为 systemd 守护进程，以实现服务开机自启和更稳定的进程管理。

请务必跟随向导提示，逐一完成以下核心配置项，切勿跳过任何步骤：

• 选择运行模式（例如选择 local 本地模式）。
• 配置您的 OpenAI API Key。
• 设置默认 Agent 模型（例如 openai/gpt-5.2-pro）。
• 配置 Gateway 服务监听的端口号（默认端口为 18789）。

步骤三：启动 Gateway 核心服务

向导配置完成后，使用以下命令启动 Gateway 服务：

openclaw gateway start

当终端显示类似 systemd service: openclaw-gateway.service 已成功启动的提示时，即表示 Gateway 服务运行正常。

步骤四：访问 Dashboard 并建立连接

Gateway 启动后，即可通过 Web 仪表盘进行管理和监控：

1. 在 Windows 系统的浏览器中访问地址：http://127.0.0.1:18789。
2. 进入左侧菜单栏的 「控制」→「概览」 页面。
3. 在页面的 「网关访问」 区域，确认 WebSocket URL 和网关令牌（Token）已自动填充。
4. 直接点击页面中央醒目的 「连接」 按钮。

当页面右上角状态栏显示 「健康状况：正常」 时，恭喜您！OpenClaw 已成功安装并连接。✅

安装成功验证

如何确认 OpenClaw 安装成功并运行正常？请查看 Dashboard 中「概览」页面的「系统快照」区域，确认包含以下关键信息：

下图为本机成功安装 OpenClaw 后，控制台「概览」页面的实际截图，可作为安装成功的视觉参考：

常见问题与解决方法（FAQ）

Q1：执行 openclaw onboard 命令后，向导反复循环启动，无法退出？

此问题通常是由于初始配置向导检测到之前的配置项不完整，从而触发了自动重新引导机制。

解决方案：重新完整运行一次配置向导。此次请务必认真对待每一步设置，对所有选项做出明确的选择或确认，确保每一项配置均已填写完整，避免使用跳过或直接按回车接受默认值。

Q2：Dashboard 页面提示“无法连接”或“Token 未授权”？

此问题大多源于安装引导过程中跳过了关键认证步骤，导致 Control UI 未能与 Gateway 服务完成必要的握手与授权。

请按以下步骤进行检查与修复：

1. 确认浏览器访问地址为 http://127.0.0.1:18789。
2. 进入 「控制」→「概览」 页面。
3. 检查 「网关令牌」 输入框是否为空。正确的 Token 通常保存在 ~/.openclaw/openclaw.json 配置文件的 gateway.auth.token 字段中。
4. 若 Token 存在，直接点击 「连接」 按钮。

您也可以通过命令行快速查看当前 Token 值：

cat ~/.openclaw/openclaw.json | grep token

Q3：按照常规方式重启 Gateway 后，问题仍然存在怎么办？

如果执行标准的 openclaw gateway restart 命令未能解决问题，可以尝试以下更彻底的进程清理与重启组合命令，确保所有相关残留进程被终止：

openclaw gateway stop
sleep 3
pkill -f "openclaw.*gateway" 2>/dev/null
sleep 2
openclaw gateway start

Q4：如何快速确认 Gateway 服务正在正常运行？

有两种最直接有效的方法：

1. 在 WSL2 终端中使用 systemctl 命令检查服务运行状态：

systemctl status openclaw-gateway.service

2. 更简便的方法是直接查看 Dashboard 右上角的状态指示器，只要 「健康状况」 显示为 「正常」，即证明系统运行良好。

核心文件与目录位置

了解关键配置文件与工作目录的位置，对于日常维护和故障排查至关重要：

当您遇到运行问题时，建议首先核对 ~/.openclaw/openclaw.json 配置文件内容的完整性与准确性，许多初期故障都源于此文件的配置缺失或错误。确认配置无误后，再尝试重启 Gateway 服务，通常可以解决大部分常见问题。