Sessions and memory
Honchoメモリ
Honcho は、外部 Plugin を通じて OpenClaw に AI ネイティブなメモリを追加します。専用サービスに会話を永続化し、時間をかけてユーザーとエージェントのモデルを構築することで、ワークスペースの Markdown ファイルを超えたセッション横断コンテキストをエージェントに提供します。
提供される機能
- セッション横断メモリ - 会話は各ターンの後に永続化されるため、セッションのリセット、Compaction、チャンネルの切り替えをまたいでコンテキストが引き継がれます。
- ユーザーモデリング - Honcho は、各ユーザーのプロファイル(設定、事実、コミュニケーションスタイル)と、エージェントのプロファイル(人格、学習した振る舞い)を維持します。
- セマンティック検索 - 現在のセッションだけでなく、過去の会話から得られた観察結果を検索します。
- マルチエージェント認識 - 親エージェントは生成したサブエージェントを自動的に追跡し、子セッションでは親がオブザーバーとして追加されます。
利用可能なツール
Honcho は、会話中にエージェントが使用できるツールを登録します。
データ取得(高速、LLM 呼び出しなし):
| ツール | 機能 |
|---|---|
honcho_context |
セッションを横断した完全なユーザー表現 |
honcho_search_conclusions |
保存された結論に対するセマンティック検索 |
honcho_search_messages |
セッションを横断してメッセージを検索(送信者、日付で絞り込み) |
honcho_session |
現在のセッション履歴と要約 |
Q&A(LLM を使用):
| ツール | 機能 |
|---|---|
honcho_ask |
ユーザーについて質問します。事実の確認には depth='quick'、統合的な分析には 'thorough' を使用します |
はじめに
Plugin をインストールしてセットアップを実行します。
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceセットアップコマンドでは API 認証情報の入力を求め、設定を書き込み、必要に応じて既存のワークスペースメモリファイルを移行します。
設定
設定は plugins.entries["openclaw-honcho"].config にあります。
{ plugins: { entries: { "openclaw-honcho": { config: { apiKey: "your-api-key", // omit for self-hosted workspaceId: "openclaw", // memory isolation baseUrl: "https://api.honcho.dev", }, }, }, },}セルフホストのインスタンスでは、baseUrl にローカルサーバー(たとえば http://localhost:8000)を指定し、API キーを省略します。
既存メモリの移行
既存のワークスペースメモリファイル(USER.md、MEMORY.md、IDENTITY.md、memory/、canvas/)がある場合、openclaw honcho setup がそれらを検出し、移行を提案します。
仕組み
AI の各ターン後に、会話が Honcho に永続化されます。ユーザーとエージェントの両方のメッセージが観察されるため、Honcho は時間をかけてモデルを構築し、洗練できます。
会話中、Honcho ツールは OpenClaw の before_prompt_build Plugin フックでサービスに問い合わせ、モデルがプロンプトを受け取る前に関連するコンテキストを注入します。
Honcho と組み込みメモリの比較
| 組み込み / QMD | Honcho | |
|---|---|---|
| ストレージ | ワークスペースの Markdown ファイル | 専用サービス(ローカルまたはホスト型) |
| セッション横断 | メモリファイル経由 | 自動、組み込み |
| ユーザーモデリング | 手動(MEMORY.md に書き込み) | 自動プロファイル |
| 検索 | ベクトル + キーワード(ハイブリッド) | 観察結果に対するセマンティック検索 |
| マルチエージェント | 追跡なし | 親子関係の認識 |
| 依存関係 | なし(組み込み)または QMD バイナリ | Plugin のインストール |
Honcho と組み込みメモリシステムは併用できます。QMD が設定されている場合、Honcho のセッション横断メモリと併せてローカルの Markdown ファイルを検索するための追加ツールが利用可能になります。
CLI コマンド
openclaw honcho setup # Configure API key and migrate filesopenclaw honcho status # Check connection statusopenclaw honcho ask <question> # Query Honcho about the useropenclaw honcho search <query> [-k N] [-d D] # Semantic search over memory