Moltbrain

🚀 MoltBrain

MoltBrainは、OpenClaw、MoltBook、Claude Code用の長期記憶レイヤーです。自動的にプロジェクトのコンテキストを学習し、思い出すことができます。 $BRAIN CA 0x35e7942E91876Eb0c24A891128E559a744fe8B07

インストール • 機能 • 動作原理 • ストレージ • Virtuals • OpenClaw • 設定 • API

🚀 クイックスタート

╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║   ステップ1    /plugin marketplace add nhevers/moltbrain                ║
║   ステップ2    /plugin install moltbrain                                ║
║                                                                      ║
╚══════════════════════════════════════════════════════════════════════╝

以上です。MoltBrainは自動的に動作を開始します。

✨ 主な機能

+-------------------------+-------------------------+-------------------------+
|                         |                         |                         |
|   観測機能              |   スマート検索          |   Webビューアー         |
|   ----------------      |   ----------------      |   ----------------      |
|   自動的に発見、決定、コードをキャプチャ  |   MCPツールを介した意味検索  |   localhost:37777で履歴を閲覧 |
|                         |                         |                         |
+-------------------------+-------------------------+-------------------------+
|                         |                         |                         |
|   分析機能              |   タグとフィルター      |   お気に入り            |
|   ----------------      |   ----------------      |   ----------------      |
|   トークン、セッション、概念のトレンドを追跡 |   カスタムタグとスマートフィルターで整理 |   最も重要な観測結果をブックマーク |
|                         |                         |                         |
+-------------------------+-------------------------+-------------------------+
|                         |                         |                         |
|   エクスポート機能      |   テーマ設定            |   ショートカット        |
|   ----------------      |   ----------------      |   ----------------      |
|   JSON、CSV、またはカスタムテンプレート付きのMarkdownでエクスポート |   カスタムテーマ付きのダークモードとライトモード |   Webビューアーでのキーボード全操作 |
|                         |                         |                         |
+-------------------------+-------------------------+-------------------------+

🔧 技術詳細

                         ╔═══════════════════════════════════╗
                         ║      CLAUDE CODE SESSION          ║
                         ╚═══════════════╤═══════════════════╝
                                         │
                    ┌────────────────────┼────────────────────┐
                    │                    │                    │
                    ▼                    ▼                    ▼
           ╔════════════════╗   ╔════════════════╗   ╔════════════════╗
           ║  SessionStart  ║   ║  PostToolUse   ║   ║     Stop       ║
           ║────────────────║   ║────────────────║   ║────────────────║
           ║ Inject context ║   ║ Capture output ║   ║ Generate       ║
           ║ from memory    ║   ║ extract facts  ║   ║ summary        ║
           ╚═══════╤════════╝   ╚═══════╤════════╝   ╚═══════╤════════╝
                   │                    │                    │
                   └────────────────────┼────────────────────┘
                                        │
                         ╔══════════════╧══════════════╗
                         ║      WORKER SERVICE         ║
                         ║    http://localhost:37777   ║
                         ╚══════════════╤══════════════╝
                                        │
              ┌─────────────────────────┼─────────────────────────┐
              │                         │                         │
              ▼                         ▼                         ▼
     ╔════════════════╗       ╔════════════════╗       ╔════════════════╗
     ║    SQLite      ║       ║   ChromaDB     ║       ║  Web Viewer    ║
     ║   Database     ║       ║ Vector Search  ║       ║     UI         ║
     ║────────────────║       ║────────────────║       ║────────────────║
     ║ Observations   ║       ║ Semantic       ║       ║ Timeline       ║
     ║ Summaries      ║       ║ similarity     ║       ║ Search         ║
     ║ Sessions       ║       ║ matching       ║       ║ Analytics      ║
     ╚════════════════╝       ╚════════════════╝       ╚════════════════╝

⚙️ 設定

設定は ~/.moltbrain/settings.json に保存されます。

┌──────────────────────────────────────┬─────────┬────────────────────────────┐
│             設定項目                  │ デフォルト値 │        説明         │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_WORKER_PORT                │  37777  │ ワーカーサービスのポート        │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_CONTEXT_OBSERVATIONS       │   50    │ 注入する最大観測結果数 │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_PROVIDER                   │ claude  │ 要約用のAIプロバイダー  │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_PRUNE_DAYS                 │    0    │ 自動削除 (0 = 無効)  │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_THEME                      │ system  │ UIのテーマ (dark/light/sys)  │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_LOG_LEVEL                  │  info   │ ログの詳細度レベル    │
└──────────────────────────────────────┴─────────┴────────────────────────────┘

