【2026年】TencentDB Agent Memory完全ガイド！Hermes Agent用の最強ローカルメモリエンジン

---

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エージェントに必要なのか？

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

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

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

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

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

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

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

---

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

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

どう動くのか？

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

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

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

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

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

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

---

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

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

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ファイルとして直接読めるので：

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

---

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

---

読者が知りたいこと

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

---

合わせて読みたい

• 【2026年】Claude Fable 5で金融資産を守る！AIエージェントによる資産管理・監視・最適化の実践ガイド
• 【2026年】Cloudflare Monetization Gateway完全ガイド！Webページ・API・MCPツールに「1回の課金」をかける方法
• 【2026年】A Fable of Codexes完全ガイド — Claudeが指揮するAIワーカー軍団の作り方
• 【2026年】GPT-Live完全ガイド！OpenAIのフルデュプレックス音声AIがChatGPTを根本から変える
• 【2026年】component.galleryを使ってAIのUI生成指示を劇的に上手くする方法！コンポーネント用語図鑑の活用法