Kuasai 3 cara beralih model di OpenClaw: Tutorial lengkap dari Claude Sonnet 4.6 hingga GPT-5.4-mini

Saat menggunakan OpenClaw, banyak pengguna yang sering menemui masalah umum: model saat ini terlalu mahal atau kurang cocok, lalu bingung bagaimana cara beralih ke model lain. Misalnya, Anda sedang menggunakan mode Anthropic Messages claude-sonnet-4-6, konsumsi Token harian cukup besar, dan Anda ingin beralih ke gpt-5.4-mini yang lebih ekonomis—apakah perlu menjalankan openclaw onboard lagi?

Jawabannya adalah: Sama sekali tidak perlu melakukan onboard ulang. OpenClaw menyediakan 3 cara fleksibel untuk beralih model, dan prosesnya bisa selesai dalam waktu kurang dari 10 detik.

Nilai Utama: Setelah membaca artikel ini, Anda akan menguasai semua metode untuk beralih model di OpenClaw, memilih cara yang paling sesuai dengan skenario Anda, serta mempelajari cara menambahkan Provider kustom untuk mencapai manajemen multi-model yang terpadu.

Poin Utama Beralih Model di OpenClaw

Sebelum masuk ke langkah-langkah operasional, mari pahami mekanisme inti peralihan model di OpenClaw. OpenClaw adalah platform yang agnostik terhadap model, yang di bagian dasarnya menggunakan konfigurasi Provider untuk terhubung ke berbagai penyedia layanan AI.

Prasyarat Beralih Model di OpenClaw

Sebelum beralih model, pastikan kondisi berikut terpenuhi:

1. OpenClaw sudah terinstal dan onboard selesai: Sudah pernah menjalankan openclaw onboard saat instalasi pertama.
2. Kunci API model target sudah dikonfigurasi: Misalnya, jika ingin beralih ke GPT-5.4-mini, Anda harus memiliki kunci API OpenAI.
3. Layanan Gateway sedang berjalan: Konfirmasi status layanan melalui openclaw status.

# Periksa status operasional OpenClaw
openclaw status

# Jika gateway tidak berjalan, jalankan
openclaw gateway start

🎯 Saran Teknis: Jika Anda perlu menggunakan kunci API dari beberapa model sekaligus, Anda bisa mendapatkan antarmuka API terpadu melalui platform APIYI (apiyi.com). Satu kunci API sudah cukup untuk memanggil model utama seperti Claude, GPT, Gemini, dan lainnya, sehingga Anda tidak perlu repot mendaftar dan mengelola banyak kunci API secara terpisah.

OpenClaw Cara 1: Beralih Model Secara Real-time dengan Perintah /model

Ini adalah cara tercepat dan termudah untuk beralih model, sangat cocok jika Anda ingin melakukan pengujian cepat atau mengganti model sesuai kebutuhan di tengah percakapan.

Sintaks Dasar

Di antarmuka obrolan OpenClaw mana pun, cukup ketik:

/model openai/gpt-5.4-mini

Sangat mudah—perintah langsung aktif setelah diketik, dan percakapan saat ini akan mulai menggunakan GPT-5.4-mini.

Contoh Lengkap Perintah Beralih Model di OpenClaw

Karakteristik Perintah /model

Keunggulan:

• Langsung aktif, tidak perlu memulai ulang layanan apa pun.
• Bisa beralih kapan saja dalam percakapan, mendukung pengujian A/B untuk model yang berbeda.
• Tidak memengaruhi pengaturan model default di file konfigurasi.

Keterbatasan:

• Hanya berlaku untuk sesi saat ini, percakapan baru akan kembali ke model default.
• Tidak mengubah file konfigurasi, pengaturan akan hilang setelah aplikasi dimulai ulang.

Demonstrasi Operasi Aktual

Misalkan Anda saat ini menggunakan claude-sonnet-4-6 dan ingin beralih ke gpt-5.4-mini:

Langkah 1: Konfirmasi model saat ini

# Ketik di obrolan OpenClaw
/model

# Contoh output:
# Current model: anthropic/claude-sonnet-4-6
# Provider: anthropic
# API type: anthropic-messages

Langkah 2: Eksekusi perintah beralih

/model openai/gpt-5.4-mini

# Contoh output:
# ✅ Model switched to: openai/gpt-5.4-mini
# Provider: openai
# API type: openai-completions

Langkah 3: Verifikasi keberhasilan

Kirim pesan langsung dan amati apakah respons berasal dari model baru. Anda bisa bertanya "Kamu model apa?" untuk memastikannya.

💡 Tips: Jika saat beralih muncul peringatan bahwa kunci API belum dikonfigurasi, artinya Anda belum mengatur kunci untuk Provider target. Lihat bagian konfigurasi Provider di "Cara 2: Mengedit File Konfigurasi" di bawah untuk menambahkannya.

OpenClaw Cara 2: Mengedit File Konfigurasi untuk Perubahan Permanen

