MoltBot APIプロキシ設定：Claude Opusなど複数の大規模言語モデルを導入する3ステップ完全チュートリアル

MoltBotで Claude Opus 4.5 やその他の大規模言語モデルを使いたいけれど、APIプロキシの設定方法がわからないとお困りではありませんか？この記事では、MoltBotのマルチプロバイダー（Multi-Provider）設定について、ステップバイステップで解説します。複数のモデルサービスを同時に連携させ、スマートな切り替えや障害時のバックアップを実現しましょう。

核となるメリット: この記事を読み終える頃には、MoltBotの models.providers の設定方法をマスターし、メインモデル、バックアップモデル、モデルエイリアスの設定ができるようになります。これにより、安定して信頼性の高いAIアシスタントを構築できます。

MoltBot API プロキシ設定：コア概念の解説

MoltBot は、OpenAI Compatible API を通じて、ほぼすべての主要な大規模言語モデルサービスへの接続をサポートしています。設定を成功させるためには、以下のコア概念を理解することが重要です。

MoltBot 設定ファイル体系

MoltBot Provider 設定の主要フィールド

各 Provider 設定には、以下の重要なフィールドが含まれます。

API プロトコル種別の説明

MoltBot は、主に2つの OpenAI 互換プロトコルをサポートしています。

🎯 設定のアドバイス: ほとんどの API プロキシサービス（APIYI など）は openai-completions プロトコルを使用します。LM Studio や Ollama などのローカル環境を使用している場合は、openai-responses を使用する必要があります。

MoltBot マルチプロバイダー設定：完全な例

以下は、APIYI と Qwen Portal の 2 つのサービスに同時に接続する、実際に利用可能なマルチプロバイダー設定の例です。

構成ファイルの完全な例

{
  "models": {
    "providers": {
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "${QWEN_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "coder-model", "name": "Qwen Coder", "contextWindow": 128000 },
          { "id": "vision-model", "name": "Qwen Vision", "contextWindow": 128000 }
        ]
      },
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5", "contextWindow": 200000 },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4", "contextWindow": 200000 },
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101",
        "fallbacks": ["qwen-portal/vision-model"]
      },
      "models": {
        "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
        "apiyi/claude-sonnet-4-20250514": { "alias": "sonnet" },
        "qwen-portal/coder-model": { "alias": "qwen" }
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    }
  }
}

設定構造の詳細解説

1. models.providers セクション

これは API プロキシサービスを定義するコア部分です。

"providers": {
  "apiyi": {
    "baseUrl": "https://api.apiyi.com/v1",
    "apiKey": "${APIYI_API_KEY}",
    "api": "openai-completions",
    "models": [...]
  }
}

• プロバイダー ID (apiyi): カスタムサービス識別子。後の参照に使用されます。
• baseUrl: API エンドポイント。/v1 で終わる必要があります。
• apiKey: 直接入力、または ${ENV_VAR} 環境変数の使用をサポートしています。
• models: このプロバイダーがサポートするモデルのリストです。

2. agents.defaults.model セクション

デフォルトで使用するモデルとフォールバック（障害耐性）戦略を定義します。

"model": {
  "primary": "apiyi/claude-opus-4-5-20251101",
  "fallbacks": ["qwen-portal/vision-model"]
}

• primary: メインモデル。形式は provider-id/model-id です。
• fallbacks: 予備モデルの配列。メインモデルが失敗した時に自動的に切り替わります。

3. agents.defaults.models セクション

モデルのエイリアス（別名）を定義し、素早い切り替えを可能にします。

"models": {
  "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
  "qwen-portal/coder-model": { "alias": "qwen" }
}

エイリアスを設定すると、会話の中で /model opus を使って素早くモデルを切り替えることができます。

MoltBot API プロキシ設定：ステップバイステップチュートリアル

ステップ 1：API キーの取得

設定を始める前に、API キーを準備する必要があります。

