Skip to main content

​
模型提供商概览

OpenClaw 支持多种大型语言模型（LLM）提供商，让您可以灵活选择最适合您需求的 AI 模型。无论是使用云端 API 服务，还是本地运行开源模型，OpenClaw 都能无缝集成。

​
快速开始

配置模型提供商只需两步：
1

完成身份认证

使用 openclaw onboard 命令与提供商进行身份认证，或手动配置 API 密钥。
2

设置默认模型

在配置文件中设置您的默认模型，格式为 provider/model。
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6"
      }
    }
  }
}

​
主要提供商

Anthropic

Claude 系列模型，支持 API 密钥和 setup-token 认证

OpenAI

GPT 系列模型，支持 API 密钥和 Codex 订阅认证

Qwen

通义千问模型，支持 OAuth 免费层访问

MiniMax

MiniMax M2.5 系列，适用于复杂编码任务

Ollama

本地运行开源模型的最佳选择

​
模型引用格式

在 OpenClaw 中，所有模型都使用统一的 provider/model 格式引用： 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6"
      }
    }
  }
}

​
认证方式

OpenClaw 支持多种认证方式：

​
API 密钥认证

最常见的认证方式，适用于大多数云端提供商： 
# 通过环境变量设置
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# 或使用配置命令
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​
OAuth 认证

部分提供商支持 OAuth 流程，无需手动管理 API 密钥： 
# OpenAI Codex
openclaw models auth login --provider openai-codex

# Qwen OAuth
openclaw plugins enable qwen-portal-auth
openclaw models auth login --provider qwen-portal

# MiniMax OAuth
openclaw plugins enable minimax-portal-auth
openclaw onboard --auth-choice minimax-portal

​
Setup Token

Anthropic 支持使用 Claude Code CLI 生成的 setup-token： 
# 在任意机器上生成 token
claude setup-token

# 在网关主机粘贴 token
openclaw models auth paste-token --provider anthropic

​
API 密钥轮换

OpenClaw 支持为选定提供商配置多个 API 密钥，在遇到速率限制时自动轮换： 
# 方式 1：逗号分隔的密钥列表
export ANTHROPIC_API_KEYS="sk-ant-key1,sk-ant-key2,sk-ant-key3"

# 方式 2：编号环境变量
export ANTHROPIC_API_KEY_1="sk-ant-key1"
export ANTHROPIC_API_KEY_2="sk-ant-key2"
export ANTHROPIC_API_KEY_3="sk-ant-key3"

# 方式 3：单个优先级覆盖（用于测试）
export OPENCLAW_LIVE_ANTHROPIC_KEY="sk-ant-test-key"
密钥轮换仅在收到速率限制响应（如 429 错误）时触发。其他类型的错误会立即失败，不会尝试轮换。

​
命令行工具

OpenClaw 提供便捷的命令行工具管理模型： 
# 列出所有可用模型
openclaw models list

# 切换默认模型
openclaw models set anthropic/claude-opus-4-6

# 查看当前认证状态
openclaw models status

# 查看详细认证信息（JSON 格式）
openclaw models status --json

​
自定义提供商

您也可以添加自定义提供商或使用 OpenAI/Anthropic 兼容的代理： 
{
  "models": {
    "mode": "merge",
    "providers": {
      "custom-provider": {
        "baseUrl": "https://api.example.com/v1",
        "apiKey": "${CUSTOM_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "custom-model",
            "name": "Custom Model",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

​
故障切换配置

您可以配置多个模型作为故障切换选项： 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallbacks": [
          "openai/gpt-5.4",
          "minimax/MiniMax-M2.5"
        ]
      }
    }
  }
}
当主模型不可用时，OpenClaw 会自动尝试使用故障切换列表中的模型。

​
下一步

选择您要使用的提供商，查看详细的配置指南：

Anthropic

OpenAI

Qwen

MiniMax

Ollama