Open Claw 切换模型操作手册

概述

今天我想和大家分享一下我在使用 Open Claw 时，如何灵活切换不同 AI 模型的经验。Open Claw 作为一个强大的 AI 模型接入工具，它的多模型支持特性真的让我在项目开发中省了不少心。无论是想用 Claude 进行深度对话，还是想试试 Kimi 的快速响应，都能在一个工具里搞定。下面我就把常用的切换和配置方法整理出来，希望能帮到你。

常用命令

Open Claw 提供了一套非常直观的 CLI 命令来管理模型，用起来就像在跟一个老朋友对话一样简单。这几个命令是我最常用的：

openclaw models status              # 查看当前模型状态
openclaw models list                # 列出所有可用模型
openclaw models set <model-or-alias> # 设置当前模型
openclaw models scan                # 扫描可用模型

切换模型的方法

方法一：命令行切换（推荐）

这是我个人最喜欢的方式，直接、快速、不拖泥带水。用 openclaw models set 命令就能瞬间切换模型：

# 设置模型（格式：provider/model 或别名）
openclaw models set anthropic/claude-opus-4-6

# 或使用简写（使用默认 provider）
openclaw models set claude-sonnet-4-6

# 使用 OpenRouter 风格的模型引用
openclaw models set openrouter/moonshotai/kimi-k2

模型引用格式说明：
- models set <model-or-alias> 接受 provider/model 或别名
- 模型引用通过第一个 / 分割，如果模型 ID 包含 /（OpenRouter 风格），需要包含 provider 前缀
- 如果省略 provider，OpenClaw 将输入视为别名或默认 provider 的模型

方法二：查看模型状态

在切换之前，我习惯先看看当前的状态，做到心中有数。status 命令提供了丰富的选项：

# 查看当前默认模型和 fallback 配置
openclaw models status

# 以 JSON 格式输出
openclaw models status --json

# 以纯文本格式输出
openclaw models status --plain

# 检查认证状态（exit 1=过期/缺失，2=即将过期）
openclaw models status --check

# 对配置的 auth profiles 进行实时探测
openclaw models status --probe

# 探测单个 provider
openclaw models status --probe-provider <name>

# 查看特定 agent 的模型状态
openclaw models status --agent <id>

status 命令选项：

方法三：列出和扫描模型

有时候我不知道有哪些模型可用，这时候 list 和 scan 就派上用场了：

# 列出所有可用模型
openclaw models list

# 扫描新模型
openclaw models scan

方法四：配置别名和 fallbacks

为了使用更方便，我还会给常用的模型设置别名，并且配置好 fallback 策略：

# 列出模型别名
openclaw models aliases list

# 列出 fallback 配置
openclaw models fallbacks list

Auth profiles（认证配置）

切换模型的核心前提是得有对应的认证信息。Open Claw 的认证管理做得挺人性化的：

# 添加新的认证配置
openclaw models auth add

# 登录 provider（OAuth/API Key）
openclaw models auth login --provider <id>

# 设置 setup-token
openclaw models auth setup-token

# 粘贴 token 字符串
openclaw models auth paste-token

认证说明：
- setup-token：提示输入 setup-token 值（在任何机器上用 claude setup-token 生成）
- paste-token：接受在其他地方生成的 token 字符串
- Anthropic 政策注意：setup-token 支持是技术兼容性，Anthropic 已阻止某些订阅在 Claude Code 之外的使用，请验证当前条款

查看已安装的 providers

想知道系统里已经有哪些 providers 了吗？这个命令一目了然：

openclaw plugins list

快速参考

为了方便大家快速查阅，我把最常用的几个命令整理成了表格：

相关文档

• Open Claw 安装过程指南
• Open Claw 接入飞书平台
• 官方文档

最后更新：2026-03-08