Pernahkah Anda menemui error ini saat menjalankan model Claude dengan OpenClaw?
400 ... ValidationException: Operation not allowed
Chat biasa lancar-lancar saja, tapi begitu masuk ke pemanggilan alat (tool use), langsung error——ini adalah masalah yang hampir pasti dialami setiap pengguna OpenClaw saat menghubungkan Claude API.
Akar masalahnya cuma satu: Anda menggunakan format API yang salah.
OpenClaw menyediakan dua pilihan format untuk terhubung ke Claude: openai-completions dan anthropic-messages. Saat menggunakan mode kompatibilitas OpenAI, chat teks biasa memang bisa jalan, tapi akan ditolak saat masuk ke siklus pemanggilan alat multi-putaran (tool_calls → tool_result → tool loop). Hanya dengan beralih ke format anthropic-messages, fitur pemanggilan alat bisa berjalan stabil.
Artikel ini berdasarkan konfigurasi yang sudah teruji secara praktis, akan memandu Anda langkah demi langkah menggunakan APIYI apiyi.com sebagai layanan proksi API untuk menyelesaikan konfigurasi akses OpenClaw ke Claude API dengan benar dalam 5 langkah.
Analisis Masalah Utama Akses OpenClaw ke Claude API
Sebelum masuk ke solusi, mari kita pahami dulu mengapa error ini terjadi.
Apa itu OpenClaw?
OpenClaw adalah salah satu framework AI Agent open-source paling populer di tahun 2025-2026, yang dikembangkan oleh Peter Steinberger (pendiri PSPDFKit). Fitur utamanya meliputi:
- Dukungan Multi-platform: Signal, Telegram, Discord, WhatsApp, iMessage
- Akses Multi-model: Claude, GPT, DeepSeek, dan model utama lainnya
- Kemampuan Pemanggilan Alat: Lebih dari 50 integrasi bawaan, mendukung eksekusi kode, pencarian web, smart home, dll.
- Berjalan Lokal: Konfigurasi dan riwayat percakapan disimpan secara lokal untuk menjaga privasi.
| Fitur Utama OpenClaw | Keterangan |
|---|---|
| Pengembang | Peter Steinberger (Pendiri PSPDFKit) |
| Lisensi | Open source & Gratis |
| Platform yang Didukung | Signal / Telegram / Discord / WhatsApp / iMessage |
| Model yang Didukung | Claude / GPT / DeepSeek, dll. |
| Format API | openai-completions / anthropic-messages |
| Integrasi Alat | 50+ integrasi bawaan |
| Penyimpanan Data | Penyimpanan lokal, privasi terjaga |
Perbedaan Mendasar Dua Format API
OpenClaw mendukung dua cara untuk mengakses Claude API:
| Dimensi Perbandingan | openai-completions | anthropic-messages |
|---|---|---|
| Path Endpoint | /v1/chat/completions |
/v1/messages |
| Chat Teks Biasa | ✅ Normal | ✅ Normal |
| Pemanggilan Alat (tool use) | ❌ Error 400 | ✅ Stabil & Bisa Digunakan |
| Loop Alat Multi-putaran | ❌ Error | ✅ Stabil & Bisa Digunakan |
| Prompt Caching (Cache Petunjuk) | ❌ Tidak mendukung | ✅ Mendukung |
| Extended Thinking | ⚠️ Tidak lengkap | ✅ Dukungan penuh |
| Persyaratan Header | Tidak ada syarat khusus | Memerlukan anthropic-version |
🎯 Saran Teknis: Saat menghubungkan OpenClaw ke Claude API, wajib menggunakan format
anthropic-messagesagar fitur pemanggilan alat bisa berjalan stabil. Kami menyarankan penggunaan APIYI apiyi.com sebagai layanan proksi API, karena platform ini mendukung penuh format Messages API asli dari Anthropic.
Mengapa Pemanggilan Alat Gagal pada Format openai-completions?
Saat OpenClaw menggunakan format openai-completions untuk memanggil Claude, inilah yang terjadi:
- Konversi Format: OpenClaw mengirimkan field
tool_callsdanfunctiondalam format OpenAI. - Ketidakcocokan Protokol: Claude secara native menggunakan format
tool_usedantool_result. - Konflik Multi-putaran: Siklus alat (tool loop) membutuhkan konsistensi
tool_use_iddi antara beberapa permintaan. Informasi ini sering hilang selama proses konversi format. - Penolakan Validasi: Layanan proksi atau API hulu mendeteksi ketidakcocokan format dan mengembalikan
400 ValidationException.
Konfigurasi Lengkap Integrasi OpenClaw ke Claude API: Selesai dalam 5 Langkah
Konfigurasi berikut didasarkan pada pengujian nyata menggunakan APIYI (apiyi.com) sebagai penyedia layanan proksi API Claude.
Langkah 1: Konfigurasi Provider (Konfigurasi Inti)
Tambahkan konfigurasi berikut di bagian models.providers pada file openclaw.json:
{
"models": {
"providers": {
"apiyi": {
"baseUrl": "https://api.apiyi.com",
"apiKey": "sk-YOUR_APIYI_KEY",
"api": "anthropic-messages",
"headers": {
"anthropic-version": "2023-06-01",
"anthropic-beta": ""
},
"models": [
{
"id": "claude-opus-4-6",
"name": "claude-opus-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
}
]
}
}
}
}
Detail Poin Konfigurasi:
| Item Konfigurasi | Nilai yang Benar | Penjelasan |
|---|---|---|
baseUrl |
https://api.apiyi.com |
Jangan sertakan /v1, jika tidak, URL akan menjadi .../v1/v1/messages |
api |
"anthropic-messages" |
Harus menggunakan ini, jangan gunakan openai-completions |
anthropic-version |
"2023-06-01" |
Wajib disertakan, jika tidak permintaan akan ditolak |
anthropic-beta |
"" (string kosong) |
Paksa nonaktifkan fitur beta untuk menghindari kesalahan 400 |
reasoning |
false |
Nonaktifkan kolom thinking untuk menghindari ValidationException |
streaming |
Disarankan dinonaktifkan | Menonaktifkan streaming lebih stabil pada skenario proksi |
💡 Penting: Jangan sekali-kali menulis
baseUrlsebagaihttps://api.apiyi.com/v1. Saat menggunakan formatanthropic-messages, Open
Mengapa Memilih APIYI sebagai Layanan Proksi Claude API untuk OpenClaw
Saat memilih penyedia layanan proksi API, ada beberapa faktor kunci yang perlu dipertimbangkan.
Perbandingan Pemilihan Layanan Proksi Claude API
| Dimensi Pertimbangan | Koneksi Langsung Anthropic | APIYI apiyi.com | Layanan Proksi Lain |
|---|---|---|---|
| Format Anthropic Messages | ✅ Dukungan Native | ✅ Dukungan Penuh | ⚠️ Dukungan Parsial |
| Pemanggilan Alat (tool use) | ✅ Mendukung | ✅ Dukungan Stabil | ⚠️ Mungkin Tidak Stabil |
| Prompt Caching | ✅ Mendukung | ✅ Mendukung | ❌ Sebagian Besar Tidak Mendukung |
| Koneksi Langsung Lokal | ❌ Perlu Proksi/VPN | ✅ Bisa Diakses Langsung | ✅ Sebagian Bisa Langsung |
| Antarmuka Terpadu Multi-Model | ❌ Hanya Claude | ✅ Claude + GPT + Lainnya | ✅ Dukungan Parsial |
| Bayar Sesuai Penggunaan | ✅ Harga Resmi | ✅ Penagihan Fleksibel | ⚠️ Harga Tidak Transparan |
| Verifikasi Nyata OpenClaw | – | ✅ Sudah Terverifikasi | ⚠️ Belum Terverifikasi |
💰 Optimasi Biaya: APIYI apiyi.com mendukung format Anthropic Messages API native, yang berarti saat digunakan di OpenClaw, permintaan Anda dapat menikmati diskon Prompt Caching Claude—biaya Input Token yang terkena cache hanya 10% dari harga dasar.
3 Keunggulan Utama Layanan Proksi APIYI
1. Dukungan Penuh Format Native Anthropic
Platform APIYI bukan sekadar meneruskan format OpenAI secara sederhana, melainkan mendukung penuh Anthropic Messages API (endpoint /v1/messages), termasuk:
- Parameter kontrol cache
cache_control - Format pemanggilan alat native
tool_use/tool_result - Header permintaan
anthropic-version - Extended Thinking (Berpikir Mendalam)
2. Terverifikasi dengan OpenClaw
Semua konfigurasi dalam artikel ini didasarkan pada pengujian nyata di platform APIYI, memastikan:
- Siklus pemanggilan alat multi-putaran berjalan stabil
tool_use_idditeruskan dengan benar di antara beberapa permintaan- Tidak ada kehilangan konteks dalam skenario percakapan panjang
3. Manajemen Terpadu Berbagai Model
Cukup dengan satu kunci API, Anda dapat melakukan pemanggilan model Claude, GPT, DeepSeek, dan lainnya. Di OpenClaw, Anda dapat mengonfigurasi model yang berbeda untuk Agent yang berbeda dan beralih dengan fleksibel.
Tips Konfigurasi Lanjutan OpenClaw dengan Claude API
Setelah menguasai konfigurasi dasar, tips berikut dapat membantu Anda melakukan optimasi lebih lanjut.
Tips 1: Konfigurasi Model Berbeda untuk Agent Berbeda
{
"agents": {
"list": [
{
"id": "tasks",
"model": "apiyi/claude-opus-4-6",
"tools": { "profile": "coding" }
},
{
"id": "chat",
"model": "apiyi/claude-sonnet-4-6-thinking",
"tools": { "profile": "default" }
}
]
}
}
- tasks agent: Gunakan Opus 4.6 untuk menangani tugas kompleks dan pembuatan kode.
- chat agent: Gunakan Sonnet 4.6 untuk percakapan sehari-hari dengan biaya yang lebih rendah.
Tips 2: Manfaatkan Prompt Caching untuk Menekan Biaya
Karena APIYI mendukung format native Anthropic, system prompt di OpenClaw dapat di-cache secara otomatis. Untuk agent dengan system prompt yang panjang, biaya input setelah cache hit hanya 10%.
Tips 3: Catatan Keamanan
- Jangan mengekspos kunci API di saluran publik Discord.
- Kunci dalam
openclaw.jsondisimpan dalam bentuk teks biasa, pastikan izin akses file sudah benar. - Jika kunci bocor, segera lakukan rotasi di dashboard APIYI apiyi.com.
FAQ Akses Claude API di OpenClaw
Q1: Apakah harus pakai layanan proksi untuk pakai Claude di OpenClaw?
Tidak wajib, tapi bagi pengguna yang mengalami kendala akses geografis sangat disarankan. Menghubungkan langsung ke API Anthropic membutuhkan lingkungan jaringan luar negeri, sedangkan melalui layanan proksi API APIYI (apiyi.com), Anda bisa melakukan pemanggilan model secara langsung sekaligus menikmati dukungan fitur Anthropic Messages API yang lengkap.
Q2: Mengapa konfigurasi sudah diubah tapi perilaku OpenClaw tidak berubah?
Ini adalah masalah yang paling sering terjadi, 99% penyebabnya adalah sesi (session) yang sudah ada menyimpan cache konfigurasi lama. Gunakan perintah sessions.patch atau sessions.reset untuk memperbarui sesi, atau lakukan pengujian di kanal (channel) baru. Detail perintahnya bisa dilihat di langkah ke-4.
Q3: Apakah fitur thinking Claude 4.6 bisa digunakan di OpenClaw?
Saat ini pada jalur proksi, kolom thinking (thinking / output_config) mungkin memicu 400 ValidationException. Disarankan untuk mengatur reasoning: false. Pantau terus status dukungan fitur thinking melalui pembaruan platform APIYI (apiyi.com) di masa mendatang.
Q4: Bisakah satu kunci APIYI digunakan untuk beberapa Agent OpenClaw sekaligus?
Bisa. kunci API dari APIYI tidak membatasi jumlah Agent yang berjalan bersamaan. Anda bisa mengonfigurasi kunci yang sama untuk berbagai Agent seperti tasks, chat, atau coder, dan biaya akan dihitung berdasarkan penggunaan Token yang sebenarnya.
Q5: Apakah latensi pemanggilan alat (tool call) Claude di OpenClaw normal?
Pemanggilan alat melibatkan beberapa putaran permintaan API (kirim permintaan → ambil tool_use → eksekusi alat → kembalikan tool_result → ambil balasan akhir), jadi biasanya memang lebih lambat daripada chat biasa. Melalui jalur proksi rendah latensi dari APIYI (apiyi.com), latensi setiap putaran pemanggilan API dapat dikontrol dalam batas yang wajar.
Ringkasan: 3 Poin Kunci Akses Claude API di OpenClaw
Berdasarkan hasil uji coba konfigurasi dalam artikel ini, berikut adalah poin-poin penting yang perlu diingat saat menghubungkan OpenClaw ke Claude API:
- Wajib menggunakan format anthropic-messages: Atur
api: "anthropic-messages". Ini adalah syarat utama agar pemanggilan alat berjalan stabil. Formatopenai-completionsakan menyebabkan error 400 saat terjadi pemanggilan alat multi-putaran. - 3 Jebakan yang harus dihindari:
baseUrljangan menyertakan/v1, nonaktifkananthropic-betadanreasoning, serta perhatikan cache pada sesi yang sudah ada. - Pilih penyedia layanan proksi yang tepat: APIYI (apiyi.com) mendukung penuh Messages API asli dari Anthropic. Berdasarkan hasil uji coba OpenClaw, fitur pemanggilan alat dan Prompt Caching terbukti stabil dan dapat digunakan.
Kami merekomendasikan penggunaan APIYI (apiyi.com) untuk mempercepat konfigurasi akses Claude API di OpenClaw, hanya butuh 5 menit agar pemanggilan alat bisa berjalan lancar.
Referensi
-
Dokumentasi Resmi OpenClaw – Model Providers: Penjelasan konfigurasi penyedia model
- Tautan:
docs.openclaw.ai/concepts/model-providers
- Tautan:
-
Dokumentasi Resmi Anthropic – Messages API: Format pemanggilan asli Claude API
- Tautan:
platform.claude.com/docs/en/api/messages
- Tautan:
-
Dokumentasi Resmi Anthropic – Kompatibilitas SDK OpenAI: Batasan fitur mode kompatibilitas
- Tautan:
platform.claude.com/docs/en/api/openai-sdk
- Tautan:
-
Repositori GitHub OpenClaw: Kode sumber terbuka dan diskusi Issue
- Tautan:
github.com/openclaw/openclaw
- Tautan:
📝 Penulis: Tim APIYI | Tim Teknis APIYI, berfokus pada integrasi API Model Bahasa Besar AI dan berbagi pengetahuan teknis. Kunjungi apiyi.com untuk mendapatkan lebih banyak tutorial teknis dan kunci API.
