OpenClaw新手入门5分钟在Mac上部署Qwen3.5-9B镜像1. 为什么选择OpenClawQwen3.5-9B组合上周我在整理历年积累的数千份PDF技术文档时突然意识到手动分类的效率实在太低。在尝试了几个自动化工具后最终选择了OpenClaw配合Qwen3.5-9B这个组合方案。这个选择基于三个实际考量首先Qwen3.5-9B的多模态理解能力特别适合处理混合格式的文档。我的文件堆里有扫描版PDF、OCR文本、甚至有些手写笔记的照片传统工具很难统一处理。而OpenClaw的本地化特性则完美解决了隐私顾虑——这些文档包含未公开的技术方案绝对不能上传到第三方服务。记得第一次运行成功时看着它自动将混杂的文档按编程语言/框架版本/技术领域三级目录归类那种解放双手的畅快感至今难忘。下面我就把这次实践的全过程拆解给大家。2. 环境准备与一键安装2.1 基础环境检查在开始前请确保你的Mac满足以下条件操作系统macOS Monterey (12.0) 或更高版本内存建议16GB以上Qwen3.5-9B较耗资源存储至少20GB可用空间网络能稳定访问GitHub和npm仓库打开终端输入以下命令检查基础环境sw_vers system_profiler SPHardwareDataType | grep Memory df -h | grep /$2.2 一键安装OpenClaw官方安装脚本已经帮我们处理了大部分依赖问题。在终端执行curl -fsSL https://openclaw.ai/install.sh | bash这里有个小插曲我的开发机因为长期积累的brew包冲突第一次安装失败了。如果你遇到类似情况可以先用以下命令清理环境brew cleanup sudo rm -rf /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core brew update-reset安装完成后验证版本openclaw --version # 预期输出类似openclaw/1.2.3 darwin-arm64 node-v18.16.03. 配置向导关键步骤解析3.1 初始化onboard向导执行配置向导时新手建议选择QuickStart模式openclaw onboard你会看到交互式配置界面这几个选项需要特别注意Operation Mode选择QuickStart后续可随时修改Default Provider选择Custom因为我们要对接本地Qwen镜像Model Address输入你的Qwen3.5-9B服务地址如http://localhost:8080/v1API Key如果是本地部署可留空平台部署则填写对应密钥3.2 解决端口冲突问题第一次启动时我遇到了18789端口被占用的报错。解决方法如下lsof -i :18789 kill -9 PID openclaw gateway start如果经常遇到端口冲突可以修改默认端口。编辑配置文件nano ~/.openclaw/openclaw.json找到gateway.port字段修改为其他值如17890然后重启服务。4. 连接Qwen3.5-9B模型服务4.1 模型地址配置无论你是本地部署还是使用平台镜像都需要确保模型服务地址正确。打开配置文件code ~/.openclaw/openclaw.json在models.providers部分添加如下配置根据实际情况调整qwen-local: { baseUrl: http://localhost:8080/v1, apiKey: , api: openai-completions, models: [ { id: qwen3.5-9b, name: Local Qwen3.5-9B, contextWindow: 32768 } ] }保存后执行openclaw gateway restart openclaw models list4.2 模型健康检查确保模型服务正常运行后我们可以做个简单测试curl -X POST http://localhost:18789/v1/chat/completions \ -H Content-Type: application/json \ -d { model: qwen3.5-9b, messages: [{role: user, content: 你好}] }如果返回类似下面的响应说明对接成功{ id: chatcmpl-3qyRaCQ..., object: chat.completion, created: 1715586283, model: qwen3.5-9b, choices: [{ index: 0, message: { role: assistant, content: 你好有什么我可以帮助你的吗 } }] }5. 实现首个自动化案例文件整理5.1 创建文件整理技能我们先安装文件处理基础技能clawhub install file-processor然后创建一个简单的整理规则。新建~/Documents/OpenClaw/file_rules.json{ rules: [ { match: [*.pdf, *.docx], actions: [ { type: classify_by_content, target: ~/Documents/分类结果, categories: [Python, Java, 机器学习] } ] } ] }5.2 执行自动化任务现在可以通过两种方式触发任务方法一命令行触发openclaw run --task 整理~/Downloads目录下的技术文档方法二Web控制台操作访问http://localhost:18789在对话窗口输入请整理Downloads文件夹的技术文档点击发送并观察执行日志我第一次运行时模型误将Node.js文档归类到了Java类别。后来通过增加样本关键词优化了规则categories: [ { name: Node.js, keywords: [require(, npm, express] } ]6. 常见问题与解决方案在实际部署过程中我遇到了几个典型问题这里分享解决方法问题1模型响应超时现象执行任务时频繁超时解决方案调整超时参数单位毫秒openclaw config set model.timeout 60000问题2中文路径识别错误现象包含中文的路径无法正确读取解决方案在配置中显式声明编码格式{ system: { fileEncoding: utf-8 } }问题3权限不足导致操作失败现象尝试移动系统文件时被拒绝解决方案以管理员权限启动服务慎用sudo openclaw gateway start记得每次修改配置后都要重启服务openclaw gateway restart获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。