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

2026-05-06阅读 0热度 0

windows 人工智能 opencalw

在 Windows 上轻松驾驭 OpenClaw：一份保姆级安装指南

想体验强大的 OpenClaw，但被复杂的安装流程劝退？别担心，这份指南就是为你准备的。我们将手把手、分步骤地完成从环境配置到成功启动的全过程。即使你是编程新手，只要跟着一步步来，也能顺利搞定。

一、环境准备（必做）

工欲善其事，必先利其器。OpenClaw 的运行仰赖两个基础工具：Node.js 和 Git。确保它们版本达标且配置到位，是后续一切顺利的前提。

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

步骤 1：下载 Node.js

首先，访问 Node.js 官方网站。在下载页面，直接选择 Windows 安装程序 (.msi)，注意选64位版本。一个懒人技巧：瞄准页面顶部标识的“当前版本”下载，这通常就是最新的稳定版，能确保版本号高于22。

步骤 2：安装 Node.js

找到下载好的安装包，双击运行。安装过程其实很友好：勾选同意许可协议，一路点击“下一步”。安装路径建议保持默认，如果非要自定义，记住一个原则——千万别用中文路径，那往往是各种奇怪错误的源头。

关键来了，安装向导通常会默认勾选“Add to PATH”（添加到环境变量）选项，这一步至关重要，务必确保它被勾选上。之后，继续点击“下一步”直至安装完成。

步骤 3：验证版本

安装完了，到底成没成功？敲几行命令验验货。
按下键盘上的 Win + R 键，输入 cmd 并按回车，打开命令提示符窗口。
分别执行下面两行命令：

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

如果屏幕上显示的版本号符合要求，恭喜你，这一步闯关成功。如果遇到以下情况也别慌：

版本低于要求：很简单，重新下载更新的版本，再次运行安装程序覆盖安装即可，一般不需要先卸载旧版。
提示“不是内部或外部命令”：这通常是环境变量没生效。试着关闭命令提示符再重新打开一次，或者干脆重新运行安装程序，确认“Add to PATH”选项被勾选。
后续安装报 npm 版本低：如果之后安装 OpenClaw 时 npm 报了错，就按照错误提示，运行一下 npm update 命令，更新后再试。

2. 安装并配置 Git

步骤 1：下载 Git

接着，我们来搞定 Git。访问 Git 的官方网站，下载 Windows 版本的安装包。这里无需纠结版本，直接下载最新版准没错。

步骤 2：安装 Git

运行 Git 安装包，大部分时候你只需要不断点击“Next”。但有一个步骤值得你稍作停留：当安装程序出现“Adjusting your PATH environment”选项时，请选择第二项“Git from the command line and also from 3rd-party software”。这个选项能自动帮你配置好环境变量，省去后面很多手动配置的麻烦。

步骤 3：配置 Git（解决 SSH 认证问题）

这一步是个防患于未然的小技巧。为了避免后续安装依赖时可能出现的 SSH 权限错误，我们提前给 Git 打个“补丁”。
再次打开命令提示符，将下面这行命令完整复制粘贴进去，然后按回车：

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

命令执行后只要没报红字错误，就说明配置成功了。它相当于告诉 Git，以后都用 HTTPS 协议去拉取代码，更加通用稳定。

二、安装 Ollama

1. 下载 Ollama

OpenClaw 需要一个“动力引擎”，那就是 Ollama。前往 Ollama 官网，点击那个醒目的“Download for Windows”按钮。安装包大概百兆左右，下载时请稍安勿躁。

2. 安装 Ollama

找到下载的 OllamaSetup.exe，双击运行。安装过程很顺畅，基本上就是允许程序运行，然后一路点击“下一步”，安装路径保持默认就好。安装完成后，系统通常会自动弹出 Ollama 的登录界面。如果没弹出，去开始菜单里搜一下“Ollama”手动启动它。

3. 注册并登录 Ollama

第一次使用，我们需要一个账号。在登录界面点击“Sign Up”，用你的邮箱和密码完成注册。注册成功后，回到登录界面，输入刚注册的账号密码登录进去。过程中可能会提示你绑定当前设备，放心点击同意即可。到此，Ollama 的基础设置就完成了。

三、安装并启动 OpenClaw

1. 运行 Ollama 命令行

登录 Ollama 后，一个命令行窗口会自动打开（这就是它的操作后台）。如果万一没自动开，你可以手动按下 Win + R 输入 cmd 打开命令提示符，然后输入 ollama 命令并回车。
在出现的 Ollama 操作菜单里，用键盘的下方向键，移动光标选中“Install OpenClaw”这个选项，然后按下回车键确认安装。

2. 选择运行模型

安装脚本运行完毕后，系统会贴心地问你：想用什么模式来运行？
这里给出明确建议：对于绝大多数用户，直接选择“cloud”（云模型）。它的好处是无需依赖你本地的显卡算力，普通电脑也能流畅运行，门槛最低。
当然，如果你的电脑配置够顶，比如拥有 RTX 4060 或更高性能的显卡，可以尝试选择“local”（本地模型）。选择这个选项后，系统会自动下载庞大的模型文件（注意，这会占用几十GB的磁盘空间），下载时请保持耐心。

3. 验证 OpenClaw 启动

模型加载完成后，命令行窗口会清晰地提示“OpenClaw is running”。看到这行字，就意味着服务已经跑起来了。接下来进行最后一步验证：
1. 打开你电脑上任意一个浏览器，Chrome、Edge、火狐都可以。
2. 在地址栏里输入 127.0.0.1:18789。
3. 按下回车键。
如果浏览器里出现了 OpenClaw 的操作界面，那么，大功告成！你的安装之旅已经胜利收官。

四、常见问题解决

走完全程当然最好，但万一卡在哪一步，可以来这里找找答案：
- npm 安装失败，提示“spawn git”错误：这基本上就是 Git 没装好或者环境变量没生效。请返回第一部分，检查 Git 的安装步骤，或者简单粗暴地——重启一下命令提示符窗口再试。
- 访问 127.0.0.1:18789 无法打开页面：首先确认一下，之前那个显示“OpenClaw is running”的命令行窗口有没有被你不小心关掉？服务必须在后台运行着。其次，可能是模型还没完全加载完，多等一会儿，直到看到 running 提示再试。
- Node.js 版本验证不通过：如果检查版本始终低于22，最彻底的办法是，卸载现有版本，重新去官网下载一个 22.x 或更新的版本进行安装。

总结

整个安装流程，其实可以梳理出两条清晰的主线：
第一条线是基础环境：Node.js（≥22）、npm（≥11.11）、Git，这三者的版本与配置是基石，尤其是 Git 替换为 HTTPS 协议那一步，能预防很多隐性问题。
第二条线是服务部署：Ollama 完成注册登录后，在它的命令行中安装 OpenClaw，并根据自己电脑的实际情况（通常是普通电脑）选择云模型。
最后，通过浏览器访问本地地址 127.0.0.1:18789 来验收成果。
回过头看，整个流程的核心难点往往不在于 OpenClaw 本身，而在于前置环境的“绝对正确”。所以，如果中途遇到任何权限或版本报错，别犹豫，首先回头仔细检查 Node.js 和 Git 的安装与配置环节，问题大概率就出在那里。祝你一次安装成功，尽情探索 OpenClaw 的世界！