讲师中心 微信公众号
AI工具推荐 视频效率加速

OpenClaw macOS模型接入配置:千问本地版参数设置指南【详解】

夏宇姑娘_8579

夏宇姑娘_8579

发布时间:2026-06-17 18:13:38

|

626人浏览过

|

来源于php中文网

原创

必须手动修正OpenClaw配置文件中的模型地址、协议类型和上下文参数,确保指向本地千问3.5-9B服务;先验证API可用性,再备份并修改openclaw.json,设provider为Custom、baseUrl含/v1、apiKey非空、defaultModel为qwen-local/qwen3.5-9b、modelLoading为lazy,最后用openclaw status和openclaw chat验证。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

openclaw macos模型接入配置:千问本地版参数设置指南【详解】

要在Mac上让OpenClaw真正调用你本地跑起来的千问3.5-9B模型,而不是默认连云端Qwen Portal或OpenAI,必须手动修正配置文件中的模型地址、协议类型和上下文参数——错一个字段,OpenClaw就会静默降级到备用模型,甚至卡在“loading model”状态不报错。

确认千问服务已就绪并可访问

先别急着改配置。打开终端,执行:
curl -s http://localhost:8000/v1/models | jq '.'
如果返回空或connection refused,说明千问API服务没跑起来。常见原因:LM Studio没点“Start Server”,或Ollama没用ollama serve启动后台服务。这一步跳过,后续所有配置都白搭。

如果你用的是LM Studio,默认端口是1234;Ollama默认是11434;手动部署Transformers API则常设8000。请用对应端口重试curl命令,确保返回包含"qwen3.5-9b"或类似model id的JSON对象。

定位并备份原始配置文件

执行以下命令直接打开配置目录:
open ~/.openclaw

找到openclaw.json文件。在修改前,务必右键→“复制”,然后粘贴一份命名为openclaw.json.bak。这一步不能省——v2026.3.31版本一旦配置格式错误,OpenClaw会拒绝启动,且不提示具体哪一行出错。

【千万勿直接编辑~/.openclaw/openclaw.json而无备份】

修改模型提供商为Custom并填入本地参数

用TextEdit或VS Code打开openclaw.json,找到"models" → "providers"节点。删除原有Qwen或OpenAI区块,替换为以下结构(注意缩进与逗号):

{
  "qwen-local": {
    "baseUrl": "http://localhost:8000/v1",
    "apiKey": "sk-xxx",
    "api": "openai-completions",
    "models": [
      {
        "id": "qwen3.5-9b",
        "name": "千问3.5-9B本地版",
        "contextWindow": 8192,
        "maxTokens": 2048
      }
    ]
  }
}

apiKey字段可填任意非空字符串(如"sk-xxx"),因为本地API通常不校验密钥;但留空会导致OpenClaw误判为无效provider而跳过加载。

OpenClaw Upgrade Fix
OpenClaw Upgrade Fix

安全升级 OpenClaw 2026.4.x,自动备份配置、排查并修复升级问题、权限管理、支持版本回滚。

下载

baseUrl必须带/v1后缀,否则请求会404;若你用LM Studio,此处应改为http://localhost:1234/v1;Ollama则为http://localhost:11434/v1。

设置默认模型并启用延迟加载

继续在同一个文件中,找到"defaultModel"字段,将其值改为:
"qwen-local/qwen3.5-9b"

再找到"modelLoading"字段(若不存在则手动添加),设为:
"lazy"

这个设置很关键:lazy模式下OpenClaw启动时不预加载模型,而是首次请求时才连接本地API。实测发现,若设为eager,M1 Mac在模型未就绪时会卡死60秒后超时退出,而lazy模式能立即响应错误提示。

验证配置是否生效

保存文件,关闭所有终端窗口,重新打开一个干净终端,执行:
openclaw status

观察输出中是否有类似“Provider: qwen-local | Model: qwen3.5-9b | Status: ready”的行。若有,说明接入成功;若显示“fallback to qwen-portal”,说明baseUrl写错或端口不通。

最后运行一次真实推理测试:
openclaw chat --message "你好,请用中文回答,只说三个字"

如果返回“你好呀”之类本地模型生成的内容,而非“Hello world”等英文回复,证明千问3.5-9B已接管全部对话流。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

更多
macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

4964

2025.05.09

macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

4964

2025.05.09

OpenClaw如何卸载
OpenClaw如何卸载

《OpenClaw如何卸载?OpenClawAI小龙虾安全卸载最新指南》为您提供详尽、安全的卸载步骤,帮助用户彻底移除OpenClaw及其相关组件。本指南针对Windows与macOS系统分别说明操作流程,涵盖停止后台进程、清除配置文件、删除残留数据等关键环节,确保无痕卸载,避免系统冲突或隐私泄露。无论您是因更换工具、解决兼容问题,还是出于安全考虑,本文都将助您高效、安心地完成卸载操作。请务必按照最新版本指引执行,以保障设备稳定与数据安

160

2026.03.19

OpenClaw安装部署教程
OpenClaw安装部署教程

本合集涵盖2026最新版OpenClaw(小龙虾)本地部署全流程,适用于Windows系统,包含环境配置、模型接入、Web界面启动及飞书/Telegram/QQ等多平台对接。无论你是小白还是开发者,10分钟内即可完成安装,快速体验AI智能体“长手干活”的强大能力!

221

2026.03.19

OpenClaw初学者教程:如何使用和设置
OpenClaw初学者教程:如何使用和设置

《OpenClawAI初学者教程:如何使用和设置》是一套面向新手的入门指南,涵盖环境搭建、基础配置、模型加载及简单推理操作。通过本教程,你将快速掌握OpenClawAI的核心功能,轻松开启AI开发之旅。

201

2026.03.19

OpenClawAI技能系统基础介绍:OpenClawAISkills是什么
OpenClawAI技能系统基础介绍:OpenClawAISkills是什么

OpenClawAI Skills 是 OpenClaw 智能体的核心功能模块,用于定义和管理 AI 可执行的具体能力,如查询天气、发送消息、操作文件等。通过技能系统,用户可灵活扩展智能体功能,实现高度定制化的自动化任务。

1078

2026.03.20

龙虾OpenClaw安全使用指南
龙虾OpenClaw安全使用指南

围绕龙虾OpenClawAI使用中的安全风险,本合集系统梳理常见漏洞与隐患,提供实用防护方法与最新安全指南,帮助用户在稳定运行的同时规避风险,提升整体使用安全性与体验。

149

2026.03.20

openclaw养虾硬件指南最新版
openclaw养虾硬件指南最新版

《OpenClawAI硬件指南最新版》合集聚焦AI硬件入门与进阶,从核心组件解析到实战搭建,系统讲解算力配置、设备选型与优化方案。内容通俗易懂,适合开发者与科技爱好者快速掌握AI硬件要点,构建高效稳定的智能计算环境。

508

2026.03.20

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

0

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn