【03】Windows 系统一键安装 OpenClaw:保姆级图文教程

Windows 系统一键安装 OpenClaw：保姆级图文教程

5分钟完成安装，让你的电脑拥有本地 AI 助手

前言

经过第二章的环境准备，你的电脑已经安装了 Node.js 和 Ollama。现在我们终于可以安装 OpenClaw 了！

本章将详细介绍：

• 一键安装脚本安装 OpenClaw

• 初始化配置向导

• 常见安装错误及解决方案

• 验证安装是否成功

安装方式选择

OpenClaw 提供两种安装方式：

方式	命令	适用人群	难度

一键脚本	irm https://openclaw.ai/install.ps1 \| iex	99%用户	简单
npm 安装	npm install -g openclaw	开发者	简单

推荐使用一键脚本安装，更简单快捷。

第一步：一键安装 OpenClaw

打开 PowerShell

1. 按 Win + X

2. 选择「Windows PowerShell」（不是管理员也可以）

执行安装命令

# 设置执行策略（允许运行脚本） Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned # 一键安装 OpenClaw irm https://openclaw.ai/install.ps1 | iex

重要提示：

• 不要使用 powershell -c "irm ... | iex" 的嵌套写法

• 直接在 PowerShell 窗口中运行，不要加外层引号

安装过程说明

运行命令后，你会看到类似以下输出：

Downloading OpenClaw from https://openclaw.ai... Installing OpenClaw... Installing dependencies... Setup complete!

等待安装完成，通常需要 1-3 分钟。

第二步：验证安装

安装完成后，验证 OpenClaw 是否安装成功：

# 检查版本 openclaw --version # 查看帮助 openclaw --help

成功响应：

OpenClaw v1.2.3 Usage: openclaw [command] ...

第三步：运行初始化向导

这是最关键的步骤！通过向导配置你的第一个 AI 模型。

openclaw onboard

向导步骤详解

步骤 1：安全警告

Security Warning This will install a persistent service that auto-starts on boot. Do you want to continue? (Y/n)

输入：按 Y 然后回车

步骤 2：选择模式

Select Mode: 1. QuickStart (Recommended for beginners) 2. Manual Configuration

输入：输入 1，按回车

步骤 3：选择模型提供商

Select Model Provider: 1. Anthropic (Claude) 2. OpenAI (GPT) 3. Custom Provider (Ollama) 4. Google (Gemini) ...

输入：输入 3，选择「Custom Provider」

步骤 4：配置 API Base URL

Enter API Base URL:

输入：

http://127.0.0.1:11434/v1

注意：这是 Ollama 的本地地址

步骤 5：输入 API Key

Enter API Key:

输入：

ollama

本地模型不需要真实密钥，随便输入一个字符串即可

步骤 6：选择兼容模式

Select Endpoint Compatibility: 1. OpenAI-compatible (Recommended) 2. Anthropic-compatible 3. Google-compatible

输入：输入 1

步骤 7：输入模型 ID

Enter Model ID:

输入：

qwen2.5:7b

如果你还没下载模型，可以先输入一个名字，后面我们会下载

步骤 8：跳过后续配置

后续选项全部输入 n 或选择「Skip for now」：

Configure additional settings? (y/N) → n Install recommended skills? (Y/n) → n ...

第四步：修改配置文件

安装向导会在用户目录下创建配置文件，我们需要做一些修改。

找到配置文件

配置文件位置：

C:\Users\<你的用户名>\.openclaw\openclaw.json

修改上下文窗口

这是最常见的坑！Ollama 默认上下文只有 4096 tokens，但 OpenClaw 要求至少 16000 tokens

打开配置文件，找到模型配置部分，修改为：

{ "models": { "providers": { "custom-127-0-0-1-11434": { "models": [ { "id": "qwen2.5:7b", "contextWindow": 32768, "maxTokens": 8192 } ] } } } }

第五步：下载本地模型

现在我们需要下载一个 AI 模型到本地。

下载命令

