クラウドナビ
← 記事一覧に戻る
【2026年】TencentDB Agent Memory完全ガイド!Hermes Agent・OpenClawと連携可能な最強ローカル記憶エンジン
AIツール·1分で読了

この記事のまとめ

> 💡 AIエージェントに「人間のような記憶」を与える——それがTencentDB Agent Memoryです。

💡 AIエージェントに「人間のような記憶」を与える——それがTencentDB Agent Memoryです。

2026年5月、腾讯(Tencent/テンセント)が TencentDB Agent Memory をMITライセンスでオープンソース化。瞬く間に GitHub 8.4Kスター を獲得し、AIエージェント業界に衝撃を与えました。

なぜこれほど注目されているのか?

その答えはシンプルです。既存のAIエージェントは 「毎回会話をリセットされるようなもの」 。過去の会話や好みを覚えていないため、同じことを何度も説明する必要がありました。

TencentDB Agent Memoryはこれを解決します。エージェントに 「人のような記憶」 を与え、過去の経験を学習し、再利用できるようにする——それがこのプロジェクトの使命です。

しかも 完全ローカル動作・ゼロ外部API依存・MITライセンス で、しかも Hermes AgentとOpenClawの両方に対応済み という驚きの完成度。

この記事では、その全容を徹底解説します。


🚀 TencentDB Agent Memoryとは?3行で

項目内容
一言でAIエージェントに長期記憶を与えるローカル記憶エンジン
開発元Tencent Cloud(腾讯雲)
ライセンスMIT(完全無料・商用可)
対応エージェントHermes Agent ✅ / OpenClaw ✅
記憶の層4層(L0会話→L1原子→L2シナリオ→L3ペルソナ)
外部API依存ゼロ(完全ローカル動作)
トークン削減効果最大61.38%削減
成功率向上最大51.52%向上(相対値)
バックエンドSQLite + sqlite-vec(ローカル)or TCVDB

🧠 なぜ「記憶」がAIエージェントに必要なのか?

あなたがAIエージェント(Hermes AgentやOpenClaw)を使っているとき、こんな経験はありませんか?

あなた:「このプロジェクトのコーディング規約は〜」
エージェント:「承知しました」
(数時間後)
あなた:「さっきの続きをお願い」
エージェント:「??? どんなのでしたっけ?」

これが、「従来のAIエージェントの限界」 です。

ほとんどのエージェントは セッションが切れると記憶がリセット されるため、

  • 同じSOP(作業手順)を何度も説明する
  • プロジェクトの背景を毎回ゼロから説明する
  • ユーザーの好みや設定を覚えていない

という無駄が発生します。

TencentDB Agent Memoryはこれを解決します。


🏗️ 4層の階層記憶アーキテクチャ

TencentDB Agent Memoryの最大の特徴は 「フラットなベクトル検索」ではなく「階層的な記憶構造」 を採用していること。

名前内容保存形式
L0会話(Conversation)生の会話ログ・ツールの出力そのままデータベース
L1原子(Atom)会話から抽出した「単一の事実」データベース
L2シナリオ(Scenario)複数の原子から構成される「場面ブロック」Markdownファイル
L3ペルソナ(Persona)ユーザーの日々の好み・長期的な目標Markdown(persona.md)

どう動くのか?

記憶は 「上から下へ」「下から上へ」 の双方向で機能します。

記憶の形成(ボトムアップ):
  会話ログ → 事実の抽出 → シナリオの構成 → ペルソナの生成

記憶の想起(トップダウン):
  ペルソナ(ユーザーの好み)→ シナリオ(場面)→ 原子(詳細事実)

従来のフラットな記憶システムとの違い:

従来:「会話を全部チャンクに分割→ベクトルDBに突っ込む→類似検索」 → 文脈がバラバラで、「なぜこの記憶が出てきたか」が不明

TencentDB:「階層構造で保持→トップダウンで必要な詳細にドリルダウン」 → 記憶に「理由」があり、追跡可能(ホワイトボックス)


📊 性能データ:トークン61%削減・成功率52%向上

