Windows下OpenClaw安装详解：对接千问3.5-9B模型接口

1. 为什么选择OpenClaw+千问3.5-9B组合

去年我在尝试自动化办公流程时，发现市面上的RPA工具要么太笨重，要么需要将敏感数据上传到云端。直到遇到OpenClaw这个开源框架，它让我能在本地电脑上实现"AI员工"的效果——通过自然语言指令完成文件整理、数据收集等重复工作。

这次选择千问3.5-9B模型作为后端，主要看中它的三个特性：

• 中文理解能力强：相比其他开源模型，在处理中文办公文档时错误率更低
• 适中的资源消耗：9B参数量在消费级显卡上就能流畅运行
• 长文本处理优势：32K上下文窗口特别适合处理我的周报、会议纪要等文档

2. 安装前的准备工作

2.1 系统环境确认

在开始前，请确保你的Windows系统满足以下条件：

• Windows 10/11 64位专业版或企业版（家庭版可能遇到权限问题）
• PowerShell 5.1+（输入$PSVersionTable查看版本）
• 已安装Node.js 18+（建议通过nvm-windows管理多版本）

我最初在Windows家庭版上尝试安装时，就遇到了服务注册失败的问题。后来改用专业版后，所有权限问题都迎刃而解。

2.2 管理员权限获取

OpenClaw需要向系统注册后台服务，因此必须使用管理员权限的PowerShell：

1. 在开始菜单搜索"PowerShell"
2. 右键选择"以管理员身份运行"
3. 执行Start-Process powershell -Verb RunAs进行二次确认

3. 核心安装流程

3.1 通过npm全局安装

在管理员PowerShell中执行以下命令：

# 清除可能存在的旧版本
npm uninstall -g openclaw

# 安装最新稳定版
npm install -g openclaw@latest

# 验证安装
openclaw --version

如果看到版本号输出（如v0.8.2），说明基础安装成功。我首次安装时因为网络问题超时失败，添加淘宝镜像源后解决了：

npm config set registry https://registry.npmmirror.com

3.2 初始化配置向导

执行关键配置命令：

openclaw onboard

你会看到交互式配置界面，这里重点说明几个关键选项：

1. Mode选择：

   • 新手建议选QuickStart（自动配置默认参数）
   • 像我这样需要对接特定模型的选Advanced

2. Provider选择：

   • 使用方向键选择Qwen（千问系列）
   • 不要选择Skip for now，否则后续需要手动修改配置文件

3. Default model：

   • 输入qwen3.5-9b（注意字母全小写）
   • 如果本地已部署模型服务，选Custom并输入API地址

4. Channels：

   • 国内用户可以先跳过（按空格取消选择）
   • 后续可在配置文件中单独添加飞书/钉钉集成

4. 模型接口对接实战

4.1 配置文件修改

完成向导后，需要手动检查配置文件（通常位于C:\Users\[用户名]\.openclaw\openclaw.json）。找到models部分，确保配置如下：

{
  "models": {
    "providers": {
      "qwen": {
        "baseUrl": "http://localhost:8080/v1", // 替换为你的模型服务地址
        "apiKey": "your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-9b",
            "name": "Qwen-3.5-9B-Local",
            "contextWindow": 32768
          }
        ]
      }
    }
  }
}

如果你使用的是星图平台提供的千问镜像，baseUrl应该替换为平台分配的外部访问地址。

4.2 防火墙设置

Windows Defender防火墙经常会拦截本地服务通信。需要开放18789端口：

New-NetFirewallRule -DisplayName "OpenClaw Gateway" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow

我曾因为忘记这个步骤，导致管理界面一直无法访问，浪费了半小时排查。

5. 服务启动与验证

5.1 启动网关服务

在PowerShell中执行：

openclaw gateway start

正常启动会看到类似输出：

[info] Gateway service started on port 18789
[info] Model provider 'qwen' initialized

5.2 常见启动问题解决

问题1：端口冲突

Error: listen EADDRINUSE: address already in use :::18789

解决方案：

# 查找占用进程
netstat -ano | findstr 18789
# 终止对应进程
taskkill /PID [进程ID] /F

问题2：模型连接失败

[error] Failed to initialize model provider: connect ECONNREFUSED

检查步骤：

1. 确认模型服务已运行（如本地部署的千问服务）
2. 测试接口连通性：

curl -X POST "http://localhost:8080/v1/completions" -H "Content-Type: application/json" -d '{"model":"qwen3.5-9b","prompt":"test"}'

3. 如果使用平台服务，检查白名单和API Key

6. 基础功能测试

成功启动后，在浏览器访问http://localhost:18789打开管理界面。建议进行三项基础测试：

1. 基础指令测试：

   • 在对话窗口输入"列出当前目录文件"
   • 观察是否返回正确的文件列表

2. 模型能力测试：

   • 输入"用100字总结OpenClaw的核心价值"
   • 检查返回内容是否连贯合理

3. 自动化流程测试：

   • 输入"创建一个名为test的文件夹，在里面生成一个包含随机数字的txt文件"
   • 检查文件系统是否按预期变化

我在首次测试时发现模型响应特别慢，后来发现是本地显存不足。改用平台提供的GPU实例后，响应速度从15秒提升到2秒以内。

7. 进阶配置建议

7.1 开机自启动

为了让OpenClaw在电脑启动时自动运行，可以创建计划任务：

$action = New-ScheduledTaskAction -Execute "powershell.exe" -Argument "-NoProfile -Command `"openclaw gateway start`""
$trigger = New-ScheduledTaskTrigger -AtStartup
Register-ScheduledTask -TaskName "OpenClaw Gateway" -Action $action -Trigger $trigger -RunLevel Highest

7.2 性能调优

在openclaw.json中添加这些参数可以提升响应速度：

{
  "gateway": {
    "timeout": 30000,
    "maxRetries": 3
  },
  "models": {
    "qwen": {
      "timeout": 60000,
      "temperature": 0.3  // 降低随机性，适合确定性任务
    }
  }
}

8. 安全注意事项

1. 权限控制：

   • 不要长期使用管理员权限运行网关服务
   • 建议创建专用系统账户运行OpenClaw

2. 操作审计：

   # 查看操作日志
   Get-Content ~\.openclaw\logs\gateway.log -Tail 50
   

3. 敏感数据保护：

   • 避免让AI处理含有密码、密钥的文件
   • 可以在配置中设置文件访问黑名单

经过一个月的实际使用，这个组合已经能帮我自动处理60%以上的文档整理工作。最让我惊喜的是，通过简单的自然语言指令就能完成复杂的多步骤操作，比如"把上周的所有会议录音转文字，提取关键决策点生成Markdown报告"。

---

获取更多AI镜像

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