Jika Anda ingin perubahan model berlaku secara permanen (otomatis menggunakan model baru setiap kali OpenClaw dimulai), Anda perlu mengubah file konfigurasi. Ini adalah cara yang paling direkomendasikan untuk penggunaan sehari-hari.

Lokasi File Konfigurasi

File konfigurasi utama OpenClaw terletak di:

~/.openclaw/openclaw.json

Anda dapat membukanya dengan editor teks apa pun, atau menggunakan perintah bawaan OpenClaw:

# Gunakan editor konfigurasi bawaan
openclaw configure

# Atau buka langsung dengan editor
code ~/.openclaw/openclaw.json    # VS Code
vim ~/.openclaw/openclaw.json     # Vim
nano ~/.openclaw/openclaw.json    # Nano

Penjelasan Struktur File Konfigurasi OpenClaw

File konfigurasi menggunakan format JSON standar. Berikut adalah kolom inti yang terkait dengan peralihan model:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-xxxxx",
        "api": "anthropic-messages",
        "models": ["claude-sonnet-4-6", "claude-opus-4-6", "claude-haiku-4-5"]
      },
      "openai": {
        "apiKey": "sk-xxxxx",
        "api": "openai-completions",
        "models": ["gpt-5.4-mini", "gpt-5.2", "o3-mini"]
      }
    }
  }
}

Langkah-langkah: Beralih dari Claude Sonnet ke GPT-5.4-mini

Langkah 1: Buka file konfigurasi

openclaw configure

Langkah 2: Pastikan Provider OpenAI sudah dikonfigurasi

Periksa apakah ada konfigurasi openai di dalam models.providers. Jika belum, tambahkan konten berikut:

"openai": {
  "apiKey": "sk-kunci-openai-anda",
  "api": "openai-completions",
  "models": ["gpt-5.4-mini", "gpt-5.2"]
}

Langkah 3: Ubah model default

Ubah nilai agents.defaults.model.primary dari anthropic/claude-sonnet-4-6 menjadi openai/gpt-5.4-mini:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-5.4-mini"
      }
    }
  }
}

Langkah 4: Simpan file dan mulai ulang Gateway

# Mulai ulang gateway agar konfigurasi aktif
openclaw gateway restart

# Konfirmasi status
openclaw status

Langkah 5: Verifikasi konfigurasi

# Gunakan perintah doctor untuk memeriksa apakah konfigurasi sudah benar
openclaw doctor --fix

🚀 Mulai Cepat: Jika Anda tidak ingin mengelola banyak kunci API secara terpisah untuk OpenAI, Anthropic, Google, dll., disarankan untuk menggunakan platform APIYI (apiyi.com). Hanya dengan satu kunci API, Anda dapat memanggil semua model utama melalui antarmuka yang kompatibel dengan OpenAI, sehingga konfigurasi menjadi lebih ringkas.

Penjelasan Tipe API dalam File Konfigurasi OpenClaw

Ini adalah bagian yang sering membingungkan pengguna. OpenClaw mendukung dua jenis protokol API:

Penting: Saat beralih model, tipe API akan secara otomatis mengikuti konfigurasi Provider. Anda tidak perlu menentukan tipe API secara manual, cukup pastikan kolom api pada Provider sudah dikonfigurasi dengan benar.

OpenClaw Cara Ganti Model 3: Operasi Visual melalui Dashboard

Bagi pengguna yang tidak terbiasa dengan operasi baris perintah (command line), OpenClaw menyediakan antarmuka Web Dashboard agar Anda bisa mengelola konfigurasi model secara grafis.

Menjalankan Dashboard

openclaw dashboard

Setelah dijalankan, browser akan otomatis membuka http://127.0.0.1:18789/, yang merupakan antarmuka manajemen Web lokal untuk OpenClaw.

Langkah-langkah Mengganti Model di Dashboard

Langkah 1: Setelah membuka Dashboard, cari opsi Settings (Pengaturan) di bilah navigasi sebelah kiri.

Langkah 2: Masuk ke halaman konfigurasi Models atau Agents.

Langkah 3: Di dalam daftar model, cari opsi Default Model.

Langkah 4: Pilih model target dari menu tarik-turun (contoh: openai/gpt-5.4-mini).

Langkah 5: Klik Save untuk menyimpan konfigurasi.

Langkah 6: Dashboard akan menanyakan apakah Anda ingin memulai ulang (restart) Gateway, cukup konfirmasi saja.

Keunggulan Operasi Dashboard

💰 Optimasi Biaya: Antarmuka Dashboard juga memungkinkan Anda melihat volume pemanggilan dan konsumsi Token setiap model secara intuitif. Jika Anda merasa biaya Claude Sonnet 4.6 terlalu tinggi, Anda bisa mengecek perbandingan harga berbagai model di APIYI apiyi.com untuk menemukan alternatif yang lebih hemat.

Lanjutan Ganti Model OpenClaw: Menambahkan Provider Kustom

