零基础玩转OpenClaw：千问3.5-9B模型接入保姆级教程
零基础玩转OpenClaw：千问3.5-9B模型接入保姆级教程
1. 为什么选择OpenClaw+千问3.5-9B组合
去年我在整理个人知识库时，发现每天要花2小时重复处理文档归类、信息检索和笔记整理。直到尝试用OpenClaw对接千问3.5-9B模型后，这些工作变成了自动化的流水线作业。这个组合最吸引我的地方在于：
- 完全本地化：所有操作都在自己电脑完成，敏感的工作文档不用上传到第三方服务器
- 成本可控：相比直接调用商业API，本地部署的千问3.5-9B模型按需运行，长期使用更经济
- 灵活扩展：通过OpenClaw的Skill系统，可以给模型添加文件操作、网页访问等实际能力
不过第一次配置时，我在模型地址验证环节卡了整整半天。本文将把踩过的坑都标注出来，帮你一次性跑通全流程。
2. 环境准备与OpenClaw安装
2.1 基础环境检查
打开终端执行以下命令，确保系统满足最低要求：
# 检查操作系统版本（Mac/Linux适用） uname -a # 检查内存（建议4GB以上） free -h || sysctl hw.memsize # Linux/Mac分别对应的命令 # 检查Node.js版本（需v18+） node -v如果缺少Node.js环境，推荐用nvm管理多版本：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install 182.2 一键安装OpenClaw
执行官方安装脚本（国内用户可加上代理前缀）：
curl -fsSL https://openclaw.ai/install.sh | bash常见报错处理：
Permission denied：在命令前添加sudonpm ERR!：先运行npm cache clean --force- 网络超时：尝试
curl --retry 3 -fsSL...
安装完成后验证版本：
openclaw --version # 应输出类似 v0.8.1 的版本号3. 千问3.5-9B模型配置
3.1 获取模型访问地址
假设你已经通过星图平台部署好千问3.5-9B镜像，会得到类似这样的服务地址：
http://127.0.0.1:8000/v1 # 本地部署示例 https://your-domain.com/qwen-api # 云端地址示例关键验证步骤：
curl -X POST "你的模型地址/chat/completions" \ -H "Content-Type: application/json" \ -d '{"model":"qwen3.5-9b","messages":[{"role":"user","content":"你好"}]}'正常应返回JSON格式的模型响应。
3.2 修改OpenClaw配置文件
定位配置文件（通常位于~/.openclaw/openclaw.json），在models.providers段添加：
{ "models": { "providers": { "qwen-local": { "baseUrl": "你的模型地址", "apiKey": "可留空或任意字符串", "api": "openai-completions", "models": [ { "id": "qwen3.5-9b", "name": "千问3.5-9B本地版", "contextWindow": 32768 } ] } } } }特别注意：
- 如果地址包含
/v1路径，确保baseUrl包含完整路径 - Windows用户注意路径反斜杠转义问题
4. 服务启动与验证
4.1 启动网关服务
openclaw gateway start --port 18789检查服务状态：
lsof -i :18789 # 应看到node进程 curl http://localhost:18789/healthcheck # 应返回{"status":"ok"}4.2 Web控制台测试
浏览器访问http://localhost:18789，在聊天窗口输入：
/use qwen3.5-9b 请用中文自我介绍正常应看到模型生成的回复。如果超时或无响应：
- 检查模型服务日志是否有报错
- 在终端执行
openclaw doctor诊断配置 - 尝试简化请求内容测试基础连通性
5. 常见问题排坑指南
问题1：模型返回"Invalid API Key"
- 原因：某些实现需要非空apiKey
- 解决：在配置中设置
"apiKey":"sk-任意字符串"
问题2：长时间无响应
# 测试网络连通性 ping 你的模型地址 # 检查CORS配置 curl -I -X OPTIONS "你的模型地址" -H "Origin: http://localhost:18789"问题3：中文乱码
- 在配置中增加：
"headers": { "Accept-Charset": "utf-8" }6. 进阶使用建议
当基础问答测试通过后，可以尝试这些实用场景：
- 文件处理自动化：
clawhub install file-manager然后对OpenClaw说："帮我整理Downloads文件夹，按扩展名分类"
- 定时任务： 用crontab设置每天9点自动执行：
0 9 * * * openclaw run --task "生成今日工作清单"- 浏览器自动化： 安装技能后，可以指令："搜索最近的AI会议并保存结果到Excel"
这个过程中最让我惊喜的是，OpenClaw会把每个操作步骤都记录在~/.openclaw/logs/下，随时可以复查AI到底执行了哪些具体动作。这种透明性对调试复杂任务特别有帮助。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。