Windows 系统下 Ollama 安装 OpenClaw 完整教程

Windows 系统 OpenClaw 安装教程：从零到一，新手也能轻松部署

你是否对强大的 OpenClaw 感兴趣，却因复杂的安装步骤望而却步？别担心，这份详细的 Windows 安装指南，将从环境准备到成功启动，为你提供全程图解。即使你是初学者，只要跟随本教程逐步操作，也能顺利完成 OpenClaw 的安装与配置。

一、必备环境安装与配置

万事开头难，良好的开端是成功的一半。OpenClaw 稳定运行依赖于 Node.js 和 Git 这两个核心工具。确保其版本达标且配置正确，是整个安装流程顺利的关键所在。

1. 安装/升级 Node.js（版本要求 ≥22，npm ≥11.11）

步骤 1：下载 Node.js 安装包

首先，访问 Node.js 官方网站。在下载页面中，请务必选择适用于 Windows 的安装程序 (.msi)，并确认下载的是 64 位版本。一个省心的小技巧：直接下载首页标记的“当前版本”（Current），这通常是最新的稳定版，能够确保版本号满足≥22的要求。

步骤 2：执行 Node.js 安装

找到下载完成的安装包，双击运行。安装过程十分直观：阅读并同意许可协议，随后一路点击“下一步”。安装路径建议采用默认设置，如需自定义，请务必避免使用包含中文或空格的路径，这能有效规避潜在的兼容性问题。

关键配置：安装向导中通常会默认勾选“Automatically install the necessary tools…”或“Add to PATH”选项，请务必确认此选项被选中。这一步是将 Node.js 和 npm 加入系统环境变量，方便在任意位置调用。确认后，继续完成安装。

步骤 3：验证 Node.js 与 npm 版本

安装完成后，需要验证是否成功。按下键盘的 Win + R 组合键，输入 cmd 后回车，打开命令提示符（CMD）窗口。
分别输入并执行以下两条验证命令：

# 检查 Node.js 版本（需 ≥22.0.0） node -v # 检查 npm 版本（需 ≥11.11.0） npm -v

若屏幕上正确显示符合要求的版本号，即表示安装成功。若遇到问题，可参考以下解决方案：

• 版本号低于要求：无需卸载，直接前往官网下载更高版本的安装包，运行后选择覆盖安装即可。
• 提示“‘node’不是内部或外部命令”：这通常是环境变量未生效所致。请尝试关闭并重新打开 CMD 窗口，或重新运行安装程序并确认“Add to PATH”选项已勾选。
• 后续安装中 npm 报版本过低：若安装 OpenClaw 时提示 npm 版本问题，可运行 npm update -g npm 命令来全局更新 npm。

2. 安装并正确配置 Git

步骤 1：下载 Git 客户端

接下来，我们需要安装 Git。访问 Git 官方网站，下载适用于 Windows 的最新版安装程序。选择最新稳定版即可，无需纠结具体版本号。

步骤 2：安装 Git 客户端

运行 Git 安装包，大部分步骤保持默认，连续点击“Next”。但请注意此关键选项：当出现“Adjusting your PATH environment”（调整您的 PATH 环境）设置时，请选择第二项“Git from the command line and also from 3rd-party software”。此选项能自动将 Git 添加到系统路径，对后续操作至关重要。

步骤 3：配置 Git 使用 HTTPS 协议（预防 SSH 错误）

这是一个重要的优化步骤，能有效预防后续安装依赖时可能出现的 SSH 认证失败问题。
再次打开命令提示符窗口，复制并粘贴以下命令，然后按回车执行：

git config --global url."https://github.com/".insteadOf git@github.com:

此命令执行后若无错误提示，则配置成功。它指示 Git 在克隆 GitHub 仓库时默认使用 HTTPS 协议替代 SSH，通用性更强，能减少网络配置带来的困扰。

二、部署 Ollama 服务端

1. 获取 Ollama 安装程序

OpenClaw 需要依托 Ollama 作为其 AI 模型服务后端。请访问 Ollama 官方网站，点击显著的“Download for Windows”按钮获取安装包。文件大小约百兆，请耐心等待下载完成。

2. 安装 Ollama 软件

