OpenClaw LLMTR eklentisi: paket kurulumu ve manifest okuma

LLMTR neden ayrı bir eklenti paketi

OpenClaw deposunda LLMTR desteği çekirdek kodun içine dağıtılmış değildir. extensions/llmtr dizini altında kendi README dosyası, kendi eklenti manifesti ve kendi model kataloğu olan bağımsız bir paket durur. Paket dağıtımda @openclaw/llmtr-provider adıyla yayımlanır ve kurulduğunda OpenClaw tarafına llmtr kimliğiyle tek bir sağlayıcı ekler.

Bu ayrım pratik bir sonuç doğurur: entegrasyonun tamamı tek bir JSON dosyasından okunabilir. Kimlik doğrulama seçeneği, ortam değişkeni adı, model kimliği normalizasyonu ve model kataloğu aynı manifest içinde yaşar. Bir davranışı merak ettiğinizde çekirdek kodda arama yapmak yerine manifesti açmak yeterlidir.

Paketi kurmak ve anahtarı tanıtmak

Başlamadan önce kaynağın nerede olduğunu netleştirelim: bu entegrasyon upstream OpenClaw sürümüne merge edilmedi. Eklenti paketini ve bu yazıda anlatılan manifesti knowhycodata/openclaw deposunda feat/llmtr-provider dalı altında bulacaksınız. Resmi dağıtımda sağlayıcıyı arayan okuyucu bulamaz; önce bu dalı çalışır hale getirin.

Kurulum iki komutla başlar: eklentiyi yüklemek ve Gateway sürecini yeniden başlatmak. Ardından anahtar ya rehberli kurulum akışıyla ya da doğrudan ortam değişkeniyle tanıtılır. Manifest, kimlik doğrulama seçeneğini llmtr-api-key kimliğiyle kaydettiği için onboard komutunda bu seçeneği adıyla çağırabilirsiniz.

Anahtarı komut satırından geçirmek isterseniz manifest ayrıca bir bayrak tanımlar. Aşağıdaki blokta anahtar yerine yer tutucu kullanılmıştır; gerçek anahtarı kabuk geçmişine bırakmamak için ortam dosyasından okutmayı tercih edin.

Eklenti kurulumu, anahtar tanıtımı ve model listesi

openclaw plugins install @openclaw/llmtr-provider
openclaw gateway restart

# Rehberli akış
openclaw onboard --auth-choice llmtr-api-key

# Ya da ortam değişkeni
export LLMTR_API_KEY="llmtr-your_key"

# Sağlayıcıya bağlı modelleri listele
openclaw models list --provider llmtr

Manifest alanları tek tek ne yapıyor

openclaw.plugin.json dosyası eklentiyi tanımlayan sözleşmedir. Aşağıdaki tablo dosyadaki alanları ve her birinin çalışma anındaki karşılığını listeler. Alan adları dosyadaki yollarla birebir aynıdır, dolayısıyla tabloyu manifestin yanına koyup okuyabilirsiniz.

Model referansı yazımı ve çift önek tuzağı

OpenClaw tarafında model referansları sağlayıcı önekiyle yazılır. Küresel bir rota için biçim llmtr/anthropic/claude-sonnet-5 şeklindedir: baştaki llmtr sağlayıcıyı, kalan kısım LLMTR kataloğundaki kanonik model kimliğini gösterir. Manifestte tanımlı varsayılan model de budur.

Türkiye barındırmalı rotalarda kanonik kimlik zaten llmtr önekiyle başlar. Bu yüzden referans tek önekte toplanır: Trendyol modeli llmtr/trendyol-asure-12b olarak yazılır, önek iki kez tekrarlanmaz. Manifestteki prefixWhenBare alanı öneksiz yazılan kimlikleri tamamladığı için, kısa yazımla tam yazım aynı rotaya çıkar.

• Küresel rota: llmtr öneki artı sağlayıcı bölü model biçimindeki kanonik kimlik
• Türkiye barındırmalı rota: kanonik kimlik zaten llmtr ile başlar, önek tekrarlanmaz
• Varsayılan model manifestte llmtr/anthropic/claude-sonnet-5 olarak tanımlıdır
• Öneksiz yazılan kimlik prefixWhenBare kuralıyla tamamlanır