評価項目OpenClaw単体Agent Memory連携改善率
WideSearch(成功)33%50%+51.52%
WideSearch(トークン)221.31M85.64M-61.38%
SWE-bench(成功)58.4%64.2%+9.93%
SWE-bench(トークン)3474.1M2375.4M-33.09%
AA-LCR(成功)44.0%47.5%+7.95%
AA-LCR(トークン)112.0M77.3M-30.98%
PersonaMem(精度)48%76%+59%

特に注目すべきポイント:

  1. トークン消費が最大61%削減 → そのままコスト削減に直結
  2. 成功率が最大52%向上 → 過去の経験を活かして賢く行動
  3. ペルソナ記憶の精度が48%→76% → ユーザーの好みを正確に学習

これらの結果は 「単発のタスク」ではなく「連続した50タスクのセッション」 で測定されたもの。現実の長期運用に近い環境での数値です。


🔧 Hermes Agentとの連携方法

これが最大のポイントです。

TencentDB Agent Memoryには Hermes Agent用のプラグインが公式に用意されています。 セットアップ方法は2通り。

方法A:Dockerで一発セットアップ(最も簡単)

# 1. リポジトリをクローン
git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git
cd TencentDB-Agent-Memory/docker/opensource

# 2. Dockerイメージをビルド
docker build -f Dockerfile.hermes -t hermes-memory .

# 3. 実行(APIキーを設定)
MODEL_API_KEY="sk-your-key-here"
docker run -d \
  --name hermes-memory \
  --restart unless-stopped \
  -p 8420:8420 \
  -e MODEL_API_KEY="$MODEL_API_KEY" \
  -e MODEL_BASE_URL="https://api.openai.com/v1" \
  -e MODEL_NAME="gpt-4o" \
  -e MODEL_PROVIDER="custom" \
  -v hermes_data:/opt/data \
  hermes-memory

# 4. 動作確認
curl http://localhost:8420/health

# 5. Hermesにログイン
docker exec -it hermes-memory hermes

たったこれだけ。 Hermes Agentに記憶機能が追加されます。

方法B:既存のHermesに後付け(Docker不要)

すでにHermes Agentを動かしている方向け:

# 1. プラグインをインストール
mkdir -p ~/.memory-tencentdb
cd /tmp && npm init -y --silent
npm install @tencentdb-agent-memory/memory-tencentdb@latest --omit=dev
cp -r node_modules/@tencentdb-agent-memory/memory-tencentdb \
      ~/.memory-tencentdb/tdai-memory-openclaw-plugin

# 2. 依存関係をインストール
cd ~/.memory-tencentdb/tdai-memory-openclaw-plugin
npm install --omit=dev
npm install tsx

# 3. Hermesプラグインディレクトリにシンボリックリンク
ln -sf ~/.memory-tencentdb/tdai-memory-openclaw-plugin/hermes-plugin/memory/memory_tencentdb \
       ~/.hermes/hermes-agent/plugins/memory/memory_tencentdb

# 4. config.yamlにプロバイダを追加
# ~/.hermes/config.yaml に以下を追記:
# memory:
#   provider: memory_tencentdb

# 5. .envにGateway設定を追加
# ~/.hermes/.env に以下を追記:
# MEMORY_TENCENTDB_GATEWAY_CMD="sh -c 'cd ~/.memory-tencentdb/tdai-memory-openclaw-plugin && exec npx tsx src/gateway/server.ts'"
# MEMORY_TENCENTDB_GATEWAY_HOST="127.0.0.1"
# MEMORY_TENCENTDB_GATEWAY_PORT="8420"
# TDAI_LLM_API_KEY="sk-your-key"
# TDAI_LLM_BASE_URL="https://api.openai.com/v1"
# TDAI_LLM_MODEL="gpt-4o"

初回会話時にGatewayが自動起動 するので、あとは普通にHermesを使うだけ。記憶は自動的に管理されます。


🔧 OpenClawとの連携方法

OpenClawを使っている場合は、さらに簡単。

# 1. プラグインをインストール
openclaw plugins install @tencentdb-agent-memory/memory-tencentdb
openclaw gateway restart

# 2. 設定ファイルで有効化
# ~/.openclaw/openclaw.json に以下を追記:
# {
#   "memory-tencentdb": {
#     "enabled": true
#   }
# }

設定はたったこれだけ。 OpenClawが自動で会話のキャプチャ・記憶抽出・呼び出しを行います。


🎯 これで何ができるようになるのか?

