Honchoメモリ
Honcho は、OpenClawにAIネイティブなメモリを追加します。会話を専用サービスに永続化し、時間の経過とともにユーザーとエージェントのモデルを構築することで、ワークスペースのMarkdownファイルを超えたセッション間コンテキストをエージェントに提供します。
提供されるもの
- セッション間メモリ — 会話は各ターン後に永続化されるため、コンテキストはセッションのリセット、圧縮、チャネル切り替えをまたいで維持されます。
- ユーザーモデリング — Honchoは各ユーザーについてのプロファイル（好み、事実、コミュニケーションスタイル）と、エージェントについてのプロファイル（性格、学習した振る舞い）を維持します。
- セマンティック検索 — 現在のセッションだけでなく、過去の会話からの観察内容を検索できます。
- マルチエージェント認識 — 親エージェントは生成されたサブエージェントを自動的に追跡し、子セッションでは親がオブザーバーとして追加されます。
利用可能なツール
Honchoは、会話中にエージェントが使用できるツールを登録します。
データ取得（高速、LLM呼び出しなし）:
| Tool | 役割 |
|---|
honcho_context | セッションをまたいだ完全なユーザー表現 |
honcho_search_conclusions | 保存された結論に対するセマンティック検索 |
honcho_search_messages | セッションをまたいでメッセージを検索（送信者、日付で絞り込み） |
honcho_session | 現在のセッション履歴と要約 |
| Tool | 役割 |
|---|
honcho_ask | ユーザーについて質問します。事実にはdepth='quick'、統合には'thorough'を使います |
はじめに
プラグインをインストールしてセットアップを実行します。
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Honchoは完全にローカル（セルフホスト）で実行することも、api.honcho.dev のマネージドAPI経由で実行することもできます。セルフホストオプションには外部依存関係は不要です。
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キーは省略してください。
既存メモリの移行
既存のワークスペースメモリファイル（USER.md、MEMORY.md、IDENTITY.md、memory/、canvas/）がある場合、openclaw honcho setup がそれらを検出し、移行を提案します。
移行は非破壊です — ファイルはHonchoにアップロードされます。元のファイルが削除または移動されることはありません。
仕組み
各AIターンの後、会話はHonchoに永続化されます。ユーザーとエージェントの両方のメッセージが観察されるため、Honchoは時間の経過とともにモデルを構築し、洗練させていきます。
会話中、Honchoツールは before_prompt_build フェーズでサービスに問い合わせ、モデルがプロンプトを見る前に関連コンテキストを注入します。これにより、正確なターン境界と関連性の高い想起が確保されます。
Honchoと組み込みメモリの比較
| 組み込み / QMD | Honcho |
|---|
| 保存先 | ワークスペースMarkdownファイル | 専用サービス（ローカルまたはホスト型） |
| セッション間 | メモリファイル経由 | 自動、組み込み |
| ユーザーモデリング | 手動（MEMORY.mdに記述） | 自動プロファイル |
| 検索 | ベクター + キーワード（ハイブリッド） | 観察内容に対するセマンティック検索 |
| マルチエージェント | 追跡されない | 親子認識あり |
| 依存関係 | なし（組み込み）またはQMDバイナリ | プラグインのインストール |
CLIコマンド
openclaw honcho setup # APIキーを設定してファイルを移行
openclaw honcho status # 接続状態を確認
openclaw honcho ask <question> # ユーザーについてHonchoに問い合わせる
openclaw honcho search <query> [-k N] [-d D] # メモリに対するセマンティック検索
さらに読む
