差分

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

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

出力: canvas 表示用の 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,        },      },    },  },}

これにより、ツールと skill を利用可能な状態に保ちながら、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

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

出力詳細のコントラクト

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

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

ビューアーには N unmodified lines のような行が表示されます。展開コントロールは、レンダリングされた差分に展開可能なコンテキストデータがある場合にのみ表示されます（通常は変更前/変更後の入力）。多くの 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,          },        },      },    },  },}

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

• ビューアーの HTML とメタデータは、Diffs Plugin の blob 名前空間にある共有 state/openclaw.sqlite データベース内に保存されます。HTML は gzip 圧縮されます。SQLite に保存されるのはランダムな URL トークンの SHA-256 ハッシュのみで、トークン自体は保存されません。
• レンダリングされた PNG/PDF ファイルは、チャンネル配信にファイルパスが必要なため、$TMPDIR/openclaw-diffs 配下に一時的な実体として残ります。有効期限のメタデータは SQLite が管理し、JSON サイドカーは書き込まれません。
• デフォルトの成果物 TTL: 30 分。受け入れ可能な最大 TTL: 6 時間。
• クリーンアップは、成果物を作成する各呼び出しの後に随時実行されます。期限切れの SQLite 行が最初に削除され、続いて対応する PNG/PDF ディレクトリが削除されます。
• フォールバックのスイープ処理により、対応する行がなく、24 時間を超えて古い一時フォルダーが削除されます。従来の meta.json、file-meta.json、viewer.html キャッシュはインポートも読み取りもされません。

ビューアー 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 -> loopback のデフォルト 127.0.0.1。Gateway のバインドモードが custom で、gateway.customBindHost が設定されている場合は、loopback の代わりにそのホストが使用されます。

baseUrl のルール: http:// または https:// である必要があります。クエリとハッシュは拒否されます。オリジンにオプションのベースパスを加えた形式が許可されます。

セキュリティモデル

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

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

解決順序:

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

トラブルシューティング

運用ガイダンス

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

関連項目

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