Konfigurasi Proxy API MoltBot: Tutorial Lengkap 3 Langkah Akses Berbagai Model Seperti Claude Opus

Ingin menghubungkan MoltBot ke Claude Opus 4.5 atau Model Bahasa Besar lainnya, tetapi tidak tahu cara mengonfigurasi proksi API? Artikel ini akan memandu Anda langkah demi langkah untuk menyelesaikan Konfigurasi Multi-Provider MoltBot, sehingga asisten AI Anda dapat terhubung ke beberapa layanan model secara bersamaan, memungkinkan peralihan cerdas dan pencadangan pemulihan bencana.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai metode konfigurasi models.providers di MoltBot, belajar cara mengatur model utama, model cadangan, dan alias model untuk membangun asisten AI yang stabil dan andal.

Konfigurasi Proksi API MoltBot: Analisis Konsep Inti

MoltBot mendukung akses ke hampir semua layanan Model Bahasa Besar arus utama melalui API Kompatibel OpenAI. Memahami konsep inti berikut adalah kunci keberhasilan konfigurasi.

Sistem File Konfigurasi MoltBot

Bidang Inti Konfigurasi Provider MoltBot

Setiap konfigurasi Provider berisi bidang-bidang kunci berikut:

Penjelasan Tipe Protokol API

MoltBot mendukung dua protokol kompatibel OpenAI yang utama:

🎯 Saran Konfigurasi: Sebagian besar layanan proksi API (seperti APIYI apiyi.com) menggunakan protokol openai-completions. Jika Anda menggunakan LM Studio atau Ollama yang di-deploy secara lokal, Anda perlu menggunakan openai-responses.

Konfigurasi Multi-Provider MoltBot: Contoh Lengkap

Berikut adalah contoh konfigurasi multi-provider yang siap pakai, menghubungkan layanan APIYI dan Qwen Portal sekaligus:

Contoh File Konfigurasi Lengkap

{
  "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}"
    }
  }
}

Penjelasan Detail Struktur Konfigurasi

1. Bagian models.providers

Ini adalah bagian inti untuk menentukan layanan proksi API:

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

• Provider ID (apiyi): Identitas layanan kustom yang akan digunakan untuk referensi nantinya.
• baseUrl: Endpoint API, harus diakhiri dengan /v1.
• apiKey: Mendukung pengisian langsung atau menggunakan variabel lingkungan ${ENV_VAR}.
• models: Daftar model yang didukung oleh Provider tersebut.

2. Bagian agents.defaults.model

Menentukan model default yang digunakan dan strategi pemulihan bencana (failover):

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

• primary: Model utama, formatnya adalah provider-id/model-id.
• fallbacks: Array model cadangan, otomatis beralih jika model utama gagal.

3. Bagian agents.defaults.models

Menentukan alias model untuk memudahkan peralihan cepat:

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

Setelah mengonfigurasi alias, kamu bisa menggunakan perintah /model opus dalam percakapan untuk beralih model dengan cepat.

Konfigurasi Proxy API MoltBot: Tutorial Langkah demi Langkah

Langkah 1: Mendapatkan API Key

Sebelum melakukan konfigurasi, Anda perlu menyiapkan API Key:

🚀 Mulai Cepat: Direkomendasikan menggunakan APIYI apiyi.com sebagai Provider utama. Hanya dengan satu API Key, Anda bisa memanggil model-model populer seperti Claude, GPT, Gemini, dll., tanpa perlu mendaftar di banyak platform secara terpisah.

Langkah 2: Mengatur Variabel Lingkungan

Demi keamanan, disarankan menggunakan variabel lingkungan untuk menyimpan API Key:

# Linux/macOS - Tambahkan ke ~/.bashrc atau ~/.zshrc
export APIYI_API_KEY="sk-your-apiyi-key"
export QWEN_API_KEY="your-qwen-key"
export TELEGRAM_BOT_TOKEN="your-telegram-token"

# Terapkan konfigurasi
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"

Langkah 3: Mengedit File Konfigurasi

Buka atau buat file konfigurasi MoltBot:

# Buka file konfigurasi
nano ~/.moltbot/moltbot.json

# Atau gunakan VS Code
code ~/.moltbot/moltbot.json

Tempelkan konfigurasi berikut ke dalam file:

{
  "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"
      }
    }
  }
}

Langkah 4: Memverifikasi Konfigurasi

Mulai ulang MoltBot dan verifikasi apakah konfigurasi sudah berjalan:

# Mulai ulang MoltBot
moltbot restart

# Periksa konfigurasi model saat ini
moltbot models list

# Uji pemanggilan model
moltbot chat "Halo, tolong beri tahu saya Anda model apa"

{
  "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}"
    }
  }
}

💡 Tips Konfigurasi: Menggunakan "mode": "merge" memungkinkan Anda tetap menyimpan konfigurasi model bawaan MoltBot sambil menambahkan Provider kustom Anda sendiri. Dengan begitu, jika layanan kustom tidak tersedia, sistem bisa kembali (fallback) ke konfigurasi default.

Konfigurasi Model MoltBot: Penjelasan Detail Parameter Lanjutan

