Cara Menghubungkan Kimi K2.5 ke OpenClaw/ClawdBot

Pernah bertanya-tanya apa yang dibutuhkan untuk menggabungkan model *open-source* canggih dengan agen otonom yang kuat? Mengintegrasikan Kimi K2.5 dengan OpenClaw (sebelumnya ClawdBot/MoltBot) memungkinkan Anda membuat agen AI yang digerakkan sendiri yang dapat bernalar, membuat kode, dan mengotomatiskan tugas berdasarkan bahasa alami dengan konfigurasi minimal. Dukungan untuk Kimi K2.5 di OpenClaw berarti Anda dapat menggunakan model ramah agen terkemuka di platform asisten *open-source* tanpa terikat langganan.

Asisten AI tersebar luas, tetapi sebagian besar mengandalkan API proprietary yang membutuhkan biaya dan membatasi akses. OpenClaw mengisi kekosongan ini dengan menawarkan platform agen *open-source* yang berjalan secara lokal atau di *cloud*. Namun, menghubungkan model seperti Kimi K2.5 (model multimodal, agen-swafoto yang kuat yang dikembangkan oleh Moonshot AI) memerlukan konfigurasi terperinci. Dengan pengaturan yang benar, agen Anda dapat melakukan tugas-tugas kompleks seperti *coding*, penalaran, dan alur kerja multi-langkah, semuanya tetap gratis dan terbuka.

Apa Itu OpenClaw dan Kimi K2.5?

OpenClaw (ClawdBot / MoltBot)

OpenClaw adalah platform asisten AI otonom *open-source* yang awalnya dikenal sebagai ClawdBot atau MoltBot. Ini memungkinkan Anda menjalankan agen AI yang dapat merespons perintah, mengelola tugas, berintegrasi dengan platform perpesanan seperti Telegram, dan menangani panggilan *tool* di mesin Anda. Ini dikembangkan dalam TypeScript/Swift di bawah lisensi MIT dan mendukung penerapan lokal dan *cloud*.

Mengapa ini penting: OpenClaw menyediakan kerangka kerja agen — *runtime* inti dan *tooling* yang memungkinkan model AI terhubung ke tugas-tugas dunia nyata alih-alih hanya bernalar secara terpisah.

Model Kimi K2.5

Kimi K2.5 adalah model multimodal *open-source* canggih dari Moonshot AI, dilatih pada triliunan *token* multimodal dengan jendela konteks yang besar (256K *token*) yang mendukung *coding*, penalaran, dan tugas visual. Arsitektur *agent swarm*-nya memungkinkan beberapa panggilan *tool* secara paralel, membuatnya cocok untuk alur kerja yang melibatkan penalaran panjang dan eksekusi *tool* yang kompleks.

Fitur utama Kimi K2.5 meliputi:

Jendela konteks besar untuk alur kerja yang panjang
Penalaran multimodal (teks dan gambar)
Dirancang untuk kasus penggunaan yang berpusat pada agen
Model *open-weight* dengan berbagai metode akses (API/penyedia)

💡

Ingin alat Pengujian API hebat yang menghasilkan Dokumentasi API yang indah?

Ingin platform terintegrasi, All-in-One agar Tim Pengembang Anda bekerja sama dengan produktivitas maksimum?

Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!

button

Menginstal OpenClaw

Pertama, Anda perlu mengkloning dan menyiapkan OpenClaw.

Langkah 1: Kloning OpenClaw

Di terminal Anda, jalankan:

git clone https://github.com/clawdbot/moltbot.git openclaw
cd openclaw

Ini mengambil repositori OpenClaw ke sistem lokal Anda. Simpan direktori ini untuk konfigurasi dan pembaruan di masa mendatang.

Langkah 2: Instal Dependensi

Jalankan:

npm install
# Atau dengan pnpm
pnpm install

Ini menginstal semua dependensi yang diperlukan (Node.js/Bun, alat CLI, file konfigurasi) yang dibutuhkan untuk menjalankan OpenClaw secara lokal.

Langkah 3: Siapkan Variabel Lingkungan

Buat file .env di *root* proyek. Di dalamnya, Anda akan menentukan kunci API Anda untuk penyedia seperti Moonshot atau Fireworks/OpenRouter:

cp .env.example .env

Edit .env untuk menambahkan kunci API Kimi Anda:

# .env
KIMI_API_KEY=sk-k2-5-your-api-key-here
KIMI_MODEL=kimi-k2.5-preview
KIMI_BASE_URL=https://api.kimi.ai/v1

Buat kunci API Kimi K2.5 Anda di Moonshot.ai:

Anda juga dapat menambahkan kunci untuk OpenRouter atau penyedia lain jika Anda ingin menggunakan *backend* yang berbeda. Pastikan *string* kunci Anda tidak dikelilingi oleh tanda kutip saat digunakan dalam produksi nyata.

