现在大家都在养虾🦞（OpenClaw），如果你还没有开始部署，先看这篇部署教程，OpenClaw：详细的小白安装教程及避坑指南，多模型设置看这篇教程OpenClaw：详细的小白免费模型设置教程及避坑指南。

说实话，刚开始用 OpenClaw 的时候，我也被它的模型配置搞晕过。什么 provider、fallback、auth profile... 这些概念堆在一起，谁看谁迷糊。

后来用久了才发现，其实逻辑很简单：一个主力模型 + 一堆备选模型 + 自动故障转移。

今天就来彻底梳理一下 OpenClaw 里所有跟模型相关的命令，看完你就能随心所欲地切换和管理模型了。

先搞清楚核心概念

OpenClaw 的模型管理有三层结构：

Provider（提供商） → Model（模型） → Auth（认证）

举个例子：

• • openrouter 是 Provider
• • claude-opus-4-5 是 Model
• • 组合起来就是 openrouter/claude-opus-4-5

认证方式有两种：

• • API Key：大多数提供商使用
• • OAuth：像 Qwen Portal 这类支持免密登录的

配置好 Provider 和认证后，OpenClaw 会自动发现可用的模型列表。

斜杠命令 /model /models /status

/model — 当前会话用什么模型？

在聊天界面直接输入 /model，你会看到类似这样的输出：

Current: qwen-portal/coder-modelSwitch: /model <provider/model>Browse: /models (providers) or /models <provider> (models)More: /model status

• • Current：当前会话实际使用的模型
• • Switch：切换模型
• • Browset：浏览模型
• • More：更多信息

/models — 有哪些模型可用？

在聊天界面直接输入 /models 会按 Provider 分组列出所有已配置的模型：

Providers:- baishan (1)- nvidia (2)- opencode (2)- opencode1 (1)- openrouter (4)- qwen-portal (2)- xunfei (2)Use: /models <provider>Switch: /model <provider/model>

/models <provider> — 具体提供商有哪些模型可用？

在聊天界面输入 /models openrouter 会列出openrouter所有已配置的模型：

Models (openrouter · 🔑 api-key (openrouter:default)) — showing 1-4 of 4 (page 1/1)- openrouter/openrouter/free- openrouter/openrouter/healer-alpha- openrouter/openrouter/hunter-alpha- openrouter/z-ai/glm-4.5-air:freeSwitch: /model <provider/model>All: /models openrouter all

/model <provider/model>快速切换模型

想临时换模型？在聊天界面直接直接用：

/model openrouter/hunter-alpha

注意：这只是切换当前会话的模型，不会改配置文件。下次新会话还是用默认模型。

/status 会话状态速览

在聊天界面直接输入 /status，你会看到：

🦞 OpenClaw 2026.3.11 (29dc654)🧠 Model: qwen-portal/coder-model · 🔑 oauth (qwen-portal:default)🗄️ Cache: 100% hit · 175k cached, 0 new📚 Context: 0/128k (0%) · 🧹 Compactions: 0🧵 Session: agent:main:main • updated just now⚙️ Runtime: direct · Think: off🪢 Queue: collect (depth 0)

• • Model：当前使用的模型
• • Auth：认证方式
• • Tokens：本次会话的 token 消耗
• • Cache：缓存命中率（省钱的关键！）
• • Context：上下文使用比例

命令行工具：openclaw models

如果你喜欢在终端操作，openclaw models 命令提供了更强大的功能。

openclaw models status — 模型体检报告

这个命令会显示：

• • 默认模型和 fallback 列表
• • 每个 Provider 的认证状态
• • Token 使用情况（如果 Provider 支持）

# 基本状态openclaw models status# 加上实时探测（会消耗少量 token）openclaw models status --probe# 只探测某个 Provideropenclaw models status --probe-provider openrouter# JSON 格式输出openclaw models status --json# 检查认证是否过期（退出码 1=过期/缺失, 2=即将过期）openclaw models status --check# 查看特定 Agent 的模型配置openclaw models status --agent work

openclaw models list — 完整模型列表

