लॉगबुक Plugin

​

शुरू करने से पहले

• एक कनेक्ट किया हुआ Node जो screen.snapshot या logbook.snapshot उपलब्ध कराता हो। macOS ऐप Node को Screen Recording अनुमति चाहिए। हेडलेस macOS Node होस्ट (openclaw node host run) को सिस्टम के screencapture टूल द्वारा समर्थित, Plugin से प्रदान की गई logbook.snapshot कमांड मिलती है।
• बंडल में शामिल Codex Plugin सक्षम और प्रमाणीकृत होना चाहिए। Codex वर्तमान में Logbook के लिए आवश्यक संरचित इमेज-एक्सट्रैक्शन अनुबंध प्रदान करता है। openclaw models auth login --provider openai से साइन इन करें; अन्य प्रमाणीकरण पथों के लिए Codex हार्नेस देखें।
• एक कार्यशील डिफ़ॉल्ट एजेंट मॉडल। विज़न पास के बाद Logbook कार्ड, स्टैंडअप नोट्स और दिन के प्रश्नोत्तर तैयार करने के लिए इसका उपयोग करता है।

​

त्वरित शुरुआत

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

​

यह कैसे काम करता है

1. कैप्चर: प्रत्येक captureIntervalSeconds (डिफ़ॉल्ट 30s) पर Logbook चुने गए Node की कैप्चर कमांड चलाता है और एक स्केल किया हुआ JPEG फ़्रेम संग्रहीत करता है। लगातार एक जैसे फ़्रेम निष्क्रिय चिह्नित किए जाते हैं और विश्लेषण से बाहर रखे जाते हैं।
2. अवलोकन: विश्लेषण विंडो (डिफ़ॉल्ट 15 मिनट) बीत जाने पर Plugin अधिकतम 16 सक्रिय फ़्रेमों के नमूने लेकर उन्हें विज़न मॉडल को भेजता है, जो टाइमस्टैम्प वाली गतिविधि टिप्पणियाँ लौटाता है (“VS Code: store.ts संपादित करना, टाइप त्रुटि ठीक करना”)। दो मिनट से अधिक का कैप्चर अंतराल या स्थानीय मध्यरात्रि भी वर्तमान विंडो बंद कर देती है।
3. संश्लेषण: टिप्पणियों और मौजूदा कार्डों के अंतिम 45 मिनट को शीर्षक, सारांश, श्रेणी, मुख्य ऐप और संक्षिप्त ध्यान-भंग विवरण वाले टाइमलाइन कार्डों (प्रत्येक 10-60 मिनट) में संशोधित किया जाता है।
4. छँटाई: retentionDays (डिफ़ॉल्ट 14) से पुराने फ़्रेम हटा दिए जाते हैं। कार्ड, टिप्पणियाँ और कैश किए गए स्टैंडअप रखे जाते हैं।

​

मॉडल और डेटा प्रवाह

​

कॉन्फ़िगरेशन

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

​

विज़न मॉडल चयन

1. plugins.entries.logbook.config.visionModel
2. tools.media.models के अंतर्गत पहली इमेज-सक्षम Codex प्रविष्टि

​

डैशबोर्ड टैब

• टाइमलाइन: प्रत्येक गतिविधि के लिए विस्तृत किए जा सकने वाले कार्ड, जिनमें श्रेणी के रंग, मुख्य ऐप, ध्यान-भंग चिप और स्नैपशॉट कीफ़्रेम होते हैं।
• दिन का संक्षिप्त अवलोकन: फ़ोकस अनुपात, श्रेणी विभाजन, शीर्ष ऐप।
• दैनिक स्टैंडअप: कल और आज की जानकारी को पेस्ट करने के लिए तैयार अपडेट में बदलता है।
• अपने दिन के बारे में पूछें: ट्रैक की गई टाइमलाइन से प्राकृतिक भाषा के प्रश्नों के उत्तर (“मैंने Gateway PR की समीक्षा कब की थी?”)।
• अभी विश्लेषण करें: विश्लेषण अंतराल की प्रतीक्षा करने के बजाय वर्तमान कैप्चर विंडो तुरंत बंद करता है।

​

Gateway विधियाँ

​

गोपनीयता संबंधी नोट्स

