Unterschiede

diffs ist ein optionales Plugin-Tool mit kurzer integrierter Systemanleitung und einem zugehörigen Skill, der Änderungsinhalte in ein schreibgeschütztes Diff-Artefakt für Agenten umwandelt.

Es akzeptiert entweder:

• before- und after-Text
• einen vereinheitlichten patch

Es kann Folgendes zurückgeben:

• eine Gateway-Viewer-URL für die Canvas-Darstellung
• einen gerenderten Dateipfad (PNG oder PDF) für die Nachrichtenzustellung
• beide Ausgaben in einem Aufruf

Wenn aktiviert, stellt das Plugin eine knappe Nutzungsanleitung im System-Prompt-Bereich voran und stellt außerdem einen ausführlichen Skill für Fälle bereit, in denen der Agent vollständigere Anweisungen benötigt.

Schnellstart

openclaw plugins install diffs

{  plugins: {    entries: {      diffs: {        enabled: true,      },    },  },}

Integrierte Systemanleitung deaktivieren

Wenn Sie das Tool diffs aktiviert lassen, aber seine integrierte System-Prompt-Anleitung deaktivieren möchten, setzen Sie plugins.entries.diffs.hooks.allowPromptInjection auf false:

{  plugins: {    entries: {      diffs: {        enabled: true,        hooks: {          allowPromptInjection: false,        },      },    },  },}

Dies blockiert den Hook before_prompt_build des diffs-Plugins, während Plugin, Tool und zugehöriger Skill verfügbar bleiben.

Wenn Sie sowohl die Anleitung als auch das Tool deaktivieren möchten, deaktivieren Sie stattdessen das Plugin.

Typischer Agenten-Workflow

Eingabebeispiele

{  "before": "# Hello\n\nOne",  "after": "# Hello\n\nTwo",  "path": "docs/example.md",  "mode": "view"}

{  "patch": "diff --git a/src/example.ts b/src/example.ts\n--- a/src/example.ts\n+++ b/src/example.ts\n@@ -1 +1 @@\n-const x = 1;\n+const x = 2;\n",  "mode": "both"}

Referenz für Tool-Eingaben

Alle Felder sind optional, sofern nicht anders angegeben.

Syntaxhervorhebung

OpenClaw enthält Syntaxhervorhebung für gängige Quellcode-, Konfigurations- und Dokumentationssprachen:

javascript, typescript, tsx, jsx, json, markdown, yaml, css, html, sh, python, go, rust, java, c, cpp, csharp, php, sql, docker, ruby, swift, kotlin, r, dart, lua, powershell, xml und toml.

Gängige Aliase wie js, ts, bash, md, yml, c++, dockerfile, rb, kt und ps1 werden auf diese Standardsprachen normalisiert.

Installieren Sie das Diff Viewer Language Pack Plugin, um weitere Sprachen hervorzuheben:

openclaw plugins install clawhub:@openclaw/diffs-language-pack

Wenn das Language Pack verfügbar ist, kann OpenClaw deutlich mehr Sprachen hervorheben. Wenn das Pack nicht installiert ist, werden Dateien außerhalb der Standardliste weiterhin als lesbarer Klartext dargestellt. Beispiele sind Astro, Vue, Svelte, MDX, GraphQL, Terraform/HCL, Nix, Clojure, Elixir, Haskell, OCaml, Scala, Zig, Solidity, Verilog/VHDL, Fortran, MATLAB, LaTeX, Mermaid, Sass/Less/SCSS, Nginx, Apache, CSV, dotenv, INI und Diff-Dateien.

Weitere Details finden Sie unter Diffs Language Pack Plugin und den Upstream-Sprach- und Alias-Katalog von Shiki unter Shiki-Sprachen.

Vertrag für Ausgabedetails

Das Tool gibt strukturierte Metadaten unter details zurück.

Zusammenfassung des Modusverhaltens:

Eingeklappte unveränderte Abschnitte

• Der Viewer kann Zeilen wie N unmodified lines anzeigen.
• Erweiterungssteuerelemente in diesen Zeilen sind bedingt und nicht für jede Eingabeart garantiert.
• Erweiterungssteuerelemente erscheinen, wenn der gerenderte Diff erweiterbare Kontextdaten enthält, was typisch für Vorher- und Nachher-Eingaben ist.
• Bei vielen Unified-Patch-Eingaben sind ausgelassene Kontextkörper in den geparsten Patch-Hunks nicht verfügbar, sodass die Zeile ohne Erweiterungssteuerelemente erscheinen kann. Dieses Verhalten ist erwartet.
• expandUnchanged gilt nur, wenn erweiterbarer Kontext vorhanden ist.

Plugin-Standardeinstellungen

