Günlük Plugin'i

Logbook Plugin'i, ekran etkinliğini otomatik bir çalışma günlüğüne dönüştürür. Eşleştirilmiş bir Node'dan düzenli aralıklarla ekran görüntüleri alır, bunları zaman damgalı gözlemler hâlinde özetler ve Kontrol Arayüzü içinde zaman çizelgesi kartları oluşturur. Ayrıca günlük durum toplantısı notları oluşturabilir ve izlenen bir gün hakkındaki soruları yanıtlayabilir.

OpenClaw'a ait durum, Gateway üzerinde <state-dir>/logbook/ altında kalır ancak model işleme işlemi mutlaka yerel değildir. Örneklenen ekran görüntüleri yapılandırılmış görüntü rotasına; gözlemler ve zaman çizelgesi metni ise varsayılan ajan modeline gider. Ekran içeriğinin ve bundan türetilen etkinlik metninin makinede kalması gerekiyorsa her iki aşama için de yerel model rotalarını kullanın.

Logbook paketle birlikte gelir ve varsayılan olarak devre dışıdır. captureEnabled varsayılan olarak true olduğundan Plugin'in etkinleştirilmesi, Gateway'in ekran yakalamayı kabul etmesini sağlar.

Başlamadan önce

Gereksinimler:

• screen.snapshot veya logbook.snapshot sunan bağlı bir Node. macOS uygulama Node'u Ekran Kaydı iznine ihtiyaç duyar. Başsız bir macOS Node ana bilgisayarı (openclaw node host run), sistemdeki screencapture aracı tarafından desteklenen ve Plugin'in sağladığı logbook.snapshot komutunu alır.
• Paketle gelen Codex Plugin'inin etkinleştirilmiş ve kimliği doğrulanmış olması. Codex şu anda Logbook'un ihtiyaç duyduğu yapılandırılmış görüntü çıkarma sözleşmesini sağlar. openclaw models auth login --provider openai ile oturum açın; diğer kimlik doğrulama yolları için Codex donanımına bakın.
• Çalışan bir varsayılan ajan modeli. Logbook, görüntü geçişinden sonra kartları, durum toplantısı notlarını ve günlük soru-cevapları sentezlemek için bunu kullanır.

Hızlı başlangıç

Codex ve Logbook Plugin'lerini etkinleştirin:

openclaw plugins enable codexopenclaw plugins enable logbook

Belirlenimci başlatma için açık bir görüntü modeli yapılandırın:

{  plugins: {    entries: {      codex: {        enabled: true,      },      logbook: {        enabled: true,        config: {          visionModel: "codex/gpt-5.6-sol",        },      },    },  },}

plugins.allow kullanıyorsanız hem codex hem de logbook değerlerini ekleyin. Plugin yapılandırmasını değiştirdikten sonra Gateway'i yeniden başlatın, ardından kayıtları inceleyip gösterge panelini açın:

openclaw gateway restartopenclaw plugins inspect logbook --runtime --jsonopenclaw nodes status --connectedopenclaw nodes describe --node <idOrNameOrIp>openclaw dashboard

Node açıklaması screen.snapshot veya logbook.snapshot içermelidir. Başsız Node'lar logbook.snapshot değerini yalnızca Plugin etkinleştirildikten sonra duyurur. Komut eksikse Node sorun giderme sayfasına bakın.

Logbook sekmesi yalnızca etkinleştirilmiş bir Plugin ve operator.write Control UI oturumu için görünür. Durum satırında hata olmadan Yakalanıyor gösterilmelidir. Analiz penceresi kapandığında bir zaman çizelgesi kartı görünür veya etkinlik yakalandıktan sonra Şimdi analiz et seçeneğini belirleyebilirsiniz.

Nasıl çalışır?

