Logbook Plugin'i

Logbook plugini, 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 anlık 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şlemesi her zaman 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. Plugin etkinleştirildiğinde captureEnabled varsayılan olarak true olduğundan Gateway ekran yakalamayı kabul etmiş olur.

Başlamadan önce

Gereksinimler:

• screen.snapshot veya logbook.snapshot sunan bağlı bir Node. macOS uygulama Node'u, Ekran Kaydı izni gerektirir. Başsız bir macOS Node ana makinesi (openclaw node host run), sistemin screencapture aracıyla desteklenen ve plugin tarafından sağlanan logbook.snapshot komutunu edinir.
• Paketle gelen Codex plugininin etkinleştirilmiş ve kimlik doğrulamasının yapılmış olması. Codex şu anda Logbook'un gerektirdiği 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 çalışma ortamı bölümüne bakın.
• Çalışan bir varsayılan ajan modeli. Logbook, görüntü işleme geçişinden sonra kartları, durum toplantısı notlarını ve güne ilişkin soru-cevapları sentezlemek için bunu kullanır.

Hızlı başlangıç

Codex ve Logbook pluginlerini etkinleştirin:

openclaw plugins enable codexopenclaw plugins enable logbook

Belirlenimci başlangıç 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 panoyu 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 yalnızca plugin etkinleştirildikten sonra logbook.snapshot duyurur. Komut eksikse Node sorun giderme bölümüne bakın.

Logbook sekmesi yalnızca etkinleştirilmiş bir plugin ve operator.write yetkili Kontrol Arayüzü oturumu için görünür. Durum satırı hata olmadan Yakalanıyor göstermelidir. Analiz penceresi kapandığında bir zaman çizelgesi kartı görünür; etkinlik yakalandıktan sonra Şimdi analiz et seçeneğini de belirleyebilirsiniz.

Nasıl çalışır?

1. Yakalama: Logbook, her captureIntervalSeconds süresinde (varsayılan 30 sn.) seçilen Node'un yakalama komutunu çağırır ve ölçeklendirilmiş bir JPEG karesi depolar. Art arda gelen özdeş kareler boşta olarak işaretlenir ve analiz dışında bırakılır.
2. Gözlemleme: Bir analiz penceresi (varsayılan 15 dakika) dolduğunda plugin en fazla 16 etkin kare örnekler ve bunları 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 varsa kısa dikkat dağınıklıkları içeren zaman çizelgesi kartları (her biri 10-60 dakika) hâlinde yeniden düzenlenir.
4. Temizleme: retentionDays süresinden (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 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özlemleme aşamasına gider; kart sentezleme, durum toplantısı ve soru-cevap aşamaları türetilmiş metin 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ılara yuvarlanır ve desteklenen aralığa 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. Panodaki 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.image.models altındaki görüntü işleyebilen ilk Codex girdisi
3. tools.media.models altındaki görüntü işleyebilen ilk Codex girdisi

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

Pano sekmesi

• Zaman çizelgesi: Her etkinlik için kategori renkleri, ana uygulama, dikkat dağınıklığı etiketleri ve bir anlık görüntü ana karesi içeren genişletilebilir kartlar.
• Güne genel bakış: Odaklanma oranı, kategori dağılımı, en çok kullanılan uygulamalar.
• Günlük durum toplantısı: Dünü ve bugünü yapıştırılmaya hazır bir güncellemeye dönüştürür.
• Gününüzü 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 işletim durumunu veya türetilmiş metni döndürür. Ham ekran görüntüsü pikselleri, model harcamasına yol açan eylemler ve çalışma zamanı değişiklikleri operator.write gerektirir. Kontrol Arayüzü sekmesi de bu eylemleri ve ham kare önizlemelerini sunduğu için 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önderilmeleri dışında makineden hiçbir zaman ayrılmaz.
• Gözlemler, son kartlar ve sorular; kart sentezleme, durum toplantısı oluşturma veya soru-cevap sırasında varsayılan ajan modeli üzerinden 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 sahip erişimli dosya izinleriyle yazılır.
• gateway.nodes.denyCommands öğ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 ayarı, Logbook'un analiz için medya görüntü modellerini ödünç almasını da durdurur; bu durumda yalnızca plugin yapılandırmasında açıkça belirtilen bir visionModel kullanılır.

Sorun giderme

Logbook sekmesi eksik

Üç koşulun tamamını denetleyin:

1. openclaw plugins list --enabled çıktısı logbook içerir.
2. Plugin veya izin listesi değişikliğinden sonra Gateway yeniden başlatılmıştır.
3. Kontrol Arayüzü bağlantısında operator.write vardır; 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 değerlerini içermelidir.

Yakalama 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 Ekran Kaydı izni verin.
• nodeId yapılandırılmışsa Node kimliğiyle veya görünen adıyla eşleştiğini doğrulayın.
• gateway.nodes.denyCommands öğesinin screen.snapshot içermediğini kontrol edin.

Art arda üç hatadan sonra Logbook, on yakalama döngüsü boyunca bekleme süresini artırır 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 algılama rotasının bulunmadığı anlamına gelir. Codex Plugin'ini etkinleştirip kimlik doğrulamasını yapın veya geçerli ve açıkça belirtilmiş bir visionModel ayarlayın. Model eksikken yakalanan kareler beklemede kalır ve yapılandırma düzeltildikten sonra analiz edilebilir.
• analysisIntervalMinutes süresini bekleyin veya etkinlik yakalandıktan sonra Şimdi analiz et seçeneğini belirleyin.
• Art arda gelen aynı kareler boşta olma kanıtıdır ve analiz toplu işlemlerine dahil edilmez. Test etmeden önce görünür ekranı değiştirin.
• En son toplu işlem bir hata gösteriyorsa model veya kimlik doğrulama sorununu düzeltin ve Şimdi analiz et seçeneğini belirleyin. Modelin tekrar tekrar kullanılmasından kaynaklanan harcamaları önlemek için başarısız toplu işlemler yalnızca bu açık eylemle yeniden denenir.

İlgili

• Plugin'leri yönetme
• Codex çalıştırma düzeneği
• Medya anlama
• Node'lar
• Node sorunlarını giderme
• Denetim kullanıcı arayüzü