Human-Like Memory スキル
エージェントが使用可能な長期記憶ツール。Human-Like Memory 向け。
このスキルがサポートする機能:
- モデルが記憶が有用と判断した場合の、エージェント起動によるリコールと保存
- ユーザーが直接記憶の呼び出しや保存を指示した場合の、明示的なユーザー起動
このスキルは、意図的に 常時オンではありません:
- デフォルトでは、毎ターンリコールを行うべき ではありません
- デフォルトでは、すべての会話ターンを黙って保存するべき ではありません
- ランタイムに公開されている環境変数のみを読み取ります
- ローカルの秘密ファイルやスキルごとのプライベート設定ファイルは 読み取りません
常時オンで自動リコール・保存を行いたい場合は、このスキルではなく Human-Like Memory プラグインを使用してください。
データとネットワークの開示
エージェントまたはユーザーがこのスキルを呼び出すと:
recall/searchは、クエリ、user_id、agent_idをhttps://plugin.human-like.meまたは設定されたベースURLに送信しますsave/save-batchは、明示的に渡した会話内容を同じサービスに送信します- ローカルファイル、シェル履歴、関連のない環境変数は読み取られず、アップロードもされません
使用すべき場合
- 過去の記憶を明示的に検索したい場合
- ユーザーの事実、決定、好み、サマリーを明示的に保存したい場合
- エージェントが適切に応答するために過去のコンテキストが必要な場合
- エージェントが永続的な好み、決定、修正、サマリーを保存すべき場合
使用すべきでない場合
- 毎ターンの自動リコールやフックレベルのバックグラウンド保存が必要な場合
- 隠れた、またはサイレントなネットワークアクティビティが必要な場合
- リモートへのデータ転送を一切行いたくない場合
セットアップ
1. APIキーを取得
plugin.human-like.me にアクセスし、mp_xxx キーをコピーしてください。
2. Hermes 経由で設定
export HUMAN_LIKE_MEM_API_KEY="mp_your_key_here"
export HUMAN_LIKE_MEM_BASE_URL="https://plugin.human-like.me"
export HUMAN_LIKE_MEM_USER_ID="hermes-user"
export HUMAN_LIKE_MEM_AGENT_ID="main"
スキル読み込み時に Hermes のセキュア環境設定を使用することもできます。
3. 確認
node {baseDir}/scripts/memory.mjs config
期待される出力:
{
"apiKeyConfigured": true
}
コマンド
記憶の呼び出しまたは検索
node {baseDir}/scripts/memory.mjs recall "<query>"
node {baseDir}/scripts/memory.mjs search "<query>"
1ターンの保存
node {baseDir}/scripts/memory.mjs save "<user_message>" "<assistant_response>"
バッチ保存
echo '[{"role":"user","content":"..."},{"role":"assistant","content":"..."}]' | node {baseDir}/scripts/memory.mjs save-batch
ランタイム設定の確認
node {baseDir}/scripts/memory.mjs config
エージェント呼び出しスタイル
このスキルは、記憶が明らかに有用である場合にエージェントによって呼び出される場合があります。
推奨される動作:
- ユーザーが以前の作業、以前の好み、以前の決定に言及したり、以前の続きを依頼した場合は
recall/searchを使用する - ユーザーが何かを覚えておくように明示的に依頼した場合、本人確認の詳細を訂正した場合、安定した好みを述べた場合、重要な決定を確認した場合は
saveを使用する HUMAN_LIKE_MEM_AUTO_SAVE_ENABLED=trueで、現在の会話がおおよそHUMAN_LIKE_MEM_SAVE_TRIGGER_TURNSターンに達した場合、意味のある複数ターンの議論の後にはsave-batchを使用する- 継続的な価値のない単純な挨拶や一般的な単一ターンの質問のためにメモリAPIを呼び出さない
これによりエージェントに自律性が与えられますが、スキルは常時オンではなくスマートトリガーモードのままになります。
推奨クエリ例
- リコール:
"先週のロードマップの決定" - 検索:
"私が言及した名前の好みは何ですか" - 保存:
"私はUTC+8のタイムスタンプを好みます"
保存トリガー
エージェントは、ユーザーが以下の場合に save を強く検討する必要があります:
- 安定した好みを述べた場合
- 決定を行ったり確認したりした場合
- 後で重要になる個人プロファイルの事実を提供した場合
- 以前の誤解を訂正した場合
- 「これを覚えておいて」と明示的に言った場合
エージェントは、長いやり取りの後、最後の数ターンのコンパクトなサマリーが将来の継続性に役立つ可能性が高い場合に save-batch を使用できます。
エラーハンドリング
- APIキーがない場合、スクリプトは正確な環境変数設定手順を出力します
- サービスがタイムアウトまたはエラーになった場合、暗黙的に何も保存されません
- 記憶が見つからない場合は、通常の空の結果として処理します
プライバシー
- パスワード、トークン、シークレットを送信しないでください
- 設定されたメモリサービスに保存しても問題ないコンテンツのみを渡してください
- 送信されるフィールドと運用上の注意については SECURITY.md を確認してください
OpenClaw 互換性に関する注意
- OpenClaw メタデータアーティファクトは
compat/openclaw/に保存されています - ランタイムコマンドは互換性を維持しています (
scripts/memory.mjsコマンドサーフェスは変更なし)