Tutorial Integrasi API Relay OpenClaw: Konfigurasi Kerangka Kerja Agen Otonom

I. Apa itu OpenClaw

OpenClaw adalah kerangka kerja AI Agent sumber terbuka (open source): cukup arahkan ke model (lokal atau gateway cloud), dan ia dapat mengotomatiskan tugas di komputer Anda—mengoperasikan antarmuka, menjalankan perintah, mengelola file, dll. Intinya adalah "mengonfigurasi endpoint model", sehingga sangat cocok untuk dihubungkan dengan gateway situs ini.

II. Instalasi OpenClaw

Disarankan menggunakan skrip instalasi sekali klik:

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard

Anda juga dapat menginstalnya melalui Docker atau kode sumber:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Docker：./scripts/docker/setup.sh
# Kode sumber（pnpm）：corepack enable && pnpm install && pnpm openclaw setup

III. Menghubungkan ke Gateway Situs Ini (Dua Cara)

Cara 1: Panduan Interaktif (onboard)

Jalankan openclaw onboard, saat memilih Provider, pilih opsi yang mendukung alamat kustom, lalu masukkan:

Base URL : https://www.relay-api.com
API Key  : sk-kunci-anda
Model ID : claude-sonnet-5

(endpoint openai / gemini masing-masing merujuk ke https://www.relay-api.com/v1 dan https://www.relay-api.com/v1beta)

Cara 2: Mengubah File Konfigurasi Secara Langsung

OpenClaw membaca ~/.openclaw/openclaw.json (Linux/macOS) atau %USERPROFILE%\.openclaw\openclaw.json (Windows). Tambahkan Provider baru di dalam models.providers:

{
  "gateway": {
    "mode": "local"
  },
  "agents": {
    "defaults": {
      "model": {"primary": "jizhi/claude-sonnet-5"}
    }
  },
  "models": {
    "providers": {
      "jizhi": {
        "baseUrl": "https://www.relay-api.com",
        "apiKey": "sk-kunci-anda",
        "api": "openai-completions"
      }
    }
  }
}

Ubah primary menjadi slug model yang Anda gunakan, maka semua tugas agen OpenClaw akan melewati gateway situs ini.

IV. Startup dan Perintah Umum

openclaw gateway --port 18789

Setelah startup, akses http://localhost:18789 untuk masuk ke konsol. Perintah umum:

openclaw doctor              # Diagnosis masalah
openclaw security audit      # Pemeriksaan keamanan
openclaw config set key x    # Mengubah konfigurasi
openclaw channels add --channel telegram  # Menambahkan saluran pesan

V. Pemecahan Masalah Umum

Fenomena	Penanganan
401 / 403	Kunci tidak valid, belum diaktifkan, atau saldo tidak mencukupi; pastikan sk- benar dan lakukan top-up.
404 / Model tidak tersedia	Slug model tidak konsisten dengan platform, atau model belum diaktifkan; periksa kembali Model ID.
Tidak dapat terhubung ke model	Pastikan baseUrl menggunakan pintu masuk situs ini.

Saran Keamanan: Jangan tulis kunci sk- ke repositori publik; tugas tipe agen mengonsumsi token cukup besar, perhatikan saldo Anda.

Penjelasan Base URL: Situs ini menerima /v1beta/models/... dan /v1beta/v1beta/models/... (serta /v1/... dan /v1/v1/...), jadi apakah klien menambahkan /v1 atau /v1beta secara otomatis atau tidak, tidak akan mempengaruhi pemanggilan: Base URL dapat diisi dengan root domain atau alamat yang menyertakan /v1beta. Silakan cari dan salin Model ID di menu "Token" di sudut kanan atas konsol.