# 列出所有可用模型openclaw models list# 按 Provider 筛选openclaw models list --provider openrouter

openclaw models set — 修改默认模型

# 设置默认模型openclaw models set openrouter/claude-opus-4-5

这会修改配置文件 openclaw.json，所有新会话都会使用这个模型。

小贴士：如果模型 ID 里包含 /（比如 OpenRouter 的某些模型），记得加上 Provider 前缀，否则 OpenClaw 可能解析错误。

openclaw models scan — 扫描可用模型

openclaw models scan

这个命令会重新扫描所有已配置 Provider 的可用模型列表。当你刚添加新 Provider 或者想刷新模型列表时很有用。

openclaw models aliases — 模型别名

# 查看所有别名openclaw models aliases list

别名是模型的简短昵称，比如把 openrouter/anthropic/claude-opus-4-5 简化为 opus。设置默认模型时可以直接用别名：

openclaw models set opus

Fallback 机制：模型挂了自动切换

查看当前 Fallback

openclaw models fallbacks list

配置 Fallback

在 openclaw.json 中配置：

{"agents":{"defaults":{"model":{"primary":"openrouter/claude-opus-4-5","fallbacks":["openrouter/gpt-5","xunfei/xopglm5","qwen-portal/coder-model"]}}}}

执行顺序：主力模型 → fallback[0] → fallback[1] → fallback[2] → ...

什么情况会触发 fallback？

• • 模型 API 返回 429（限流）
• • 模型 API 返回 402（余额不足）
• • 模型 API 返回 500（服务器错误）
• • 认证过期

不会触发 fallback 的情况：

• • 你的 prompt 有问题
• • 上下文超长

实际体验

我现在的配置是这样的：

"primary":"qwen-portal/coder-model","fallbacks":["openrouter/z-ai/glm-4.5-air:free","xunfei/xopglm5","baishan/GLM-5"]

效果就是：Qwen Portal 挂了 → 自动切 OpenRouter 免费 GLM → 再挂了切讯飞 → 最后切白山智算。

基本上不用担心模型不可用的问题。

认证管理：openclaw models auth

添加认证

# 交互式添加openclaw models auth add# OAuth 登录（如果 Provider 支持）openclaw models auth login --provider qwen-portal# 粘贴 Tokenopenclaw models auth paste-token

认证方式对照

实战场景

场景一：省钱模式

想用免费模型？试试这些：

/model openrouter/z-ai/glm-4.5-air:free/model openrouter/openrouter/free/model opencode/minimax-m2.5-free

OpenRouter 经常有临时免费模型，比如最近的 Hunter Alpha 和 Healer Alpha，完全免费。

场景二：临时需要更强的模型

写复杂代码时临时切换：

/model anthropic/claude-opus-4-5

用完再切回便宜的模型。

场景三：某个 Provider 挂了

# 查看状态openclaw models status --probe# 手动切换到其他 Provider 的模型/model xunfei/xopglm5

场景四：检查 Token 消耗

# 在聊天中查看/status# 在命令行查看openclaw models status

常用命令速查

聊天内命令

命令行工具

最后

OpenClaw 的模型管理设计得相当灵活。核心思路就是：配置多个模型，让系统自动处理故障转移。

对于国内用户，建议的配置策略是：

1. 1. 主力模型：选一个性价比高的（如 Qwen、讯飞 GLM）
2. 2. Fallback 1：OpenRouter 免费模型（省钱）
3. 3. Fallback 2：国内其他 Provider（保证可用性）
4. 4. 特殊场景：临时切换到顶级模型（如 Claude Opus）

这样既能控制成本，又能保证可用性。

参考

• • docs/cli/models.md — 核心命令参考
• • docs/cli/status.md — 会话状态
• • docs/providers/models.md — Provider 概念

  • docs/providers/openrouter.md — OpenRouter 配置
• • 本文基于 OpenClaw 2026.3.11 版本

以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧，如果想第一时间收到推送，也可以给我个星标⭐～谢谢你看我的文章，我们，下次再见。