OpenClawSkills
GitHub
リファレンス • 5分で読める

トランスクリプト衛生

参考:プロバイダー固有のトランスクリプトサニタイゼーションと修復ルール

このドキュメントは、実行前にトランスクリプトに適用されるプロバイダー固有の修正について説明します

(building model context). These are in-memory adjustments used to satisfy strict

プロバイダーの要件を満たすために使用されるメモリ内の調整です。これらはディスクに保存された JSONL トランスクリプトを書き換えることはありません。

範囲には以下が含まれます:

- ツール呼び出し ID のサニタイゼーション

- ツール結果のペアリング修復

- ターンの検証/順序付け

- 思考署名のクリーンアップ

- 画像ペイロードのサニタイゼーション

トランスクリプトストレージの詳細が必要な場合は、以下を参照してください:

- ''/reference/session-management-compaction''

Tutorial.step

グローバルルール:画像のサニタイゼーション

画像ペイロードは常にサイズによる

プロバイダー側の拒否を防ぐためにサニタイズされます(過大な base64 画像のダウンスケール/再圧縮)。

Implementation:

- ''sanitizeSessionMessagesImages'' は ''src/agents/pi-embedded-helpers/images.ts'' にあります

- ''sanitizeContentBlocksImages'' は ''src/agents/tool-images.ts'' にあります

Tutorial.step

過去の動作(2026.1.22 以前)

2026.1.22 リリース以前、OpenClaw は複数のレイヤーのトランスクリプト衛生を適用していました:

- トランスクリプトサニタイズ拡張機能がすべてのコンテキストビルドで実行され、以下を行うことができました:

- ツール使用/結果のペアリングを修復。

- ツール呼び出し ID をサニタイズ(''_''/''-'' を保持する非厳密モードを含む)。

- ランナーもプロバイダー固有のサニタイゼーションを実行し、作業が重複していました。

- プロバイダーポリシーの外で追加の変異が発生しました。これには以下が含まれます:

- Stripping ''<final>'' tags from assistant text before persistence.

- 空のアシスタントエラーターンを削除。

この複雑さにより、クロスプロバイダーの回帰(特に ''openai-responses'' ''call_id|fc_id'' ペアリング)が発生しました。2026.1.22 のクリーンアップで拡張機能が削除され、ランナーでロジックが集中化され、OpenAI は画像サニタイゼーションを除いて''ノータッチ''になりました。