Cara mengatur Hermes Agent dengan OmniaKey: endpoint OpenAI-compatible

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

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

Atur melalui config.yaml

Untuk konfigurasi multi-model yang tersimpan, tulis nilai yang sama di ~/.hermes/config.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 mencantumkan semua id yang bisa Anda set, dan harga menunjukkan tarif per token masing-masing. Key yang sama juga berfungsi di agent lain; lihat panduan pengaturan OpenClaw, API key kustom di Cline, dan pengaturan Claude Code.

Kesalahan pengaturan yang umum

Empat hal ini sering muncul saat Anda mengarahkan Hermes ke custom endpoint. Penyebab dan solusinya berasal dari dokumentasi provider Hermes dan referensi konfigurasi.

/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:<model ID>, 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
• Nous Research: konfigurasi Hermes Agent

Panduan coding agent membahas alat lainnya.