Legen Sie Plugin-weite Standardeinstellungen in ~/.openclaw/openclaw.json fest:

{  plugins: {    entries: {      diffs: {        enabled: true,        config: {          defaults: {            fontFamily: "Fira Code",            fontSize: 15,            lineSpacing: 1.6,            layout: "unified",            showLineNumbers: true,            diffIndicators: "bars",            wordWrap: true,            background: true,            theme: "dark",            fileFormat: "png",            fileQuality: "standard",            fileScale: 2,            fileMaxWidth: 960,            mode: "both",            ttlSeconds: 21600,          },        },      },    },  },}

Unterstützte Standardeinstellungen:

• fontFamily
• fontSize
• lineSpacing
• layout
• showLineNumbers
• diffIndicators
• wordWrap
• background
• theme
• fileFormat
• fileQuality
• fileScale
• fileMaxWidth
• mode
• ttlSeconds

Explizite Tool-Parameter überschreiben diese Standardeinstellungen.

Konfiguration persistenter Viewer-URLs

{  plugins: {    entries: {      diffs: {        enabled: true,        config: {          viewerBaseUrl: "https://gateway.example.com/openclaw",        },      },    },  },}

Sicherheitskonfiguration

{  plugins: {    entries: {      diffs: {        enabled: true,        config: {          security: {            allowRemoteViewer: false,          },        },      },    },  },}

Artefaktlebenszyklus und Speicherung

• Artefakte werden im temporären Unterordner gespeichert: $TMPDIR/openclaw-diffs.
• Viewer-Artefaktmetadaten enthalten:
  • zufällige Artefakt-ID (20 Hex-Zeichen)
  • zufälliges Token (48 Hex-Zeichen)
  • createdAt und expiresAt
  • gespeicherter viewer.html-Pfad
• Die Standard-TTL für Artefakte beträgt 30 Minuten, wenn nichts angegeben ist.
• Die maximal akzeptierte Viewer-TTL beträgt 6 Stunden.
• Die Bereinigung läuft opportunistisch nach der Artefakterstellung.
• Abgelaufene Artefakte werden gelöscht.
• Die Fallback-Bereinigung entfernt veraltete Ordner, die älter als 24 Stunden sind, wenn Metadaten fehlen.

Viewer-URL und Netzwerkverhalten

Viewer-Route:

• /plugins/diffs/view/{artifactId}/{token}

Viewer-Assets:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js, wenn das Diff eine Sprache aus dem Diff Viewer Language Pack verwendet

Das Viewer-Dokument löst diese Assets relativ zur Viewer-URL auf, sodass ein optionales baseUrl-Pfadpräfix auch für beide Asset-Anfragen beibehalten wird.

Verhalten bei der URL-Erstellung:

• Wenn beim Tool-Aufruf baseUrl angegeben ist, wird es nach strenger Validierung verwendet.
• Andernfalls wird, wenn im Plugin viewerBaseUrl konfiguriert ist, dieser Wert verwendet.
• Ohne eine der beiden Überschreibungen verwendet die Viewer-URL standardmäßig die Loopback-Adresse 127.0.0.1.
• Wenn der Gateway-Bind-Modus custom ist und gateway.customBindHost gesetzt ist, wird dieser Host verwendet.

baseUrl-Regeln:

• Muss http:// oder https:// sein.
• Query und Hash werden abgelehnt.
• Origin plus optionaler Basispfad ist erlaubt.

Sicherheitsmodell

Browseranforderungen für den Dateimodus

mode: "file" und mode: "both" benötigen einen Chromium-kompatiblen Browser.

Auflösungsreihenfolge:

Häufiger Fehlertext:

• Diff PNG/PDF rendering requires a Chromium-compatible browser...

Beheben Sie dies, indem Sie Chrome, Chromium, Edge oder Brave installieren oder eine der oben genannten Optionen für den ausführbaren Pfad setzen.

Fehlerbehebung

Operative Leitlinien

• Bevorzugen Sie mode: "view" für lokale interaktive Reviews im Canvas.
• Bevorzugen Sie mode: "file" für ausgehende Chat-Kanäle, die einen Anhang benötigen.
• Lassen Sie allowRemoteViewer deaktiviert, sofern Ihre Bereitstellung keine Remote-Viewer-URLs erfordert.
• Setzen Sie explizite kurze ttlSeconds für sensible Diffs.
• Vermeiden Sie es, Secrets in Diff-Eingaben zu senden, wenn dies nicht erforderlich ist.
• Wenn Ihr Kanal Bilder stark komprimiert (zum Beispiel Telegram oder WhatsApp), bevorzugen Sie die PDF-Ausgabe (fileFormat: "pdf").

Verwandt

• Browser
• Plugins
• Tools-Übersicht