OpenClaw极简配置法：千问3.5-35B-A3B-FP8快速接入指南

1. 为什么选择极简配置法

上周我在测试OpenClaw对接本地大模型时，被冗长的onboard向导折磨得够呛——光是模型选择、渠道配置、技能安装就花了半小时。直到发现直接修改openclaw.json的baseUrl字段就能跳过所有流程，才意识到技术尝鲜其实可以更简单。

这种方法特别适合以下场景：

• 你已经在本地或云端部署了千问3.5-35B-A3B-FP8模型服务
• 只想快速验证OpenClaw能否与模型正常交互
• 暂时不需要飞书/钉钉等沟通渠道集成
• 希望用最少的配置步骤完成基础功能测试

2. 五分钟完成模型接入

2.1 定位配置文件

首先找到OpenClaw的核心配置文件。在macOS/Linux系统默认路径为：

~/.openclaw/openclaw.json

如果找不到该文件，可以执行以下命令生成默认配置：

openclaw onboard --generate-only

2.2 修改模型端点

用任意文本编辑器打开配置文件，找到或添加models.providers字段。以下是接入千问3.5-35B-A3B-FP8的最小配置示例：

{
  "models": {
    "providers": {
      "qwen-local": {
        "baseUrl": "http://你的模型服务IP:端口/v1",
        "apiKey": "任意非空字符串",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-35b-a3b-fp8",
            "name": "本地千问3.5",
            "contextWindow": 32768
          }
        ]
      }
    }
  }
}

关键参数说明：

• baseUrl：模型服务的HTTP端点，确保端口与模型部署时一致
• apiKey：本地模型可不验证，但字段必须存在
• api：固定为openai-completions以使用兼容协议
• id：建议与模型实际名称保持一致便于识别

2.3 重启网关服务

保存修改后，需要重启OpenClaw网关使配置生效：

openclaw gateway restart

验证模型是否成功加载：

openclaw models list

正常情况应看到类似输出：

✔ 已加载模型提供方: qwen-local
  - qwen3.5-35b-a3b-fp8 (本地千问3.5)

3. 基础任务验证

3.1 文件读写测试

通过OpenClaw控制台（http://127.0.0.1:18789）或直接使用CLI发送测试指令：

请在我的桌面创建test.txt文件，内容为"OpenClaw接入测试"

成功执行后你会看到：

1. 桌面出现test.txt文件
2. 文件内容准确写入指定文本
3. 控制台返回类似响应：

{
  "status": "success",
  "data": {
    "path": "/Users/你的用户名/Desktop/test.txt",
    "action": "create_and_write"
  }
}

3.2 网页搜索验证

测试更复杂的多步骤任务：

搜索最近三天关于OpenClaw的技术文章，将前3条结果的标题和URL保存到search_results.csv

理想情况下OpenClaw会：

1. 自动打开默认浏览器
2. 执行关键词搜索
3. 提取指定信息
4. 生成结构化CSV文件

4. 常见问题排查

4.1 模型服务未响应

如果任务长时间挂起或报错，首先检查模型服务状态：

curl -X POST http://你的模型服务IP:端口/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"qwen3.5-35b-a3b-fp8","messages":[{"role":"user","content":"ping"}]}'

正常应返回JSON格式的模型响应。如果连接失败，检查：

• 模型服务是否正常运行
• 防火墙是否放行端口
• baseUrl是否包含正确的协议头（http/https）

4.2 文件权限问题

在Linux/macOS遇到文件操作失败时，尝试：

chmod 755 ~/.openclaw
sudo chown -R $(whoami) ~/.openclaw

4.3 模型响应超时

在配置文件中增加超时设置：

"qwen-local": {
  "timeout": 30000,
  // 其他参数不变
}

5. 安全注意事项

虽然极简配置方便，但要注意：

1. 最小权限原则：不要用root权限运行OpenClaw服务
2. 网络隔离：如果模型服务在公网，建议配置IP白名单
3. 操作确认：关键文件操作前可添加"requireConfirmation": true配置项
4. 定期检查：监控~/.openclaw/logs/operation.log中的敏感操作记录

这种配置方式就像给OpenClaw装上了"直连管道"，跳过了所有中间环节。虽然牺牲了一些功能完整性，但换来了极致的验证速度——我的测试显示，从修改配置到完成首个任务平均只需2分37秒。

---

获取更多AI镜像

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