Windows下OpenClaw安装指南：一键部署Qwen3-14b_int4_awq镜像

Windows下OpenClaw安装指南：一键部署Qwen3-14b_int4_awq镜像

1. 为什么选择OpenClaw+Qwen3本地组合

上周我在整理团队技术文档时，发现每天要重复执行十几个机械操作：从不同文件夹收集日志、转换格式、生成汇总表格。当我第三次因为手工操作出错而返工时，终于决定试试OpenClaw这个号称"能像人类一样操作电脑"的AI智能体框架。

选择Qwen3-14b_int4_awq镜像是因为它的量化版本在保持90%以上准确率的同时，显存占用只有原版的1/4。我的RTX 3060笔记本（12GB显存）跑起来完全无压力，实测连续工作8小时显存占用稳定在9GB左右。这种组合特别适合需要长期后台运行的自动化任务。

2. 环境准备与基础安装

2.1 系统要求检查

在开始前，请确保你的Windows设备满足：

• 操作系统：Windows 10 21H2或更高版本（实测11代i5+16GB内存足够流畅运行）
• PowerShell版本：5.1或更高（输入$PSVersionTable.PSVersion查看）
• Node.js环境：建议v18+（后续安装会自带，但已有环境需确认兼容性）

2.2 管理员权限安装

关键步骤：必须使用管理员权限打开PowerShell！这是我踩过的第一个坑：普通权限安装后会出现服务启动失败。

# 以管理员身份运行PowerShell后执行 npm install -g openclaw@latest openclaw --version # 验证安装，应输出类似0.8.2的版本号

如果遇到npm command not found，需要先安装Node.js。推荐使用官方LTS版本：

winget install OpenJS.NodeJS.LTS

3. 配置向导关键选择

运行openclaw onboard会进入交互式配置，这几个选项直接影响后续使用体验：

3.1 模式选择

? 选择配置模式 (Use arrow keys) ❯ QuickStart (推荐新手) Advanced (自定义参数)

第一次使用建议选QuickStart，它会：

• 自动启用基础技能模块
• 使用默认端口(18789)
• 跳过复杂的安全配置

3.2 模型提供方配置

这是连接Qwen镜像的关键步骤：

? 选择模型提供方 Qwen (官方渠道) OpenAI (需API Key) ❯ Custom (自定义地址)

选择Custom后，需要输入：

• 基础URL：你的Qwen3-14b_int4_awq镜像服务地址（如http://localhost:8000/v1）
• API Key：留空或任意字符（本地部署通常不需要）
• 模型ID：建议填写qwen3-14b-awq保持识别一致性

4. 配置文件手动优化

自动生成的~/.openclaw/openclaw.json可能需要手动调整。用VS Code打开后重点关注：

{ "models": { "providers": { "custom": { "baseUrl": "http://localhost:8000/v1", "apiKey": "任意值", "api": "openai-completions", "models": [{ "id": "qwen3-14b-awq", "name": "本地Qwen量化版", "contextWindow": 32768 }] } } } }

特别提醒：如果Qwen镜像使用了非标准端口或路径，需要确保baseUrl与vLLM启动参数一致。我遇到过因为漏写/v1导致一直连接超时的情况。

5. 服务启动与验证

5.1 启动网关服务

openclaw gateway start # 查看状态 openclaw gateway status

正常启动会显示：

Gateway running on port 18789 Model providers: [custom] Connected channels: []

5.2 测试模型连接

在PowerShell执行：

openclaw models list

应返回类似：

[ { "id": "qwen3-14b-awq", "name": "本地Qwen量化版", "provider": "custom" } ]

6. 常见问题解决方案

6.1 权限错误排查

现象：安装时报EPERM: operation not permitted

# 解决方案 Set-ExecutionPolicy RemoteSigned -Force npm cache clean --force

6.2 端口冲突处理

如果18789端口被占：

# 查看占用进程 netstat -ano | findstr 18789 # 修改配置文件中端口后重启 openclaw gateway restart

6.3 模型连接超时

检查vLLM服务是否正常：

curl http://localhost:8000/v1/models

正常应返回：

{"object":"list","data":[{"id":"qwen3-14b-awq"}]}

7. 第一个自动化任务实践

验证安装成功后，可以尝试基础文件操作：

1. 在Web控制台(http://localhost:18789)输入： "请在我的桌面创建test文件夹，并生成包含当前日期的文本文件"
2. OpenClaw会：
   • 调用Qwen理解指令
   • 规划操作步骤
   • 执行文件系统操作
3. 桌面会出现test/YYYY-MM-DD.txt文件

效率对比：过去手动操作需要2分钟的任务，现在10秒内完成。更重要的是可以半夜挂着脚本批量处理上百个文件。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。