TencentDB エージェントメモリを OpenClaw に接続する方法: ローカル長期メモリ、ログ圧縮、追跡可能な取得

長い OpenClaw タスクがツール呼び出しの複数ラウンドにまたがると、通常 2 つの問題が発生します。コンテキストがログで詰まるか、新しいセッションでプロジェクト規約の再解釈が必要になるかです。 TencentDB エージェントメモリは、OpenClaw にローカルの長期メモリと短期ログ圧縮を提供します。SQLite + sqlite-vec は、長期情報を階層的に編成するためにデフォルトで使用されます。オフロードが有効になると、完全なツール出力が外部ファイルに保存され、合理化されたシンボリック状態のみがコンテキストに挿入されます。【プロジェクト公式倉庫】(https://github.com/TencentCloud/TencentDB-Agent-Memory)

この記事では、OpenClaw アクセスについてのみ説明します。主な目標は、「エージェントにすべてを記憶させる」ことではなく、必要に応じて事実を取得できるようにし、元の会話やツールのログまで大まかな概要を追跡できるようにすることです。

インストール前に 2 つのことを確認してください

現在、OpenClaw は基本的な会話を通常どおり開始および実行できます。まずモデル、権限、またはゲートウェイの問題を解決してから、メモリプラグインを追加します。
ローカルデータのバックアップ場所とアクセス境界を知っています。メモリにはプロジェクトコンテキスト、タスクレコード、ツール出力が含まれる場合があるため、無関係な一時的なキャッシュとして扱うべきではありません。

初めてアクセスする場合は、最初に長期記憶のみを有効にし、リコールが正しいことを確認してからログ圧縮を有効にすることをお勧めします。このようにして、エラーが発生すると、その原因がメモリの抽出、取得、またはオフロード構成のいずれであるかを明確に判断できます。

プラグインをインストールして有効にする

OpenClaw ネイティブプラグインコマンドを使用してインストールします。

1
2


openclaw plugins install @tencentdb-agent-memory/memory-tencentdb
openclaw gateway restart

後続のアップグレードでは、セマンティックバージョン範囲が原因でプラグインが無効になることを避けるために、OpenClaw のプラグイン更新コマンドも使用する必要があります。

1

openclaw plugins update @tencentdb-agent-memory/memory-tencentdb

~/.openclaw/openclaw.json で有効化:

1
2
3
4
5


{
  "memory-tencentdb": {
    "enabled": true
  }
}

公式 README には、デフォルトのバックエンドはローカル SQLite + sqlite-vec であると記載されています。有効にすると、プラグインは会話をキャプチャし、記憶を抽出し、シーンを集約し、ペルソナを生成し、次のラウンドの前にリコールします。メモリ機能のために外部 API を追加で呼び出す必要はありません。

一連の検証可能な事実を使用して長期記憶をテストする

「私のことを覚えていますか？」とただ尋ねないでください。回答とレビュー可能性を備えたテストを受けてください:

1
2
3


第 1 轮：告诉 Agent 当前项目的包管理器、测试命令和一条明确的输出约定。
第 2 轮：让它执行一个与这些约定相关的小任务。
新会话：询问测试命令和输出约定，并要求说明信息来源或不确定项。

標準に合格したということは、より多くの内容を記述したことを意味するのではなく、事実を正確に取得し、許可なく存在しない情報を追加しなかったことを意味します。プロジェクトのコミットメントが変更された場合は、どれが古いかをモデルが自動的に判断することを期待するのではなく、古いメモリを更新または消去する必要があります。

短期ログ圧縮 (オフロード) を有効にする

多くの場合、ツールの出力、検索結果、エラースタックは、長いタスクのトークン肥大化の主な原因となります。プロジェクトのオフロード機能は、圧縮された Mermaid 状態図をコンテキスト内に残したまま、完全なログを外部ファイルに移動します。公式要件では、OpenClaw とプラグインのバージョンが少なくとも 0.3.4 である必要があります。

プラグイン設定で開きます:

1
2
3
4
5
6
7
8
9


{
  "memory-tencentdb": {
    "config": {
      "offload": {
        "enabled": true
      }
    }
  }
}

次に、コンテキストエンジンスロットを登録し、OpenClaw がコンテキストオフロードリクエストをプラグインに引き渡せるようにします。

1
2
3
4
5
6
7


{
  "plugins": {
    "slots": {
      "contextEngine": "memory-tencentdb"
    }
  }
}

最後に、プロジェクトが提供するパッチを実行して、after-tool-call メッセージをアンインストールして復元できるようにします。

1

bash scripts/openclaw-after-tool-call-messages.patch.sh

このパッチは、OpenClaw のインストールごとに 1 回だけ実行する必要があります。 OpenClaw のアップグレード後に再適用する必要があります。

追跡可能な取得の仕組み

ログを圧縮しても、詳細が失われることはありません。 TencentDB Agent Memory の短期リンクは次のとおりです。

1
2
3
4
5


完整工具日志 → refs/*.md
              ↓
步骤摘要 → jsonl 索引
              ↓
Mermaid 状态图（带 node_id）→ 注入 Agent 上下文

エージェントまたはユーザーが結論を検証する必要がある場合、対応する概要と元のログは node_id に沿った Mermaid 状態図から見つけることができます。長期記憶は、同様のドリルダウン関係 Persona → Scenario → Atom → Conversation に従います。したがって、「エージェントが間違って記憶した理由」をトラブルシューティングする場合は、最終的な概要を変更するだけでなく、最初に元の証拠に戻る必要があります。

アクティベーション後に実行する必要がある 3 つの受け入れチェック

長期再現: 新しいセッションでテスト事実を正しく検索し、不確実な項目を認めることができます。
ログトレースバック: マルチツール呼び出しタスクを実行し、圧縮後も node_id を通じて元の出力が見つかることを確認します。
障害保護: ツール呼び出しを意図的に失敗させ、エラーメッセージ、元のログ、および次の回復ラウンドが理解できるかどうかを確認します。

短縮されたコンテキストのみが表示され、元の情報を追跡できない場合は、重要な運用タスクにオフロードを使用しないでください。圧縮の前提は、トークン自体を削減することではなく、回復可能であることです。

構成とデータのセキュリティ境界

デフォルトでローカルストレージを使用しても、セキュリティを無視できるわけではありません。提案:

メモリデータディレクトリを暗号化バックアップおよびリカバリドリルに組み込みます。
長期保存すべきではない会話、ツールログ、ペルソナにキーを入れないでください。
OpenClaw またはプラグインを更新した後、テストセッションを使用して、メモリ抽出、リコール、およびオフロードが低下していないことを確認します。
古いペルソナ、シナリオ、プロジェクトの取り組みを定期的に見直して、古い情報や機密情報を削除します。

Hermes、Docker Gateway、または OpenAI 互換のローカルモデルを同時にデプロイする場合は、[TencentDB エージェントメモリのローカルデプロイメントの概要] (/ja/2026/07/15/tencentdb-agent-memory-local-deployment-ollama-guide/) を参照してください。

よくある質問

プロジェクト契約を有効にした後も忘れてしまった場合、最初にどこを確認すればよいですか?

まず、プラグインが有効になっていること、ゲートウェイが再起動されていることを確認し、実際に新しいセッションにまたがるかどうかをテストします。メモリ抽出のトリガータイミングと格納ディレクトリの権限を確認してください。テストを曖昧にしないでください。検証可能なコマンド、パス、または出力規則を使用してください。

オフロード後に完全なログが表示されないのはなぜですか?

完全なログは、コンテキストを完全に挿入せずに、refs/*.md などの外部ログに保存する必要があります。 node_id と Mermaid ダイアグラムの概要インデックスを元に戻します。ファイルが存在しない、または読み取れない場合は、まずパス、権限、パッチが正しく適用されているかどうかを確認してください。

オフロードを有効にする必要がありますか?

いいえ。短期のタスクまたはデバッグの初期段階では、長期記憶のみを使用できます。ツールの出力が実際にコンテキストの肥大化を引き起こしており、バックリンクが損なわれていないことを確認した場合にのみ、オフロードをオンにします。

概要

TencentDB エージェントメモリにアクセスするための安全なシーケンスは、まず OpenClaw プラグインをインストールして有効にし、検証可能な事実で長期リコールをテストし、次に必要に応じてオフロードをオンにし、コンテキストエンジンを登録し、パッチを適用し、最後に node_id が元のログに戻れるかどうかを確認します。その結果、解釈できない自動要約ではなく、監査可能なローカルメモリシステムが作成されます。