Windows下OpenClaw安装指南：一键对接Phi-3-mini-128k-instruct模型
Windows下OpenClaw安装指南：一键对接Phi-3-mini-128k-instruct模型
1. 为什么选择OpenClaw+Phi-3-mini组合？
去年我在尝试自动化办公流程时，发现市面上的RPA工具要么太笨重，要么需要复杂的编程。直到遇到OpenClaw这个开源智能体框架，它让我能用自然语言指挥AI完成本地文件整理、数据提取等重复工作。而Phi-3-mini-128k-instruct作为微软最新推出的轻量级模型，在指令跟随和上下文理解上表现突出，特别适合作为OpenClaw的"大脑"。
这个组合最吸引我的三点：
- 本地化隐私保护：所有操作都在本机完成，敏感数据不用上传云端
- 轻量高效：Phi-3-mini对硬件要求友好，我的Surface笔记本就能流畅运行
- 自然语言交互：直接说"帮我整理上周的会议记录"就能自动执行
2. 环境准备与基础安装
2.1 系统要求检查
在开始前，请确保你的Windows设备满足：
- Windows 10/11 64位系统
- PowerShell 5.1或更高版本
- 至少8GB内存（推荐16GB）
- 已安装Node.js 16+（可通过
node -v验证）
我最初在Windows Server 2019上安装时遇到兼容性问题，建议普通用户优先使用Windows 10/11。
2.2 管理员权限安装
关键步骤：必须以管理员身份运行PowerShell！这是我踩过的第一个坑：
# 检查npm版本 npm -v # 全局安装OpenClaw npm install -g openclaw@latest --force # 验证安装 openclaw --version如果看到版本号输出（如v0.8.2），说明基础安装成功。我遇到过因公司网络策略导致安装失败的情况，这时需要添加代理：
npm config set proxy http://your.proxy:port npm config set https-proxy http://your.proxy:port3. 配置向导关键操作
3.1 初始化onboard流程
执行以下命令启动配置向导：
openclaw onboard你会看到ASCII艺术字和配置菜单。根据我的经验，建议选择：
- Mode：
Advanced（虽然QuickStart更简单，但我们需要自定义模型） - Provider：选择
Skip for now（后续手动配置Phi-3） - Channels：先跳过（完成核心功能后再加飞书等）
- Skills：选择
Yes启用基础技能模块
配置完成后，会在C:\Users\[用户名]\.openclaw生成配置文件。
3.2 修改配置文件连接Phi-3
找到openclaw.json，在models.providers部分新增（注意替换实际模型地址）：
{ "models": { "providers": { "phi3-mini": { "baseUrl": "http://localhost:8000/v1", // vLLM默认端口 "apiKey": "your-api-key-here", "api": "openai-completions", "models": [ { "id": "phi-3-mini-128k-instruct", "name": "Phi-3 Mini Instruct", "contextWindow": 128000, "maxTokens": 4096 } ] } } } }特别注意：如果Phi-3模型部署在其他设备上，需要将localhost改为实际IP，并确保防火墙放行对应端口。
4. 服务启动与验证
4.1 启动网关服务
openclaw gateway start正常启动会显示类似日志：
[Gateway] Starting on port 18789... [Model] Registered provider: phi3-mini [Skills] 15 basic skills loaded4.2 访问本地控制台
浏览器打开http://localhost:18789，如果看到Web界面，说明服务运行正常。我第一次启动时遇到端口冲突，解决方法：
# 查看占用18789端口的进程 netstat -ano | findstr 18789 # 终止冲突进程（谨慎操作） taskkill /PID [进程ID] /F # 指定新端口启动 openclaw gateway --port 187905. 常见问题解决方案
5.1 模型连接失败排查
现象：Web界面显示"Model not available"
检查步骤：
- 确认Phi-3服务已启动且端口开放
- 在PowerShell测试连通性：
curl -X POST "http://localhost:8000/v1/completions" -H "Content-Type: application/json" -d '{"model": "phi-3-mini-128k-instruct", "prompt": "Hello"}'- 如果返回403错误，检查vLLM启动参数是否包含
--api-key your-api-key-here
5.2 权限问题处理
典型报错：
[Error] Permission denied when accessing C:\Program Files\解决方案：
- 为OpenClaw创建专用工作目录：
mkdir C:\OpenClawWorkspace- 修改配置文件中的
workspace路径指向该目录 - 对目录赋予完全控制权限：
icacls "C:\OpenClawWorkspace" /grant "Users":(OI)(CI)F6. 第一个自动化任务实践
验证安装是否成功的终极方法——让OpenClaw+Phi-3实际干活。尝试执行：
openclaw run "请创建一个包含本周工作计划的Markdown文件"如果一切正常，你会看到：
- Phi-3生成合理的计划内容
- 自动在工作目录创建
weekly_plan.md文件 - 控制台返回任务执行结果
性能提示：如果响应慢，可以调整Phi-3的vLLM参数，如--max-num-seqs=16提高并发处理能力。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。