找到下载的 OllamaSetup.exe 文件，双击运行。安装过程简单直接：授予程序运行权限，然后遵循向导提示点击“下一步”，安装路径建议保持默认。安装结束后，系统通常会启动 Ollama 并弹出登录/注册界面。如未自动启动，请在开始菜单中搜索“Ollama”并打开。

3. 注册并登录 Ollama 账户

首次使用需要注册账户。在启动的界面点击“Sign Up”，使用你的电子邮箱和密码完成注册流程。注册成功后，返回登录界面，使用刚注册的账号进行登录。过程中可能需要授权绑定当前设备，请点击同意。至此，Ollama 服务框架已就绪。

三、完成 OpenClaw 的安装与启动

1. 通过 Ollama 命令行安装

成功登录 Ollama 后，通常会弹出一个命令行窗口（即 Ollama 的后台服务终端）。如果未自动弹出，您可以手动按下 Win + R 输入 cmd 打开命令提示符，然后输入 ollama 命令回车启动。
在出现的 Ollama 命令行交互菜单中，使用键盘的下方向键将光标移动至“Install OpenClaw”选项，按回车键开始安装。

2. 选择模型运行模式

安装脚本执行完毕后，系统会提示你选择运行模式。
给绝大多数用户的明确建议：选择“cloud”（云端模型）模式。 此模式无需强大的本地显卡支持，普通家用电脑或笔记本即可流畅运行，是门槛最低、最稳定的选择。
若你的电脑配备高性能独立显卡（如 NVIDIA RTX 4060 或更高级别），且拥有充足的硬盘空间，可以尝试选择“local”（本地模型）模式。选择此模式后，Ollama 将开始下载庞大的模型文件（可能达数十GB），请确保网络稳定并耐心等待。

3. 验证 OpenClaw 服务状态

模型加载完毕后，命令行窗口将显示“OpenClaw is running”等类似提示，这表明服务已在后台成功启动。最后一步是进行可视化验证：
1. 打开您电脑上的任一浏览器，如 Chrome、Microsoft Edge 或 Firefox。
2. 在浏览器地址栏中输入本地访问地址：127.0.0.1:18789。
3. 按下回车键。
如果浏览器成功加载出 OpenClaw 的 Web 操作界面，那么恭喜你！OpenClaw 已在您的 Windows 电脑上安装并启动成功。

四、安装故障排除指南

顺利安装是目标，但遇到问题时也别慌张，以下常见问题及解决方案可供参考：
- npm 安装失败，报“spawn git ENOENT”等错误：这通常是由于 Git 未正确安装或环境变量未配置所致。请返回第一部分，重新检查 Git 的安装步骤，特别是 PATH 环境变量的配置。简便方法是彻底关闭命令提示符窗口后重新打开再试。
- 无法通过 127.0.0.1:18789 访问界面：首先，请确认显示“OpenClaw is running”的命令行窗口是否仍在运行，切勿关闭。其次，可能是模型尚未完全加载完成，请等待命令行出现明确的服务启动成功提示后再尝试访问。
- Node.js 版本始终无法满足要求：如果多次验证版本号仍低于22，建议先通过控制面板卸载现有 Node.js，然后重新从官网下载 22.x 或以上的 LTS（长期支持）版本进行全新安装。

安装流程总结

回顾整个 Windows 平台 OpenClaw 的安装过程，我们可以清晰地将其归纳为两条主线：
第一条主线：基础环境搭建。核心是确保 Node.js (≥22)、npm (≥11.11) 和 Git 这三者版本达标且配置无误。其中，将 Git 的默认拉取协议配置为 HTTPS 是关键一步，能提前规避大量网络权限问题。
第二条主线：服务部署与启动。通过安装并登录 Ollama，在其提供的命令行环境中完成 OpenClaw 的安装，并依据自身硬件条件（多数用户推荐云端模型）选择合适的运行模式。
最终，在浏览器中访问本地指定端口 127.0.0.1:18789 来验证安装成果。
需要强调的是，整个流程中绝大多数错误并非源于 OpenClaw 自身，而是前置依赖环境配置的“绝对准确性”所致。因此，若在安装中途遇到任何权限或版本报错，请首要排查 Node.js 和 Git 的安装与配置环节。希望本指南能助你一次安装成功，即刻开启 OpenClaw 的探索之旅！