Son teknoloji bir açık kaynak modelini güçlü bir otonom ajanla birleştirmenin ne anlama geldiğini hiç merak ettiniz mi? Kimi K2.5'i OpenClaw (eski adıyla ClawdBot/MoltBot) ile entegre etmek, minimum yapılandırmayla doğal dile dayalı olarak muhakeme edebilen, kod yazabilen ve görevleri otomatikleştirebilen kendi kendini yöneten bir yapay zeka ajanı oluşturmanıza olanak tanır. OpenClaw'da Kimi K2.5 desteği, önde gelen ajan dostu bir modeli abonelik kısıtlamaları olmaksızın açık kaynaklı bir asistan platformunda kullanabileceğiniz anlamına gelir.
Yapay zeka asistanları her yerde bulunsa da çoğu, maliyetli olan ve erişimi kısıtlayan tescilli API'lere dayanır. OpenClaw, yerel olarak veya bulutta çalışan açık kaynaklı bir ajan platformu sunarak bu boşluğu doldurur. Ancak, Kimi K2.5 (Moonshot AI tarafından geliştirilen güçlü bir çok modlu, ajan sürüsü yetenekli model) gibi bir modeli bağlamak ayrıntılı yapılandırma gerektirir. Bu kurulumu doğru yapmak, ajanınızın ücretsiz ve açık kalarak kodlama, muhakeme ve çok adımlı iş akışları gibi karmaşık görevleri yerine getirebileceği anlamına gelir.
OpenClaw ve Kimi K2.5 Nedir?
OpenClaw (ClawdBot / MoltBot)
OpenClaw, başlangıçta ClawdBot veya MoltBot olarak bilinen açık kaynaklı bir otonom yapay zeka asistan platformudur. Komutlara yanıt verebilen, görevleri yönetebilen, Telegram gibi mesajlaşma platformlarıyla entegre olabilen ve makinenizdeki araç çağrılarını yönetebilen yapay zeka ajanlarını çalıştırmanıza olanak tanır. MIT lisansı altında TypeScript/Swift ile geliştirilmiştir ve yerel ve bulut dağıtımını destekler.
Bu neden önemli?: OpenClaw, ajan çerçevesini – yani yapay zeka modellerinin sadece soyut muhakeme yapmak yerine gerçek dünya görevlerine bağlanmasını sağlayan temel çalışma zamanı ve araçları – sağlar.
Kimi K2.5 Modeli
Kimi K2.5, Moonshot AI'dan gelen son teknoloji ürünü açık kaynaklı çok modlu bir modeldir. Trilyonlarca çok modlu jetonla eğitilmiş ve kodlama, muhakeme ve görsel görevleri destekleyen devasa bir bağlam penceresine (256K jeton) sahiptir. Ajan sürüsü mimarisi, birden fazla paralel araç çağrısını mümkün kılar, bu da onu uzun muhakeme ve karmaşık araç yürütme gerektiren iş akışları için uygun hale getirir.
Kimi K2.5'in temel özellikleri şunları içerir:
- Uzun iş akışları için devasa bağlam penceresi
- Çok modlu muhakeme (metin ve görseller)
- Ajan odaklı kullanım durumları için tasarlanmıştır
- Çeşitli erişim yöntemlerine sahip açık ağırlıklı model (API/sağlayıcılar)
Geliştirici Ekibinizin maksimum verimlilikle birlikte çalışması için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?
Apidog tüm taleplerinizi karşılar ve Postman'ı çok daha uygun bir fiyata değiştirir!
OpenClaw Kurulumu
Öncelikle OpenClaw'u klonlamanız ve hazırlamanız gerekecek.
Adım 1: OpenClaw'u Klonlayın
Terminalinizde şunu çalıştırın:
git clone https://github.com/clawdbot/moltbot.git openclaw
cd openclaw
Bu, OpenClaw deposunu yerel sisteminize çeker. Yapılandırma ve gelecekteki güncellemeler için bu dizini saklayın.
Adım 2: Bağımlılıkları Yükleyin
Şunu çalıştırın:
npm install
# Veya pnpm ile
pnpm install
Bu, OpenClaw'u yerel olarak çalıştırmak için gereken tüm bağımlılıkları (Node.js/Bun, CLI araçları, yapılandırma dosyaları) yükler.
Adım 3: Ortam Değişkenlerini Ayarlayın
Proje kök dizininde bir .env dosyası oluşturun. İçine Moonshot veya Fireworks/OpenRouter gibi sağlayıcılar için API anahtarlarınızı tanımlayacaksınız:
cp .env.example .env
Kimi API anahtarınızı eklemek için .env dosyasını düzenleyin:
# .env
KIMI_API_KEY=sk-k2-5-buraya-api-anahtarınız
KIMI_MODEL=kimi-k2.5-preview
KIMI_BASE_URL=https://api.kimi.ai/v1
Kimi k2.5 API anahtarınızı Moonshot.ai adresinde oluşturun:
Farklı bir arka uç kullanmak isterseniz OpenRouter veya diğer sağlayıcılar için de anahtarlar ekleyebilirsiniz. Gerçek üretimde kullanıldığında anahtar dizelerinizin tırnak içine alınmadığından emin olun.
{
"model": {
"primary": "openrouter/moonshotai/kimi-k2.5"
},
"models": {
"openrouter/moonshotai/kimi-k2.5": {}
},
"api": {
"openrouter": {
"key": "buraya_openrouter_api_anahtarınız"
}
}
}
Güvenlik ipucu: .env dosyasını asla versiyon kontrolüne (git) göndermeyin. Hemen .gitignore dosyasına ekleyin:
echo ".env" >> .gitignore
💡Pro İpucu: Yapılandırma dosyalarını düzenlemeden önce API anahtarınızı Apidog'da test edin. Bu, kimlik doğrulama hatalarından kaynaklanan kesintileri önler.
Kimi K2.5 için OpenClaw'u Yapılandırma
OpenClaw yüklendikten sonra, Kimi K2.5'i birincil model olarak kullanmak üzere yapılandırmanız gerekir.
OpenClaw Yapılandırmasını Güncelleme
İki yaygın yapılandırma dosyası konumu vardır:
- Yerel proje yapılandırması:
openclaw.json - Genel yapılandırma:
~/.openclaw/openclaw.json
Bunlardan birini açın ve aşağıdaki JSON kod parçasını eklemek için değiştirin:
{
"authProviders": {
"moonshot": {
"provider": "openrouter",
"apiKey": "${env.KIMI_API_KEY}",
"model": "moonshot/kimi-k2.5-preview"
}
},
"chatEngines": {
"default": {
"provider": "moonshot",
"maxTokens": 2048,
"temperature": 0.7
}
}
}
Ortam değişkeni ikamesini kullanmıyorsanız ${env.KIMI_API_KEY} yerine gerçek API anahtarınızı yazın. OpenClaw, modelleri tanımlamak için openrouter/<sağlayıcı>/<model> formatını kullanır.
Yapılandırma için Ortam Değişkenlerini Kullanma
Moonshot.ai/kimi k2.5 yapılandırmasını depolamak için bir .env dosyası da oluşturabilirsiniz:
# .env içinde
OPENCLAW_PROVIDER=moonshot
OPENCLAW_MODEL=moonshot/kimi-k2.5-preview
OPENCLAW_API_KEY=sk-k2-5-buraya-api-anahtarınız
Eğer openclaw.json dosyası yoksa OpenClaw bunları başlangıçta okuyacaktır.
Alternatif: Fireworks AI Kullanımı (Başka Bir Sağlayıcı)
Başka bir sağlayıcı olarak, Kimi K2.5 arka ucunu yapılandırmak için Fireworks.ai'yi kullanabilirsiniz:
# Fireworks API anahtarını ayarlayın
export FIREWORKS_API_KEY=buraya-fireworks-anahtarınız
# OpenClaw'u yapılandırın
echo '{
"authProviders": {
"fireworks": {
"provider": "fireworks",
"apiKey": "${env.FIREWORKS_API_KEY}",
"model": "accounts/fireworks/models/kimi-k2.5-preview"
}
},
"chatEngines": {
"default": {
"provider": "fireworks"
}
}
}' > openclaw.json
YOUR_FIREWORKS_API_KEY yerine Fireworks API anahtarınızı yazın. Bu komut dosyası, OpenClaw JSON dosyanızı Fireworks'ü Kimi K2.5 ile bir sağlayıcı olarak kullanacak şekilde yapılandırır.
OpenClaw'u Çalıştırma
Yapılandırmadan sonra, yapay zeka ajanının erişilebilir olması için OpenClaw'un ağ geçidini başlatmanız gerekir.
Ağ Geçidini Çalıştırın
Proje dizininizde:
npm run start:gateway
# Veya CLI kullanıyorsanız
openclaw gateway start
Bu, OpenClaw sunucusunu başlatır ve gelen ajan olayları ile komutlarını dinler. Etkileşimler için CLI'yı kullanın veya mesajlaşma platformlarıyla (örn. Telegram) entegre edin. Kimi K2.5 modeli için açıkça destek ekleyen ve kabuk tamamlama gibi kullanışlı CLI özelliklerini içeren en son sürüme (v2026.1.30 gibi) güncellediğinizden emin olun.
Alternatif: Etkileşimli Kabuğu Çalıştırın
Yerel test için:
npm run start:cli
# Veya
openclaw shell
Bu, Kimi ile doğrudan sohbet edebileceğiniz etkileşimli bir istemciye sizi düşürür.
Doğrulama
Çalıştıktan sonra, OpenClaw kabuğuna girerek bağlantıyı test edin. Modelin yanıt verdiğini doğrulamak için sohbet veya ajan istemleri gibi basit komutlar girin.
Örnek:
$ openclaw shell
> /chat "Tokyo'da hava nasıl?"
Eğer Kimi K2.5 yanıt veriyorsa, entegrasyonunuz çalışıyor demektir.
Model Yapılandırmasını Test Edin
Kimi'nin aktif sağlayıcı olduğunu doğrulayın:
openclaw config list
Şunu göstermelidir:
Active Provider: moonshot
Model: moonshot/kimi-k2.5-preview
Base URL: https://api.kimi.ai/v1
API Bağlantısını Test Edin
Doğrudan bir test çalıştırın:
openclaw test-model kimi "Kuantum bilişimi basit terimlerle açıkla"
Bu, sohbet motorunu atlar ve ham model bağlantısını test eder.
OpenClaw İçinde Kimi K2.5 Kullanımı
Her şey çalışır durumda olduğunda, AI ajanınızın muhakemesini ve iş akışlarını güçlendirmek için artık Kimi K2.5'i kullanabilirsiniz:
Basit İpuçları
openclaw chataracılığıyla etkileşimli oturumlar başlatın- Telegram veya diğerleriyle eşleştirdikten sonra mesajlaşma entegrasyonlarınız üzerinden görevleri çalıştırın
- API anahtarlarınızı ortam değişkenlerinde güvende tutun
openclaw usage --provider moonshotile kullanımı izleyin
Telegram ile Entegrasyon
Telegram bot entegrasyonunu yapılandırın:
# Telegram bot belirtecini ayarlayın
export TELEGRAM_BOT_TOKEN=buraya-telegram-belirteciniz
# openclaw.json dosyasını güncelleyin
echo '{
"integrations": {
"telegram": {
"enabled": true,
"botToken": "${env.TELEGRAM_BOT_TOKEN}"
}
}
}' >> openclaw.json
# Ağ geçidini yeniden başlatın
npm run start:gateway
Artık Telegram üzerinden Kimi K2.5 ile sohbet edebilirsiniz.
Kod Oluşturma için Kimi Kullanımı
# OpenClaw kabuğunda
> /agent "Hava durumu verilerini getiren ve Slack'e gönderen bir Python betiği oluştur"
Kimi, ajan yeteneklerini kullanarak kodu yazacak, bağımlılıkları önerecek ve dağıtım adımlarını özetleyecektir.
Oran Sınırları ve Maliyet Yönetimi
OpenClaw, Kimi K2.5 ve Kimi Coding gibi modellere tek bir oturum açma ile ücretsiz erişim sunsa da, sağlayıcı sınırlarına (ücretsiz ve ücretli) dikkat edin.
Kullanımınızı izleyin:
openclaw usage --provider moonshot --daily
Harcama uyarıları ayarlayın:
export MOONSHOT_SPENDING_LIMIT=10 # 10 USD
Gelişmiş Yapılandırma
Özel Sistem İstemleri
Kimi'nin varsayılan davranışını geçersiz kılın:
{
"chatEngines": {
"codeAssistant": {
"provider": "moonshot",
"systemPrompt": "Siz, güvenlik açıklarına odaklanmış uzman bir kod inceleyicisiniz. Doğrudan ve eleştirel olun."
}
}
}
Özel motoru kullanın:
openclaw chat --engine codeAssistant "Bu fonksiyonu SQL enjeksiyon riskleri açısından incele"
Model Parametreleri
Üretim parametrelerini ince ayar yapın:
{
"chatEngines": {
"creative": {
"provider": "moonshot",
"temperature": 0.9,
"topP": 0.95,
"maxTokens": 4096
}
}
}
Birden Fazla Sağlayıcı
Yedek sağlayıcıları yapılandırın:
{
"chatEngines": {
"primary": {
"provider": "moonshot",
"fallbackProviders": ["openai", "anthropic"]
}
}
}
Eğer Kimi kullanılamıyorsa, OpenClaw otomatik olarak yedek sağlayıcıya geçecektir.
Sorun Giderme
"Sağlayıcı bulunamadı" hatası
Neden: openclaw.json yüklenmedi veya sözdizimi hatası var
Çözüm: JSON sözdizimini doğrulayın:
node -e "console.log(JSON.parse(require('fs').readFileSync('openclaw.json', 'utf8')))"
"Kimlik doğrulama başarısız" hatası
Neden: Geçersiz API anahtarı veya süresi dolmuş belirteç
Çözüm: Anahtarı doğrulayın:
curl -H "Authorization: Bearer $KIMI_API_KEY" https://api.kimi.ai/v1/models
"Model mevcut değil" hatası
Neden: Yanlış model tanımlayıcısı
Çözüm: Mevcut modelleri listeleyin:
curl -H "Authorization: Bearer $KIMI_API_KEY" https://api.kimi.ai/v1/models | jq '.data[].id'
Bağlantı zaman aşımı
Neden: Ağ sorunları veya güvenlik duvarı engellemesi
Çözüm: Bağlantıyı test edin:
telnet api.kimi.ai 443
Sonuç
Kimi K2.5'i OpenClaw (ClawdBot/MoltBot) ile bağlamak, ajan platformunu muhakeme, kodlama ve çok modlu görevleri yapabilen güçlü, açık kaynaklı bir yapay zeka sistemine dönüştürür. Depoyu klonlayarak, sağlayıcıları ve API anahtarlarını yapılandırarak ve ağ geçidini başlatarak, tescilli kısıtlamalar olmaksızın önde gelen açık ağırlıklı bir modelden yararlanan tam işlevsel bir yapay zeka asistanının kilidini açarsınız.
İster iş akışlarını otomatikleştirmek, ister sohbet platformlarıyla entegre olmak veya yeni nesil ajanlar oluşturmak isteyin, bu entegrasyon size ihtiyacınız olan esnekliği ve yeteneği sağlar.