💻 CLIコマンド

moltbrain stats          # メモリ統計情報を表示
moltbrain export         # Markdown形式でエクスポート  
moltbrain tag <id> <t>   # 観測結果にタグを付ける
moltbrain prune          # 手動でクリーンアップ
moltbrain search <q>     # 観測結果を検索

📁 プロジェクト構造

moltbrain/
│
├── 📊 benchmarks/         パフォーマンステスト
├── 🎨 contrib/            コミュニティモードとテーマ
├── 📚 docs/               ドキュメント
├── 📖 examples/           使用例とガイド
│
├── 🔌 extension/
│   ├── profiles/          観測モード
│   ├── runtime/           ワーカースクリプト
│   ├── themes/            UIのテーマ (dark/light)
│   ├── snippets/          コードスニペット
│   └── templates/         要約テンプレート
│
├── 🌍 locales/            i18n (en, es, fr)
├── 🗄️ migrations/         データベースのマイグレーション
├── 📋 schemas/            JSONの検証スキーマ
├── 🛠️ scripts/            ビルドとユーティリティスクリプト
│
├── 💻 src/
│   ├── analytics/         トークンとセッションのトラッキング
│   ├── cache/             クエリとコンテキストのキャッシュ
│   ├── core/              コアエンジン
│   ├── export/            JSON/CSV/MDのエクスポーター
│   ├── favorites/         ブックマークシステム
│   ├── filters/           日付/タイプ/プロジェクトのフィルター
│   ├── formatters/        出力フォーマッター
│   ├── mcp/               OpenClawとMoltBook用のMCPサーバー
│   ├── shortcuts/         キーボードショートカット
│   ├── themes/            テーマシステム
│   └── validators/        入力検証
│
├── 🦞 integrations/
│   └── clawd/             Clawd拡張機能とスキル
│
├── 📝 templates/          エクスポートテンプレート
├── 🧪 tests/              テストスイート
└── 🔧 tools/              CLIユーティリティ

🔌 API

ワーカーは http://localhost:37777 でREST APIを公開しています。

# ヘルスチェック
curl http://localhost:37777/health

# 観測結果を検索
curl "http://localhost:37777/api/search?q=authentication"

# タイムラインを取得
curl "http://localhost:37777/api/timeline?project=my-app&days=7"

# データをエクスポート
curl "http://localhost:37777/api/export?format=json" > backup.json

# 統計情報を取得
curl "http://localhost:37777/api/stats"

🗄️ ストレージDapp

エージェントとアプリ用の永続的なPostgresベースのストレージです。app.moltbrain.dev/storage で利用できます。

+-----------------------------------------------------------------------------+
|                                                                             |
|   BLOBストレージ      SHA-256を介したコンテンツアドレス指定のJSONブロブ                |
|   ----------         ハッシュでデータを保存し、取得します。リクエストごとに $0.01 の料金がかかります。   |
|                                                                             |
|   メモリスロット      エージェントの状態用の名前付きキーバリュースロット                  |
|   ----------         割り当て、書き込み、読み取りができます。セッションをまたいで永続的です。    |
|                                                                             |
|   エージェントボールト       ラベルバッジ付きのウォレットごとのスコープ                   |
|   ----------         エージェントが使用するのと同じウォレットを接続します。              |
|                      保存されたデータを閲覧、表示、削除できます。            |
|                                                                             |
+-----------------------------------------------------------------------------+

すべてのエンドポイントは x402 マイクロペイメント（Base上の $0.01 USDC）で支払われます。データはウォレットごとにスコープされ、Postgresによってバックアップされ、再デプロイ後も存続します。 エージェントは保存されたデータに label（例： "openclaw_session", "virtuals_agent"）を付けることができ、ボールトにはどのエントリが保存されたかが表示されます。

# ブロブを保存
curl -X POST https://app.moltbrain.dev/api/x402/store \
  -H "X-PAYMENT: <x402_header>" \
  -d '{"data": {"key": "value"}, "label": "my_agent"}'

