Windows下OpenClaw避坑指南：千问3.5-35B-A3B-FP8接口调试全记录

1. 为什么需要这篇指南

上周我在Windows 11上尝试部署OpenClaw对接千问3.5-35B-A3B-FP8模型时，遭遇了从环境配置到接口调用的连环坑。官方文档对macOS的支持更友好，而Windows特有的权限管理、路径格式和依赖冲突问题让我花了整整两天时间才跑通全流程。本文将分享我在PowerShell权限处理、npm依赖冲突解决、模型baseUrl配置等关键环节的实战经验。

特别说明：本文所有操作均在Windows 11 22H2专业版完成，OpenClaw版本为v0.8.3，千问模型部署在本地服务器（192.168.1.100:5000）。如果你使用云服务或不同版本，部分细节可能需要调整。

2. 环境准备阶段的三个深坑

2.1 PowerShell权限的终极解法

第一次运行安装命令就遇到了经典错误：

npm install -g openclaw
# 报错：无法加载文件 C:\Program Files\nodejs\openclaw.ps1，因为在此系统上禁止运行脚本

错误本质：Windows默认禁止执行PowerShell脚本。网上常见的Set-ExecutionPolicy RemoteSigned方案其实有安全隐患，我的推荐做法是：

1. 以管理员身份启动PowerShell
2. 创建专属执行策略规则：

New-Item -Path $PROFILE -Type File -Force
code $PROFILE

在打开的配置文件中添加：

function Install-OpenClaw {
    [CmdletBinding()]
    param()
    Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
    npm install -g openclaw
}

这样每次只需调用Install-OpenClaw函数，既保证安全又避免全局修改执行策略。

2.2 npm依赖冲突的破局思路

安装过程中最棘手的问题是node-sass编译失败（特别是同时装有Vue/CRA项目时）。经过多次测试，最稳定的解决方案是：

1. 先清理全局缓存：

npm cache clean --force

2. 指定特定版本安装：

npm install -g openclaw@0.8.3 --ignore-scripts

3. 单独安装缺失模块：

npm install -g node-gyp@latest

关键点：--ignore-scripts参数跳过了可能失败的postinstall阶段，后续再手动补全依赖。

2.3 中文路径的隐藏雷区

OpenClaw默认将配置存储在用户目录下，但中文用户名会导致插件加载异常。如果用户名为中文，必须执行：

[Environment]::SetEnvironmentVariable("OPENCLAW_HOME", "C:\OpenClaw", "User")

然后在C盘创建对应目录并赋予权限：

mkdir C:\OpenClaw
icacls C:\OpenClaw /grant "${env:USERNAME}:(OI)(CI)F"

3. 千问3.5模型对接实战

3.1 baseUrl配置的注意事项

对接本地部署的千问3.5时，配置文件~/.openclaw/openclaw.json需要特别注意：

{
  "models": {
    "providers": {
      "qwen-local": {
        "baseUrl": "http://192.168.1.100:5000/v1",  // 必须带/v1后缀
        "apiKey": "EMPTY",  // 本地部署可填任意值
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-35b-a3b-fp8",
            "name": "千问3.5本地版",
            "contextWindow": 32768,
            "vision": true  // 多模态必须显式声明
          }
        ]
      }
    }
  }
}

易错点：

• 忘记添加/v1路径导致404错误
• 未设置"vision": true导致图片理解功能不可用
• Windows路径反斜杠需要转义（\\）

3.2 多模态任务验证方法

通过PowerShell发送测试请求：

$body = @{
    model = "qwen3-35b-a3b-fp8"
    messages = @(
        @{
            role = "user"
            content = @(
                @{ type = "text"; text = "描述这张图片的内容" },
                @{ type = "image_url"; image_url = @{ url = "file:///C:/test.jpg" } }
            )
        }
    )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Uri "http://127.0.0.1:18789/v1/chat/completions" `
    -Method Post `
    -Body $body `
    -ContentType "application/json"

常见问题排查：

1. 图片路径要用file:///协议且三斜杠
2. 本地图片需要先通过openclaw upload命令上传到工作区
3. 若返回"模型不支持多模态"，检查配置文件中的vision字段

4. 稳定性优化的关键配置

4.1 内存泄漏预防方案

长时间运行后容易出现内存溢出，建议修改网关启动参数：

$env:NODE_OPTIONS="--max-old-space-size=4096"
openclaw gateway start

同时在配置文件中添加：

{
  "gateway": {
    "healthCheckInterval": 300,
    "autoRestart": true  
  }
}

4.2 任务超时机制

对于图片处理等耗时操作，必须设置合理超时：

{
  "skills": {
    "timeout": {
      "default": 60,
      "vision": 120  
    }
  }
}

5. 典型故障排除记录

5.1 错误："Failed to load plugin @m1heng-clawd/feishu"

现象：飞书插件安装成功但加载失败
根因：Windows下npm模块符号链接问题
解决步骤：

1. 删除node_modules缓存：

rm -r ~\.openclaw\node_modules

2. 重新安装并指定完整路径：

openclaw plugins install @m1heng-clawd/feishu --prefix ~\.openclaw

5.2 错误："Model response format invalid"

现象：千问模型能正常响应但OpenClaw报解析错误
调试方法：

1. 开启原始日志：

$env:DEBUG="openclaw:*"
openclaw gateway restart

2. 对比直接调用模型和通过网关调用的响应差异
3. 最终发现需要添加响应适配器：

{
  "models": {
    "adapters": {
      "qwen": {
        "responseFormat": "openai"
      }
    }
  }
}

---

获取更多AI镜像

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