windows+wsl+OpenClaw 安装指南（二）：5分钟快速搭建 OpenClaw —— 从 0 到可用的 AI 助手

作者：技术实践派
标签：OpenClaw | AI助手 | 快速开始 | WSL | 自动化部署
难度：⭐⭐☆☆☆（初级）
阅读时间：8分钟

---

一、前言

在上一篇文章中，我们了解了 OpenClaw 的整体架构。本文将带你从 0 开始，5分钟内搭建一个可用的 AI 助手。

如果你：

• 想快速体验 OpenClaw 的功能
• 不想深入了解技术细节
• 希望先跑起来再慢慢学习

那么这篇文章就是为你准备的！

---

二、准备工作

2.1 系统要求检查

在开始之前，请确认你的环境：

检查项	要求	检查命令
Windows 版本	Windows 10/11	winver
WSL 已安装	WSL2 + Ubuntu-22.04/24.04	wsl -l -v
管理员权限	需要	右键 PowerShell → 以管理员身份运行

2.2 一键检查脚本

保存以下脚本为 check-env.ps1：

# 环境检查脚本
Write-Host "=== OpenClaw 环境检查 ===" -ForegroundColor Cyan

# 检查 Windows 版本
$winVer = [System.Environment]::OSVersion.Version
Write-Host "Windows 版本: $($winVer.Major).$($winVer.Minor).$($winVer.Build)"

# 检查 WSL
$wslList = wsl -l -v 2>&1
if ($wslList -match "Ubuntu") {
    Write-Host "[✓] WSL Ubuntu 已安装" -ForegroundColor Green
} else {
    Write-Host "[✗] WSL Ubuntu 未安装，请先安装" -ForegroundColor Red
    Write-Host "安装命令: wsl --install -d Ubuntu-24.04"
}

# 检查管理员权限
$isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")
if ($isAdmin) {
    Write-Host "[✓] 当前以管理员身份运行" -ForegroundColor Green
} else {
    Write-Host "[!] 建议以管理员身份运行 PowerShell" -ForegroundColor Yellow
}

Write-Host "`n检查完成！" -ForegroundColor Cyan

运行：powershell -ExecutionPolicy Bypass -File check-env.ps1

---

三、5分钟快速安装

3.1 下载安装包

# 克隆仓库（假设代码托管在 GitHub）
git clone https://github.com/your-repo/openclaw-install-guide.git
cd openclaw-install-guide/安装openclaw

# 或者下载 ZIP 并解压
# 解压后进入 安装openclaw 目录

3.2 准备配置文件

# 复制配置模板
copy config-template.env config.env

# 编辑配置（使用记事本或 VS Code）
notepad config.env

最小化配置示例：

# 基础配置
GATEWAY_PORT=18789
GATEWAY_TOKEN=your-secure-token-here
WSL_DISTRO=Ubuntu-24.04
WSL_USER=your-wsl-username

# 大模型选择（二选一）
# 方案 A: 本地 Ollama（需要提前安装 Ollama Windows 版）
USE_LOCAL_MODEL=true
OLLAMA_MODEL=ministral-3:3b

# 方案 B: 腾讯混元（推荐，无需显卡）
# USE_TENCENT_HUNYUAN=true
# TENCENT_API_KEY=sk-your-api-key
# TENCENT_MODEL=hunyuan-turbos

# 飞书集成（可选，初学者建议跳过）
ENABLE_FEISHU=false

3.3 运行一键安装脚本

以管理员身份打开 PowerShell，执行：

cd 安装openclaw
.\auto-install.bat

安装过程大约需要 5-10 分钟，期间会自动完成：

步骤	耗时	说明
1. 配置 WSL NAT 模式	10秒	设置网络模式
2. 重启 WSL	30秒	使配置生效
3. 配置端口转发	10秒	Windows → WSL 端口映射
4. 安装系统依赖	1-2分钟	libvips 等
5. 安装 Node.js 24	1-2分钟	下载并配置
6. 安装 OpenClaw	2-3分钟	npm 全局安装
7. 初始化配置	30秒	onboard 流程
8. 配置模型	30秒	根据 config.env
9. 启动 Gateway	10秒	创建 systemd 服务

3.4 访问 Dashboard

安装完成后，脚本会输出访问地址：

========================================
  🎉 OpenClaw 安装完成！
========================================

访问地址:
  http://localhost:18789/?token=your-token-here

Dashboard 界面将在浏览器中打开...

手动访问：

http://localhost:18789/?token=your-token-here

首次访问可能需要：