Katalog: canlı tazeleme, snapshot ve elle sabitleme

Eklenti model listesini gateway kataloğundan tazeler ve yalnızca sohbet tamamlama yeteneği yayımlayan rotaları saklar. Bağlam penceresi, çıktı üst sınırı, kiplikler ve akıl yürütme desteği aynı yanıttan okunur. Paketle birlikte gelen anlık görüntü ise çevrimdışı yedek olarak durur, yani ağ erişimi olmadığında liste boş kalmaz.

Anlık görüntü bir tavan değil taban listedir. Katalogda görünen ama snapshot'ta bulunmayan bir rotayı kullanmak ya da yayımlanan bir değeri geçersiz kılmak isterseniz modeli yapılandırma dosyasında sağlayıcı altına elle ekleyebilirsiniz. Sabitlemeden önce modelin hangi işlemleri desteklediğini katalog yanıtından doğrulayın: gömme, görsel, video ve ses rotaları sohbet döngüsünü çalıştıramaz.

Snapshot dışındaki bir rotayı sağlayıcı altında sabitlemek

{
  "models": {
    "providers": {
      "llmtr": {
        "models": [
          {
            "id": "perplexity/sonar-pro",
            "contextWindow": 131072,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

Emekli rota bulgusu ve hata okuma

Eklenti dokümanının sorun giderme bölümü, daha önce çalışan bir kimliğin hata vermesini emekli rotalarla açıklar. Bu partide kataloğu doğruladığımızda llmtr/sincap kimliğinin gerçekten emekli olduğunu gördük; örnek yapılandırmalarda bu kimliği kullanmayın. Türkiye barındırmalı canlı seçenekler arasında llmtr/gemma-4, llmtr/qwen3-5-4b ve llmtr/trendyol-asure-12b bulunuyor.

Emekli kimlikler katalog yanıtından, yanıt vermeyi bırakmadan önce düşer. Bu yüzden bir kimliğin hâlâ geçerli olup olmadığını tahmin etmek yerine sağlayıcıya bağlı model listesini çalıştırıp çıktıdaki kimliği kopyalamak daha güvenli bir alışkanlıktır.

Sık sorulan sorular

Eklentiyi kurduktan sonra Gateway'i neden yeniden başlatıyoruz?

Kurulum belgesi iki komutu birlikte veriyor: paketi yükleyen komut ve Gateway sürecini yeniden başlatan komut. Manifestte başlangıç etkinleştirmesi kapalı tutulduğu için sağlayıcının süreç tarafından tanınması bu yeniden başlatmayla birlikte doğrulanır.

Katalog sayfasında gördüğüm bir model OpenClaw listesinde neden çıkmıyor?

Eklenti kataloğu tazelerken yalnızca sohbet tamamlama yayımlayan rotaları tutuyor. Gömme, görsel, video ve ses rotaları ile sohbet yeteneği yayımlamayan kayıtlar listeye hiç girmiyor. Katalog yanıtındaki desteklenen işlem alanına bakarak durumu doğrulayabilirsiniz.

Snapshot listesinde olmayan bir rotayı kullanabilir miyim?

Evet. Yapılandırmada sağlayıcı altındaki model dizisine kimliği, bağlam penceresini ve çıktı üst sınırını yazarak rotayı sabitleyebilirsiniz. Aynı yöntem yayımlanan bir değeri kendi ölçünüzle değiştirmek için de kullanılır.

Model kimliğini llmtr öneki olmadan yazarsam ne olur?

Manifestteki normalizasyon kuralı öneksiz kimliğin başına llmtr ekler. Bu davranış kısa yazımı kolaylaştırır ama hangi rotanın çağrıldığını okumayı zorlaştırabilir; paylaşılan yapılandırmalarda tam biçimi yazmak daha okunaklı olur.

İlgili yazılar

• LLMTR entegre geliştirici araçları: 21 aracın bağlanma biçimi
• Cline ile LLMTR: editör panelinde sağlayıcı kurulumu
• OpenCode yapılandırmasında LLMTR sağlayıcı bloğu ve model adları

• Model katalogu
• Chat Completions rehberi
• API anahtarlari
• Fiyatlandirma