
この記事のまとめ
> 💡 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.31M | 85.64M | -61.38% |
| SWE-bench(成功) | 58.4% | 64.2% | +9.93% |
| SWE-bench(トークン) | 3474.1M | 2375.4M | -33.09% |
| AA-LCR(成功) | 44.0% | 47.5% | +7.95% |
| AA-LCR(トークン) | 112.0M | 77.3M | -30.98% |
| PersonaMem(精度) | 48% | 76% | +59% |
特に注目すべきポイント:
- トークン消費が最大61%削減 → そのままコスト削減に直結
- 成功率が最大52%向上 → 過去の経験を活かして賢く行動
- ペルソナ記憶の精度が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
合わせて読みたい
- 【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生成指示を劇的に上手くする方法!コンポーネント用語図鑑の活用法
この記事をシェアする
関連記事

2026年7月19日
【2026年】component.galleryを使ってAIのUI生成指示を劇的に上手くする方法!コンポーネント用語図鑑の活用法

2026年6月15日
【2026年】ChatGPT vs Claude vs Gemini 徹底比較!無料プランから有料まで完全ガイド

2026年6月18日
【2026年最新】無料で使えるAIモデル完全ガイド!Claude Opus 4.8・GPT-5.5・Gemini 2.5 Proを0円で使う8つの方法

2026年6月18日
【2026年】Accio Work完全ガイド!Alibaba提携のAIエージェントが仕入れ・ショップ構築・販売を全部自動化する

2026年6月19日
【2026年】Ollama完全セットアップガイド!ミニPCでローカルAIを動かす方法

2026年6月23日
【2026年】Blueprint.am完全解説!AIが配線図・部品表・組立手順を自動生成する「Claude for Hardware」