API Provider Setup

OpenClaw にサードパーティの API 中継ステーションプロバイダを追加および設定します。

設定場所

設定ファイル：~/.openclaw/openclaw.json

models.providers セクションにカスタムプロバイダを追加します。

設定テンプレート

Anthropic 互換 API（例：anapi、智谱）

{
  "models": {
    "mode": "merge",
    "providers": {
      "供应商名称": {
        "baseUrl": "https://api.example.com",
        "apiKey": "sk-your-api-key",
        "auth": "api-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "model-id",
            "name": "显示名称",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      }
    }
  }
}

OpenAI 互換 API（例：OpenRouter）

{
  "models": {
    "mode": "merge",
    "providers": {
      "供应商名称": {
        "baseUrl": "https://api.example.com/v1",
        "apiKey": "sk-your-api-key",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4",
            "name": "GPT-4",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

重要なフィールドの説明

モデルエイリアスの追加

agents.defaults.models にエイリアスを追加します。

{
  "agents": {
    "defaults": {
      "models": {
        "供应商/模型id": {
          "alias": "简短别名"
        }
      }
    }
  }
}

⚠️ 重要な制約：alias フィールドは文字列である必要があり、配列であってはなりません！

// ✅ 正しい
"alias": "opus46"

// ❌ 間違い - Config validation failed が発生します
"alias": ["opus46", "aixn/opus46"]

複数のエイリアスを同じモデルに割り当てる必要がある場合は、models に複数のレコードを追加する必要があります。

"供应商/模型id": { "alias": "别名1" }

デフォルトモデルとして設定

agents.defaults.model で設定します。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "供应商/模型id",
        "fallbacks": [
          "备选供应商1/模型id",
          "备选供应商2/模型id"
        ]
      }
    }
  }
}

追加手順

1. プロバイダ情報の取得

   • Base URL
   • API Key
   • API 形式（Anthropic または OpenAI 互換）
   • サポートされているモデルのリスト

2. gateway config.patch を使用して追加

   gateway config.patch 添加供应商配置

3. Gateway を再起動して有効化

   gateway restart

4. 新しいモデルのテスト

   session_status(model="新供应商/模型id")

一般的な中継ステーション設定の例

Anapi (Anthropic 中継)

"anapi": {
  "baseUrl": "https://anapi.9w7.cn",
  "apiKey": "sk-xxx",
  "auth": "api-key",
  "api": "anthropic-messages",
  "models": [{"id": "opus-4.5", "name": "Opus 4.5", "contextWindow": 200000}]
}

智谱 ZAI

"zai": {
  "baseUrl": "https://open.bigmodel.cn/api/anthropic",
  "apiKey": "xxx.xxx",
  "auth": "api-key",
  "api": "anthropic-messages",
  "models": [{"id": "glm-4.7", "name": "GLM-4.7", "contextWindow": 200000}]
}

OpenRouter VIP

"openrouter-vip": {
  "baseUrl": "https://openrouter.vip/v1",
  "apiKey": "sk-xxx",
  "auth": "api-key",
  "api": "openai-completions",
  "models": [{"id": "gpt-5.2", "name": "GPT-5.2", "contextWindow": 200000}]
}

トラブルシューティング

1. 401 Unauthorized - API Key が間違っているか期限切れ
2. 404 Not Found - baseUrl パスが間違っているか、API 形式が一致しない
3. モデルが存在しない - models[].id が正しいか確認
4. 形式が間違っている - api フィールドがプロバイダの API 形式と一致するか確認

よくある質問と解決策

API 形式の不一致による 404

症状：メッセージは正常に送信されたが、AI から 404 status code (no body) が返される

原因：プロバイダの API 形式の設定が間違っている。

診断：

# Anthropic Messages API 形式のテスト
curl -X POST "https://your-api-endpoint/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"model-id","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

# OpenAI Completions API 形式のテスト
curl -X POST "https://your-api-endpoint/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model":"model-id","messages":[{"role":"user","content":"hi"}],"max_tokens":10}'

解決：

1. プロバイダが使用する API 形式を確認します。

   • Anthropic 形式：/v1/messages を使用し、リクエストボディに messages 配列を含めます
   • OpenAI 形式：/v1/chat/completions を使用し、リクエストボディに messages 配列を含めます

2. models.json の api フィールドを修正します。

   {
     "providers": {
       "your-provider": {
         "api": "anthropic-messages"  // または "openai-completions"
       }
     }
   }

3. Gateway を再起動します。

   openclaw gateway restart

事例：

• Anapi は Anthropic Messages API を使用するため、"api": "anthropic-messages" を設定する必要があります
• OpenRouter VIP は OpenAI Completions API を使用するため、"api": "openai-completions" を設定する必要があります
• 智谱 ZAI は Anthropic Messages API を使用するため、"api": "anthropic-messages" を設定する必要があります