memory-setup

メモリ設定スキル

エージェントを金魚からゾウへと変身させましょう。このスキルは、Moltbot/Clawdbot の永続メモリを設定するのに役立ちます。

クイックセットアップ

1. 設定でメモリ検索を有効にする

~/.clawdbot/clawdbot.json（または moltbot.json）に追加します。

{
  "memorySearch": {
    "enabled": true,
    "provider": "voyage",
    "sources": ["memory", "sessions"],
    "indexMode": "hot",
    "minScore": 0.3,
    "maxResults": 20
  }
}

2. メモリ構造を作成する

ワークスペース内に次の構造を作成します。

workspace/
├── MEMORY.md              # Long-term curated memory
└── memory/
    ├── logs/              # Daily logs (YYYY-MM-DD.md)
    ├── projects/          # Project-specific context
    ├── groups/            # Group chat context
    └── system/            # Preferences, setup notes

3. MEMORY.md を初期化する

ワークスペースのルートに MEMORY.md を作成します。

# MEMORY.md — Long-Term Memory

## About [User Name]
- Key facts, preferences, context

## Active Projects
- Project summaries and status

## Decisions & Lessons
- Important choices made
- Lessons learned

## Preferences
- Communication style
- Tools and workflows

設定オプションの説明

設定	用途	推奨値
enabled	メモリ検索を有効にします	true
provider	埋め込みプロバイダー	"voyage"
sources	インデックス対象	["memory", "sessions"]
indexMode	インデックス作成のタイミング	"hot"（リアルタイム）
minScore	関連性のしきい値	0.3（値を下げると結果が増えます）
maxResults	返されるスニペットの最大数	20

プロバイダーのオプション

• voyage — Voyage AI の埋め込み（推奨）
• openai — OpenAI の埋め込み
• local — ローカル埋め込み（API 不要）

ソースのオプション

• memory — MEMORY.md + memory/*.md ファイル
• sessions — 過去の会話のトランスクリプト
• both — 完全なコンテキスト（推奨）

日次ログの形式

毎日 memory/logs/YYYY-MM-DD.md を作成します。

# YYYY-MM-DD — Daily Log

## [Time] — [Event/Task]
- What happened
- Decisions made
- Follow-ups needed

## [Time] — [Another Event]
- Details

エージェントへの指示（AGENTS.md）

エージェントの動作に関する指示を AGENTS.md に追加します。

## Memory Recall
Before answering questions about prior work, decisions, dates, people, preferences, or todos:
1. Run memory_search with relevant query
2. Use memory_get to pull specific lines if needed
3. If low confidence after search, say you checked

トラブルシューティング

メモリ検索が機能しませんか？

1. 設定で memorySearch.enabled: true を確認します
2. ワークスペースのルートに MEMORY.md があることを確認します
3. ゲートウェイを再起動します：clawdbot gateway restart

検索結果が関連性に欠けますか？

• 結果を増やすには、minScore を 0.2 に下げます
• maxResults を 30 に増やします
• メモリファイルに意味のある内容が含まれていることを確認します

プロバイダーのエラーが発生しますか？

• Voyage：環境変数に VOYAGE_API_KEY を設定します
• OpenAI：環境変数に OPENAI_API_KEY を設定します
• API キーがない場合は local プロバイダーを使用します

動作確認

メモリが機能しているかテストします。

User: "What do you remember about [past topic]?"
Agent: [Should search memory and return relevant context]

エージェントにメモリがない場合、設定が適用されていません。ゲートウェイを再起動してください。

設定の全体例

{
  "memorySearch": {
    "enabled": true,
    "provider": "voyage",
    "sources": ["memory", "sessions"],
    "indexMode": "hot",
    "minScore": 0.3,
    "maxResults": 20
  },
  "workspace": "/path/to/your/workspace"
}

重要な理由

メモリがない場合：

• エージェントはセッションのたびにすべてを忘れます
• 質問を繰り返し、コンテキストを失います
• プロジェクトの継続性がありません

メモリがある場合：

• 過去の会話を思い出します
• あなたの好みを把握します
• プロジェクトの履歴を追跡します
• 時間をかけて関係を築きます

金魚 → ゾウ。🐘