大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



去年我在帮一个设计师朋友搭建自动化工作流时，第一次尝试在Windows上部署OpenClaw。当时踩了不少坑——从PowerShell权限问题到模型接口编码错误，整个过程就像在玩扫雷游戏。但最终成功对接GLM-4-Flash模型后，看着他通过自然语言指令自动整理设计稿和生成说明文档，这种成就感让我决定把经验系统化整理出来。

Windows环境下的自动化工具往往面临两个困境：要么功能太简单（如基础宏命令），要么配置太复杂（需要整套DevOps工具链）。OpenClaw恰好处于中间地带——既能通过大模型理解复杂指令，又保持了个人电脑可部署的轻量特性。特别是搭配GLM这类中文友好的本地模型时，可以避开网络延迟和API调用限制，实现真正的"离线智能助手"。

2.1 PowerShell权限的正确打开方式

大多数安装失败都始于权限问题。不同于Linux/macOS，Windows默认会阻止脚本执行。我推荐以下组合拳：

1. 以管理员身份启动PowerShell（右键菜单选择）
2. 先执行策略检查：

Get-ExecutionPolicy 

如果返回Restricted，需要临时放宽策略：

GPT plus 代充 只需 145Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass 

注意：这只会影响当前会话，关闭窗口后自动恢复默认策略，兼顾安全与便利

3. 安装完成后建议恢复默认值：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted 

2.2 Node.js与npm的版本玄学

OpenClaw对Node版本相对敏感，经过多次测试，我锁定以下组合最稳定：

• Node.js v18.16.0 LTS（不要用最新版）
• npm 9.5.1（随Node自带）

验证安装时别只看版本号，要检查关键模块路径：

GPT plus 代充 只需 145where node where npm 

如果出现多个路径，需要清理旧版本避免冲突。有个隐蔽问题容易忽略——系统PATH中如果有中文目录，可能导致模块加载失败，建议安装到全英文路径如C:DevTools odejs。

2.3 前置依赖的手动补全

官方脚本有时会漏装部分依赖，我习惯提前手动安装：

choco install -y git python3 make 

特别是windows-build-tools这个包，很多npm原生模块编译时需要：

GPT plus 代充 只需 145npm install –global windows-build-tools –vs2015 

经验：在咖啡机旁放个计时器，这步通常需要15-20分钟

3.1 安装过程的三个选择点

执行核心安装命令时：

npm install -g openclaw@latest 

会遇到几个关键选择：

1. 安全警告：npm会提示潜在风险，此时按y继续即可
2. 可选依赖：建议全部安装（按回车默认选择）
3. 符号链接：出现optional dep failed警告时可忽略，不影响主体功能

安装完成后不要急着运行，先做完整性检查：

GPT plus 代充 只需 145openclaw –version

应该输出类似 v0.9.1 的版本号

Get-Command openclaw | Format-List *

确认Source是正确路径

3.2 初始化配置的避坑策略

运行openclaw onboard时，Windows环境有几个特殊注意点：

1. 配置文件路径：默认在\(env:USERPROFILE.openclaw，建议先用资源管理器确认该目录可写
2. 防毒软件干扰：特别是实时扫描功能可能阻断网关启动，建议临时添加例外
3. 编码问题预防：提前执行：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8 \)env:NODE_OPTIONS=“–loader=ts-node/esm” 

在配置向导中：

• 模型选择阶段选Advanced
• 遇到Provider时选择Custom
• 暂时跳过渠道配置（后续可单独添加）

4.1 本地ollama服务准备

假设已通过星图镜像部署好GLM-4-Flash服务，关键验证步骤：

GPT plus 代充 只需 145curl http://localhost:11434/api/generate -d ‘{ “model”: “glm-4-flash”, “prompt”: “你好” }’ | Select-Object -ExpandProperty Content 

正常应返回JSON格式响应。常见问题排查：

• 端口冲突：检查11434是否被占用
• 内存不足：GLM-4-Flash需要至少8GB可用内存
• 编码错误：添加-H “Content-Type: application/json”请求头

4.2 OpenClaw配置关键字段

