Ana içeriğe geç

Libre Claw Tümleştirmesi

Libre WebUI, Kroonen AI’nin yerel ajan çatısı Libre Claw için yerleşik tümleştirme içerir. Libre Claw, genel tamamlama sağlayıcısı eklentisi değil, Libre WebUI içinde birinci sınıf ajan arayüzüdür.

Güçlü ajan davranışının sahibi Libre Claw çalışma zamanıdır:

  • kalıcı çalıştırmalar ve JSONL olay günlükleri
  • dosya, kabuk, Git, tarayıcı, HTTP, web araması, MCP ve zamanlama araçları
  • yan etkilerden önce onay istekleri
  • kalıcı bellek ve proje/kullanıcı becerileri
  • hedef kipi
  • yedek model yolları
  • kullanım raporları
  • hizmetin yönettiği otomasyonlar ve Telegram teslimatı
  • bağımsız yerel panel

Libre WebUI, Libre Claw hizmetiyle HTTP üzerinden konuşur ve özellikleri normal kimlik doğrulamalı WebUI kabuğunda sunar.

Arayüzde bu yüzeyin adı Agents olur; kenar çubuğu simgesi, /agents yolu ve komut paleti bu adı kullanır. Arkadaki çalışma zamanı Libre Claw olduğundan hizmet, komut ve ortam değişkenleri kendi adını korur.

Libre Claw ile Work Farklıdır​

Libre Claw isteğe bağlı harici çalışma zamanı olarak kalır. Libre WebUI’nin yerleşik Work kipi için gerekmez.

WorkLibre Claw
Çalışma zamanıLibre WebUI model/araç döngüsü ve DockerAyrı Libre Claw hizmeti
Ana kapsamGörev başına kalıcı, yalıtılmış kodlama alanıDaha geniş ajan çalıştırmaları, bellek, onay, zamanlama, tarayıcı, MCP ve araçlar
KalıcılıkSQLite görev geçmişi ve göreve ait Docker birimiLibre Claw çalıştırma ve bellek depoları
Model yoluOllama, Ollama Cloud veya Libre WebUI sağlayıcı eklentisiLibre Claw sağlayıcı, model ve yedek yapılandırması
Olmadan kullanımWork normal sürerYalnızca /agents Libre Claw yüzeyi bağlantısızdır

Modelin sınırlı görev kapsayıcısında dosya oluşturması için Work, daha geniş araçlar, onaylar, bellek, hedefler ve otomasyonlar için Libre Claw kullanın.

Mimari​

WebUI arka ucu Libre Claw için kabuk komutlarını veya tarayıcı araçlarını doğrudan çalıştırmaz. Kimliği doğrulanmış yönetici isteklerini yerel hizmete iletir; durumları, olayları, onayları, otomasyonları, kullanımı ve yapılandırmayı gösterir.

Libre Claw’ı Başlatma​

Libre Claw’ı kurun:

git clone https://github.com/kroonen-ai/libre-claw.git
cd libre-claw
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Hizmeti başlatın:

libre-claw start

Varsayılan panel ve API:

http://127.0.0.1:8766/dashboard

Sonra Libre WebUI → Libre Claw bölümünü açın.

Arka Uç Ortamı​

Libre WebUI varsayılan olarak yerel hizmet adresini kullanır:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000

Hizmet başka ana makine, Tailscale adresi veya ters vekil arkasındaysa LIBRE_CLAW_BASE_URL ayarlayın.

WebUI Yolları​

Libre Claw yolları yerel dosya yollarını açığa çıkarabildiği ve ajan işi başlatabildiği için kimliği doğrulanmış yönetici gerektirir:

WebUI yoluLibre Claw özelliği
GET /api/libre-claw/statusHizmet durumu, temel adres, panel adresi
GET /api/libre-claw/config/modelGüncel sağlayıcı/model
PATCH /api/libre-claw/config/modelSağlayıcı/model güncelleme
GET /api/libre-claw/config/fallbackGüncel yedek yol
PATCH /api/libre-claw/config/fallbackYedek yol güncelleme
PATCH /api/libre-claw/config/themePanel/TUI teması güncelleme
GET /api/libre-claw/runsKalıcı çalıştırmaları listele
POST /api/libre-claw/runsSohbet veya hedef çalıştırması başlat
GET /api/libre-claw/runs/:idÇalıştırma üst verileri ve yapıtları
GET /api/libre-claw/runs/:id/eventsArtımlı olaylar
POST /api/libre-claw/runs/:id/cancelÇalıştırmayı iptal et
POST /api/libre-claw/runs/:id/permissions/:toolCallIdAraç çağrısını onayla/reddet
GET /api/libre-claw/usageKullanım özeti ve kayıtları
GET /api/libre-claw/automationsOtomasyonları listele
POST /api/libre-claw/automationsOtomasyon oluştur
PATCH /api/libre-claw/automations/:idOtomasyon güncelle
POST /api/libre-claw/automations/:id/runŞimdi çalıştır
POST /api/libre-claw/automations/:id/pauseDuraklat
POST /api/libre-claw/automations/:id/resumeSürdür
DELETE /api/libre-claw/automations/:idSil

Çalıştırma Başlatma​

WebUI sayfası şunları başlatır:

  • Sohbet çalıştırmaları — normal Libre Claw ajan turları.
  • Hedef çalıştırmaları — yargıç hedefi tamamlanmış sayana veya sınıra ulaşana kadar süren sınırlı otomatik kip.

İsteğe bağlı sağlayıcı/model geçersiz kılmaları bu çalıştırma için Libre Claw’a aktarılır. Atlanırsa yapılandırılmış varsayılanlar kullanılır.

Onaylar​

Libre Claw izin istediğinde WebUI bekleyen araç çağrısını gösterir ve yönetici şunlardan birini seçer:

  • allow_once
  • deny
  • always_allow_tool

İzin modeliyle güvenlik kontrollerinin sahibi Libre Claw’dır. WebUI yalnızca seçimi API üzerinden kaydeder.

Otomasyonlar​

Libre WebUI şu Libre Claw otomasyonlarını yönetebilir:

  • rapor otomasyonları
  • Telegram’a yönlenen otomasyonlar
  • duraklatma/sürdürme
  • hemen çalıştırma
  • silme

Bunlar ana makine zamanlama işleri değil, Libre Claw otomasyonlarıdır. Raporlar ve geçmiş Libre Claw deposunda kalır.

Bellek, Beceriler, Soul ve Araçlar​

Bellek, beceriler, soul dosyaları, MCP, tarayıcı, SearXNG, Petdex ve Telegram Libre Claw içinde yapılandırılır. WebUI iç yapılandırmayı çoğaltmadan hizmet özelliklerini gösterir ve yönetir.

Yararlı komutlar:

/memory status
/skills list
/soul status
/tools list
/workspace status
/telegram
/petdex status

Sorun Giderme​

WebUI "Libre Claw daemon is not connected" Gösteriyor​

Hizmeti başlatın:

libre-claw start

Veya arka uç adresini ayarlayın:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

İzin Düğmeleri Çalışmıyor​

Çalıştırma bitmiş veya izin Libre Claw paneli ya da Telegram köprüsü gibi başka yüzeyden çözülmüş olabilir. Sayfayı yenileyip zaman çizelgesine bakın.

Araç Reddedildi​

Libre Claw izin yöneticisi yetkilidir. Çağrı WebUI onay isteğini görmeden reddedilirse Libre Claw yapılandırmasını ve olaylarını denetleyin.

Otomasyonlar Çalışmıyor​

Hizmet durumunu ve yapılandırmayı denetleyin:

libre-claw status
libre-claw start

Zamanlanmış otomasyon ve Telegram teslimatı için hizmet çalışmalıdır.

İlgili Belgeler​