第2课选择 AI 模型#

为什么需要了解这个#

AI 模型是你助手的"大脑"。不同的模型在速度、回答质量和价格上各不相同。OpenClaw 允许你选择模型、在模型之间切换，以及在主模型不可用时自动切换到备用模型。

就像在不同的专家之间选择：一个更快，另一个更准确，第三个更便宜。而且你可以随时切换。

有哪些模型#

OpenClaw 支持来自不同提供商（开发公司）的模型：

提供商	热门模型	特点
Anthropic	Claude Sonnet, Claude Opus	擅长复杂任务、分析、编程
OpenAI	GPT-4o, GPT-5	通用型，擅长对话和文本
Google	Gemini	擅长信息搜索
OpenRouter	数百种模型	统一接口访问多个提供商
Ollama	本地模型	在你的电脑上运行，免费

模型名称格式#

模型以 提供商/名称 的格式表示：

anthropic/claude-sonnet-4-5
openai/gpt-5.2
google/gemini-2.0-flash

如何配置模型#

在配置文件中#

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",    // 主模型
        fallbacks: ["openai/gpt-5.2"]              // 备用模型
      },
      models: {
        "anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
        "openai/gpt-5.2": { alias: "GPT" }
      }
    }
  }
}

primary —— 默认使用的主模型。

fallbacks —— 备用模型列表。如果主模型不可用，OpenClaw 会自动切换到下一个。

alias —— 方便使用的短名称（不用输入长名称，只需写"Sonnet"）。

通过命令行#

# 查看当前模型和状态
openclaw models status

# 设置主模型
openclaw models set anthropic/claude-sonnet-4-5

# 查看所有可用模型
openclaw models list --all

# 添加备用模型
openclaw models fallbacks add openai/gpt-5.2

通过设置向导#

openclaw onboard

向导会引导你选择模型和配置认证。

在聊天中切换模型#

在与助手对话的过程中，你可以直接切换模型：

/model                        — 显示可用模型列表
/model list                   — 同上
/model 3                      — 选择列表中的第3个模型
/model openai/gpt-5.2         — 选择具体的模型
/model status                 — 模型和认证的详细信息

模型切换只对当前会话（当前对话）有效。新会话会恢复默认模型。

认证：密钥和订阅#

要使用模型，需要验证访问权限。有两种主要方式：

API 密钥（推荐）#

你在提供商的网站上获取一个密钥并输入到 OpenClaw 中。就像一个密码，确认你有权使用该模型。

OAuth 订阅#

一些提供商（OpenAI、Anthropic）允许你使用你的付费订阅。这很方便：不需要单独支付 API 费用。

对于 Anthropic (Claude Pro/Max)：

claude setup-token
openclaw models auth setup-token --provider anthropic

对于 OpenAI (ChatGPT Plus)：

openclaw onboard
# 在认证部分选择 "openai-codex"

检查认证#

openclaw models status

这条命令会显示哪些提供商已连接，哪些密钥正常工作，哪些即将过期。

自动切换（Failover）#

Failover（故障转移）是在出现故障时自动切换到备用方案。分两个阶段工作：

阶段1：认证配置轮换#

如果你为同一个提供商有多个密钥（例如工作和个人的 OpenAI 账户），OpenClaw 会先尝试该提供商的其他密钥。

阶段2：切换到备用模型#

如果提供商的所有密钥都失败了，OpenClaw 会切换到 fallbacks 列表中的下一个模型。

冷却时间（错误后的暂停）#

如果密钥收到错误（超出限额、余额不足），OpenClaw 会临时"冻结"它：

第一次错误 → 暂停 1 分钟
第二次 → 5 分钟
第三次 → 25 分钟
最长 → 1 小时

成功请求后所有暂停会被重置。

建议：至少配置一个来自不同提供商的备用模型。这样如果一个提供商出问题，你的助手仍然能继续工作。

完整配置示例#

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: ["openai/gpt-5.2", "google/gemini-2.0-flash"]
      },
      models: {
        "anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
        "anthropic/claude-opus-4-6": { alias: "Opus" },
        "openai/gpt-5.2": { alias: "GPT" },
        "google/gemini-2.0-flash": { alias: "Gemini" }
      }
    }
  }
}

在这个示例中：

主模型是 Claude Sonnet
如果它不可用——切换到 GPT
如果 GPT 也不可用——切换到 Gemini
在聊天中可以在所有四个模型之间切换

本课总结#

AI 模型是助手的"大脑"；不同模型适合不同任务
模型以 提供商/名称 的格式表示
primary 是主模型，fallbacks 是备用模型
在聊天中可以用 /model 命令切换模型
访问需要 API 密钥或 OAuth 订阅
Failover 在故障时自动切换到备用模型
建议配置来自不同提供商的备用模型

下一课：记忆与上下文

第2课 选择 AI 模型#