Verschillen

diffs is een optionele plugintool met korte ingebouwde systeeminstructies en een begeleidende skill die wijzigingsinhoud omzet in een read-only diff-artefact voor agents.

De tool accepteert een van beide:

• before- en after-tekst
• een unified patch

De tool kan het volgende retourneren:

• een Gateway-viewer-URL voor canvaspresentatie
• een gerenderd bestandspad (PNG of PDF) voor berichtbezorging
• beide outputs in één aanroep

Wanneer ingeschakeld, voegt de Plugin beknopte gebruiksinstructies toe aan de systeempromptruimte en biedt ook een gedetailleerde skill voor gevallen waarin de agent uitgebreidere instructies nodig heeft.

Snelstart

openclaw plugins install diffs

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

Ingebouwde systeeminstructies uitschakelen

Als je de diffs-tool ingeschakeld wilt houden maar de ingebouwde systeemprompt-instructies wilt uitschakelen, stel je plugins.entries.diffs.hooks.allowPromptInjection in op false:

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

Dit blokkeert de before_prompt_build-hook van de diffs-Plugin, terwijl de Plugin, tool en begeleidende skill beschikbaar blijven.

Als je zowel de instructies als de tool wilt uitschakelen, schakel dan de Plugin zelf uit.

Typische agentworkflow

Invoervoorbeelden

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

Referentie voor toolinvoer

Alle velden zijn optioneel, tenzij anders vermeld.

Syntaxismarkering

OpenClaw bevat syntaxismarkering voor gangbare broncode-, configuratie- en documentatietalen:

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 en toml.

Gangbare aliassen zoals js, ts, bash, md, yml, c++, dockerfile, rb, kt en ps1 worden genormaliseerd naar die standaardtalen.

Installeer de Diff Viewer Language Pack-plugin om andere talen te highlighten:

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

Als het language pack beschikbaar is, kan OpenClaw veel meer talen highlighten. Als het pack niet is geinstalleerd, worden bestanden buiten de standaardlijst nog steeds weergegeven als leesbare platte tekst. Voorbeelden zijn 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 en diff-bestanden.

Zie Diffs Language Pack-plugin voor details en Shiki-talen voor Shiki's upstream taal- en aliascatalogus.

Contract voor uitvoerdetails

De tool retourneert gestructureerde metadata onder details.

Samenvatting van modusgedrag:

Samengevouwen ongewijzigde secties

• De viewer kan rijen tonen zoals N unmodified lines.
• Uitklapknoppen op die rijen zijn voorwaardelijk en niet gegarandeerd voor elk inputtype.
• Uitklapknoppen verschijnen wanneer de gerenderde diff uitbreidbare contextgegevens heeft, wat typisch is voor invoer voor en na.
• Voor veel unified patch-invoer zijn weggelaten contextgedeelten niet beschikbaar in de geparsete patch-hunks, dus de rij kan zonder uitklapknoppen verschijnen. Dit is verwacht gedrag.
• expandUnchanged is alleen van toepassing wanneer uitbreidbare context bestaat.

Plugin-standaardwaarden

Stel Plugin-brede standaardwaarden in ~/.openclaw/openclaw.json in:

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

Ondersteunde standaardwaarden:

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

Expliciete toolparameters overschrijven deze standaardwaarden.

Configuratie voor permanente viewer-URL

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

Beveiligingsconfiguratie

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

Artifact-levenscyclus en opslag

• Artefacten worden opgeslagen onder de tijdelijke submap: $TMPDIR/openclaw-diffs.
• Metadata van viewer-artefacten bevat:
  • willekeurige artefact-ID (20 hex-tekens)
  • willekeurig token (48 hex-tekens)
  • createdAt en expiresAt
  • opgeslagen pad naar viewer.html
• De standaard-TTL voor artefacten is 30 minuten wanneer deze niet is opgegeven.
• De maximaal geaccepteerde viewer-TTL is 6 uur.
• Opschoning wordt opportunistisch uitgevoerd na het maken van artefacten.
• Verlopen artefacten worden verwijderd.
• Fallback-opschoning verwijdert verouderde mappen ouder dan 24 uur wanneer metadata ontbreekt.

Viewer-URL en netwerkgedrag

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 wanneer de diff een taal uit het Diff Viewer Language Pack gebruikt

Het viewer-document lost die assets op relatief aan de viewer-URL, zodat een optioneel baseUrl-padprefix ook voor beide asset-aanvragen behouden blijft.

Gedrag voor URL-opbouw:

• Als tool-aanroep baseUrl is opgegeven, wordt deze gebruikt na strikte validatie.
• Anders, als Plugin viewerBaseUrl is geconfigureerd, wordt deze gebruikt.
• Zonder een van beide overrides gebruikt de viewer-URL standaard loopback 127.0.0.1.
• Als de Gateway-bindmodus custom is en gateway.customBindHost is ingesteld, wordt die host gebruikt.

baseUrl-regels:

• Moet http:// of https:// zijn.
• Query en hash worden geweigerd.
• Origin plus optioneel basispad is toegestaan.

Beveiligingsmodel

Browservereisten voor bestandsmodus

mode: "file" en mode: "both" hebben een Chromium-compatibele browser nodig.

Volgorde van oplossing:

Veelvoorkomende fouttekst:

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

Los dit op door Chrome, Chromium, Edge of Brave te installeren, of door een van de opties voor uitvoerbaar pad hierboven in te stellen.

Probleemoplossing

Operationele richtlijnen

• Geef de voorkeur aan mode: "view" voor lokale interactieve reviews in canvas.
• Geef de voorkeur aan mode: "file" voor uitgaande chatkanalen die een bijlage nodig hebben.
• Laat allowRemoteViewer uitgeschakeld tenzij je deployment externe viewer-URL's vereist.
• Stel expliciete korte ttlSeconds in voor gevoelige diffs.
• Vermijd het verzenden van geheimen in diff-invoer wanneer dit niet vereist is.
• Als je kanaal afbeeldingen agressief comprimeert (bijvoorbeeld Telegram of WhatsApp), geef dan de voorkeur aan PDF-uitvoer (fileFormat: "pdf").

Gerelateerd

• Browser
• Plugins
• Tools-overzicht