Günlük Plugin'i

​

Başlamadan önce

• 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ıç

openclaw plugins enable codex
openclaw plugins enable logbook

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

openclaw gateway restart
openclaw plugins inspect logbook --runtime --json
openclaw nodes status --connected
openclaw nodes describe --node <idOrNameOrIp>
openclaw dashboard

​

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.

​

Model ve veri akışı

​

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,
        },
      },
    },
  },
}

​

Görüntü modeli seçimi

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

​

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

​

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

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.

​

Yakalama bir hata bildiriyor

openclaw nodes status --connected
openclaw 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.

​

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