🚀 クイックスタート: メインプロバイダーとして APIYI (apiyi.com) の使用をお勧めします。1 つの API キーで Claude、GPT、Gemini などの主要なモデルを呼び出すことができ、複数のプラットフォームに個別に登録する必要がありません。

ステップ 2：環境変数の設定

セキュリティのため、API キーは環境変数に保存することをお勧めします。

# Linux/macOS - ~/.bashrc または ~/.zshrc に追加
export APIYI_API_KEY="sk-your-apiyi-key"
export QWEN_API_KEY="your-qwen-key"
export TELEGRAM_BOT_TOKEN="your-telegram-token"

# 設定を反映させる
source ~/.bashrc

# Windows PowerShell
$env:APIYI_API_KEY = "sk-your-apiyi-key"
$env:QWEN_API_KEY = "your-qwen-key"
$env:TELEGRAM_BOT_TOKEN = "your-telegram-token"

ステップ 3：設定ファイルの編集

MoltBot の設定ファイルを開くか作成します。

# 設定ファイルを開く
nano ~/.moltbot/moltbot.json

# または VS Code で開く
code ~/.moltbot/moltbot.json

以下の設定をファイルに貼り付けてください。

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101"
      }
    }
  }
}

ステップ 4：設定の確認

MoltBot を再起動し、設定が反映されているか確認します。

# MoltBot を再起動
moltbot restart

# 現在のモデル設定を確認
moltbot models list

# モデルの呼び出しテスト
moltbot chat "こんにちは。あなたがどのモデルか教えてください"

{
  "models": {
    "mode": "merge",
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4",
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      },
      "qwen-portal": {
        "baseUrl": "https://portal.qwen.ai/v1",
        "apiKey": "${QWEN_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "contextWindow": 128000
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "contextWindow": 128000
          }
        ]
      },
      "local-ollama": {
        "baseUrl": "http://localhost:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-responses",
        "models": [
          {
            "id": "llama3.3:70b",
            "name": "Llama 3.3 70B",
            "contextWindow": 128000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/claude-opus-4-5-20251101",
        "fallbacks": [
          "apiyi/claude-sonnet-4-20250514",
          "qwen-portal/vision-model",
          "local-ollama/llama3.3:70b"
        ]
      },
      "models": {
        "apiyi/claude-opus-4-5-20251101": {
          "alias": "opus",
          "params": { "temperature": 0.7 }
        },
        "apiyi/claude-sonnet-4-20250514": {
          "alias": "sonnet",
          "params": { "temperature": 0.5 }
        },
        "apiyi/gpt-4o": {
          "alias": "gpt"
        },
        "qwen-portal/coder-model": {
          "alias": "qwen"
        },
        "local-ollama/llama3.3:70b": {
          "alias": "llama"
        }
      },
      "imageModel": "apiyi/gpt-4o"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    },
    "discord": {
      "enabled": false,
      "token": "${DISCORD_BOT_TOKEN}"
    }
  }
}

💡 設定のヒント: "mode": "merge" を使用すると、MoltBot 内蔵のモデル設定を保持したまま、独自のカスタムプロバイダーを追加できます。これにより、カスタムサービスが利用できない場合でもデフォルト設定にフォールバックできます。

MoltBot モデル設定：高度なパラメータ詳細

モデル項目の全フィールド

モデルパラメータ設定 (params)

agents.defaults.models では、各モデルのデフォルトパラメータを設定できます。

"models": {
  "apiyi/claude-opus-4-5-20251101": {
    "alias": "opus",
    "params": {
      "temperature": 0.7,
      "maxTokens": 16000
    }
  }
}

⚠️ 注意: temperature は高度なパラメータです。モデルのデフォルト設定を理解しており、調整が必要な場合を除き、設定しないことをお勧めします。

MoltBot Fallback 障害対策（フェイルオーバー）設定

Fallback（フォールバック）機能は、AI アシスタントが常に利用可能な状態を維持するための MoltBot の重要な機能です。

Fallback の仕組み

ユーザーのリクエスト
    ↓
メインモデル (primary)
    ↓ (失敗)
バックアップモデル 1 (fallbacks[0])
    ↓ (失敗)