{
  "model": {
    "primary": "openrouter/moonshotai/kimi-k2.5"
  },
  "models": {
    "openrouter/moonshotai/kimi-k2.5": {}
  },
  "api": {
    "openrouter": {
      "key": "your_openrouter_api_key_here"
    }
  }
}

Tips keamanan: Jangan pernah melakukan *commit* .env ke kontrol versi. Tambahkan segera ke .gitignore:

echo ".env" >> .gitignore

💡Pro Tip: Uji kunci API Anda di Apidog sebelum mengedit file konfigurasi. Ini mencegah waktu henti akibat kesalahan autentikasi.

Mengonfigurasi OpenClaw untuk Kimi K2.5

Setelah OpenClaw terinstal, Anda perlu mengonfigurasinya untuk menggunakan Kimi K2.5 sebagai model utama.

Memperbarui Konfigurasi OpenClaw

Ada dua lokasi file konfigurasi umum:

Konfigurasi proyek lokal: openclaw.json
Konfigurasi global: ~/.openclaw/openclaw.json

Buka dan modifikasi salah satu dari keduanya untuk menyertakan cuplikan JSON berikut:

{
  "authProviders": {
    "moonshot": {
      "provider": "openrouter",
      "apiKey": "${env.KIMI_API_KEY}",
      "model": "moonshot/kimi-k2.5-preview"
    }
  },
  "chatEngines": {
    "default": {
      "provider": "moonshot",
      "maxTokens": 2048,
      "temperature": 0.7
    }
  }
}

Ganti ${env.KIMI_API_KEY} dengan kunci API Anda yang sebenarnya jika tidak menggunakan substitusi variabel lingkungan. OpenClaw menggunakan format openrouter/<provider>/<model> untuk mengidentifikasi model.

Menggunakan Variabel Lingkungan untuk Konfigurasi

Anda juga dapat membuat .env untuk menyimpan konfigurasi moonshot.ai/kimi k2.5 sebagai berikut:

# Di .env
OPENCLAW_PROVIDER=moonshot
OPENCLAW_MODEL=moonshot/kimi-k2.5-preview
OPENCLAW_API_KEY=sk-k2-5-your-api-key-here

OpenClaw akan membaca ini saat memulai jika tidak ada openclaw.json.

Alternatif: Menggunakan Fireworks AI (Penyedia Lain)

Sebagai penyedia lain, Anda dapat menggunakan Fireworks.ai untuk mengonfigurasi *backend* Kimi K2.5:

# Atur kunci API Fireworks
export FIREWORKS_API_KEY=your-fireworks-key-here

# Konfigurasi OpenClaw
echo '{
  "authProviders": {
    "fireworks": {
      "provider": "fireworks",
      "apiKey": "${env.FIREWORKS_API_KEY}",
      "model": "accounts/fireworks/models/kimi-k2.5-preview"
    }
  },
  "chatEngines": {
    "default": {
      "provider": "fireworks"
    }
  }
}' > openclaw.json

Ganti YOUR_FIREWORKS_API_KEY dengan kunci API Fireworks Anda. Skrip ini mengonfigurasi JSON OpenClaw Anda untuk menggunakan Fireworks sebagai penyedia dengan Kimi K2.5.

Menjalankan OpenClaw

Setelah konfigurasi, Anda perlu memulai gateway OpenClaw untuk membuat agen AI dapat diakses.

Jalankan Gateway

Di direktori proyek Anda:

npm run start:gateway
# Atau jika menggunakan CLI
openclaw gateway start

Ini memulai server OpenClaw dan mendengarkan peristiwa dan perintah agen yang masuk. Gunakan CLI atau berintegrasi dengan platform perpesanan (misalnya, Telegram) untuk interaksi. Pastikan Anda telah memperbarui ke versi terbaru (seperti v2026.1.30) yang secara eksplisit menambahkan dukungan untuk model Kimi K2.5 dan fitur CLI yang berguna seperti penyelesaian *shell*.

Alternatif: Jalankan Shell Interaktif

Untuk pengujian lokal:

npm run start:cli
# Atau
openclaw shell

Ini akan membawa Anda ke *prompt* interaktif di mana Anda dapat mengobrol langsung dengan Kimi.

Validasi

Setelah berjalan, uji konektivitas dengan memasuki *shell* OpenClaw. Masukkan perintah sederhana seperti obrolan atau *prompt* agen untuk mengonfirmasi model merespons.

Contoh:

$ openclaw shell
> /chat "What is the weather in Tokyo?"

Jika Kimi K2.5 merespons, integrasi Anda berfungsi.

Uji Konfigurasi Model

Verifikasi Kimi adalah penyedia aktif:

openclaw config list

Akan menampilkan:

Active Provider: moonshot
Model: moonshot/kimi-k2.5-preview
Base URL: https://api.kimi.ai/v1

