メモリとコンテキスト

確認済み実機・内容確認: 2026-07-22 対象バージョン: v0.19.0 対象コミット: 967e078a #hermes#settings#memory#context

セッションをまたぐ記憶と、長い会話をモデルのコンテキスト内に収める方法を設定する。

画面表示（主）	内部キー（サブ）	製品既定値	推奨
永続メモリ	`memory.memory_enabled`	オン	個人利用はオン、機密作業は要検討
ユーザープロファイル	`memory.user_profile_enabled`	オン	個人利用はオン
メモリ予算	`memory.memory_char_limit`	`2200` 文字	既定値
プロファイル予算	`memory.user_char_limit`	`1375` 文字	既定値
メモリプロバイダー	`memory.provider`	空欄（表示は「内蔵のみ」）	内蔵のみ
コンテキストエンジン	`context.engine`	`compressor`	`compressor`
自動圧縮	`compression.enabled`	オン	オン
圧縮しきい値	`compression.threshold`	`0.5`	0.5～0.7
圧縮目標	`compression.target_ratio`	`0.2`	0.2
保護する直近メッセージ	`compression.protect_last_n`	`20`	20

永続メモリとユーザープロファイル

設定	オン	オフ
永続メモリ	将来のセッションで役立つ事実や作業文脈を保存・参照	セッションをまたぐメモリの保存・利用を停止
ユーザープロファイル	好みや継続的な指示を短いプロファイルとして維持	ユーザープロファイルを更新・注入しない

共同端末、顧客ごとに分離が必要な環境、保存してはいけないデータを扱う場合はオフを検討する。メモリへ資格情報や秘密鍵を保存させない。

予算

文字数上限を増やすと多くの情報を保持できるが、毎ターンのコンテキスト消費も増える。まず既定値を使い、重要事項が頻繁に欠落するときだけ段階的に増やす。

メモリプロバイダー

ドロップダウンは「内蔵のみ」「Honcho」「Hindsight」の 3 択。内蔵メモリを使う場合は「内蔵のみ」（空欄）を選ぶ。

画面表示（主）	保存値（内部）	既定	動作
内蔵のみ	空文字	はい	外部プロバイダーを使わず、Hermes の内蔵メモリ（永続メモリ・ユーザープロファイル）だけで動く
Honcho	`honcho`	いいえ	Honcho の外部またはセルフホストメモリを使う。API キー入力か OAuth 接続のいずれかで接続する。詳細は HONCHO_API_KEY（または HONCHO_BASE_URL）を参照
Hindsight	`hindsight`	いいえ	Vectorize の Hindsight メモリ API を使う外部プロバイダー。API キーが必要（下記参照）

選択時の画面挙動

外部プロバイダー（Honcho / Hindsight）を選んだときだけ、ドロップダウンの下にプロバイダー設定パネルと接続 UI が現れる。「内蔵のみ」（空欄）のままなら、どちらも表示されない。

設定パネルは各プロバイダーがバックエンド側で宣言した設定項目から自動生成される（見出しは「Honcho settings」「Hindsight settings」のように英語表示）。
各項目は入力確定のたびに 1 項目ずつ自動保存される。保存に失敗したときだけエラー通知が出る。パネル自体が読み込めない場合は「Retry」ボタンで再取得できる。
インラインに表示されない詳細項目を持つプロバイダー（例: Honcho）では、「Full config…」ボタンからフル設定モーダルを開いてまとめて編集できる。Hindsight は全項目がインライン表示のため、このボタンは出ない。
API キーなどの秘密情報の項目には、設定済みかどうかを示すバッジ（例: 「API key set」/「API key not set」）が付く。

プロバイダーの OAuth 接続

