概念

Provider 是 OpenClaw 的「後端」— 連接不同的 AI 服務供應商。

支援的 Providers：

Anthropic — Claude 系列
OpenAI — GPT 系列
Google — Gemini 系列
OpenRouter — 聚合多個 provider
Local — Ollama, LM Studio

Model 格式

provider/model

範例：
anthropic/claude-opus-4-5
openai/gpt-5.2
google/gemini-2.5-pro
openrouter/anthropic/claude-opus-4-5

設定 API Keys

# 方法 1：環境變數（推薦）
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...

# 方法 2：.env 檔案
echo "ANTHROPIC_API_KEY=sk-ant-..." >> ~/.openclaw/.env

# 方法 3：config 檔案（不推薦，會暴露）
# openclaw.json
{
  "providers": {
    "anthropic": {
      "apiKey": "sk-ant-..."  // ⚠️ 不安全
    }
  }
}

Model Fallback

// openclaw.json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-5",
        "fallbacks": [
          "anthropic/claude-sonnet-4-5",
          "openai/gpt-5.2"
        ]
      }
    }
  }
}

邏輯：

嘗試 claude-opus-4-5
如果失敗（rate limit / error）→ 用 claude-sonnet-4-5
如果還是失敗 → 用 gpt-5.2

核心代碼

1. Provider 解析

function parseModelRef(modelRef) {
  // "anthropic/claude-opus-4-5"
  const [provider, ...modelParts] = modelRef.split('/');
  const model = modelParts.join('/');  // 處理 openrouter/xx/yy
  
  return { provider, model };
}

// 找到對應的 provider
function getProvider(name) {
  switch (name) {
    case 'anthropic':
      return new AnthropicProvider(config.providers.anthropic);
    case 'openai':
      return new OpenAIProvider(config.providers.openai);
    case 'google':
      return new GoogleProvider(config.providers.google);
    default:
      throw new Error(`Unknown provider: ${name}`);
  }
}

2. Fallback 邏輯

async function callWithFallback(models, messages) {
  for (const model of models) {
    try {
      return await callModel(model, messages);
    } catch (e) {
      if (e.isRetryable) {
        console.log(`${model} failed, trying next...`);
        continue;
      }
      throw e;  // 不可重試的錯誤
    }
  }
  
  throw new Error('All models failed');
}

3. Rate Limit 處理

// 每個 provider 有 cooldown
const cooldowns = new Map();

async function checkRateLimit(provider) {
  const cooldown = cooldowns.get(provider);
  
  if (cooldown && Date.now() < cooldown.until) {
    throw new Error(`Provider ${provider} in cooldown`);
  }
}

function handleRateLimitError(provider, retryAfter) {
  cooldowns.set(provider, {
    until: Date.now() + (retryAfter * 1000)
  });
}

Provider 特性

Provider	特點
Anthropic	最強推理，有 thinking
OpenAI	最快，tool calling 穩定
Google	便宜，長 context
OpenRouter	聚合，可用多種模型
Ollama	本地，隱私，免費

Thinking 模式（Claude 限定）

// 開啟 thinking（深度思考）
{
  "agents": {
    "defaults": {
      "thinking": "low"  // off | minimal | low | medium | high
    }
  }
}

或者用 /reasoning 命令：

/reasoning on
/reasoning high
/reasoning off

費用追蹤

# 查看 session 費用
/status

# 輸出
🧠 Model: anthropic/claude-opus-4-5
🧮 Tokens: 50k in / 2k out
💰 Cost: $0.45

💡 關鍵洞察

API Key 放環境變數
- 不要寫在 config
- 用 .env 檔案
- 或系統環境變數
Fallback 提高可用性
- 主模型掛了自動切換
- 避免服務中斷
- 建議至少設兩個
Rate Limit 是常態
- 特別是 Claude API
- Cooldown 機制自動處理
- 有 fallback 就不怕
選對 model 很重要
- 複雜任務用 Opus
- 簡單任務用 Sonnet/Haiku
- Cron jobs 用便宜的

Model 選擇建議

任務	建議 Model
主要對話	claude-opus-4-5
Cron jobs	claude-sonnet-4-5
簡單工具	claude-haiku
程式碼	gpt-5.2-codex

🔗 核心檔案

Providers 文檔：/opt/homebrew/lib/node_modules/openclaw/docs/providers/
Model Failover：/opt/homebrew/lib/node_modules/openclaw/docs/concepts/model-failover.md
Model 列表：/opt/homebrew/lib/node_modules/openclaw/docs/concepts/models.md

明天： Skills 系統（如何寫自己的 skill）

Day 16: Provider 系統（OpenAI, Anthropic, Google）