openclaw必须显式指定default_model_id,否则首次对话触发兜底或空响应;可通过config.yaml(最高优先级)、cli参数(临时覆盖)或dashboard ui(图形化热重载)三种方式设置,默认模型需与providers中注册id严格一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw配置多模型后,系统不会自动选中某个模型作为默认,必须显式指定一个已注册的模型ID,否则首次对话会触发兜底逻辑或返回空响应;不设置default_model_id字段,即使router.enabled为true,Zoe调度器也不会将该模型纳入初始路由候选池。
修改config.yaml全局默认模型
这是最稳定、优先级最高的方式,适用于所有部署形态(Docker、二进制、源码启动)。
1、进入OpenClaw安装目录下的config/子目录,用文本编辑器打开config.yaml文件。
2、在文件顶层(非models.providers或models.router节点内)添加或修改default_model_id字段,值必须与models.providers中某一个模型的id完全一致,例如:【gemma-local必须已在providers中成功注册,拼写大小写、连字符均需严格匹配】
3、保存文件后执行openclaw restart命令重启服务;若使用Docker,需重建容器而非仅restart容器。
4、访问Web UI,在模型选择下拉框顶部应显示已选中对应模型名,且首次API请求将直接命中该模型,不经过能力画像匹配流程。
启动时用CLI参数覆盖默认模型
适合临时调试、CI/CD动态注入或同一套配置复用多个环境的场景,运行时优先级高于config.yaml。
方法一:终端直接启动
停止当前服务后,运行:openclawstart --default-model qwen2:7b
方法二:Docker部署
在docker run命令中加入环境变量:-e OPENCLAW_DEFAULT_MODEL=qwen2:7b
【注意:该参数只影响本次启动,不写入config.yaml,重启容器后失效】
验证方式:查看服务启动日志,出现Default model set to: qwen2:7b即表示生效。
通过Dashboard UI图形化设置
无需接触代码,变更实时写入配置并热重载,适合团队协作中由管理员统一管理默认模型。
第一步:登录OpenClaw Web Dashboard,点击左侧导航栏「系统设置」→「模型管理」
第二步:在模型列表中找到目标模型(如claude-sonnet-4),点击右侧「设为默认」按钮
第三步:页面弹出确认提示,点击确定后,config.yaml中default_model_id字段将被自动更新,且Zoe调度器立即重新加载画像配置
这一步操作起来很简单,直接点击按钮就行,但要注意只有具备「系统管理」角色的用户才能看到该按钮。