# 查看可用的模型 ollama search qwen # 下载通义千问 7B 模型（推荐配置） ollama pull qwen2.5:7b # 或者下载更轻量的 3B 模型（适合低配置电脑） ollama pull qwen2.5:3b

模型下载时间

模型大小	预计下载时间

1.5B	约 5 分钟
3B	约 15 分钟
7B	约 30-60 分钟
14B	约 2-3 小时

下载时间取决于网络速度，耐心等待即可

查看已下载模型

ollama list

输出示例：

NAME ID SIZE MODIFIED qwen2.5:7b a8f32... 4.7GB 2 minutes ago

第六步：修复上下文窗口问题

这是必须做的步骤！否则 OpenClaw 会报错。

创建扩展上下文的模型

步骤 1：创建 Modelfile

在用户目录下创建文件 Modelfile（无扩展名）：

# 创建 Modelfile @" FROM qwen2.5:7b PARAMETER num_ctx 32768 "@ | Out-File -FilePath "$env:USERPROFILE\Modelfile" -Encoding ascii

步骤 2：验证文件内容

Get-Content "$env:USERPROFILE\Modelfile"

应该输出：

FROM qwen2.5:7b PARAMETER num_ctx 32768

步骤 3：创建新模型

ollama create qwen2.5-7b-32k -f "$env:USERPROFILE\Modelfile"

步骤 4：更新配置

把 openclaw.json 中的模型 ID 从 qwen2.5:7b 改为 qwen2.5-7b-32k

第七步：启动 OpenClaw

启动 Gateway

openclaw gateway

正常启动日志：

[gateway] agent model: custom-127-0-0-1-11434/qwen2.5-7b-32k [gateway] listening on ws://127.0.0.1:18789 [browser/server] Browser control listening on http://127.0.0.1:18791/ [hooks] loaded 4 internal hook handlers

打开 Dashboard

新开一个 PowerShell 窗口，输入：

openclaw dashboard

这会自动打开浏览器，并使用正确的 token 登录。

常见安装错误及解决方案

错误 1：PowerShell 执行策略被拒绝

错误信息：

irm : 无法加载文件 C:\Users\...\Temp\...\install.ps1，因为在此系统上禁止运行脚本。

解决方案：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

错误 2：嵌套命令被拒绝

错误信息：

拒绝访问

原因：使用了 powershell -c "irm ... | iex" 的嵌套写法

解决方案：直接在 PowerShell 窗口中运行 irm ... | iex

错误 3：找不到 npm 命令

错误信息：

npm : 无法将“npm”项识别为 cmdlet...

解决方案：重新安装 Node.js，确保添加到 PATH

错误 4：上下文窗口太小

错误信息：

Model context window too small (4096 tokens). Minimum required: 16000 tokens

解决方案：按照第六步创建扩展上下文的模型

错误 5：ollama 服务未运行

错误信息：

connection refused

解决方案：

# 重启 Ollama 服务 ollama serve # 或者在任务管理器中重启 Ollama 程序

安装验证清单

完成安装后，验证以下项目：

openclaw --version 显示版本号 openclaw onboard 成功运行 ollama list 显示已下载的模型 openclaw gateway 成功启动 openclaw dashboard 打开浏览器界面

创建桌面快捷方式

为了方便每次快速打开 OpenClaw，我们可以创建桌面快捷方式：

# 获取 token $token = "你的token" # 创建 URL 快捷方式 $shell = New-Object -ComObject WScript.Shell $shortcut = $shell.CreateShortcut("$env:USERPROFILE\Desktop\OpenClaw.url") $shortcut.TargetPath = "http://127.0.0.1:18789/#token=$token" $shortcut.Save()

总结

本章我们完成了：

• 一键安装 OpenClaw

• 运行初始化配置向导

• 下载第一个本地 AI 模型

• 修复上下文窗口问题

• 启动并验证 OpenClaw

下一章预告：Ollama 本地大模型部署 - 零成本拥有私人 AI

关注公众号：跟着鹏鹏学技术

下一篇预告：Ollama 本地大模型部署详解