Tutorial Integrasi OpenClaw dengan API Relay: Konfigurasi Kerangka Kerja Agen Otonom

1. Apa itu OpenClaw

OpenClaw adalah kerangka kerja AI Agent sumber terbuka: Anda mengarahkannya ke model (lokal atau gateway cloud), dan ia dapat menyelesaikan tugas secara otomatis di komputer Anda—mengoperasikan antarmuka, menjalankan perintah, mengelola file, dll. Intinya adalah "mengonfigurasi endpoint model", sehingga sangat cocok untuk dihubungkan ke gateway situs kami.

2. Instalasi OpenClaw

Direkomendasikan menggunakan skrip instalasi sekali klik:

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

Anda juga dapat menginstalnya menggunakan Docker atau dari 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

3. Menghubungkan ke Gateway Situs Kami (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-api-anda
Model ID : claude-sonnet-5

(Endpoint openai / gemini masing-masing sesuai dengan 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 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-api-anda",
        "api": "openai-completions"
      }
    }
  }
}

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

4. Memulai dan Perintah Umum

openclaw gateway --port 18789

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

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

5. Pemecahan Masalah Umum

Gejala	Tindakan
401 / 403	Kunci tidak valid, belum diaktifkan, atau saldo tidak mencukupi; pastikan sk- benar dan isi saldo.
404 / Model tidak tersedia	Slug model tidak cocok dengan platform, atau model belum diaktifkan; periksa ID model.
Tidak dapat terhubung ke model	Pastikan baseUrl menggunakan gateway situs kami.

Saran Keamanan: Jangan tulis kunci sk- di repositori publik; tugas jenis agen menghabiskan banyak token, harap perhatikan saldo Anda.