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 模型。
向导步骤详解
步骤 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
输入：
http://127.0.0.1:11434/v1注意：这是 Ollama 的本地地址
步骤 5：输入 API Key
输入：
本地模型不需要真实密钥，随便输入一个字符串即可
步骤 6：选择兼容模式
Select Endpoint Compatibility:
1. OpenAI-compatible (Recommended)
2. Anthropic-compatible
3. Google-compatible输入：输入 1
步骤 7：输入模型 ID
输入：
如果你还没下载模型，可以先输入一个名字，后面我们会下载
步骤 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 小时 |
下载时间取决于网络速度，耐心等待即可
查看已下载模型
输出示例：
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
正常启动日志：
[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 窗口，输入：
这会自动打开浏览器，并使用正确的 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 服务未运行
错误信息：
解决方案：
# 重启 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 本地大模型部署详解
夜雨聆风
