Sessions and memory
Honchoメモリ
Honcho は OpenClaw に AI ネイティブなメモリを追加します。会話を専用サービスに永続化し、時間をかけてユーザーとエージェントのモデルを構築することで、ワークスペースの Markdown ファイルを超えたクロスセッションコンテキストをエージェントに提供します。
提供されるもの
- クロスセッションメモリ -- 会話は各ターン後に永続化されるため、コンテキストはセッションリセット、Compaction、チャンネル切り替えをまたいで維持されます。
- ユーザーモデリング -- Honcho は各ユーザーについてのプロファイル（好み、事実、コミュニケーションスタイル）と、エージェントについてのプロファイル（性格、学習された振る舞い）を維持します。
- セマンティック検索 -- 現在のセッションだけでなく、過去の会話から得られた観察内容を検索できます。
- マルチエージェント対応 -- 親エージェントは生成した sub-agent を自動的に追跡し、親は子セッションの observer として追加されます。
利用可能な tools
Honcho は、会話中にエージェントが使える tools を登録します。
データ取得（高速、LLM 呼び出しなし）:
| Tool | 説明 |
|---|---|
honcho_context |
セッション全体にわたる完全なユーザー表現 |
honcho_search_conclusions |
保存された結論に対するセマンティック検索 |
honcho_search_messages |
セッション全体のメッセージ検索（送信者、日付で絞り込み可能） |
honcho_session |
現在のセッション履歴と要約 |
Q&A（LLM 活用）:
| Tool | 説明 |
|---|---|
honcho_ask |
ユーザーについて質問します。事実には depth='quick'、統合的な要約には 'thorough' を使います |
はじめに
Plugin をインストールしてセットアップを実行します。
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
setup コマンドは API 認証情報を尋ね、config を書き込み、必要に応じて既存のワークスペースメモリファイルを移行します。
設定
設定は plugins.entries["openclaw-honcho"].config 配下にあります。
{
plugins: {
entries: {
"openclaw-honcho": {
config: {
apiKey: "your-api-key", // セルフホストでは省略
workspaceId: "openclaw", // メモリ分離
baseUrl: "https://api.honcho.dev",
},
},
},
},
}
セルフホストのインスタンスでは、baseUrl をローカルサーバー（たとえば http://localhost:8000）に向け、API key は省略してください。
既存メモリの移行
既存のワークスペースメモリファイル（USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/）がある場合、openclaw honcho setup はそれらを検出し、移行を提案します。
仕組み
各 AI ターンの後、会話は Honcho に永続化されます。ユーザーとエージェントの両方のメッセージが観測されるため、Honcho は時間をかけてモデルを構築し、洗練させていきます。
会話中、Honcho tools は before_prompt_build フェーズでサービスに問い合わせ、モデルがプロンプトを見る前に関連コンテキストを注入します。これにより、正確なターン境界と適切な想起が保証されます。
Honcho と組み込みメモリの比較
| 組み込み / QMD | Honcho | |
|---|---|---|
| ストレージ | ワークスペース Markdown ファイル | 専用サービス（ローカルまたはホスト型） |
| クロスセッション | メモリファイル経由 | 自動、組み込み |
| ユーザーモデリング | 手動（MEMORY.md に書く） |
自動プロファイル |
| 検索 | ベクトル + キーワード（ハイブリッド） | 観察内容に対するセマンティック検索 |
| マルチエージェント | 追跡されない | 親/子の対応あり |
| 依存関係 | なし（組み込み）または QMD バイナリ | Plugin インストール |
Honcho と組み込みメモリシステムは一緒に使えます。QMD が設定されている場合、Honcho のクロスセッションメモリと並行してローカル Markdown ファイルを検索するための追加 tools が利用可能になります。
CLI コマンド
openclaw honcho setup # API key を設定してファイルを移行
openclaw honcho status # 接続状態を確認
openclaw honcho ask <question> # ユーザーについて Honcho に問い合わせる
openclaw honcho search <query> [-k N] [-d D] # メモリに対するセマンティック検索
さらに読む
- Plugin source code
- Honcho documentation
- Honcho OpenClaw integration guide
- Memory -- OpenClaw メモリの概要
- Context Engines -- Plugin コンテキストエンジンの仕組み