メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 を書き込み、必要に応じて既存のワークスペースメモリファイルを移行します。
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 key は省略してください。

​
既存メモリの移行

既存のワークスペースメモリファイル（USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/）がある場合、openclaw honcho setup はそれらを検出し、移行を提案します。
移行は非破壊です — ファイルは Honcho にアップロードされます。元のファイルが削除または移動されることはありません。

​
仕組み

各 AI ターンの後、会話は Honcho に永続化されます。ユーザーとエージェントの両方のメッセージが観測されるため、Honcho は時間をかけてモデルを構築し、洗練させていきます。 会話中、Honcho tools は before_prompt_build フェーズでサービスに問い合わせ、モデルがプロンプトを見る前に関連コンテキストを注入します。これにより、正確なターン境界と適切な想起が保証されます。

​
Honcho と組み込みメモリの比較

組み込み / QMDHoncho
ストレージワークスペース 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] # メモリに対するセマンティック検索

​
さらに読む

​
関連