修改openclaw.json的模型配置段时，这些参数最容易出错：

{ “models”: {

GPT plus 代充 只需 145"providers": { "glm-local": { "baseUrl": "http://localhost:11434/api", // 注意尾部的/api "apiKey": "null", // ollama不需要key但必须保留字段 "api": "openai-completions", // 协议类型 "models": [ { "id": "glm-4-flash", "name": "本地GLM4闪存版", "contextWindow": 32768, "maxTokens": 8192, "timeout": 60000 // Windows建议调大超时 } ] } } 

} }

血泪教训：baseUrl末尾的/api必须保留，否则会报404

4.3 编码问题的终极解决方案

Windows环境下中文乱码问题尤为突出，我总结出三层防御：

1. 系统级设置：

Set-ItemProperty -Path ‘HKCU:Console’ -Name ‘OutputEncoding’ -Value 65001 \(env:NODE_OPTIONS="--loader=ts-node/esm --experimental-specifier-resolution=node" 

2. OpenClaw启动脚本： 在网关启动命令前添加编码声明：

GPT plus 代充 只需 145\)env:PYTHONIOENCODING=“utf-8” $env:LANG=“en_US.UTF-8” openclaw gateway start 

3. 模型调用时的Content-Type： 在自定义技能中强制指定：

headers: 

5.1 服务启动的三种姿势

1. 前台调试模式（推荐初期使用）：

GPT plus 代充 只需 145openclaw gateway –port 18789 –log-level debug 

优势：实时看到错误日志，Ctrl+C可立即终止

2. 后台服务模式：

openclaw gateway start 

验证是否运行：

GPT plus 代充 只需 145Get-Process -Name “openclaw” -ErrorAction SilentlyContinue 

3. Windows服务模式（长期运行首选）：

nssm install OpenClawGateway “C:path o ode.exe” “C:path oopenclaw” gateway start nssm start OpenClawGateway 

5.2 日志分析的三个关键点

查看日志文件（默认在~/.openclaw/logs/）时重点关注：

1. 模型连接阶段：

GPT plus 代充 只需 145[ModelConnector] Initializing provider: glm-local 

如果卡在这里，通常是baseUrl不可达

2. 心跳检测记录：

[Gateway] Health check passed for model glm-4-flash 

缺失此记录说明模型未正确注册

3. 编码转换警告：

GPT plus 代充 只需 145[Babel] Warning: Invalid UTF-8 detected 

出现时需要检查前文的编码设置

6.1 基础功能测试三部曲

1. 模型列表查询：

openclaw models list 

正常应显示glm-4-flash状态为active

2. 简单指令测试：

GPT plus 代充 只需 145openclaw exec “写首关于咖啡的诗” 

观察是否生成符合GLM风格的中文内容

3. 文件操作测试：

openclaw exec “在桌面创建test.txt，内容为Hello World” 

检查桌面是否确实出现该文件

6.2 复杂任务验证案例

测试一个包含多步骤的实际任务：

GPT plus 代充 只需 145“查找C盘下所有.jpg文件，统计大小后生成Markdown报告” 

成功执行的标志：

1. 控制台输出统计表格
2. 生成photo_report.md文件
3. 日志中出现完整的任务分解记录

如果失败，通常会在日志中看到类似：

[Skill:file-search] Error: EPERM: operation not permitted 

这时需要检查文件系统权限而非模型问题

问题1：安装时卡在node-gyp rebuild

• 解决方案：手动安装VS Build Tools后重试
• 根治方法：提前执行npm config set msvs_version 2015

问题2：模型响应慢或超时

• 检查点：ollama服务日志是否有OOM警告
• 调优参数：在模型配置中增加“timeout”:

问题3：中文变成乱码

• 立即检查：PowerShell是否处于UTF-8模式（chcp 65001）
• 长期方案：修改系统区域设置为中文(简体,中国)

问题4：飞书等渠道无法连接

• 关键验证：先用curl测试本地网关是否可达

GPT plus 代充 只需 145curl http://127.0.0.1:18789/api/health 

• 配置要点：检查防火墙是否放行18789端口

---

获取更多AI镜像

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