# Cara mengatur Hermes Agent dengan OmniaKey: endpoint OpenAI-compatible > Hubungkan Hermes Agent ke endpoint OmniaKey yang kompatibel dengan OpenAI. Gunakan hermes model atau config.yaml, ganti model, dan hindari error 404. - Canonical HTML: https://omniakey.com/id/blog/hermes-setup - Markdown: https://omniakey.com/id/blog/hermes-setup.md - Published: 2026-05-24 (updated 2026-10-30) - Author: Kiki, COO at OmniaKey - Language: id - Category: Guide - Reading time: 4 min - All posts: https://omniakey.com/blog/llms.txt --- Diperbarui 30 Oktober 2026: empat kesalahan pengaturan Hermes yang umum kini dilengkapi gejala, penyebab, dan solusinya, diambil dari dokumentasi resmi Hermes Agent. Untuk **mengatur Hermes Agent API**, tambahkan custom endpoint yang kompatibel dengan OpenAI. Hermes Agent dari Nous Research dapat berpindah antara Claude, GPT, Gemini, dan Grok berdasarkan model ID. ## Cara cepat: `hermes model` ```bash hermes model ``` Pilih **Custom endpoint (self-hosted / VLLM / etc.)**, lalu masukkan: - **Base URL:** `https://api.omniakey.com/v1` - **API key:** key OmniaKey Anda - **Model:** misalnya `claude-opus-4-8` > Akhiri Base URL dengan `/v1`. Hermes menambahkan `/chat/completions`; path lengkap atau slash di akhir sering menyebabkan 404. ## Atur melalui `config.yaml` Untuk konfigurasi multi-model yang tersimpan, tulis nilai yang sama di `~/.hermes/config.yaml`: ```yaml model: provider: custom base_url: https://api.omniakey.com/v1 api_key: your-omniakey-api-key default: claude-opus-4-8 models: - claude-opus-4-8 - gpt-5.5 - gemini-3.1-pro-preview - grok-4.5 ``` `provider: custom` memberi tahu Hermes untuk memanggil endpoint Anda secara langsung. Daftar `models:` mengisi pemilih `/model`; restart Hermes setelah mengedit, lalu ganti antara `claude-opus-4-8`, `gpt-5.5`, `gemini-3.1-pro-preview`, dan `grok-4.5` tanpa keluar dari sesi. ## Satu key, empat keluarga model OmniaKey memilih model berdasarkan ID di endpoint yang kompatibel dengan OpenAI. Satu endpoint mencakup empat keluarga, dengan biaya per token dari satu saldo prabayar. ID yang Anda atur adalah ID yang dijalankan, tanpa fallback diam-diam. [Katalog model](https://omniakey.com/id/models) mencantumkan semua id yang bisa Anda set, dan [harga](https://omniakey.com/id/pricing) menunjukkan tarif per token masing-masing. Key yang sama juga berfungsi di agent lain; lihat panduan [pengaturan OpenClaw](https://omniakey.com/id/blog/openclaw-setup), [API key kustom di Cline](https://omniakey.com/id/blog/cline-custom-api-key), dan [pengaturan Claude Code](https://omniakey.com/id/blog/claude-code-setup). - **OpenAI-compatible**: - **Anthropic-native**: - **Gemini-native**: ## Kesalahan pengaturan yang umum Empat hal ini sering muncul saat Anda mengarahkan Hermes ke custom endpoint. Penyebab dan solusinya berasal dari [dokumentasi provider Hermes](https://hermes-agent.nousresearch.com/docs/integrations/providers) dan [referensi konfigurasi](https://hermes-agent.nousresearch.com/docs/user-guide/configuration). ### `/model` tidak menawarkan custom endpoint Gejala: Anda mengetik `/model` di sesi yang sedang berjalan dan OmniaKey tidak ada di daftar. Penyebab: `/model` di dalam sesi hanya beralih antara provider yang sudah Anda siapkan. Perintah ini tidak bisa menambah provider, menjalankan OAuth, atau meminta API key. Solusi: keluar dari sesi, jalankan `hermes model` di terminal, siapkan custom endpoint di sana, lalu mulai sesi baru. ### Key di `.env` diabaikan dan permintaan pergi ke provider lain Gejala: Anda menaruh base URL atau key di `~/.hermes/.env`, dan Hermes tetap memanggil provider bawaan. Penyebab: `LLM_MODEL` di `.env` sudah dihapus, `config.yaml` adalah satu-satunya sumber untuk model dan endpoint, dan `OPENAI_BASE_URL` hanya berlaku untuk provider `openai-api`. Solusi: taruh `base_url` dan `api_key` di blok `model:` pada `~/.hermes/config.yaml`, atau arahkan `key_env` ke variabel yang menyimpan key. Setelah `base_url` diatur, Hermes memanggil endpoint itu langsung dan melakukan autentikasi dengan `api_key` atau `OPENAI_API_KEY`. ### Hermes tidak mau mulai dengan `provider: main` Gejala: proses mulai gagal, atau pemilih model tetap kosong, setelah Anda mengatur `provider: main` di blok `model:` tingkat atas. Penyebab: `main` berarti "pakai provider agent utama saya" dan hanya berlaku di dalam `auxiliary:`, `compression:`, atau entri fallback. Solusi: atur `provider: custom` di `model:`, bersama `base_url` dan key OmniaKey. ### `/model custom` mendarat di model yang salah Gejala: `/model custom` memilih model yang tidak Anda minta, atau error. Penyebab: `/model custom` tanpa nama bertanya ke API `/models` endpoint dan memilih otomatis hanya jika tepat satu model dimuat; OmniaKey menyediakan beberapa. Solusi: sebutkan modelnya, misalnya `/model custom:claude-opus-4-8`. ## Pertanyaan yang sering diajukan ### Bagaimana cara menghubungkan Hermes Agent ke OmniaKey? Jalankan `hermes model`, pilih Custom endpoint (self-hosted / VLLM / etc.), lalu isi `https://api.omniakey.com/v1` sebagai base URL, key OmniaKey Anda, dan model ID seperti `claude-opus-4-8`. Tiga nilai yang sama di `~/.hermes/config.yaml` juga bisa dipakai jika Anda lebih suka mengedit file. ### Mengapa Hermes mengembalikan 404 dengan base URL OmniaKey saya? Base URL harus berakhir di `/v1`. Hermes menambahkan `/chat/completions` sendiri, jadi URL yang sudah memuat path itu, atau yang berakhiran garis miring, adalah penyebab umum 404. ### Apakah satu key OmniaKey cukup untuk Claude, GPT, Gemini, dan Grok? Ya. OmniaKey memilih model berdasarkan ID di endpoint yang kompatibel dengan OpenAI, jadi satu endpoint menjangkau keempat keluarga: yang Anda ganti adalah ID, bukan blok provider. Tambahkan ID yang Anda mau ke daftar `models:` dan ID itu muncul di pemilih `/model`. ### Bagaimana cara berganti model di tengah sesi? Ketik `/model custom:`, misalnya `/model custom:gpt-5.5`. Setelah mengedit daftar `models:`, mulai ulang Hermes sekali, dan pemilih serta `/model` sama-sama melihat ID baru. ## Sumber yang dicek - [Nous Research: provider LLM dan model](https://hermes-agent.nousresearch.com/docs/integrations/providers) - [Nous Research: konfigurasi Hermes Agent](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) [Panduan coding agent](https://docs.omniakey.com/en/coding) membahas alat lainnya.