• स्नैपशॉट में स्क्रीन पर दिखाई देने वाली कोई भी चीज़, जिसमें सीक्रेट भी शामिल हैं, हो सकती है। फ़्रेम कॉन्फ़िगर किए गए अवलोकन मॉडल के लिए नमूना इनपुट के रूप में भेजे जाने के अलावा कभी भी मशीन से बाहर नहीं जाते।
• कार्ड संश्लेषण, स्टैंडअप निर्माण या प्रश्नोत्तर के दौरान अवलोकन, हाल के कार्ड और प्रश्न डिफ़ॉल्ट एजेंट मॉडल के माध्यम से मशीन से बाहर जा सकते हैं। दोनों मॉडल रूट पर प्रदाता की डेटा-प्रबंधन नीति लागू करें।
• जब आपको पूरी तरह स्थानीय पाइपलाइन की आवश्यकता हो, तो संरचित अवलोकन मॉडल और डिफ़ॉल्ट एजेंट मॉडल, दोनों के लिए स्थानीय रूट का उपयोग करें।
• फ़्रेम, टाइमलाइन डेटाबेस और अस्थायी कैप्चर केवल स्वामी के लिए फ़ाइल अनुमतियों के साथ लिखे जाते हैं।
• screen.snapshot को gateway.nodes.commands.deny में जोड़ना स्क्रीन-कैप्चर किल स्विच है: यह ऐप-नोड कैप्चर और Logbook के अपने logbook.snapshot कमांड, दोनों को अवरुद्ध करता है।
• tools.media.image.enabled: false सेट करने से Logbook विश्लेषण के लिए मीडिया इमेज मॉडल का उपयोग भी बंद कर देता है; तब केवल Plugin कॉन्फ़िगरेशन में स्पष्ट रूप से दिया गया visionModel उपयोग किया जाता है।

​

समस्या निवारण

​

Logbook टैब मौजूद नहीं है

1. openclaw plugins list --enabled में logbook शामिल है।
2. Plugin या अनुमति-सूची में बदलाव के बाद Gateway पुनः आरंभ हुआ है।
3. Control UI कनेक्शन में operator.write है; केवल-पढ़ने योग्य सत्र को इंटरैक्टिव टैब डिस्क्रिप्टर प्राप्त नहीं होता।

​

कैप्चर त्रुटि की रिपोर्ट करता है

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

• पुष्टि करें कि नोड screen.snapshot या logbook.snapshot उपलब्ध कराता है।
• कैप्चर करने वाले Mac पर Screen Recording की अनुमति दें।
• अगर nodeId कॉन्फ़िगर किया गया है, तो पुष्टि करें कि यह नोड आईडी या डिस्प्ले नाम से मेल खाता है।
• जाँचें कि gateway.nodes.commands.deny में screen.snapshot शामिल नहीं है।

​

कैप्चर सफल हैं, लेकिन कोई कार्ड दिखाई नहीं देता

• मॉडल अनुपलब्ध स्थिति का अर्थ है कि कोई संगत संरचित विज़न रूट नहीं मिला। Codex Plugin सक्षम करके प्रमाणित करें या मान्य स्पष्ट visionModel सेट करें। मॉडल अनुपलब्ध रहने तक कैप्चर किए गए फ़्रेम लंबित रहते हैं और कॉन्फ़िगरेशन ठीक होने के बाद उनका विश्लेषण किया जा सकता है।
• analysisIntervalMinutes की प्रतीक्षा करें या गतिविधि कैप्चर होने के बाद अभी विश्लेषण करें चुनें।
• लगातार एक जैसे फ़्रेम निष्क्रियता के प्रमाण हैं और विश्लेषण बैच में शामिल नहीं होते। परीक्षण करने से पहले दिखाई देने वाली स्क्रीन बदलें।
• अगर नवीनतम बैच में त्रुटि दिखाई देती है, तो मॉडल या प्रमाणीकरण की समस्या ठीक करें और अभी विश्लेषण करें चुनें। मॉडल पर बार-बार खर्च से बचने के लिए विफल बैच का दोबारा प्रयास केवल उस स्पष्ट कार्रवाई पर किया जाता है।

​

संबंधित

• Plugin प्रबंधित करें
• Codex हार्नेस
• मीडिया की समझ
• नोड
• नोड समस्या निवारण
• Control UI