公開日：2日前最終更新日：2日前

【開発日記】Hermes AgentとClaude Codeの記憶をHonchoで共有した

Xでシェア facebookでシェア LINEでシェア

とむ

今日やったこと
詰まったところと、どう解いたか
気づき
次にやること

今日は、普段使っている2つのAIエージェント、Hermes Agent と Claude Code に同じ記憶を持たせるために、Plastic Labs のオープンソースの記憶レイヤー Honcho を自分のPCの Docker で動かしてつなぎました。最終的に、Hermes（ターミナル・Discord）と Claude Code の3か所の会話が同じ場所に貯まり、Claude Code 側に Hermes 由来の記憶が自動で差し込まれるところまで確認できました。

今日やったこと

PC起動時に Discord が自動で立ち上がらないよう、スタートアップ登録を無効化（タスクマネージャーで無効にするのと同じやり方）
Honcho をクラウド版ではなく、自分のPCの Docker で起動
テスト会話を入れて、記憶（観察）が自動で作られることを確認
Hermes Agent に Honcho のプラグインを入れ、記憶の保存先を Honcho に切り替え
Claude Code にも Honcho のプラグインを入れ、同じワークスペースにつないだ
Discord で /new してから一言送り、Discord の会話も保存されることを確認

クラウド版を使えば設定は一番簡単ですが、会話の全文を外部サービスに預けることになります。Claude Code との会話には本番環境の操作や設定の話が多いので、保存先は自分のPCに置くことにしました。ただし、記憶を作る（要約する）処理には LLM の API を使うので、その部分は外に出ます。そこは割り切りです。

詰まったところと、どう解いたか

1つ目は「記憶が空のまま」問題。テスト会話を3件入れても、記憶がまったくできませんでした。設定を読むと、Honcho の記憶づくりの処理（deriver）は費用を抑えるため、会話が約512トークン分たまるか、30分たつまで処理を始めない仕様でした。長めの会話を足したところ、13件の観察が自動で作られました（LLM の呼び出しは約3.6秒）。

2つ目は Hermes のプラグイン。インストールは「成功」と表示されるのに、実際には Honcho の SDK が入っておらず、ログに「honcho-ai が必要」という警告が出続けていました。Hermes は依存パッケージを入れる前に「入れてよいか」を聞く作りで、対話なしで実行するとその質問ごとスキップされていたのが原因です。依存の導入に同意するオプションを付けて入れ直し、常駐しているゲートウェイを再起動したら動きました。

hermes plugins install honcho --force --yes-deps --enable

3つ目は「自分が別人になる」問題。保存はされたものの、話し相手が自分の名前ではなく、Windows のユーザーIDで登録されていました。Windows では本人の判定がまだ効かないためで、「話し相手は常に自分」に固定する設定（pinUserPeer）で解決しました。Discord も自分しか使わない運用なので、この設定で困りません。

おまけ。作業の途中で、Docker が突然応答しなくなりました。Windows のイベントログを見ると、ちょうどその時刻に Windows Update が WSL を更新していて、その巻き添えで Docker の仮想環境が止まっていました。Docker Desktop を再起動して復旧しています。

Hermes（ターミナル・Discord）と Claude Code の会話を、自分のPCの Docker で動く Honcho に保存し、LLM API で記憶を作って次の会話に差し込む構成図。下段はつまずいた3つの点と解決方法。

気づき

記憶の保存は、スキルやコマンドを使わなくても自動です。Hermes は一往復ごと、Claude Code はフック（決まったタイミングで自動で動く処理）で会話が送られます。一方で Hermes は、会話の途中では記憶の仕組みを切り替えません。毎回同じ前置きを使い回して費用を抑える仕組み（プロンプトキャッシュ）を壊さないためで、Discord では /new のあとの最初のメッセージから保存が始まりました。

Claude Code 側のプラグインは、外部のコードを取り込む操作なので AI の自動承認では通らず、自分で /plugin コマンドを打って入れました。入れたあと Claude Code に一言送った時点で、Hermes の記憶から作られた「段階ごとに確認しながら進めたい」といった内容が自動で渡されていて、2つのエージェントで記憶が共有できていることを確認できました。