Konfigurasi Model
Atur model bahasa untuk Hermes Agent, termasuk penyedia model, kredensial API, dan pemeriksaan koneksi.
Halaman ini menjelaskan cara mengonfigurasi large language model untuk Hermes Agent, termasuk perbedaan antara tiga metode konfigurasi, cara mendapatkan API Key, langkah konfigurasi di konsol, model yang didukung, dan panduan memilih model.
Yang dibahas di halaman ini
-
Perbedaan antara tiga metode konfigurasi (Coding Plan / API / Custom Model)
-
Cara mendapatkan API Key
-
Langkah konfigurasi di konsol
-
Penggantian model
-
Model yang didukung
-
Panduan memilih model
Tiga metode konfigurasi
Dropdown tingkat pertama pada kartu "Model" di konsol menyediakan tiga opsi:
| Metode | Mode penagihan | Sumber API Key | Kasus penggunaan |
|---|---|---|---|
| Model Coding Plan | Bulanan / tahunan | Penyedia | Penggunaan intensitas tinggi |
| Model API | Bayar sesuai pemakaian | Penyedia | Penggunaan ringan atau uji coba |
| Custom model | Bergantung pada endpoint | Disediakan pengguna | Menghubungkan model luar negeri atau endpoint yang kompatibel dengan OpenAI |
Alur umum mendapatkan API Key
Antarmuka tiap penyedia berbeda, tetapi alurnya umumnya sama:
-
Kunjungi situs penyedia: Setelah memilih model di kartu model pada konsol, tautan "Get API KEY" akan muncul di bawahnya. Klik tautan tersebut untuk membuka situs penyedia
-
Daftar atau masuk: Sebagian besar platform Tiongkok mendukung login via WeChat atau nomor telepon
-
Selesaikan verifikasi nama asli: Penyedia model Tiongkok umumnya mewajibkan verifikasi nama asli sebelum pemanggilan API diizinkan
-
Buka halaman pengelolaan API Key: Biasanya berada di "Konsol → API Management / Key Management / Credentials"
-
Buat Key baru: Beri nama Key tersebut (misalnya
LightVela) dan segera salin setelah dibuat. Sebagian besar platform hanya menampilkan Key lengkap satu kali -
Kembali ke LightVela dan tempel Key tersebut
Konfigurasi di konsol
Masuk ke konsol lalu buka tombol "Model".
Langkah konfigurasi
-
Pilih sumber (dropdown tingkat pertama): Model API / Model Coding Plan / Custom Model
-
Pilih model spesifik (dropdown tingkat kedua): Model yang tersedia ditampilkan berdasarkan sumber yang dipilih di atas
-
Masukkan API Key: Tempel Key yang sudah Anda peroleh. Ikon mata di sebelah kanan mengatur visibilitas
-
Klik "Add as default"
-
Catatan terkait akan muncul di daftar "Current model", menandakan konfigurasi berhasil
Kolom tambahan untuk custom model
Saat memilih "Custom Model", biasanya Anda perlu mengisi kolom berikut selain API Key:
-
Base URL: Alamat API layanan model, misalnya
https://api.openai.com/v1 -
Model Name: Pengenal model, misalnya
gpt-4oatauclaude-3-5-sonnet-20241022
Kolom yang sebenarnya mengikuti antarmuka konsol.
Mengganti model
Cara mengganti
Jalankan kembali langkah konfigurasi. Aksi "Add as default" yang baru akan menimpa konfigurasi sebelumnya.
Dampak pada memori
Mengganti model tidak memengaruhi memori percakapan. Memori merupakan milik Hermes Agent itu sendiri; model hanya bertanggung jawab menghasilkan balasan.
Model yang didukung
Model Coding Plan (bulanan)
| Nama | Penyedia |
|---|---|
| Zhipu AI (GLM International - Coding Plan) | Zhipu AI |
| Kimi Coding Plan | Moonshot AI |
| Xiaomi Token Plan | Xiaomi |
| Bailian Coding Plan | Alibaba Cloud Bailian |
| Volcano Engine Ark Coding Plan | Volcano Engine (ByteDance) |
Model API (bayar sesuai pemakaian)
| Nama | Penyedia |
|---|---|
| OpenAI | OpenAI |
| Anthropic | Anthropic |
| Google Gemini | |
| OpenRouter | OpenRouter |
| DeepSeek | DeepSeek |
| Bailian (Qwen) | Alibaba |
| MiniMax (International) | MiniMax |
| Moonshot AI (Kimi International) | Moonshot |
| Zhipu AI (GLM International) | Zhipu |
| Volcano Engine (Doubao) | ByteDance |
| Xiaomi MiMo | Xiaomi |
Custom model
Endpoint apa pun yang kompatibel dengan protokol OpenAI Chat Completions dapat dihubungkan, termasuk:
-
Model yang di-hosting sendiri: vLLM, Ollama, LM Studio, dan layanan lain yang menyediakan endpoint kompatibel OpenAI
-
Platform agregasi: OpenRouter, dan sejenisnya
Panduan memilih model
Arah pemilihan untuk prioritas yang berbeda:
| Prioritas | Arah yang disarankan |
|---|---|
| Kuota gratis | Banyak penyedia menawarkan kuota gratis untuk akun baru; mulai dengan uji coba |
| Pemrosesan konteks panjang | Pilih model dengan context window lebih besar (seperti Moonshot AI) |
| Kecepatan respons | Antar penyedia berbeda cukup jauh; andalkan pengalaman aktual |
| Pemahaman bahasa Tiongkok | Model Tiongkok umumnya lebih baik dalam bahasa Tiongkok |
| Penggunaan intensitas tinggi | Pilih Coding Plan bulanan dari penyedia terkait |
Rekomendasi: pakai dulu kredit uji coba paket Launch untuk beberapa percakapan. Setelah memastikan Hermes Agent bekerja normal, tentukan model yang ingin Anda gunakan.
FAQ
| Masalah | Kemungkinan penyebab | Solusi |
|---|---|---|
| "Current model" tetap kosong setelah memasukkan Key | Format Key salah atau mengandung spasi | Salin dan tempel ulang; pastikan tidak ada spasi di awal atau akhir |
| Tidak ada respons dalam waktu lama setelah mengirim pesan | Saldo penyedia tidak cukup atau Key dinonaktifkan | Periksa saldo dan status Key di konsol penyedia |
| Isi balasan berupa karakter acak atau tidak bermakna | Endpoint custom model tidak kompatibel dengan protokol OpenAI | Verifikasi ketersediaan endpoint dengan klien kompatibel OpenAI lain terlebih dahulu |
| "Model response timeout" | Rate limit penyedia atau jaringan tidak stabil | Coba lagi nanti atau ganti ke penyedia lain |
| Tidak yakin dengan Base URL suatu custom model | — | Periksa dokumentasi API layanan terkait; biasanya berformat https://xxx.com/v1 |
Error percakapan "HTTP 401:InvalidAuthentication" atau error 401 sejenis
Jika HTTP 401:InvalidAuthentication atau error 401 xxx lain muncul saat percakapan dengan OpenClaw, biasanya penyebabnya salah satu dari berikut:
-
API Key model dikonfigurasi dengan salah;
-
API Key Coding Plan tertukar dengan API Key model biasa;
-
Versi domestik atau internasional dari penyedia model dipilih dengan salah.
Jika ini terjadi, periksa kembali konfigurasi model Anda.