バックアップモデル 2 (fallbacks[1])
    ↓ (失敗)
...試行を継続

推奨される Fallback 設定戦略

推奨設定例:

"model": {
  "primary": "apiyi/claude-opus-4-5-20251101",
  "fallbacks": [
    "apiyi/claude-sonnet-4-20250514",
    "apiyi/gpt-4o",
    "qwen-portal/vision-model"
  ]
}

💰 コスト最適化: APIYI (apiyi.com) を通じて Fallback を設定することで、複数のモデル間を自動で切り替えながら、統一された課金方式を利用できるため、コスト管理が容易になります。

MoltBot モデル切り替え：実践テクニック

エイリアスを使用した素早い切り替え

エイリアスを設定しておくと、会話の中でいつでもモデルを切り替えることができます。

あなた: /model opus
MoltBot: Claude Opus 4.5 に切り替えました

あなた: /model sonnet
MoltBot: Claude Sonnet 4 に切り替えました

あなた: /model qwen
MoltBot: Qwen Coder に切り替えました

特定のタスクにモデルを指定する

あなた: /model gpt この画像を分析してください
MoltBot: [GPT-4o を使用して画像を分析中...]

あなた: /model opus 深掘りした技術記事を書いてください
MoltBot: [Claude Opus を使用して執筆中...]

現在のモデルの状態を確認する

# コマンドラインで確認
moltbot models list

# 会話の中で確認
あなた: /model
MoltBot: 現在のモデル: apiyi/claude-opus-4-5-20251101 (alias: opus)

MoltBot API プロキシ設定: よくある質問

{
  "models": {
    "mode": "merge",
    "providers": {
      "local-ollama": {
        "baseUrl": "http://localhost:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-responses",
        "models": [...]
      },
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "${APIYI_API_KEY}",
        "api": "openai-completions",
        "models": [...]
      }
    }
  }
}

"agents": {
  "defaults": {
    "model": {
      "primary": "apiyi/claude-opus-4-5-20251101"
    },
    "imageModel": "apiyi/gpt-4o",
    "models": {
      "apiyi/claude-opus-4-5-20251101": { "alias": "opus" },
      "apiyi/gpt-4o": { "alias": "vision" }
    }
  }
}

MoltBot API プロキシ設定: まとめと推奨事項

この記事を通じて、MoltBot で API プロキシを設定する完全な方法をマスターしました。

1. 設定構造の理解: models.providers でサービスを定義し、agents.defaults で使用戦略を定義します。
2. 複数プロバイダーの設定: 複数の API サービスを同時に導入し、可用性を高めます。
3. フォールバックの設定: メインモデルが失敗した際に、予備モデルへ自動で切り替えます。
4. エイリアスの活用: /model alias コマンドでモデルを素早く切り替えます。

ベストプラクティス

主要な API プロキシサービスとして APIYI（apiyi.com）の利用をお勧めします。このプラットフォームは Claude、GPT、Gemini などの主要モデルへの統一的なアクセスを提供しており、設定が簡単で柔軟な課金体系に対応しているため、MoltBot のマルチモデル切り替えシーンに最適です。

参考資料

1. MoltBot 公式ドキュメント – Models: モデル設定の詳細

   • リンク: docs.molt.bot/concepts/models
   • 説明: 公式モデル設定ガイド

2. MoltBot 公式ドキュメント – Configuration: 完全な設定リファレンス

   • リンク: docs.molt.bot/gateway/configuration
   • 説明: すべての設定項目の詳細解説

3. MoltBot 公式ドキュメント – Model Providers: プロバイダーの設定

   • リンク: docs.molt.bot/concepts/model-providers
   • 説明: カスタムプロバイダーの設定方法

4. MoltBot GitHub: ソースコードと Issue での議論

   • リンク: github.com/moltbot/moltbot
   • 説明: 最新バージョンとフィードバック

本文執筆: APIYI Team | さらなる AI 技術の共有については、APIYI apiyi.com をご覧ください。

更新日: 2026年1月