模型与 Provider

此外，任何 OpenAI 兼容的 API 都可以通过 openai-compatible 接入。

最简单的方式是通过交互引导完成：

openclaw onboard
# 或单独设置某个 Provider
openclaw models auth add --provider anthropic

API Key 保存在 ~/.openclaw/.env：

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...
OPENROUTER_API_KEY=sk-or-...

Key 优先级：OPENCLAW_LIVE_<PROVIDER>_KEY > <PROVIDER>_API_KEYS（逗号分隔多 Key）> <PROVIDER>_API_KEY。

在配置文件中指定主模型和备用模型：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: [
          "openai/gpt-4o",
          "openrouter/anthropic/claude-sonnet-4-5"
        ]
      }
    }
  }
}

当主模型返回 429（限流）或 5xx 错误时，自动切换到备用模型。

# 查看可用模型列表
openclaw models list

# 检查模型认证状态
openclaw models status
openclaw models status --check  # 退出码 1=过期, 2=即将过期

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

# 扫描可用模型
openclaw models scan

# 管理备用模型
openclaw models fallbacks

# 管理模型别名
openclaw models aliases

不同渠道可以使用不同的模型，适合控制成本或匹配能力：

{
  channels: {
    modelByChannel: {
      "telegram": "anthropic/claude-sonnet-4-5",
      "discord:guild:123": "openai/gpt-4o",
      "whatsapp": "ollama/llama3.1"
    }
  }
}

OpenClaw 原生支持 Ollama，适合离线或隐私优先的场景：

# 确保 Ollama 已安装并运行
ollama serve

# 拉取模型
ollama pull llama3.1

# 在 OpenClaw 中使用
openclaw models set ollama/llama3.1

使用本地模型时建议收紧工具策略，因为小模型可能误用复杂工具。 参考 按模型限制工具。

用户可以在对话中临时切换模型：

# 在聊天中发送
/model anthropic/claude-opus-4

# 带认证档案
/model gpt-4o@profile-id

点击查看每个 Provider 的完整配置教程：