Windows下OpenClaw安装详解：千问3.5-9B接口配置全流程

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

去年我在尝试自动化办公流程时，发现市面上的RPA工具要么太笨重，要么需要频繁上传数据到云端。直到遇到OpenClaw这个开源的本地化AI智能体框架，配合千问3.5-9B这样的中量级大模型，终于找到了个人开发者和小团队的"甜点方案"。

这个组合最吸引我的三点在于：

• 数据不出本地：所有操作都在本机完成，处理敏感文档时特别安心
• 开发友好：通过npm就能安装，配置文件是标准的JSON格式
• 模型可选：既可以用平台部署的千问，也能切换到自己微调的版本

不过要注意的是，这种方案更适合个人或小团队的自动化场景。如果是企业级的生产系统，可能需要更专业的商业解决方案。

2. 环境准备与基础安装

2.1 系统要求检查

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

• Windows 10 21H2或更高版本
• PowerShell 5.1+（管理员权限运行）
• Node.js 16+（建议安装LTS版本）
• 至少8GB可用内存（千问3.5-9B运行时需要约6GB）

我曾在Surface Pro 7（16GB内存）和一台老旧的Dell笔记本（8GB内存）上都成功运行过，但后者在处理复杂任务时明显吃力。如果你的设备性能有限，可以考虑先试用更小参数的模型。

2.2 管理员权限安装

关键步骤：必须使用管理员权限的PowerShell！这是我踩过的第一个坑——普通权限安装后会出现各种奇怪的权限错误。

# 以管理员身份打开PowerShell后执行
npm install -g openclaw

安装完成后验证版本：

openclaw --version
# 预期输出类似：1.2.3

如果遇到command not found错误，可能是Node.js路径没加入系统PATH。可以尝试：

# 重新加载环境变量
refreshenv
# 再次检查版本
openclaw --version

3. 初始化配置向导

3.1 运行onboard向导

安装完成后，运行配置向导：

openclaw onboard

这里会遇到几个关键配置项，我的选择建议是：

1. Mode选择：

   • 新手选QuickStart（自动配置基础参数）
   • 需要自定义端口或模型时选Advanced

2. Provider选择：

   • 本地部署的千问选Qwen
   • 如果使用平台提供的接口地址选Custom

3. Default model：

   • 确保选择qwen3.5-9b（如果对接的是这个版本）

4. Channels：

   • 国内用户可以先跳过，后续再单独配置飞书等渠道

3.2 配置文件位置

所有配置最终会保存在这个文件：

~/.openclaw/openclaw.json

建议安装完成后立即备份这个文件。我有次误删后不得不重新走一遍配置流程，相当耗时。

4. 对接千问3.5-9B模型

4.1 模型地址配置

对接千问3.5-9B有两种主要方式：

方式一：使用平台提供的接口地址

{
  "models": {
    "providers": {
      "qwen-platform": {
        "baseUrl": "https://your-platform-domain.com/v1",
        "apiKey": "your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-9b",
            "name": "Qwen-3.5-9B-Platform",
            "contextWindow": 8192,
            "maxTokens": 2048
          }
        ]
      }
    }
  }
}

方式二：本地部署的模型服务

如果你在本地部署了千问的API服务（比如通过星图镜像），配置类似：

{
  "models": {
    "providers": {
      "qwen-local": {
        "baseUrl": "http://localhost:8080/v1",
        "apiKey": "none",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-9b",
            "name": "Qwen-3.5-9B-Local",
            "contextWindow": 8192,
            "maxTokens": 2048
          }
        ]
      }
    }
  }
}

4.2 网络与防火墙设置

这是最容易出问题的环节。根据我的经验，需要特别注意：

1. 防火墙放行：
   • 开放OpenClaw网关端口（默认18789）
   • 如果对接本地模型服务，放行模型API端口（如8080）

# 检查端口监听状态
netstat -ano | findstr 18789

# 添加防火墙规则（管理员权限）
New-NetFirewallRule -DisplayName "OpenClaw Gateway" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow

2. 连通性测试：

# 测试模型API连通性
curl http://localhost:8080/v1 -Method POST -Headers @{"Content-Type"="application/json"} -Body '{"model":"qwen3.5-9b"}'

# 预期返回类似：{"object":"list","data":[...]}

如果遇到连接超时，可能是：

• 模型服务未启动
• 端口被占用
• 防火墙阻止

5. 服务启动与验证

5.1 启动网关服务

# 常规启动
openclaw gateway start

# 或指定端口
openclaw gateway --port 18789

建议首次运行时不要加--daemon参数，方便查看实时日志。

5.2 访问控制台

浏览器打开：

http://localhost:18789

如果页面无法加载：

1. 检查服务是否真的启动成功
2. 尝试127.0.0.1替代localhost
3. 清除浏览器缓存后重试

5.3 模型连接测试

在控制台输入简单指令测试：

请用中文回答：OpenClaw是什么？

预期会看到千问模型生成的回答。如果超时或报错，需要检查：

1. 模型配置中的baseUrl是否正确
2. 模型服务是否健康（直接curl测试）
3. 网络代理设置（如果有）

6. 常见问题排查

根据我的踩坑经验，整理了几个典型问题：

问题一：模型响应慢

• 检查任务管理器，确认没有其他程序占用大量内存
• 尝试降低maxTokens参数值
• 如果是平台接口，可能是网络延迟导致

问题二：安装后命令不可用

• 重新打开PowerShell终端
• 检查Node.js是否安装成功
• 确认npm全局安装路径在系统PATH中

问题三：跨设备访问被拒绝

• 修改配置文件中的host从127.0.0.1改为0.0.0.0
• 配置防火墙放行对应端口
• 注意：这样会暴露服务到局域网，确保做好安全措施

问题四：模型返回乱码

• 检查系统区域设置是否为中文
• 确认模型配置中的contextWindow与模型实际能力匹配
• 尝试在请求头中添加"Accept-Charset": "utf-8"

7. 进阶配置建议

当基础功能跑通后，可以考虑这些优化：

1. 飞书/钉钉集成：

   • 安装对应插件：openclaw plugins install @m1heng-clawd/feishu
   • 配置企业自建应用凭证
   • 好处：可以直接在办公IM里触发自动化任务

2. 技能市场探索：

   # 搜索可用技能
   clawhub search --keyword "办公"
   
   # 安装文件处理技能
   clawhub install file-processor
   

3. 性能调优：

   • 在openclaw.json中调整maxTokens和temperature
   • 对时间敏感任务，设置合理的timeout参数
   • 考虑使用更轻量的模型处理简单任务

这套配置我已经稳定使用了三个月，主要用来处理日报生成、资料归档和简单的数据清洗工作。虽然初期配置花了些时间，但一旦跑通，确实能节省大量重复劳动时间。

---

获取更多AI镜像

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