OpenClaw Mengakses Claude: 2 Cara Konfigurasi – Mode Kompatibel OpenAI vs Format Asli Claude, Tutorial Lengkap

Catatan Penulis: Panduan langkah demi langkah untuk mengonfigurasi dua metode akses di OpenClaw: mode kompatibel OpenAI dan format native Claude, termasuk kode konfigurasi JSON lengkap, daftar model yang kompatibel, dan perbandingan perbedaan kunci.

Di OpenClaw (Open WebUI), ada dua cara untuk mengakses Model Bahasa Besar: Mode kompatibel OpenAI (openai-completions) dan format native Claude (anthropic-messages). Banyak pengguna yang tidak memahami perbedaan keduanya, sehingga ada yang salah menggunakan format untuk model Claude, atau melewatkan fitur canggih seperti Prompt Caching yang dibawa oleh format native.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai metode konfigurasi lengkap untuk kedua cara akses di OpenClaw, memahami format mana yang harus digunakan untuk setiap model, dan dapat langsung menyalin kode konfigurasi untuk digunakan.

Perbandingan Inti Dua Metode Akses OpenClaw

Ringkasan Satu Kalimat untuk Dua Metode Akses OpenClaw

Ingat satu aturan sederhana: Model seri Claude gunakan anthropic-messages, semua model lainnya gunakan openai-completions. Perbedaan paling jelas adalah baseUrl—mode kompatibel OpenAI berakhiran /v1, format native Claude tidak.

Tutorial Konfigurasi Mode Kompatibel OpenAI OpenClaw

Skenario Penggunaan Mode Kompatibel OpenAI

Mode kompatibel OpenAI (openai-completions) adalah cara akses paling universal di OpenClaw, cocok untuk semua Model Bahasa Besar non-Claude. Sebagian besar layanan proksi API menggunakan format standar OpenAI ini.

Kode Konfigurasi Lengkap Mode Kompatibel OpenAI

Berikut adalah konfigurasi lengkap untuk mengakses GPT-5.4 melalui APIYI:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-kunciAPI-anda",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-kunciAPI-anda",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      }
    }
  }
}

Poin Konfigurasi Mode Kompatibel OpenAI

🎯 Pengingat Konfigurasi: /v1 di akhir baseUrl tidak boleh dihilangkan, ini adalah jalur standar protokol kompatibel OpenAI. Kunjungi APIYI apiyi.com untuk mendaftar dan mendapatkan kunci API serta kuota gratis.

Tutorial Konfigurasi Format Native Claude OpenClaw

Skenario Penggunaan Format Native Claude

Format native Claude (anthropic-messages) adalah cara akses eksklusif untuk seri model Claude. Menggunakan format native memungkinkan Anda mendapatkan fitur-fitur canggih unik Claude seperti Prompt Caching, Extended Thinking, dan pemrosesan PDF.

Kode Konfigurasi Lengkap Format Native Claude

Berikut adalah konfigurasi lengkap untuk mengakses model Claude melalui APIYI:

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-kunciAPI-anda",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-kunciAPI-anda",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-haiku-4-5-20251001",
            "name": "Claude Haiku 4.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Poin Konfigurasi Format Native Claude

🎯 Perbedaan Kunci: baseUrl untuk format native Claude tidak menyertakan /v1. Ini adalah kesalahan paling umum bagi pemula—jika akses Claude error, periksa dulu apakah URL diakhiri dengan /v1 secara tidak sengaja.

Konfigurasi Penggunaan Dua Format OpenClaw Secara Bersamaan

Dalam penggunaan praktis, kemungkinan besar Anda perlu menggunakan model umum dan model Claude secara bersamaan. Dalam hal ini, Anda perlu mengonfigurasi dua provider di OpenClaw:

Kode Konfigurasi Gabungan Dua Provider

Tulis kedua format provider dalam file konfigurasi yang sama, dan Anda dapat beralih model dengan bebas di OpenClaw:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-kunci-API-anda",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      },
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-kunci-API-anda",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

🎯 Catatan Penting: Kedua provider dapat menggunakan kunci API yang sama. Kunci API yang sama dari APIYI apiyi.com mendukung format kompatibel OpenAI dan format native Claude secara bersamaan, tidak perlu mengajukan beberapa kunci.

Pemecahan Masalah Umum untuk Dua Format OpenClaw

Bagian yang paling mudah salah dalam proses konfigurasi adalah ketidakcocokan antara baseUrl dan tipe api. Berikut adalah kesalahan umum dan solusinya:

🎯 Kunci pemecahan masalah cepat: Format OpenAI dengan /v1, format Claude tanpa /v1. Ingat ini dapat menghindari 80% kesalahan konfigurasi. Jika mengalami masalah lain, Anda dapat mengunjungi pusat dokumentasi APIYI apiyi.com untuk melihat panduan integrasi lengkap.

Pertanyaan Umum

Kesimpulan

Inti dari dua cara akses OpenClaw:

1. Model umum gunakan openai-completions: Semua model non-Claude seperti GPT, Gemini, DeepSeek, GLM, Kimi, Grok, Minimax, dll., baseUrl mengandung /v1
2. Seri Claude gunakan anthropic-messages: claude-sonnet-4-6, claude-opus-4-6, claude-haiku, dll., baseUrl tidak mengandung /v1, memerlukan header anthropic-version
3. Dua Provider berdampingan adalah praktik terbaik: Konfigurasikan dua provider dengan Kunci API yang sama, bebas beralih semua model di OpenClaw

Direkomendasikan untuk mendapatkan Kunci API melalui APIYI apiyi.com, satu kunci dapat mengakses semua model utama seperti GPT, Claude, Gemini, DeepSeek, dll., mendukung format kompatibel OpenAI dan format asli Claude.

📚 Referensi

1. Pusat Bantuan APIYI: Tutorial lengkap konfigurasi OpenClaw

   • Tautan: help.apiyi.com
   • Penjelasan: Berisi dokumentasi akses detail untuk setiap situs dan daftar model terbaru

2. Dokumentasi API Anthropic: Spesifikasi format API native Claude

   • Tautan: platform.claude.com/docs/en/api/messages
   • Penjelasan: Parameter lengkap dan format respons untuk Messages API

3. Dokumentasi Kompatibilitas OpenAI SDK: Parameter mana yang diabaikan di Claude

   • Tautan: platform.claude.com/docs/en/api/openai-sdk
   • Penjelasan: Daftar lengkap parameter yang didukung dan tidak didukung

4. Dokumentasi Open WebUI: Panduan konfigurasi Multi-Provider OpenClaw

   • Tautan: docs.openwebui.com
   • Penjelasan: Konfigurasi Provider, manajemen model, dan pengaturan Agent

Penulis: Tim Teknis APIYI
Diskusi Teknis: Selamat berdiskusi di kolom komentar, materi lebih lanjut dapat diakses di pusat dokumentasi APIYI docs.apiyi.com