2026-07-31T23:43:22.763Z
OpenClaw MEMORY.md がありません: 最初に失敗したレイヤーを診断します
OpenClaw メモリを修復する前の個別のワークスペース ドリフト、ファイルの不在、プライベート セッション スコープ、ブートストラップの切り捨て、および古い検索。
もし OpenClaw 言う MEMORY.md が見つからない場合は、どのワークスペースとセッションが症状を引き起こしたかを知るまで、ファイルを作成または復元しないでください。信頼できる最短の診断は次のとおりです。 1. 影響を受けるエージェントのアクティブなワークスペースを特定します。 2. それを証明する MEMORY.md はそのワークスペース内の通常のファイルです。 3. セッションがプライベート長期メモリのロードを許可されていることを確認します。 4. 欠落しているブートストラップ マーカーと、切り取られた注入されたコピーを区別します。 5. ブートストラップ チェックに合格した後にのみ、検索の鮮度をテストします。 これらのチェックはさまざまな質問に答えます。インデックスを再作成しても、間違ったワークスペースを修復することはできません。ファイルを再作成しても、意図的な共有セッションの除外を修正することはできません。プロンプト バジェットを増やしても、ディスク上に存在しないファイルを復元することはできません。 OpenClawの現在のドキュメントでは、その境界が異常に明確になっています。ワークスペース内のマークダウン ファイルは永続的なソースであり、 MEMORY.md セッション開始時に読み込まれ、詳細が表示される厳選された長期レイヤーです memory/YYYY MM DD.md メモはターンごとに注入されるのではなく、記憶ツールを通じて取得されます。そのデザインは、「欠落」という複数の正当な意味を生み出します。 まずどのワークスペースがアクティブであるかを証明します OpenClawのデフォルトのワークスペースは通常、 ~/.openclaw/workspace , しかし、それは単なるデフォルトです。プロファイルは接尾辞付きのワークスペースを選択できます。 OPENCLAW WORKSPACE DIR デフォルトをオーバーライドでき、デフォルト以外のエージェントは独自に構成されたワークスペースを持つことができます。古いディレクトリまたは兄弟ディレクトリ内のファイルは実際のものですが、別のディレクトリを使用するセッションとは無関係です。 シェルの現在のディレクトリから値を推測するのではなく、ランタイムに解決された値を要求します。 その出力から影響を受けるエージェントを選択します。次に、コンテンツではなくメタデータを検査します。 macOS では、使用します stat f 'type=%HT bytes=%z modified=%Sm' その代わり。ローカル オペレーターの証拠に正確なプライベート パスを保存します。エクスポートされた健康レシートには、不透明なワークスペース ID のみが必要です。 activeWorkspaceMatches , fileExists , regularFile 、バイト数、および変更時間。 順序は重要です: アクティブなワークスペースは検査されたパスと一致しません: 分類 WRONG WORKSPACE 。エージェントまたはプロファイル構成を修復するか、両方のコピーを確認した後でファイルを意図的に移行します。どちらのワークスペースもサイレントに上書きしないでください。 アクティブなパスは一致しますが、ファイルがありません: 分類 MISSING ON DISK 。このエージェントが実際に厳選された長期記憶を必要とするかどうかを判断します。 MEMORY.md はオプションです。 openclaw setup workspace <path 既存のファイルを上書きせずに、不足しているデフォルトをシードできます。 パスは存在しますが、対象となる通常のファイルではありません: 分類 UNSUPPORTED FILE TYPE 。これは特にサンドボックス シードに関連します。現在のワークスペースのドキュメントには、サンドボックス シード コピーは通常のワークスペース内ファイルを受け入れ、ソース ワークスペースの外で解決されるシンボリックリンクまたはハードリンク エイリアスは無視されると記載されています。 このファイルはアクティブなワークスペース内の通常のファイルです。 ストレージ レイヤーが壊れているとは呼びません。セッションスコープに移動し、証拠をブートストラップします。 この最初の段階では、一般的な誤った修復を防ぎます。つまり、もっともらしい修復を見つけます。 MEMORY.md ディスク上のどこかにあり、影響を受けるエージェントがそれを使用すると想定されます。 ファイルが存在していても、1 つのプロンプトに存在しない場合があります。 次の質問は、「シェルはファイルを読み取れるか?」ではありません。それは「何をしたのか」 OpenClaw このセッションのために注射しますか? 影響を受けるセッションでは、次を使用します。 コンテキスト レポートは、生のファイル サイズと挿入されたサイズを区別し、切り捨てを明らかにします。 openclaw doctor ブートストラップの問題を報告することもできます。結果を小さな列挙型として記録します。 present , missing marker , truncated 、 または not loaded —記憶テキストをインシデントチケットにコピーするのではなく。 現在 OpenClaw 行動は 3 つの重要な分岐を生み出します。 マーカーが見つからなくてもクラッシュではありません。 ブートストラップ ファイルが存在しない場合、 OpenClaw 欠落ファイル マーカーを挿入して続行します。このマーカーは、セッション構築時に解決されたワークスペースに関する証拠です。これは、「思い出せない」というエージェントの自然言語による主張よりも強力ですが、それでもファイルが存在しない理由はわかりません。 切り詰められたコピーは、失われたファイルではありません。 OpenClaw ブートストラップ バジェットを超えた場合、挿入されたコピーを切り捨てながら、ファイルをディスク上にそのまま保持します。文書化されたデフォルトは、ファイルあたり 20,000 文字、ブートストラップ ファイル全体で 60,000 文字です。もし /context detail レポートの切り捨て、分類 BOOTSTRAP TRUNCATED 。詳細なマテリアルを次の場所に移動します memory/ .md 、キュレートされたレイヤーを短くするか、即時コストを考慮した後で制限を意図的に引き上げます。ファイルを復元しても何も解決しません。 プライベート メモリは意図的に範囲外にすることができます。 ワークスペースのガイダンスにはロードするように記載されています。 MEMORY.md メインのプライベート セッションのみで、共有コンテキストやグループ コンテキストでは使用できません。ディスク上に存在するが、共有セッションにロードされていないファイルは、 SCOPE EXCLUDED 、不健康ではありません。その境界を変更してチェックを緑色にすると、プライベート コンテキストが漏洩する可能性があります。 実際的なルールは次のとおりです。 この優先順位により、可用性よりもプライバシーが意図的に優先されます。オペレーターは、プライベート永続メモリを挿入して共有セッションを「修復」すべきではありません。 ブートストラップのロードとメモリ検索を別のレーンに維持する MEMORY.md スタートアップインジェクションと memory search それらは関連していますが、同じメカニズムではありません。キュレーションされたファイルは、インデックス付きの取得が古い間、メインセッションのプロンプトに存在する可能性があります。逆に、メモリ検索では、ブートストラップ コピー中に毎日のメモを返すことができます。 MEMORY.md が欠落しているか切り詰められています。 ワークスペース、ファイルの適格性、スコープ、およびブートストラップ インジェクションに合格した後にのみ、次のコマンドを実行する必要があります。 長期記憶からコピーした個人的な文章ではなく、テスト用に作成されたカナリアを使用してください。インデックスが新しいかどうか、およびカナリアの不透明なレコード ID が返されたかどうかを記録します。フレーズをエクスポートしないでください。短い秘密の生のダイジェストも、オフラインで推測される可能性があるため安全ではありません。 次の 2 つの下流分類が役立ちます。 SEARCH STALE : ファイルはロードされましたが、インデックスは保留中またはダーティ状態を報告します。ここではインデックスの再作成が関係します。 RETRIEVAL MISS : インデックスは新しいと主張していますが、既知のカナリアは返されません。ソース カバレッジ、バックエンド構成、クエリ動作を検査します。 どちらの州も交換を正当化するものではない MEMORY.md 。検索修復は、ファイルとブートストラップの健全性が証明された後にのみ開始されます。 歴史的な OpenClaw 問題 9307 これは、レイヤーの結合に関する有用な警告です。 OpenClaw 2026.2.2 3 レポートには両方が含まれています ENOENT メモリ ファイルの読み取りと個別のウォッチャー/検索同期エラー。現在のバージョンに同じバグが存在するという証拠ではありません。 OpenClaw。これは、1 つのインシデントに複数の失敗したレイヤーが含まれる可能性があることを示しています。 本番環境に触れる前に決定を再現する 次の分類子はメモリの内容を使用せず、最初に失敗した層の優先順位をエンコードします。 その正確な優先順位に従って 8 つのフィクスチャをリプレイしました。健全なメイン セッション、欠落したファイル、間違ったワークスペース、拒否されたサンドボックス リンク、共有セッションの除外、切り捨てられたブートストラップ コピー、ダーティ インデックス、およびフレッシュ インデックスのカナリア ミスです。 8 つすべてが予想どおりの分類を生成しました。 この実験により、主要な運用結果が明らかになりました。人は 6 つの非健全な状態を「記憶が欠落している」と表現できますが、それぞれに異なる対応が必要です。 分類後にこの修復マトリックスを使用します。 分類 最小の合理的な行動 検証 WRONG WORKSPACE 選択したエージェント/プロファイルのパスを修正するか、レビューされた移行を実行してください 新しいメイン セッションは、意図した不透明なワークスペース ID を解決します。 MISSING ON DISK 必要な場合にのみ、オプションの厳選されたファイルをシードまたは作成します 新しいセッションのレポート present 単に書き込みコマンドが成功しただけではありません UNSUPPORTED FILE TYPE エイリアスを承認された通常のワークスペース内ファイルに置き換えます サンドボックスとホストのセッションは資格について同意します SCOPE EXCLUDED プライバシーの境界を維持する メインプライベートセッションがそれをロードします。共有セッションはそうではありません BOOTSTRAP LOAD FAILURE 権限、ランタイムビュー、ブートストラップの準備を検査する /context detail ゼロ以外の挿入されたコピーを報告します BOOTSTRAP TRUNCATED プロンプト予算を厳選または意図的に調整する 必要なアクションセンシティブなカナリアが注入された部分に残ります SEARCH STALE アクティブなバックエンドに応じてインデックスを再構築するか待機します インデックスの鮮度およびカナリア取得は両方とも合格 RETRIEVAL MISS ソースカバレッジと取得構成を検査する 同じ境界付きカナリアが不透明 ID によって返されます 「コマンドが成功しました」で停止しないでください。その結果、対象のワークスペース、適格なファイル、正しいスコープ、欠落していないブートストラップ状態、および (検索が必要な場合のみ) 現在のインデックスとカナリア取得を示す新しいセッションの受信が得られます。 制限が 1 つ残っています。この受領書は、意味上の真実ではなく、輸送と可用性を証明するものです。記憶されている決定が正しいか、最新であるか、またはまだ承認されているかを証明することはできません。アクションセンシティブなメモリには、引き続き所有者、スコープ、有効期限、および承認境界が必要です。 どこ Sidewisp 合う これは、AI エージェントの健全性レイヤーが提示すべき証拠契約の種類です。つまり、最初に失敗したレイヤー、影響、新鮮さ、信頼性、最小の安全なアクション、およびアクション後の検証です。アップロードしてはいけません MEMORY.md 、プライベート パスを明らかにするか、予期されるメモリ動作が戻る前にリカバリとして再インデックスを呼び出します。 Sidewisp は現在プライベートプレビュー段階です。 生産監視エンジンと OpenClaw アダプターは現在の Web サイト リポジトリには同梱されていないため、 Sidewisp 現在、この状態の検査や修理は行っておりません。製品の方向性は、既存のランタイムの周囲にヘルス層を追加し、回復に対する人間の権限を維持することです。あなたはできる プライベート プレビューの待機リストに参加する その境界がエージェントの運用方法と一致するかどうか。 一次情報源 OpenClaw メモリの概要 — ファイルの役割、起動時の読み込み、インデックス付きの毎日のメモ、およびブートストラップの切り捨て。 OpenClaw エージェントのワークスペース — ワークスペースの解決、サンドボックス シードの適格性、欠落しているマーカー、迅速な予算、およびプライベート セッションの範囲。 OpenClaw 問題 9307 — 2026.2.2 3 のインシデントの歴史的証拠。そのバージョン境界でのみ保持されます。