# ブロブをリスト表示
curl https://app.moltbrain.dev/api/x402/list/blobs \
  -H "X-PAYMENT: <x402_header>"

# フルカタログを取得
curl https://app.moltbrain.dev/api/x402/catalog

🎮 Virtualsプロトコルの統合

Virtuals Protocol のAIエージェントにMoltBrainを介した永続的なメモリとストレージを提供するGAME SDKプラグインです。

npm install @moltbrain/game-plugin

import { GameAgent } from "@virtuals-protocol/game";
import { MoltBrainPlugin } from "@moltbrain/game-plugin";

const moltbrain = new MoltBrainPlugin({
  privateKey: process.env.AGENT_PRIVATE_KEY!, // Base上のUSDCを持つウォレット
});

const agent = new GameAgent(process.env.GAME_API_KEY!, {
  name: "My Agent",
  goal: "Remember everything across sessions",
  description: "An agent with persistent memory via MoltBrain",
  workers: [moltbrain.getWorker()],
});

await agent.init();
await agent.step({ verbose: true });

9つの関数が利用可能です: moltbrain_chat, moltbrain_search, moltbrain_store, moltbrain_retrieve, moltbrain_allocate_slot, moltbrain_write_slot, moltbrain_read_slot, moltbrain_stats, moltbrain_capacity。 エージェントが保存したすべてのデータは、app.moltbrain.dev/storage のボールトDappに表示されます。同じウォレットを接続して閲覧できます。 完全なプラグインリポジトリはこちらを参照してください: github.com/nhevers/Moltbrain-virtuals

🦞 OpenClawの統合

人気のある個人用AIアシスタント OpenClaw（116k以上のスター）と連携します！

+-----------------------------------------------------------------------------+
|                                                                             |
|   拡張機能        OpenClawのextensions/ フォルダに追加                     |
|   ----------       完全なライフサイクルフックの統合                         |
|                                                                             |
|   スキル            OpenClawのスキルとしてインストール                              |
|   ----------       recall_context, search_memories, save_memory ツール       |
|                                                                             |
|   MCPサーバー       プロトコルベースの統合                               |
|   ----------       任意のMCP互換クライアントと連携します                     |
|                                                                             |
+-----------------------------------------------------------------------------+

クイックセットアップ:

# OpenClaw拡張機能として
cd ~/.openclaw/extensions
git clone https://github.com/nhevers/moltbrain.git moltbrain
cd moltbrain/integrations/openclaw
npm install && npm run build

# プラグインを有効にする（バンドルインストールの場合に必要）
pnpm openclaw plugins enable moltbrain

# またはMCP経由
npm run mcp:start

注意: OpenClawの extensions/ ディレクトリにバンドル拡張機能としてインストールする場合は、明示的に有効にする必要があります: pnpm openclaw plugins enable moltbrain 完全なセットアップガイドは integrations/openclaw/README.md を参照してください。

📚 MoltBookの統合

AIエージェント用のソーシャルネットワーク MoltBook と連携します！メモリを共有し、他のエージェントから学び、集団的な知識を構築しましょう。 クイックセットアップ:

# MoltBook MCP統合をインストール
npm install --save @moltbrain/moltbook-mcp

# MoltBrainの設定で構成
{
  "MOLTBRAIN_MOLTBOOK_ENABLED": true,
  "MOLTBRAIN_MOLTBOOK_API_URL": "https://moltbook.com"
}

完全なセットアップガイドは integrations/moltbook/README.md を参照してください。

💻 Claude Codeの統合

プラグインマーケットプレイスを介してClaude Codeと連携します:

/plugin marketplace add nhevers/moltbrain
/plugin install moltbrain

📋 要件

╔══════════════════════════════════════╗
║                                      ║
║   •  Node.js 18+ または  Bun 1.0+      ║
║   •  OpenClaw、MoltBook、またはClaude Code ║
║                                      ║
╚══════════════════════════════════════╝

📄 ライセンス

AGPL-3.0

_{━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━}

OpenClaw、MoltBook、Claude Codeコミュニティのために丁寧に開発されました

アプリ • ストレージDapp • Virtualsプラグイン • x402プロトコル

_{━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━}