TencentDB Agent Memoryを導入すると、AIエージェントが以下のことを自動的に行えるようになります。

① あなたの仕事の流儀を学習する

例:
1日目:「このプロジェクトはPython 3.12、FastAPI使ってね」
エージェント:記憶に保存
3日目:「新しいAPIエンドポイントを作って」
エージェント:自動的にPython 3.12 + FastAPIを使う
→ わざわざ説明し直す必要なし

② 過去のバグ修正を再利用する

例:
先週:「ログイン画面のバリデーションエラーを修正して」
→ 修正手順が記憶に保存
今週:「同じようなエラーが別の画面で出てる」
エージェント:「先週の修正パターンを適用します」
→ 同じ轍を踏まない

③ 長期間のプロジェクトでも文脈を維持

TencentDBの特筆すべき点は 「短期記憶(セッション内)+長期記憶(セッション間)」 の両方をカバーしていること。

  • 短期記憶:1回の長いタスク内で、大量のログをMermaid記法で圧縮
  • 長期記憶:昨日の会話・先週の決定・あなたの好みを覚えている

④ 記憶の「ホワイトボックス」デバッグ

ほとんどの記憶システムは 「ブラックボックス」 ですが、TencentDBは違います。

保存された記憶は Markdownファイルとして直接読める ので:

  • エージェントが何を「覚えたか」確認できる
  • 間違った記憶を手動で修正できる
  • 記憶のエクスポート・インポートも可能

🏆 なぜこれが凄いのか?既存技術との比較

比較項目TencentDB Agent Memory従来のベクトル記憶
記憶構造4層の階層構造フラットなチャンク
検索方式BM25 + ベクトル + RRF(ハイブリッド)ベクトル類似度のみ
トレーサビリティ完全追跡可能(ホワイトボックス)不可(ブラックボックス)
圧縮方式可逆圧縮(元の証拠にドリルダウン可能)非可逆圧縮が多い
保存形式Markdown + データベース(人が読める)ベクトルの数値のみ
外部API依存ゼロEmbedding API依存が多い
Hermes連携公式サポート済み未対応
OpenClaw連携公式サポート済み要カスタム実装

❓ よくある質問

❗ Hermes AgentとOpenClawの両方で使えるの?

はい。 TencentDB Agent Memoryは両方に対応しています。プラグインインストール後の設定方法が少し異なるだけで、同じ記憶エンジンが動作します。

❗ 外部のAPIキーは必要?

いいえ。 記憶の保存・検索はすべてローカルで完結します。ただし、記憶を抽出するためのLLM呼び出しにはAPIキーが必要です(お使いのモデル用のキー)。

❗ 他のエージェント(Claude Code / Codex)でも使える?

→ v1.0.0-beta.1から独立したHTTPサービスとして動作するため、RESTful API経由で任意のエージェントから呼び出せます。 今後対応エージェントが増えることが期待されます。

❗ 日本語は大丈夫?

問題ありません。 マルチリンガル対応。日本語の会話も正確に記憶・抽出できます。

❗ ストレージはどれくらい使う?

→ 使用量は会話量に依存しますが、圧縮率が高いのでテキストベースのデータベースとしては軽量です。数百万トークンの会話でも数十MB程度。

❗ プライバシーは?

完全ローカル動作なので、データが外部に出ることはありません。 すべてあなたのデバイス上で保存・処理されます。


📋 まとめ

TencentDB Agent Memoryは「AIエージェントに人間のような記憶を与える」オープンソースエンジンです。

  • ✅ トークン消費 最大61%削減 → コスト削減に直結
  • ✅ タスク成功率 最大52%向上 → 賢いエージェントに
  • Hermes Agent & OpenClaw 公式対応
  • ✅ MITライセンスで完全無料・商用利用可
  • ✅ 完全ローカル動作でプライバシー安全
  • ✅ 記憶の中身をMarkdownファイルとして直接確認可能

「エージェントが成長する」——これを現実にするのがTencentDB Agent Memoryです。

👉 GitHubリポジトリ: github.com/TencentCloud/TencentDB-Agent-Memory 👉 Tencent Cloud開発者記事: cloud.tencent.com/developer/article/2668579 👉 MarkTechPost解説: marktechpost.com


合わせて読みたい