模型提供商

概述

模型提供商（Provider）是 OpenClaw 认证、发现模型和命名模型引用的方式，与 Agent Runtime 和 Channel 是不同的层次。大多数 Provider 逻辑由插件实现。

核心要点

内置提供商（无需 models.providers 配置）：

提供商	ID	认证环境变量	示例模型
OpenAI	openai	OPENAI_API_KEY	openai/gpt-5.5
Anthropic	anthropic	ANTHROPIC_API_KEY	anthropic/claude-opus-4-6
Google Gemini	google	GEMINI_API_KEY	google/gemini-3.1-pro-preview
OpenCode	opencode	OPENCODE_API_KEY	opencode/claude-opus-4-6
Moonshot	moonshot	MOONSHOT_API_KEY	moonshot/kimi-k2.6
DeepSeek	deepseek	DEEPSEEK_API_KEY	deepseek/deepseek-v4-flash
Ollama	ollama	无需	ollama/llama3.3
OpenRouter	openrouter	OPENROUTER_API_KEY	openrouter/auto

API Key 轮换（按优先级）：

1. OPENCLAW_LIVE_<PROVIDER>_KEY（单次覆盖，最高优先级）
2. <PROVIDER>_API_KEYS（逗号/分号分隔列表）
3. <PROVIDER>_API_KEY（主 Key）
4. <PROVIDER>_API_KEY_*（编号列表）

OpenAI/Codex 特殊规则：

• openai/<model> 默认走 Codex app-server harness（ChatGPT/Codex 订阅）
• openai-codex/<model> 是旧版配置，openclaw doctor --fix 会自动修复为 openai/<model>
• 显式 PI 路由：openai/<model> + agentRuntime.id: "pi"

自定义 Provider（OpenAI/Anthropic 兼容代理）：

{
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "${LM_API_TOKEN}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [{ id: "my-local-model", contextWindow: 200000 }]
      }
    }
  }
}

代理路由注意事项：

• 非原生 OpenAI 端点自动禁用 developer role、service_tier、prompt-cache hints
• 非直连 Anthropic 端点自动抑制 beta headers（如 claude-code-20250219）

配置/使用

快速上手：

openclaw onboard                              # 交互式配置
openclaw models list --provider anthropic     # 查看可用模型
openclaw models set anthropic/claude-opus-4-6 # 设置默认模型

相关页面

• models — 模型选择与配置
• model-failover — 回退链与 auth profile 轮换
• agent-runtimes — 运行时类型