OAuth に対応した外部メモリプロバイダー（例: Honcho）を選ぶと、「メモリプロバイダー」ラベルの下に 「Connect」リンク（英語表示）が現れ、API キーを手で貼らずにブラウザーサインインで接続できる。接続状態は約 1.5 秒間隔で自動確認され（最大 120 秒）、失敗時のエラーは数秒で自動的に消える。接続済みのときは「oauth set」または「api key set」の表示に変わり、リンクは「Reconnect」（API キー接続時は「Connect via OAuth」）になる。Hindsight は OAuth 非対応のため「Connect」は表示されず、設定パネルで API キーを入力する。

メモリグラフと `/journey`

設定画面の項目ではないが、エージェントが蓄積したメモリとスキルを可視化するメモリグラフ（画面ラベル「メモリグラフ」、フィルター: すべて / 使用済み / 学習済み）がデスクトップにある。CLI・TUI では /journey が同じ学習タイムラインを表示し、その場で編集・削除できる。デスクトップのチャット欄でも /journey（別名 /learning・/memory-graph）でメモリグラフのオーバーレイをその場で開ける。誤った記憶の剪定はこの画面から行うのが早い → スラッシュコマンド一覧

Hindsight の設定

メモリプロバイダーで Hindsight を選ぶと、設定パネル「Hindsight settings」が開く（ラベルは英語表示）。API キーが未設定のときは「API key not set」バッジが付く。

画面表示（主）	選択時の初期表示	内容
Mode	Cloud	接続モード。Cloud は Hindsight Cloud API（API キーだけで使える軽量構成）、Local External は既存の Hindsight インスタンスへの接続
API key	空欄（`Enter Hindsight API key`）	Hindsight API 認証用のキー。Cloud モードでは必須
API URL	`https://api.hindsight.vectorize.io`	Hindsight API のエンドポイント
Bank ID	`hermes`	メモリの保存先バンク識別子
Recall budget	mid	想起（recall）に割り当てる予算の段階（low / mid / high）

各項目は入力確定時に自動保存されるため、「Save」ボタンは無い。Hindsight は Vectorize が提供する外部メモリサービスのため、内蔵メモリと異なり API キーなどの外部資格情報が必要になる。

mem0 などの config.yaml 専用プロバイダー

デスクトップのドロップダウンに並ぶのは「内蔵のみ」「Honcho」「Hindsight」だけだが、バックエンドには mem0 をはじめとする追加のメモリプロバイダープラグインがある。これらは設定画面からは選べず、config.yaml の memory.provider に名前を直接書くか、CLI の hermes memory setup（対話式のプロバイダー選択・設定）で有効化する。config.yaml 側で設定した値は、デスクトップのドロップダウンに現在値として表示される。

mem0 では次の構成ができる。

セルフホストバックエンド: MEM0_HOST にセルフホストの Mem0 サーバー URL を設定すると、クラウド API の代わりにそのサーバーへ直接接続する。
リコール調整: 想起（recall）に対するリランキングの有効化など、調整オプションがある。
セットアップウィザード: hermes memory setup の mem0 セットアップは、platform（クラウド）/ self-hosted / OSS のモード別ウィザードになっている。

コンテキストエンジン

画面表示（主）	保存値（内部）	既定	動作
Compressor	`compressor`	はい	Hermes の圧縮設定を使い、古い会話を要約して空きを作る
Default	`default`	いいえ	コンテキストエンジンの標準実装へ委ねる
Custom	`custom`	いいえ	登録済みのカスタムコンテキスト実装を使う。実装がない環境では選ばない

圧縮設定

自動圧縮オン: しきい値到達時に古い会話を要約する。
自動圧縮オフ: 自動要約を行わない。長い会話ではモデル上限に達しやすい。
圧縮しきい値: コンテキスト上限に対する開始比率。0.5 は50%で開始する。小さいほど早く圧縮し、大きいほど原文を長く保持する。
圧縮目標: 圧縮後に残すコンテキスト比率。0.2 は上限の20%程度を目標にする。
保護する直近メッセージ: 要約せず原文のまま残す最新メッセージ数。20 は直近20件を保護する。