
OpenClaw安装指南Windows下对接GLM-4.7-Flash模型服务1. 环境准备Windows下的基础配置在开始安装OpenClaw之前我们需要确保Windows系统满足基本运行条件。不同于macOS的Unix环境Windows需要特别注意权限管理和路径处理。我的工作机是一台搭载Windows 11的Surface笔记本配置为16GB内存和i7处理器。实际测试发现即使没有独立显卡CPU版本的GLM-4.7-Flash也能正常运行基础功能。以下是关键准备步骤首先以管理员身份打开PowerShell这是后续所有操作的入口执行系统环境检查# 检查PowerShell版本需5.1 $PSVersionTable.PSVersion # 检查Node.js是否安装需v18 node -v如果尚未安装Node.js建议通过官方安装包而非Windows应用商店获取。我最初使用商店版时遇到了路径权限问题改用下载的.msi安装包后解决。安装时务必勾选自动安装必要工具选项这会同时安装Python和C编译环境。2. OpenClaw核心安装流程Windows下的安装方式与类Unix系统有所不同。经过多次测试我总结出最稳定的安装路径# 清除可能的旧版本 npm uninstall -g openclaw # 设置镜像源国内用户建议 npm config set registry https://registry.npmmirror.com # 全局安装核心包 npm install -g openclawlatest --scripts-prepend-node-path安装完成后会遇到第一个关键点环境变量配置。OpenClaw需要将安装目录加入系统PATH但npm的全局安装位置可能因Node.js版本而变化。通过以下命令定位实际安装路径npm root -g将输出的路径如C:\Users\你的用户名\AppData\Roaming\npm\node_modules添加到系统环境变量。我建议直接在用户变量中添加避免系统级修改带来的权限问题。3. 对接GLM-4.7-Flash模型服务假设已在本地通过ollama部署好GLM-4.7-Flash默认服务地址为http://localhost:11434现在需要将其接入OpenClaw。配置文件位于C:\Users\你的用户名\.openclaw\openclaw.json我们需要编辑models部分{ models: { providers: { ollama-glm: { baseUrl: http://localhost:11434, api: openai-completions, models: [ { id: glm-4.7-flash, name: GLM-4.7-Flash Local, contextWindow: 32768 } ] } } } }这里有个细节需要注意ollama的API端点与标准OpenAI略有不同。经过抓包分析我发现需要额外添加/v1路径才能正确访问。因此实际配置中应将baseUrl设为http://localhost:11434/v1。4. 初始化配置与网关启动执行初始化命令时会遇到Windows特有的防火墙提示openclaw onboard在配置向导中选择Advanced模式Provider选择Skip for now因为我们已手动配置渠道接入建议先跳过基础技能选择Yes启动网关服务时建议使用以下命令避免端口冲突openclaw gateway --port 18789如果遇到端口占用可通过netstat -ano查找占用进程。我遇到过系统保留端口导致的问题最终通过修改注册表HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP中的Start值为4解决了冲突。5. 常见问题排查指南根据实际部署经验我整理了Windows平台特有的问题及解决方案问题1安装后openclaw命令未识别检查npm全局安装路径是否在PATH中重启PowerShell终端尝试全路径执行 $(npm root -g)\openclaw\bin\openclaw --version问题2网关启动后无法访问管理界面检查Windows防火墙是否放行18789端口尝试curl http://localhost:18789测试本地连通性查看日志Get-Content $env:USERPROFILE\.openclaw\logs\gateway.log -Wait问题3模型调用超时确认ollama服务正在运行curl http://localhost:11434/api/tags检查OpenClaw配置中的baseUrl是否包含/v1路径在PowerShell中测试模型连通性$body { model glm-4.7-flash prompt 测试 } | ConvertTo-Json Invoke-RestMethod -Uri http://localhost:11434/v1/completions -Method Post -Body $body -ContentType application/json6. 验证与日常使用成功启动后可以通过两种方式验证功能完整性方法1Web控制台测试访问http://localhost:18789在交互界面输入请用GLM-4.7-Flash总结OpenClaw的核心功能观察是否返回合理结果。方法2命令行直接调用openclaw exec 列出当前目录下的Markdown文件我在日常使用中建立了几个实用别名放在$PROFILE文件中function oc-start { openclaw gateway start } function oc-stop { openclaw gateway stop } function oc-test { openclaw exec 测试GLM模型连接 }这种配置方式让OpenClaw在Windows下的使用体验接近Linux环境大大提高了工作效率。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。