AI 模型提供商总览

OpenClaw 可以使用多家 AI 提供商的模型。选好提供商、完成认证后，在配置中用 provider/model 格式指定默认模型即可。

快速上手

1. 完成认证（通常通过 openclaw onboard）
2. 设置默认模型：

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

主要提供商

提供商	文档	特点
Anthropic Claude	详细教程	推荐首选，Claude 系列模型
OpenAI	详细教程	GPT 系列，支持 Codex 订阅
Ollama	详细教程	本地运行开源模型，无 API 费用
OpenRouter	详细教程	统一 API，一个密钥访问多家模型
其他提供商	汇总	Bedrock、通义千问、GLM 等

模型引用格式

所有模型使用 provider/model 格式引用：

anthropic/claude-opus-4-6
openai/gpt-5.4
ollama/llama3.3
openrouter/anthropic/claude-sonnet-4-5

自定义提供商

OpenClaw 支持任何 OpenAI 兼容的 API：

{
  models: {
    mode: "merge",
    providers: {
      "my-proxy": {
        baseUrl: "http://localhost:4000/v1",
        apiKey: "my-key",
        api: "openai-responses",
        models: [
          {
            id: "llama-3.1-8b",
            name: "Llama 3.1 8B",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}

多模型配置与备用模型

{
  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" },
        "anthropic/claude-opus-4-6": { alias: "Opus" },
      },
    },
  },
}

• agents.defaults.models 定义模型目录，也是 /model 命令的可选列表
• alias 是在聊天中切换模型时的简称（/model Sonnet）

图像模型

部分操作（如图片分析）可配置专用视觉模型：

{
  agents: {
    defaults: {
      imageModel: {
        primary: "openrouter/anthropic/claude-sonnet-4-5",
      },
    },
  },
}

转录提供商（音频）

音频转录使用独立的模型配置：

{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [
          { provider: "openai", model: "gpt-4o-mini-transcribe" },
        ],
      },
    },
  },
}

支持 Deepgram 作为专业转录服务。