OpenClaw提供五种模型切换方式：一、CLI命令行快速设置；二、修改JSON配置文件实现精细控制；三、WebUI图形界面可视化操作；四、按Workspace绑定专属模型；五、环境变量临时覆盖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 OpenClaw 时发现当前模型响应迟缓、人设崩塌或工具调用失败，则可能是所选模拟器核心（即后端 AI 模型）与任务类型不匹配。以下是切换 OpenClaw 模拟器核心的具体操作方法：
一、通过 CLI 命令行直接设置模型
该方法适用于快速覆盖默认模型，无需编辑配置文件，命令立即生效（需重启网关以应用至运行时）。模型标识符必须符合 OpenClaw 支持的命名规范，例如 anthropic/claude-sonnet-4-5 或 google/gemini-3-pro。
1、执行配置命令，将主模型设为 Claude Opus 4.5：
openclaw config set agent.model.primary "anthropic/claude-opus-4-5"
2、若需同时指定备用模型用于降级兜底：
openclaw config set agent.model.fallback "google/gemini-3-pro"
3、验证配置是否写入成功：
openclaw config get agent.model.primary
4、重启网关使新模型加载生效：
openclaw gateway restart
二、修改 JSON 配置文件手动切换
该方法提供最精细的控制粒度，支持为不同 Agent、不同 Channel 或不同 Workspace 指定独立模型，适合多角色协同场景。配置变更后网关会自动热重载，无需手动 restart，但首次启用需确保格式严格合法。
1、使用文本编辑器打开全局配置文件：
~/.openclaw/openclaw.json
2、在 agent 节点下添加或修改 model 字段，示例结构如下：
{
"agent": {
"workspace": "~/.openclaw/workspace",
"model": {
"primary": "anthropic/claude-sonnet-4-5",
"fallback": "qwen/qwen2-72b-instruct"
}
}
}
3、保存文件后，观察日志确认热重载触发：
openclaw logs follow | grep "model config reloaded"
4、如出现验证失败提示，立即执行健康检查定位键名或值格式错误：
openclaw doctor
三、使用 WebUI 图形界面切换
该方法面向非技术用户，通过浏览器可视化操作完成模型选择，所有选项均经过预校验，避免语法错误导致网关无法启动。界面实时同步本地配置状态，并高亮显示当前生效模型。
1、启动网关并访问控制台地址：
http://127.0.0.1:18789
2、点击顶部导航栏的 Config 标签页
为 OpenClaw 创建可直接分流的 GitHub issue 草稿，用于报告代理缓慢、损坏、无响应、工具匮乏、性能下降或“不够智能”等问题。使用 ...
3、在左侧菜单中展开 Agent Settings，找到 Primary Model 下拉框
4、从列表中选择目标模型（如 Claude Sonnet 4.5），点击右侧 Apply & Reload 按钮
5、页面弹出绿色提示“Configuration updated successfully”，表示模型已切换并热重载完成
四、按 Workspace 精确绑定专属模型
该方法实现模型与工作空间强绑定，确保不同智能体（如“会议纪要助手”与“代码审查助手”）始终调用各自优化过的模型，避免全局配置冲突。每个 workspace 目录下可独立维护 model.json 文件，优先级高于全局配置。
1、进入目标 workspace 目录：
cd ~/.openclaw/workspace/meeting-assistant
2、创建专用模型配置文件：
touch model.json
3、写入以下内容（注意路径必须为绝对路径或相对于 workspace 的相对路径）：
{
"model": "anthropic/claude-opus-4-5",
"temperature": 0.3,
"max_tokens": 4096
}
4、在全局配置中启用 workspace 级模型覆盖：
openclaw config set agent.model.enableWorkspaceModel true
5、重启网关并确认日志中出现类似提示：
"Loaded workspace-specific model for meeting-assistant: anthropic/claude-opus-4-5"
五、通过环境变量临时覆盖模型
该方法适用于调试、A/B 测试或多实例隔离部署场景，完全绕过配置文件，生命周期仅限于当前 Shell 会话或进程。环境变量优先级最高，可强制覆盖 CLI 和 JSON 中的所有设置。
1、在启动网关前导出环境变量：
export OPENCLAW_MODEL_PRIMARY="google/gemini-ultra"
2、附加 --env 参数启动网关（确保环境变量透传）：
openclaw gateway start --env OPENCLAW_MODEL_PRIMARY
3、验证当前运行时实际加载的模型：
openclaw gateway status | grep "active model"
4、如需清除该覆盖并恢复配置文件设定，关闭当前终端或执行：
unset OPENCLAW_MODEL_PRIMARY