1. Yakalama: Logbook, her captureIntervalSeconds aralığında (varsayılan 30 sn.) seçilen Node'un yakalama komutunu çağırır ve ölçeklendirilmiş bir JPEG karesi depolar. Birbirinin aynısı olan ardışık kareler boşta olarak işaretlenir ve analizin dışında bırakılır.
2. Gözlemleme: Bir analiz penceresi (varsayılan 15 dakika) dolduğunda Plugin, en fazla 16 etkin kareyi örnekleyip görüntü modeline gönderir. Model, zaman damgalı etkinlik gözlemleri döndürür ("VS Code: store.ts düzenleniyor, bir tür hatası düzeltiliyor"). İki dakikadan uzun bir yakalama boşluğu veya yerel gece yarısı da geçerli pencereyi kapatır.
3. Sentezleme: Gözlemler ve mevcut kartların son 45 dakikası; başlık, özet, kategori, ana uygulama ve kısa süreli dikkat dağıtıcıları içeren zaman çizelgesi kartları (her biri 10-60 dakika) hâlinde yeniden düzenlenir.
4. Temizleme: retentionDays günden (varsayılan 14) eski kareler silinir. Kartlar, gözlemler ve önbelleğe alınmış durum toplantısı notları korunur.

Gün sınırları ve zaman çizelgesi saatleri, tarayıcının saat dilimini değil Gateway'in yerel saat dilimini kullanır. Kareler ve SQLite zaman çizelgesi veritabanı <state-dir>/logbook/ altında bulunur.

Model ve veri akışı

Logbook iki ayrı model rotası kullanır:

SQLite veritabanının tamamı hiçbir modele gönderilmez. Ham ekran görüntüleri yalnızca gözlem aşamasına gider; kart sentezleme, durum toplantısı ve soru-cevap işlemleri türetilmiş metni alır.

Yapılandırma

{  plugins: {    entries: {      codex: {        enabled: true,      },      logbook: {        enabled: true,        config: {          captureEnabled: true,          captureIntervalSeconds: 30,          analysisIntervalMinutes: 15,          nodeId: "my-mac",          screenIndex: 0,          maxWidth: 1440,          visionModel: "codex/gpt-5.6-sol",          retentionDays: 14,        },      },    },  },}

Tüm Logbook yapılandırma anahtarları isteğe bağlıdır. Sayısal değerler tam sayıya yuvarlanır ve desteklenen aralıkla sınırlandırılır.

nodeId olmadan Logbook, screen.snapshot sunan bağlı bir uygulama Node'unu tercih eder, ardından logbook.snapshot sunan başsız bir Node'a geri döner. Sabitlenmemiş bir kurulumda başarısız olan Node, diğer uygun Node'ların arkasına alınır. Gösterge panelindeki duraklatma anahtarı yalnızca oturum boyunca geçerlidir ve Gateway yeniden başlatıldığında sıfırlanır; kalıcı olarak durdurmak için captureEnabled: false kullanın.

Görüntü modeli seçimi

Logbook gözlem modelini şu sırayla çözümler:

1. plugins.entries.logbook.config.visionModel
2. tools.media.models altındaki görüntü destekli ilk Codex girdisi

Diğer medya sağlayıcıları, Logbook'un ihtiyaç duyduğu yapılandırılmış çıkarma sözleşmesini şu anda sunmadıkları için atlanır. tools.media.image.enabled: false değerinin ayarlanması ödünç alınan medya varsayılanlarını devre dışı bırakır ancak açık bir Logbook visionModel değeri yine de uygulanır.

Gösterge paneli sekmesi

• Zaman çizelgesi: Kategori renkleri, ana uygulama, dikkat dağıtıcı etiketleri ve bir anlık görüntü ana karesiyle her etkinlik için genişletilebilir kartlar.
• Güne genel bakış: Odaklanma oranı, kategori dağılımı ve en çok kullanılan uygulamalar.
• Günlük durum toplantısı: Dün ile bugünü yapıştırmaya hazır bir güncellemeye dönüştürür.
• Gününüze soru sorun: İzlenen zaman çizelgesinden yanıtlanan doğal dil soruları ("Gateway PR'ını ne zaman inceledim?").
• Şimdi analiz et: Analiz aralığını beklemek yerine geçerli yakalama penceresini hemen kapatır.

Gateway yöntemleri

Logbook şu Gateway RPC yöntemlerini kaydeder:

Okuma yöntemleri operasyonel durumu veya türetilmiş metni döndürür. Ham ekran görüntüsü pikselleri, model harcaması gerektiren eylemler ve çalışma zamanı değişiklikleri operator.write gerektirir. Control UI sekmesi, bu eylemleri ve ham kare önizlemelerini sunduğu için ayrıca operator.write gerektirir; salt okunur bir istemci türetilmiş metin yöntemlerini doğrudan çağırmaya devam edebilir.

Gizlilik notları

• Anlık görüntüler, gizli bilgiler dâhil ekrandaki her şeyi içerebilir. Kareler, yapılandırılmış gözlem modeline örneklenmiş girdi olarak gönderilmesi dışında hiçbir zaman makineden ayrılmaz.
• Gözlemler, son kartlar ve sorular; kart sentezi, durum toplantısı oluşturma veya soru-cevap sırasında varsayılan ajan modeli aracılığıyla makineden ayrılabilir. Sağlayıcının veri işleme politikasını her iki model rotasına da uygulayın.
• Tamamen yerel bir işlem hattına ihtiyaç duyduğunuzda hem yapılandırılmış gözlem modeli hem de varsayılan ajan modeli için yerel rotaları kullanın.
• Kareler, zaman çizelgesi veritabanı ve geçici yakalamalar yalnızca sahibin erişebileceği dosya izinleriyle yazılır.
• gateway.nodes.commands.deny öğesine screen.snapshot eklemek, ekran yakalama acil durdurma anahtarıdır: hem uygulama Node'u yakalamasını hem de Logbook'un kendi logbook.snapshot komutunu engeller.
• tools.media.image.enabled: false ayarlandığında Logbook'un analiz için medya görüntü modellerini ödünç alması da durdurulur; bu durumda yalnızca Plugin yapılandırmasında açıkça belirtilen bir visionModel kullanılır.

Sorun giderme

Logbook sekmesi görünmüyor

Üç geçidi de kontrol edin:

1. openclaw plugins list --enabled, logbook içerir.
2. Plugin veya izin verilenler listesi değişikliğinden sonra Gateway yeniden başlatıldı.
3. Control UI bağlantısında operator.write bulunur; salt okunur oturumlar etkileşimli sekme tanımlayıcısını almaz.

plugins.allow ayarlanmışsa önerilen yapılandırma için hem logbook hem de codex içermelidir.

Yakalama bir hata bildiriyor

openclaw nodes status --connectedopenclaw nodes describe --node <idOrNameOrIp>openclaw logs --follow

• Node'un screen.snapshot veya logbook.snapshot sunduğunu doğrulayın.
• Yakalama Mac'inde Screen Recording izni verin.
• nodeId yapılandırılmışsa Node kimliği veya görünen adıyla eşleştiğini doğrulayın.
• gateway.nodes.commands.deny değerinin screen.snapshot içermediğini kontrol edin.

Art arda üç hatadan sonra Logbook, on yakalama döngüsü boyunca geri çekilir ve ardından yeniden dener. Sabitlenmemiş bir kurulum, uygun başka bir Node'a geçebilir.

Yakalamalar başarılı ancak kartlar görünmüyor

• Model eksik durumu, uyumlu bir yapılandırılmış görsel rota bulunamadığı anlamına gelir. Codex Plugin'ini etkinleştirip kimliğini doğrulayın veya geçerli ve açık bir visionModel ayarlayın. Model eksikken yakalanan kareler beklemede kalır ve yapılandırma düzeltildikten sonra analiz edilebilir.
• analysisIntervalMinutes için bekleyin veya etkinlik yakalandıktan sonra Şimdi analiz et seçeneğini belirleyin.
• Art arda gelen aynı kareler, boşta olunduğuna dair kanıttır ve analiz gruplarına dâhil edilmez. Test etmeden önce görünür ekranı değiştirin.
• En son grup bir hata gösteriyorsa model veya kimlik doğrulama sorununu düzeltin ve Şimdi analiz et seçeneğini belirleyin. Model için tekrar tekrar harcama yapılmasını önlemek amacıyla başarısız gruplar yalnızca bu açık eylemle yeniden denenir.

İlgili

• Plugin'leri yönetme
• Codex çalışma düzeneği
• Medya anlama
• Node'lar
• Node sorunlarını giderme
• Control UI