1. 在 WSL 中执行 openclaw devices approve --all 批准设备配对
2. 刷新浏览器

---

四、快速验证

4.1 测试 Web 对话

1. 打开 Dashboard
2. 在对话框输入：“你好，请介绍一下自己”
3. 等待 AI 回复

4.2 检查服务状态

# 查看 Gateway 状态
wsl -d Ubuntu-24.04 -e systemctl --user status openclaw-gateway

# 查看实时日志
wsl -d Ubuntu-24.04 -e journalctl --user -u openclaw-gateway -f

4.3 测试本地模型（如启用 Ollama）

# 在 WSL 中测试 Ollama 连通性
curl http://$(ip route | grep default | awk '{print $3}'):11434/api/tags

---

五、常见问题速查

5.1 安装失败

错误	原因	解决
WSL 未找到	未安装 WSL	wsl --install -d Ubuntu-24.04
端口被占用	18789 被其他程序使用	修改 config.env 中的 GATEWAY_PORT
apt-get 超时	网络问题	更换为国内镜像源（见第3篇）
npm 安装慢	国外源	已自动配置淘宝镜像

5.2 Dashboard 无法访问

# 检查端口转发
netsh interface portproxy show all

# 重新配置（如果 WSL IP 变化）
$wslIp = wsl -d Ubuntu-24.04 -e hostname -I
netsh interface portproxy delete v4tov4 listenport=18789 listenaddress=127.0.0.1
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=127.0.0.1 connectport=18789 connectaddress=$wslIp

5.3 模型无回复

本地 Ollama：

# 检查 Ollama 是否运行
Get-Process ollama

# 检查环境变量
[Environment]::GetEnvironmentVariable("OLLAMA_HOST", "User")
# 应为: 0.0.0.0:11434

腾讯混元：

# 检查 API Key 配置
wsl -d Ubuntu-24.04 -e openclaw config get models.providers.tencent-coding-plan.apiKey

---

六、下一步

恭喜你！现在你已经拥有了一个可用的 AI 助手。接下来可以：

方向	推荐阅读
深入理解原理	第3篇：环境准备深度指南
学习脚本编写	第4篇：自动化安装脚本完全解析
配置更多模型	第5篇：大模型配置实战
集成飞书	第6篇：飞书集成与企业部署
排查问题	第7篇：故障排查与运维指南
VS Code 开发	第8篇：VS Code 自动化安装实战

---

七、一键安装脚本详解

如果你想了解 auto-install.bat 做了什么，以下是核心流程：

# 1. 读取 config.env
$config = Get-Content config.env | ConvertFrom-StringData

# 2. 配置 WSL
Set-Content ~/.wslconfig "[wsl2]`nnetworkingMode=NAT"
wsl --shutdown

# 3. 端口转发
$wslIp = wsl -d Ubuntu-24.04 -e hostname -I
netsh interface portproxy add v4tov4 listenport=18789 ...

# 4. WSL 内安装（通过管道传递脚本）
$installScript | wsl -d Ubuntu-24.04 -e bash

# 5. 验证
Test-NetConnection -ComputerName localhost -Port 18789

详细解析见第4篇。

---

参考文献

快速入门

[1] OpenClaw 官方快速开始. https://openclaw.dev/docs/quickstart [EB/OL]. 2024.

[2] Microsoft. WSL 安装指南. https://docs.microsoft.com/zh-cn/windows/wsl/install [EB/OL]. 2024.

安装与配置

[3] Node.js 下载与安装. https://nodejs.org/en/download/ [EB/OL]. 2024.

[4] npm 官方文档. https://docs.npmjs.com/ [EB/OL]. 2024.

[5] Ollama Windows 安装. https://ollama.com/download/windows [EB/OL]. 2024.

故障排查

[6] Microsoft. WSL 故障排查. https://docs.microsoft.com/zh-cn/windows/wsl/troubleshooting [EB/OL]. 2024.

[7] OpenClaw 常见问题. https://openclaw.dev/docs/faq [EB/OL]. 2024.

---

本文完，转载请注明出处。

---

系列文章导航：

• 📎 上一篇：01-OpenClaw概述与架构设计（待上传后添加链接）
• 📎 下一篇：03-环境准备深度指南-WSL网络与依赖配置（待上传后添加链接）
• 📂 系列目录：windows+wsl+OpenClaw 安装指南

觉得有帮助？

• 👍 点个赞支持一下
• ⭐ 收藏备用
• ✅ 关注博主，不错过后续更新
• 💬 有问题欢迎在评论区留言