mcpField
M
memory-qdrant

memory-qdrant

github.com/zuiho-kaiエージェントワークフロー851 回インストール36 週間前に更新
リポジトリ

memory-qdrant について

memory-qdrant は、Qdrant と Transformers.js の埋め込みを使い、会話をまたいで情報を保存・検索する OpenClaw エージェント向けのローカルメモリプラグインです。メモリ内または永続ストレージを選べ、会話の自動記録は初期状態で無効です。外部 API キーも不要です。

主な機能

  1. 01ローカル埋め込みによるセマンティック検索
  2. 02メモリ内保存と永続保存
  3. 03任意の会話自動記録
  4. 04文脈に応じたメモリの想起
  5. 05メモリの保存、検索、削除ツール

活用シーン

  1. 01会話をまたいだ好みや事実の検索
  2. 02OpenClaw エージェント向けの重要情報の保存
  3. 03不要になったメモリの削除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zuiho-kai/openclaw-memory-qdrant --skill memory-qdrant

インストール後、Claude Code で/memory-qdrantを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
CHANGELOG.md
package.json
openclaw.plugin.json
LICENSE
test-fixes.js
README.md
package-lock.json
index.js

詳細

memory-qdrant

使用する場面：OpenClaw エージェントに、セマンティック検索を使って会話をまたいで情報を記憶・想起させたい場合。

⚠️ プライバシーに関する注意：オプションのautoCapture機能（デフォルトでは無効）でallowPIICaptureを有効にすると、メールアドレスや電話番号などのPIIを取得する可能性があります。プライバシーへの影響を理解したうえで有効にしてください。

QdrantベクトルデータベースとTransformers.jsの埋め込みを利用する、ローカルセマンティックメモリプラグインです。設定は不要で、完全にローカルで動作し、APIキーも必要ありません。

機能

  • Transformers.jsのローカル埋め込みによるセマンティック検索
  • インメモリモード（設定不要）または永続化可能なQdrantストレージ
  • 会話コンテキストの自動取得（オプトイン、デフォルトでは無効）
  • コンテキストを考慮したメモリの想起
  • 完全にローカルで動作し、APIキーや外部サービスは不要

インストール

clawhub install memory-qdrant

**初回セットアップ：**このプラグインは初回起動時にHugging Faceから25MBの埋め込みモデルをダウンロードします。また、ネイティブ依存関係（sharp、onnxruntime）用のビルドツールが必要になる場合があります。詳しいインストール要件はREADMEを参照してください。

設定

OpenClawの設定で有効にします。

{
  "plugins": {
    "memory-qdrant": {
      "enabled": true
    }
  }
}

オプション：

  • persistToDisk（デフォルト：true）- インメモリモードでメモリをディスクに保存します。データは~/.openclaw-memory/に保存され、再起動後も保持されます。揮発性メモリにするにはfalseに設定します。
  • storagePath（任意）- カスタムの保存ディレクトリです。デフォルトの~/.openclaw-memory/を使用する場合は空欄のままにします。
  • autoCapture（デフォルト：false）- 会話を自動記録します。デフォルトでプライバシー保護が有効です：PII（メールアドレス、電話番号）を含むテキストは自動的にスキップされます。
  • allowPIICapture（デフォルト：false）- autoCaptureが有効な場合にPIIの取得を許可します。プライバシーへの影響を理解したうえでのみ有効にしてください。
  • autoRecall（デフォルト：true）- 関連するメモリを自動的に挿入します
  • qdrantUrl（任意）- 外部Qdrantサーバーです（インメモリモードを使う場合は空欄のままにします）

使用方法

3つのツールを使用できます。

memory_store - 情報を保存します

memory_store({
  text: "User prefers Opus for complex tasks",
  category: "preference"
})

memory_search - 関連するメモリを検索します

memory_search({
  query: "workflow preferences",
  limit: 5
})

memory_forget - メモリを削除します

memory_forget({ memoryId: "uuid" })
// or
memory_forget({ query: "text to forget" })

プライバシーとセキュリティ

  • ディスクへの永続化（デフォルト）：メモリは~/.openclaw-memory/に保存され、再起動後も保持されます。揮発性メモリにするにはpersistToDisk: falseを設定します。
  • インメモリモード：persistToDisk: falseの場合、データは再起動時に消去されます
  • Qdrantモード：データは設定済みサーバーに送信されます（信頼できるサーバーのみ使用してください）
  • ネットワーク：初回起動時にHugging Faceから約25MBのモデルをダウンロードします
  • PII保護：デフォルトでは、autoCaptureはメールアドレスや電話番号を含むテキストをスキップします。プライバシーへの影響を理解したうえでのみallowPIICapture: trueを設定してください。
  • autoCapture：プライバシー保護のため、デフォルトでは無効です。有効にすると、セマンティックトリガー（好み、決定、事実）に一致するテキストのみを取得し、明示的に許可されない限りPIIをスキップします。

技術詳細

  • ベクトルDB：Qdrant（インメモリまたは外部）
  • 埋め込み：Xenova/all-MiniLM-L6-v2（ローカル）
  • モジュール：ファクトリー関数パターンを使用するES6

リンク

コメント

Markdown 対応