Lewati ke konten
Dokumentasi / Integrasi agent

Hubungkan agent Anda ke CutadAI.

OpenClaw dan Hermes Agent mendukung penyedia model OpenAI-compatible. Arahkan base URL agent ke endpoint CutadAI dan gunakan API key akun Anda.

Base URLhttps://ai.cutad.web.id/v1

OpenClaw

OpenClaw adalah gateway multi-channel untuk AI agent. Tambahkan CutadAI sebagai custom provider melalui blok models.providers pada berkas konfigurasi.

  1. 1
    Siapkan API key dan nama model

    Buat API key di Dashboard → API Keys, lalu periksa model yang tersedia untuk akun Anda melalui GET /v1/models atau halaman model di dashboard. Contoh panduan ini menggunakan deepseek-v4.1-flash.

  2. 2
    Buka berkas konfigurasi OpenClaw

    Berkas konfigurasi utama berada di ~/.openclaw/openclaw.json. Buat berkas tersebut apabila belum ada.

  3. 3
    Tambahkan provider CutadAI dan tetapkan model utama

    Nama provider bebas; panduan ini menggunakan cutadai, sehingga referensi model berbentuk cutadai/deepseek-v4.1-flash.

json — ~/.openclaw/openclaw.json
{
  "agents": {
    "defaults": {
      "model": { "primary": "cutadai/deepseek-v4.1-flash" }
    }
  },
  "models": {
    "providers": {
      "cutadai": {
        "baseUrl": "https://ai.cutad.web.id/v1",
        "apiKey": "<API_KEY_ANDA>",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-v4.1-flash", "name": "DeepSeek V4.1 Flash" }
        ]
      }
    }
  }
}
  1. 4
    Simpan dan periksa konfigurasi

    Jalankan openclaw models list untuk memastikan model cutadai/deepseek-v4.1-flash terdaftar. Model utama juga dapat ditetapkan dari terminal dengan openclaw models set cutadai/deepseek-v4.1-flash. Muat ulang gateway OpenClaw agar konfigurasi diterapkan, kemudian kirim pesan percobaan melalui agent Anda.

Catatan. Nilai apiKey juga dapat diisi dari variabel lingkungan menggunakan bentuk ${CUTADAI_API_KEY}; pastikan variabel tersebut tersedia pada proses gateway OpenClaw. Ganti nama dan id model mengikuti model yang benar-benar tersedia untuk akun Anda — menambahkan entri model pada konfigurasi tidak mengubah hak akses paket Anda.

Hermes Agent

Hermes Agent bekerja dengan endpoint OpenAI-compatible apa pun yang menyediakan /v1/chat/completions. CutadAI dapat didaftarkan sebagai custom endpoint melalui wizard model atau langsung pada ~/.hermes/config.yaml.

  1. 1
    Cara yang dianjurkan: gunakan wizard model

    Dari terminal, di luar sesi Hermes yang sedang berjalan, jalankan hermes model, pilih Custom endpoint, lalu masukkan base URL https://ai.cutad.web.id/v1, API key CutadAI Anda, dan nama model, misalnya deepseek-v4.1-flash. Wizard menyimpan hasilnya ke config.yaml.

  2. 2
    Atau atur config.yaml secara manual

    Buka ~/.hermes/config.yaml dan atur blok model sebagai berikut. Bidang default adalah nama model yang akan digunakan.

yaml — ~/.hermes/config.yaml
model:
  default: deepseek-v4.1-flash
  provider: custom
  base_url: https://ai.cutad.web.id/v1
  api_key: <API_KEY_ANDA>
  1. 3
    Mulai sesi baru dan uji

    Simpan berkas, kemudian mulai sesi Hermes baru agar konfigurasi terbaca. Di dalam sesi, perintah /model hanya beralih di antara provider dan model yang sudah terkonfigurasi; gunakan hermes model dari terminal apabila perlu mengubah endpoint atau menambahkan provider. Hasil konfigurasi yang tersimpan dapat diperiksa dengan hermes config get model.

Menjaga API key. Sebagai pengganti menulis key langsung pada config.yaml, simpan key pada variabel lingkungan di ~/.hermes/.env, lalu rujuk dari konfigurasi dengan bidang key_env: CUTADAI_API_KEY pada blok model dan hilangkan bidang api_key.
Verifikasi

Verifikasi koneksi

Sebelum menyalahkan konfigurasi agent, pastikan API key dan model Anda bekerja langsung terhadap gateway dengan dua permintaan berikut.

Periksa daftar model yang tersedia untuk key Anda:

bash
curl https://ai.cutad.web.id/v1/models \
  -H "Authorization: Bearer <API_KEY_ANDA>"

Kirim satu request percakapan percobaan:

bash
curl https://ai.cutad.web.id/v1/chat/completions \
  -H "Authorization: Bearer <API_KEY_ANDA>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{ "role": "user", "content": "Halo" }]
  }'
  • Status 401 berarti key tidak terkirim atau tidak valid; status 403 dengan model_not_allowed berarti model tidak termasuk dalam paket Anda; status 404 dengan model_not_found berarti nama model tidak tersedia di gateway.
  • Apabila kedua perintah di atas berhasil tetapi agent masih gagal, periksa base URL pada konfigurasi agent — harus persis https://ai.cutad.web.id/v1 tanpa tambahan garis miring di akhir.
Kembali ke Dokumentasi API untuk referensi parameter, streaming, batas pemakaian, webhook, dan kode kesalahan selengkapnya.

Seluruh integrasi di halaman ini menggunakan format OpenAI-compatible yang sama.