Uji Konektivitas API

Jalankan uji langsung:

openclaw test-model kimi "Explain quantum computing in simple terms"

Ini melewati mesin obrolan dan menguji koneksi model mentah.

Menggunakan Kimi K2.5 di dalam OpenClaw

Dengan semuanya berjalan, Anda sekarang dapat menggunakan Kimi K2.5 untuk mendukung penalaran dan alur kerja agen AI Anda:

Tips Sederhana

Mulai sesi interaktif melalui openclaw chat
Jalankan tugas melalui integrasi pesan Anda setelah memasangkan dengan Telegram atau yang lainnya
Jaga keamanan kunci API Anda dalam variabel lingkungan
Pantau penggunaan dengan openclaw usage --provider moonshot

Integrasi dengan Telegram

Konfigurasi integrasi bot Telegram:

# Atur token bot Telegram
export TELEGRAM_BOT_TOKEN=your-telegram-token-here

# Perbarui openclaw.json
echo '{
  "integrations": {
    "telegram": {
      "enabled": true,
      "botToken": "${env.TELEGRAM_BOT_TOKEN}"
    }
  }
}' >> openclaw.json

# Mulai ulang gateway
npm run start:gateway

Sekarang Anda dapat mengobrol dengan Kimi K2.5 melalui Telegram.

Menggunakan Kimi untuk Pembuatan Kode

# Di shell OpenClaw
> /agent "Create a Python script that fetches weather data and sends it to Slack"

Kimi akan menggunakan kemampuan agennya untuk menulis kode, menyarankan dependensi, dan menguraikan langkah-langkah penerapan.

Batas Tingkat dan Manajemen Biaya

Meskipun OpenClaw kini menawarkan akses gratis ke model seperti Kimi K2.5 dan Kimi Coding dengan satu *login*, perhatikan batas penyedia (gratis vs berbayar).

Pantau penggunaan Anda:

openclaw usage --provider moonshot --daily

Atur peringatan pengeluaran:

export MOONSHOT_SPENDING_LIMIT=10  # $10 USD

Konfigurasi Lanjutan

Prompt Sistem Kustom

Timpa perilaku default Kimi:

{
  "chatEngines": {
    "codeAssistant": {
      "provider": "moonshot",
      "systemPrompt": "You are an expert code reviewer focused on security vulnerabilities. Be direct and critical."
    }
  }
}

Gunakan mesin kustom:

openclaw chat --engine codeAssistant "Review this function for SQL injection risks"

Parameter Model

Sempurnakan parameter generasi:

{
  "chatEngines": {
    "creative": {
      "provider": "moonshot",
      "temperature": 0.9,
      "topP": 0.95,
      "maxTokens": 4096
    }
  }
}

Beberapa Penyedia

Konfigurasi penyedia *fallback*:

{
  "chatEngines": {
    "primary": {
      "provider": "moonshot",
      "fallbackProviders": ["openai", "anthropic"]
    }
  }
}

Jika Kimi tidak tersedia, OpenClaw akan secara otomatis beralih ke penyedia *fallback*.

Pemecahan Masalah

Kesalahan "Provider not found"

Penyebab: openclaw.json tidak dimuat atau kesalahan sintaks
Perbaikan: Validasi sintaks JSON:

node -e "console.log(JSON.parse(require('fs').readFileSync('openclaw.json', 'utf8')))"

Kesalahan "Authentication failed"

Penyebab: Kunci API tidak valid atau token kedaluwarsa
Perbaikan: Verifikasi kunci:

curl -H "Authorization: Bearer $KIMI_API_KEY" https://api.kimi.ai/v1/models

Kesalahan "Model not available"

Penyebab: Pengidentifikasi model salah
Perbaikan: Cantumkan model yang tersedia:

curl -H "Authorization: Bearer $KIMI_API_KEY" https://api.kimi.ai/v1/models | jq '.data[].id'

Waktu koneksi habis

Penyebab: Masalah jaringan atau pemblokiran *firewall*
Perbaikan: Uji konektivitas:

telnet api.kimi.ai 443

Kesimpulan

Menghubungkan Kimi K2.5 ke OpenClaw (ClawdBot/MoltBot) mengubah platform agen menjadi sistem AI *open-source* yang kuat yang mampu melakukan penalaran, pengkodean, dan tugas multimodal. Dengan mengkloning repo, mengonfigurasi penyedia dan kunci API, serta memulai *gateway*, Anda membuka asisten AI yang berfungsi penuh yang memanfaatkan model *open-weight* terkemuka tanpa terikat pada *proprietary*.

Baik Anda ingin mengotomatiskan alur kerja, berintegrasi dengan platform obrolan, atau membangun agen generasi berikutnya, integrasi ini memberi Anda fleksibilitas dan kemampuan yang Anda butuhkan.

button