Field Lengkap Entri Model

Parameter Konfigurasi Model MoltBot Perbandingan field Wajib vs Opsional

Parameter Tipe Wajib Contoh Nilai

FIELD WAJIB

id string YA “claude-opus-4-5-20251101”

name string YA “Claude Opus 4.5”

baseUrl string YA “https://api.apiyi.com/v1”

FIELD OPSIONAL

contextWindow number TIDAK 200000

maxTokens number TIDAK 32000

reasoning boolean TIDAK true

input array TIDAK [“text”, “image”]

Wajib diisi Gunakan default jika tidak diatur

Tips: Atur contextWindow dan maxTokens secara eksplisit sesuai batas proxy/model untuk hasil terbaik

APIYI apiyi.com

Konfigurasi Parameter Model (params)

Di dalam agents.defaults.models, Anda dapat mengatur parameter default untuk setiap model:

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

⚠️ Catatan: temperature adalah parameter tingkat lanjut. Kecuali Anda memahami pengaturan default model dan benar-benar perlu menyesuaikannya, disarankan untuk tidak mengaturnya.

Konfigurasi Fallback MoltBot

Mekanisme Fallback adalah fitur penting dari MoltBot yang memastikan asisten AI Anda selalu siap sedia setiap saat.

Cara Kerja Fallback

Permintaan Pengguna
    ↓
Model Utama (primary)
    ↓ (Gagal)
Model Cadangan 1 (fallbacks[0])
    ↓ (Gagal)
Model Cadangan 2 (fallbacks[1])
    ↓ (Gagal)
...Lanjut mencoba

Strategi Konfigurasi Fallback yang Direkomendasikan

Konfigurasi yang Direkomendasikan:

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

💰 Optimasi Biaya: Dengan mengonfigurasi Fallback melalui APIYI apiyi.com, Anda bisa berpindah antar model secara otomatis sekaligus menikmati sistem penagihan terpadu, yang memudahkan pengontrolan biaya.

Perpindahan Model MoltBot: Tips Praktis

Beralih Cepat dengan Alias

Setelah mengonfigurasi alias, Anda bisa mengganti model kapan saja di tengah percakapan:

Anda: /model opus
MoltBot: Telah beralih ke Claude Opus 4.5

Anda: /model sonnet
MoltBot: Telah beralih ke Claude Sonnet 4

Anda: /model qwen
MoltBot: Telah beralih ke Qwen Coder

Menentukan Model untuk Tugas Tertentu

Anda: /model gpt bantu saya analisis gambar ini
MoltBot: [Menggunakan GPT-4o untuk menganalisis gambar...]

Anda: /model opus tulis artikel teknis yang mendalam
MoltBot: [Menggunakan Claude Opus untuk menulis...]

Melihat Status Model Saat Ini

# Lihat melalui command line
moltbot models list

# Lihat di dalam percakapan
Anda: /model
MoltBot: Model saat ini: apiyi/claude-opus-4-5-20251101 (alias: opus)

Konfigurasi Proxy API MoltBot: Pertanyaan Umum (FAQ)

{
  "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" }
    }
  }
}

Konfigurasi Proxy API MoltBot: Ringkasan dan Saran

Melalui artikel ini, Anda telah memahami metode lengkap konfigurasi proxy API untuk MoltBot:

1. Memahami Struktur Konfigurasi: models.providers mendefinisikan layanan, agents.defaults mendefinisikan strategi penggunaan.
2. Mengatur Banyak Provider: Menghubungkan beberapa layanan API sekaligus untuk meningkatkan ketersediaan.
3. Konfigurasi Fallback: Otomatis beralih ke model cadangan jika model utama gagal.
4. Menggunakan Alias: Beralih model dengan cepat melalui perintah /model alias.

Saran Praktik Terbaik

Kami merekomendasikan penggunaan APIYI apiyi.com sebagai layanan proxy API utama Anda. Platform ini menyediakan akses terpadu ke berbagai model populer seperti Claude, GPT, dan Gemini. Konfigurasinya sederhana dan mendukung metode penagihan yang fleksibel, sangat cocok untuk skenario pergantian model di MoltBot.

Referensi

1. Dokumentasi Resmi MoltBot – Models: Penjelasan mendalam konfigurasi model

   • Link: docs.molt.bot/concepts/models
   • Deskripsi: Panduan konfigurasi model resmi

2. Dokumentasi Resmi MoltBot – Configuration: Referensi konfigurasi lengkap

   • Link: docs.molt.bot/gateway/configuration
   • Deskripsi: Penjelasan mendalam untuk semua item konfigurasi

3. Dokumentasi Resmi MoltBot – Model Providers: Konfigurasi Provider

   • Link: docs.molt.bot/concepts/model-providers
   • Deskripsi: Metode konfigurasi Provider kustom

4. MoltBot GitHub: Kode sumber dan diskusi Issue

   • Link: github.com/moltbot/moltbot
   • Deskripsi: Versi terbaru dan umpan balik masalah

Penulis: APIYI Team | Untuk lebih banyak berbagi teknologi AI, silakan kunjungi APIYI apiyi.com

Tanggal Pembaruan: Januari 2026