Jika Anda ingin menggunakan platform pihak ketiga seperti APIYI untuk mengelola banyak model secara terpusat, Anda perlu menambahkan Provider kustom di file konfigurasi.

Mengapa Menggunakan Provider Kustom?

Contoh Konfigurasi Provider Kustom

Tambahkan kode berikut di models.providers dalam file ~/.openclaw/openclaw.json:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-kunci-APIYI-anda",
        "api": "openai-completions",
        "models": [
          "claude-sonnet-4-6",
          "claude-opus-4-6",
          "gpt-5.4-mini",
          "gpt-5.2",
          "gemini-3-pro-preview"
        ]
      }
    }
  }
}

Setelah konfigurasi selesai, untuk mengganti model cukup gunakan:

/model apiyi/gpt-5.4-mini
/model apiyi/claude-sonnet-4-6
/model apiyi/gemini-3-pro-preview

Semua model dipanggil melalui Provider yang sama, tidak perlu ganti kunci API, dan tidak perlu mengonfigurasi ulang Provider.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gpt-5.4-mini"
      },
      "sandbox": {
        "enabled": true
      }
    }
  },
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-xxxxx",
        "api": "anthropic-messages",
        "models": ["claude-sonnet-4-6", "claude-opus-4-6"]
      },
      "openai": {
        "apiKey": "sk-xxxxx",
        "api": "openai-completions",
        "models": ["gpt-5.4-mini", "gpt-5.2"]
      },
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-kunci-APIYI-anda",
        "api": "openai-completions",
        "models": [
          "claude-sonnet-4-6",
          "claude-opus-4-6",
          "gpt-5.4-mini",
          "gpt-5.2",
          "gemini-3-pro-preview",
          "qwen-max"
        ]
      },
      "google": {
        "apiKey": "AIza-xxxxx",
        "api": "openai-completions",
        "models": ["gemini-3-pro-preview"]
      }
    }
  },
  "channels": {
    "telegram": { "enabled": true },
    "discord": { "enabled": false }
  }
}

Mengubah Model Default ke Provider Kustom

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gpt-5.4-mini"
      }
    }
  }
}

Setelah disimpan, jalankan:

openclaw gateway restart

🎯 Saran Teknis: Keuntungan menggunakan Provider kustom adalah fleksibilitas pergantian model yang lebih tinggi. Melalui platform agregasi seperti APIYI apiyi.com, Anda bisa mengganti model dari berbagai vendor seperti Claude, GPT, atau Gemini di OpenClaw hanya dengan satu perintah, tanpa perlu mengubah konfigurasi Provider setiap saat.

Perbandingan 3 Cara Mengganti Model di OpenClaw

Pilihan cara yang tepat bergantung pada kebutuhan spesifik Anda:

Strategi yang disarankan:

• Pengembangan harian: Gunakan file konfigurasi untuk mengatur model default, dan sesekali gunakan /model untuk beralih sementara.
• Perbandingan multi-model: Gunakan /model dalam percakapan untuk beralih dengan cepat dan membandingkan hasilnya.
• Kolaborasi tim: Gunakan Dashboard untuk mengelola konfigurasi secara terpusat.

FAQ: Pertanyaan Umum Seputar Penggantian Model OpenClaw

# Diagnosa otomatis dan perbaiki masalah konfigurasi
openclaw doctor --fix

# Lihat log real-time untuk melacak masalah
openclaw logs --follow

Tabel Referensi Cepat Operasi Pengalihan Model OpenClaw

Berikut adalah tabel referensi cepat untuk memudahkan Anda saat melakukan pengoperasian:

Kesimpulan

Pengalihan model di OpenClaw sangat fleksibel, dengan 3 metode utama:

1. Perintah /model: Paling cepat, cocok untuk peralihan sementara dan pengujian perbandingan.
2. Mengedit file konfigurasi: Paling stabil, cocok untuk mengubah model default harian.
3. Antarmuka Dashboard: Paling intuitif, cocok untuk pengguna pemula.

Poin terpenting: Beralih model tidak memerlukan onboard ulang. Selama kunci API dari penyedia target dikonfigurasi dengan benar, Anda dapat berpindah antar model secara bebas.

Bagi pengguna yang perlu sering beralih antar model dari berbagai vendor, disarankan untuk mengonfigurasi penyedia kustom melalui APIYI apiyi.com. Satu antarmuka untuk mengelola semua model, membuat peralihan model di OpenClaw menjadi jauh lebih efisien.

Penulis Artikel: Tim Teknis APIYI
Diskusi Teknis: Kunjungi APIYI apiyi.com untuk mendapatkan tutorial konfigurasi model AI dan dukungan teknis lainnya
Tanggal Pembaruan: April 2026
Versi yang Berlaku: OpenClaw 2026.3.x+

Referensi:

1. Dokumentasi Resmi OpenClaw: docs.openclaw.ai
2. Repositori GitHub OpenClaw: github.com/openclaw/openclaw
3. Situs Web Resmi OpenClaw: openclaw.ai