差分

diffs は、変更前/変更後のテキストまたは unified patch を読み取り専用の diff アーティファクトに変換する、オプションのバンドル Plugin ツールです。また、短いエージェント向けガイダンスをシステムプロンプトの先頭に追加し、より詳細な手順を示す付属 Skills を提供します。

入力: before + after テキスト、または unified patch（相互排他）。

出力: キャンバス表示用の Gateway ビューアー URL、メッセージ配信用にレンダリングされた PNG/PDF ファイルパス、またはその両方。

クイックスタート

openclaw plugins install diffs

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

組み込みのシステムガイダンスを無効にする

ツールを維持したまま、先頭に追加されるシステムプロンプトのガイダンスを削除するには、plugins.entries.diffs.hooks.allowPromptInjection を false に設定します。

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

これにより、ツールと Skills は引き続き利用可能なまま、Plugin の before_prompt_build フックがブロックされます。ガイダンスとツールの両方を無効にするには、代わりに Plugin を無効にします。

ツール入力リファレンス

特記がない限り、すべてのフィールドは省略可能です。

構文ハイライト

組み込み言語:

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、および toml。

一般的なエイリアス（js、ts、bash、md、yml、c++、dockerfile、rb、kt、ps1 など）は、これらの言語に正規化されます。

より多くの言語（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、diff など）を利用するには、Diff Viewer Language Pack Plugin をインストールします。

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

Language Pack がなくても、未対応の言語は読みやすいプレーンテキストとしてレンダリングされます。アップストリームのカタログについては、Diffs Language Pack PluginおよびShiki の言語を参照してください。

出力詳細の契約

成功したすべての結果には changed が含まれます。同一の変更前/変更後入力の場合は、アーティファクトを作成せずに false を返します。レンダリングされた結果は true を返します。

折りたたまれた未変更セクション

ビューアーには N unmodified lines のような行が表示されます。展開コントロールは、レンダリングされた diff に展開可能なコンテキストデータがある場合（通常は変更前/変更後の入力）にのみ表示されます。多くの unified patch では、ハンク内のコンテキスト本文が省略されるため、展開コントロールなしでこの行が表示されることがあります。これは想定どおりの動作であり、バグではありません。expandUnchanged は、展開可能なコンテキストが存在する場合にのみ適用されます。

複数ファイルのナビゲーション

複数のファイルを変更するパッチでは、先頭に変更ファイルの概要カードが表示されます。これには、合計 +N / -N 件数、ファイルごとの件数、追加/削除/名前変更のバッジ、および各ファイルへ移動するアンカーリンクが含まれます。レンダリングされた PNG/PDF ファイルでは、ファイルごとのヘッダー件数は維持されますが、静的ファイルでは機能しないため、インタラクティブな表示切り替えコントロールは省略されます。

Plugin のデフォルト

Plugin 全体のデフォルトを ~/.openclaw/openclaw.json に設定します。

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

サポートされる defaults キー: fontFamily、fontSize、lineSpacing、layout、showLineNumbers、diffIndicators、wordWrap、background、theme、fileFormat、fileQuality、fileScale、fileMaxWidth、mode、ttlSeconds。明示的なツール呼び出しパラメーターは、これらを上書きします。

永続的なビューアー URL 設定

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

セキュリティ設定

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

アーティファクトのライフサイクルとストレージ

• アーティファクトは $TMPDIR/openclaw-diffs 配下に保存されます。
• ビューアーのメタデータには、ランダムな 20 桁の 16 進文字からなるアーティファクト ID、ランダムな 48 桁の 16 進文字からなるトークン、createdAt/expiresAt、および保存された viewer.html のパスが格納されます。
• デフォルトのアーティファクト TTL: 30 分。受け入れ可能な最大 TTL: 6 時間。
• 各アーティファクト作成呼び出し後にクリーンアップが随時実行され、期限切れのアーティファクトが削除されます。
• メタデータがない場合、フォールバックのスイープによって 24 時間より古いフォルダーが削除されます。

ビューアー URL とネットワーク動作

ビューアールート: /plugins/diffs/view/{artifactId}/{token}

ビューアーアセット:

• /plugins/diffs/assets/viewer.js
• /plugins/diffs/assets/viewer-runtime.js
• /plugins/diffs-language-pack/assets/viewer.js（diff が言語パックの言語を使用する場合のみ）

ビューアードキュメントは、これらのアセットをビューアー URL からの相対パスで解決するため、オプションの baseUrl パスプレフィックスはアセットリクエストにも引き継がれます。

URL の解決順序: ツール呼び出しの baseUrl（厳格な検証後）-> Plugin の viewerBaseUrl -> デフォルトの local loopback 127.0.0.1。Gateway のバインドモードが custom で、gateway.customBindHost が設定されている場合、local loopback の代わりにそのホストが使用されます。

baseUrl のルール: http:// または https:// である必要があります。クエリとハッシュは拒否されます。オリジンとオプションのベースパスの組み合わせが許可されます。

セキュリティモデル

ファイルモードのブラウザー要件

mode: "file" と mode: "both" には Chromium 互換ブラウザーが必要です。

解決順序:

一般的なエラーテキスト：Diff PNG/PDF rendering requires a Chromium-compatible browser...。Chrome、Chromium、Edge、Brave のいずれかをインストールするか、上記の実行可能ファイルパスオプションのいずれかを設定して修正します。

トラブルシューティング

運用ガイダンス

• canvas でのローカルな対話型レビューには、mode: "view" を推奨します。
• 添付ファイルが必要な外部チャットチャンネルには、mode: "file" を推奨します。
• デプロイでリモートビューアー URL が必要な場合を除き、allowRemoteViewer は無効のままにしてください。
• 機密性の高い差分には、明示的に短い ttlSeconds を設定してください。
• 必要でない場合は、差分入力にシークレットを含めないでください。
• チャンネルが画像を強く圧縮する場合（たとえば Telegram や WhatsApp）、PDF 出力（fileFormat: "pdf"）を推奨します。

関連項目

• ブラウザー
• Plugin
• ツールの概要