OpenClawプラグインは、Engramサーバーによる永続メモリを追加します。

開発者が、OpenClawエージェントをEngramに接続するTypeScriptプラグインを作成しました。Engramは、構造化された観察データをSQLiteにFTS5全文検索機能付きで保存する、Goベースの軽量メモリサーバーです。これにより、再起動、圧縮、セッション終了後も持続する、エージェントのための長期記憶が実現します。

仕組み

このプラグインは、各エージェントのターン前に受信メッセージを傍受し、キーワードを抽出してEngramを検索し、関連するメモリをプロンプトに自動的に注入します。これは段階的なフォールバック検索を通じて行われます：FTS5はANDロジックを使用するため、システムは何かが一致するまでキーワードを一つずつ削除していきます。結果はBM25関連性でスコアリングされ、プラグインはセッションですでに注入されたものをスキップして、コンテキストの重複を避けます。

エージェントが保存するもの

メモリはチャットのダンプではなく、decision（決定）、bugfix（バグ修正）、config（設定）、procedure（手順）、discovery（発見）、pattern（パターン）などのカテゴリを持つ型付き観察データです。これらはプロジェクトやトピックキーでタグ付けされます。エージェントが既存のメモリと同じtopic_keyを持つものを保存すると、重複を作成する代わりに更新を行い、知識がその場で進化できるようにします。

保存されるものの例には、インフラストラクチャの設定や制約、各環境のサービス認証情報とCLIラッパー、ポート予約とデプロイメントの慣習、繰り返し発生するタスクのためのステップバイステップの手順などが含まれます。

技術的詳細

このプラグインは約750行のTypeScriptで書かれており、エージェントに11のツール、4つのライフサイクルフック、そしてCLIを提供します。OpenClawの組み込みMarkdownメモリと競合しないよう、engram_*名前空間を使用しています。

主な実装の詳細：

• 検索結果を汚染しないよう、検索前にチャネルメタデータ（Mattermost/Telegramのフレーミング、タイムスタンプ）を除去
• ストップワードを削除し、意味のあるキーワードを抽出
• スニペットの長さを動的に調整：1件の結果には詳細を、5件の結果には短い要約を提供
• すべての注入に観察IDを含め、エージェントがengram_getを呼び出して完全な内容を取得できるようにする

セットアップ要件

• Engramのインストール：brew install gentleman-programming/tap/engram またはバイナリを取得
• engram serveを実行（デフォルトポート7437、SQLiteデータベース、設定不要）
• プラグインをクローンし、npmでインストール
• 設定でtools.profile: "full"を設定し、プラグインツールをエージェントから見えるようにする

遭遇した問題と解決策

• FTS5のANDロジック：「kubernetes cluster configuration」を検索すると、1つの単語でもインデックスされていないと何も返されません。段階的なキーワードフォールバックで修正。
• プロンプト内のチャネルメタデータ：Mattermostからのメッセージはフレーミング付きで届き、検索を汚染します。メタデータを最初に除去することで解決。
• エージェントから見えないプラグインツール：OpenClawのtools.profile: "coding"はプラグイン登録ツールを除外します。tools.profile: "full"に設定することで修正。