openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh ja-JP translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-11 04:32:53 +00:00
parent d4bbf661c0
commit 4e01c20514
1 changed files with 113 additions and 113 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

226
docs/ja-JP/concepts/active-memory.md
View File

@ -2,29 +2,29 @@
read_when:
- アクティブメモリが何のためのものかを理解したい場合
- 会話型エージェントでアクティブメモリを有効にしたい場合
- アクティブメモリをどこでも有効にすることなく、その動作を調整したい場合
- どこでも有効にすることなく、アクティブメモリの動作を調整したい場合
summary: 対話型チャットセッションに関連するメモリを注入する、プラグイン所有のブロッキングメモリサブエージェント
title: アクティブメモリ
x-i18n:
generated_at: "2026-04-10T04:43:44Z"
generated_at: "2026-04-11T04:31:47Z"
model: gpt-5.4
provider: openai
source_hash: 6a51437df4ae4d9d57764601dfcfcdadb269e2895bf49dc82b9f496c1b3cb341
source_hash: e8b0e6539e09678e9e8def68795f8bcb992f98509423da3da3123eda88ec1dd5
source_path: concepts/active-memory.md
workflow: 15
---
# アクティブメモリ
アクティブメモリは、対象となる会話セッションでメインの返信の前に実行される、オプションのプラグイン所有のブロッキングメモリサブエージェントです。
アクティブメモリは、対象となる会話セッションでメインの応答の前に実行される、オプションのプラグイン所有のブロッキングメモリサブエージェントです。
これは、ほとんどのメモリシステムが高機能であっても受動的だから存在します。メモリをいつ検索するかをメインエージェントの判断に委ねたり、ユーザーが「これを覚えて」や「メモリを検索して」のように言うことに頼ったりします。その時点では、メモリが返信を自然に感じさせられたはずの瞬間は、すでに過ぎています。
これは、ほとんどのメモリシステムが高機能ではあっても受動的だからです。メインエージェントがいつメモリを検索するかを判断することに依存していたり、ユーザーが「これを覚えて」や「メモリを検索して」のように言うことに依存していたりします。その時点では、メモリによって応答が自然に感じられるはずだった瞬間は、すでに過ぎています。
アクティブメモリは、メインの返信が生成される前に、関連するメモリをシステムが提示するための限定された1回の機会を与えます。
アクティブメモリは、メインの応答が生成される前に、関連するメモリをシステムが浮上させるための、制限された1回の機会を与えます。
## これをエージェントに貼り付ける
自己完結型で安全なデフォルト設定によりアクティブメモリを有効にしたい場合は、これをエージェントに貼り付けてください。
自己完結型で安全なデフォルト設定でアクティブメモリを有効にしたい場合は、これをエージェントに貼り付けてください。
```json5
{
@ -50,15 +50,15 @@ x-i18n:
}
```
これにより、`main`エージェントでプラグインが有効になり、デフォルトではダイレクトメッセージ形式のセッションのみに制限され、まず現在のセッションモデルを継承し、明示的または継承されたモデルが利用できない場合でも組み込みのリモートフォールバックを使用できます。
これにより、`main`エージェントでプラグインが有効になり、既定ではダイレクトメッセージ形式のセッションのみに限定され、まず現在のセッションモデルを継承し、明示的または継承されたモデルが利用できない場合でも組み込みのリモートフォールバックを使用できます。
その後、Gatewayを再起動します。
```bash
node scripts/run-node.mjs gateway --profile dev
openclaw gateway
```
会話でライブ確認するには、次を使用します。
会話中にライブで確認するには、次を実行します。
```text
/verbose on
@ -72,7 +72,7 @@ node scripts/run-node.mjs gateway --profile dev
2. 1つの会話型エージェントを対象にする
3. 調整中のみログを有効にしておく
`openclaw.json`では次から始めてください。
まず、`openclaw.json`にこれを追加します。
```json5
{
@ -97,25 +97,25 @@ node scripts/run-node.mjs gateway --profile dev
}
```
その後、Gatewayを再起動します。
次に、Gatewayを再起動します。
```bash
node scripts/run-node.mjs gateway --profile dev
openclaw gateway
```
これが意味すること:
これが意味することは次のとおりです。
- `plugins.entries.active-memory.enabled: true` はプラグインを有効にします
- `config.agents: ["main"]` は `main` エージェントのみをアクティブメモリの対象にします
- `config.allowedChatTypes: ["direct"]` は、デフォルトでアクティブメモリをダイレクトメッセージ形式のセッションのみに制限します
- `config.allowedChatTypes: ["direct"]` は、既定でダイレクトメッセージ形式のセッションでのみアクティブメモリを有効にします
- `config.model` が未設定の場合、アクティブメモリはまず現在のセッションモデルを継承します
- `config.modelFallbackPolicy: "default-remote"` は、明示的または継承されたモデルが利用できない場合のデフォルトとして、組み込みのリモートフォールバックを維持します
- `config.promptStyle: "balanced"` は、`recent` モードのデフォルトの汎用プロンプトスタイルを使用します
- `config.modelFallbackPolicy: "default-remote"` は、明示的または継承されたモデルが利用できない場合に、組み込みのリモートフォールバックを既定として維持します
- `config.promptStyle: "balanced"` は、`recent` モードの既定の汎用プロンプトスタイルを使用します
- アクティブメモリは、対象となる対話型の永続チャットセッションでのみ引き続き実行されます
## 確認方法
アクティブメモリは、モデルに対して非表示のシステムコンテキストを注入します。クライアントに生の `<active_memory_plugin>...</active_memory_plugin>` タグを公開することはありません。
アクティブメモリは、モデルに対して非表示のシステムコンテキストを注入します。生の `<active_memory_plugin>...</active_memory_plugin>` タグをクライアントに公開することはありません。
## セッショントグル
@ -127,7 +127,7 @@ node scripts/run-node.mjs gateway --profile dev
/active-memory on
```
これはセッション単位です。`plugins.entries.active-memory.enabled`、エージェント対象設定、その他のグローバル設定は変更しません。
これはセッションスコープです。`plugins.entries.active-memory.enabled`、エージェントの対象設定、その他のグローバル設定は変更しません。
設定を書き込み、すべてのセッションでアクティブメモリを一時停止または再開したい場合は、明示的なグローバル形式を使用します。
@ -137,7 +137,7 @@ node scripts/run-node.mjs gateway --profile dev
/active-memory on --global
```
グローバル形式は `plugins.entries.active-memory.config.enabled` に書き込みます。`plugins.entries.active-memory.enabled` は有効のままにするため、後でコマンドを使ってアクティブメモリを再度有効にできます。
グローバル形式は `plugins.entries.active-memory.config.enabled` に書き込みます。後でコマンドでアクティブメモリを再度有効にできるように、`plugins.entries.active-memory.enabled` は有効なままにします。
ライブセッションでアクティブメモリが何をしているか確認したい場合は、そのセッションで詳細モードを有効にします。
@ -145,23 +145,23 @@ node scripts/run-node.mjs gateway --profile dev
/verbose on
```
詳細を有効にすると、OpenClawは次を表示できます。
詳細表示を有効にすると、OpenClaw は次を表示できます。
- `Active Memory: ok 842ms recent 34 chars` のようなアクティブメモリのステータス行
- `Active Memory Debug: Lemon pepper wings with blue cheese.` のような読みやすいデバッグ要約
これらの行は、非表示のシステムコンテキストに渡される同じアクティブメモリパスから導出されますが、生のプロンプトマークアップを公開する代わりに人間向けに整形されています。
これらの行は、非表示のシステムコンテキストに渡されるのと同じアクティブメモリの処理から導出されますが、生のプロンプトマークアップを公開する代わりに、人間向けに整形されています。
デフォルトでは、ブロッキングメモリサブエージェントのトランスクリプトは一時的であり、実行完了後に削除されます。
既定では、このブロッキングメモリサブエージェントのトランスクリプトは一時的なもので、実行完了後に削除されます。
フローの例:
フロー例:
```text
/verbose on
what wings should i order?
```
表示される返信の想定形:
想定される表示上の応答の形:
```text
...normal assistant reply...
@ -176,7 +176,7 @@ what wings should i order?
1. **設定によるオプトイン**
プラグインが有効であり、現在のエージェントIDが `plugins.entries.active-memory.config.agents` に含まれている必要があります。
2. **厳格な実行時適格性**
2. **厳格なランタイム適格性**
有効化され対象指定されていても、アクティブメモリは対象となる対話型の永続チャットセッションでのみ実行されます。
実際のルールは次のとおりです。
@ -197,15 +197,15 @@ active memory runs
## セッションタイプ
`config.allowedChatTypes` は、どの種類の会話でアクティブメモリを実行できるかを制御します。
`config.allowedChatTypes` は、どの種類の会話でアクティブメモリをそもそも実行できるかを制御します。
デフォルトは次のとおりです。
既定値は次のとおりです。
```json5
allowedChatTypes: ["direct"]
```
これは、アクティブメモリがデフォルトではダイレクトメッセージ形式のセッションで実行され、グループやチャンネルのセッションでは明示的にオプトインしない限り実行されないことを意味します。
つまり、アクティブメモリは既定ではダイレクトメッセージ形式のセッションで実行されますが、グループやチャネルのセッションでは、明示的にオプトインしない限り実行されません。
例:
@ -223,41 +223,41 @@ allowedChatTypes: ["direct", "group", "channel"]
## 実行される場所
アクティブメモリは会話を豊かにする機能であり、プラットフォーム全体の推論機能ではありません。
アクティブメモリは、プラットフォーム全体の推論機能ではなく、会話を強化する機能です。
| Surface | アクティブメモリは実行されるか |
| ------------------------------------------------------------------- | ---------------------------------------------------------- |
| Control UI / web chat persistent sessions | はい。プラグインが有効で、エージェントが対象なら実行されます |
| Other interactive channel sessions on the same persistent chat path | はい。プラグインが有効で、エージェントが対象なら実行されます |
| Headless one-shot runs | いいえ |
| Heartbeat/background runs | いいえ |
| Generic internal `agent-command` paths | いいえ |
| Sub-agent/internal helper execution | いいえ |
| Surface | アクティブメモリは実行されるか |
| ------------------------------------------------------------------- | ----------------------------------------------------------- |
| Control UI / web chat の永続セッション | はい。プラグインが有効で、エージェントが対象なら実行されます |
| 同じ永続チャットパス上の他の対話型チャネルセッション | はい。プラグインが有効で、エージェントが対象なら実行されます |
| ヘッドレスなワンショット実行 | いいえ |
| Heartbeat/バックグラウンド実行 | いいえ |
| 汎用の内部 `agent-command` パス | いいえ |
| サブエージェント/内部ヘルパー実行 | いいえ |
## 使用する理由
## 使う理由
アクティブメモリは次のような場合に使用してください。
次のような場合にアクティブメモリを使用します。
- セッションが永続的でユーザー向けである
- エージェントが検索すべき意味のある長期メモリを持っている
- 生のプロンプトの決定性よりも、一貫性とパーソナライズが重要である
特に次の用途に適しています。
特に次のようなものに効果的です。
- 安定した好み
- 繰り返される習慣
- 自然に表面化すべき長期的なユーザーコンテキスト
次の用途には適しません。
次のような用途には向いていません。
- 自動化
- 内部ワーカー
- 単発のAPIタスク
- 非表示のパーソナライズが意外に感じられる場所
- ワンショットAPIタスク
- 非表示のパーソナライズが驚きになってしまう場所
## 仕組み
実行時の形は次のとおりです。
ランタイムの形は次のとおりです。
```mermaid
flowchart LR
@ -268,12 +268,12 @@ flowchart LR
I --> M["Main Reply"]
```
ブロッキングメモリサブエージェントが使用できるのは次のみです。
このブロッキングメモリサブエージェントが使用できるのは次のみです。
- `memory_search`
- `memory_get`
接続が弱い場合は、`NONE` を返す必要があります。
接続が弱い場合は、`NONE` を返すべきです。
## クエリモード
@ -281,18 +281,18 @@ flowchart LR
## プロンプトスタイル
`config.promptStyle` は、メモリを返すかどうかを判断するときに、ブロッキングメモリサブエージェントがどれだけ積極的または厳格であるかを制御します。
`config.promptStyle` は、ブロッキングメモリサブエージェントがメモリを返すべきかどうかを判断する際に、どれだけ積極的または厳格になるかを制御します。
利用可能なスタイル:
使用可能なスタイル:
- `balanced`: `recent` モード向けの汎用デフォルト
- `strict`: 最も慎重。近くのコンテキストからのにじみを極力少なくしたい場合に最適
- `contextual`: 最も継続性を重視。会話履歴の重要度を高くしたい場合に最適
- `recall-heavy`: 弱めだが妥当な一致でもメモリを表面化しやすい
- `balanced`: `recent` モード向けの汎用既定値
- `strict`: 最も控えめ。近接したコンテキストからのにじみをできるだけ抑えたい場合に最適
- `contextual`: 最も継続性に優しい。会話履歴をより重視すべき場合に最適
- `recall-heavy`: 弱めだがもっともらしい一致でも、より積極的にメモリを浮上させる
- `precision-heavy`: 一致が明白でない限り、積極的に `NONE` を優先する
- `preference-only`: お気に入り、習慣、ルーティン、好み、繰り返される個人的事実に最適化されている
- `preference-only`: お気に入り、習慣、日課、好み、繰り返し現れる個人的事実に最適化
`config.promptStyle` が未設定の場合のデフォルト対応:
`config.promptStyle` が未設定の場合の既定の対応:
```text
message -> strict
@ -300,7 +300,7 @@ recent -> balanced
full -> contextual
```
`config.promptStyle` を明示的に設定した場合は、そのオーバーライドが優先されます。
`config.promptStyle` を明示的に設定した場合は、その上書き設定が優先されます。
例:
@ -310,7 +310,7 @@ promptStyle: "preference-only"
## モデルフォールバックポリシー
`config.model` が未設定の場合、アクティブメモリは次の順序でモデルを解決しようとします。
`config.model` が未設定の場合、アクティブメモリは次の順序でモデルの解決を試みます。
```text
explicit plugin model
@ -321,7 +321,7 @@ explicit plugin model
`config.modelFallbackPolicy` は最後のステップを制御します。
デフォルト:
既定値:
```json5
modelFallbackPolicy: "default-remote"
@ -333,39 +333,39 @@ modelFallbackPolicy: "default-remote"
modelFallbackPolicy: "resolved-only"
```
明示的または継承されたモデルが利用できない場合に、組み込みのリモートデフォルトへフォールバックする代わりにアクティブメモリでリコールをスキップしたい場合は、`resolved-only` を使用してください。
明示的または継承されたモデルが利用できないときに、組み込みのリモート既定値へフォールバックする代わりにアクティブメモリでリコールをスキップしたい場合は、`resolved-only` を使用します。
## 高度なエスケープハッチ
これらのオプションは、意図的に推奨設定には含めていません。
`config.thinking` は、ブロッキングメモリサブエージェントの thinking レベルを上書きできます。
`config.thinking` では、ブロッキングメモリサブエージェントの thinking レベルを上書きできます。
```json5
thinking: "medium"
```
デフォルト:
既定値:
```json5
thinking: "off"
```
これはデフォルトでは有効にしないでください。アクティブメモリは返信経路で実行されるため、thinking 時間が増えるとそのままユーザーに見えるレイテンシが増加します。
これは既定では有効にしないでください。アクティブメモリは応答経路で実行されるため、thinking 時間が増えると、そのままユーザーに見えるレイテンシが増加します。
`config.promptAppend` は、デフォルトのアクティブメモリプロンプトの後、会話コンテキストの前に追加のオペレーター指示を加えます。
`config.promptAppend` は、既定のアクティブメモリプロンプトの後、会話コンテキストの前に、追加の運用者向け指示を加えます。
```json5
promptAppend: "Prefer stable long-term preferences over one-off events."
```
`config.promptOverride` は、デフォルトのアクティブメモリプロンプトを置き換えます。OpenClawはその後も会話コンテキストを追加します。
`config.promptOverride` は、既定のアクティブメモリプロンプトを置き換えます。OpenClaw はその後も会話コンテキストを追加します。
```json5
promptOverride: "You are a memory search agent. Return NONE or one compact user fact."
```
プロンプトのカスタマイズは、別のリコール契約を意図的にテストしている場合を除き、推奨されません。デフォルトのプロンプトは、メインモデル向けに `NONE` かコンパクトなユーザー事実コンテキストを返すよう調整されています。
プロンプトのカスタマイズは、異なるリコール契約を意図的にテストしている場合を除き、推奨されません。既定のプロンプトは、`NONE` またはメインモデル向けのコンパクトなユーザー事実コンテキストを返すように調整されています。
### `message`
@ -375,19 +375,19 @@ promptOverride: "You are a memory search agent. Return NONE or one compact user
Latest user message only
```
次のような場合に使用してください。
このモードを使うのは次のような場合です。
- 最も高速な動作がほしい
- 安定した好みのリコールを最も強く優先したい
- 最速の動作にしたい
- 安定した好みのリコールに最も強く寄せたい
- フォローアップのターンで会話コンテキストが不要
推奨タイムアウト:
- `3000`〜`5000` msあたりから始める
- `3000` 〜 `5000` ms 前後から始める
### `recent`
最新のユーザーメッセージに加え、直近の小さな会話テールが送信されます。
最新のユーザーメッセージに加えて、直近の会話の短い末尾が送信されます。
```text
Recent conversation tail:
@ -399,14 +399,14 @@ Latest user message:
...
```
次のような場合に使用してください。
このモードを使うのは次のような場合です。
- 速度と会話の文脈把握のより良いバランスがほしい
- 速度と会話の文脈づけのバランスをより良くしたい
- フォローアップの質問が直近の数ターンに依存することが多い
推奨タイムアウト:
- `15000` msあたりから始める
- `15000` ms 前後から始める
### `full`
@ -420,17 +420,17 @@ user: ...
...
```
次のような場合に使用してください。
このモードを使うのは次のような場合です。
- レイテンシよりも最高のリコール品質が重要
- 会話に、スレッドのかなり前方にある重要な前提が含まれている
- レイテンシよりも、できるだけ高いリコール品質が重要
- 会話スレッドのかなり前方に重要な前提情報が含まれている
推奨タイムアウト:
- `message` や `recent` より十分に大きくする
- スレッドサイズに応じて `15000` ms以上から始める
- `message` や `recent` と比べて大幅に増やす
- スレッドサイズに応じて `15000` ms 以上から始める
一般に、タイムアウトはコンテキストサイズに応じて増やす必要があります。
一般に、タイムアウトはコンテキストサイズに応じて増やすべきです。
```text
message < recent < full
@ -440,13 +440,13 @@ message < recent < full
アクティブメモリのブロッキングメモリサブエージェント実行では、ブロッキングメモリサブエージェント呼び出し中に実際の `session.jsonl` トランスクリプトが作成されます。
デフォルトでは、そのトランスクリプトは一時的です:
既定では、そのトランスクリプトは一時的なものです:
- 一時ディレクトリに書き込まれます
- ブロッキングメモリサブエージェント実行のためだけに使用されます
- 実行終了直後に削除されます
- ブロッキングメモリサブエージェントの実行にのみ使用されます
- 実行完了直後に削除されます
デバッグや確認のためにそれらのブロッキングメモリサブエージェントのトランスクリプトをディスク上に保持したい場合は、永続化を明示的に有効にします。
デバッグや確認のために、それらのブロッキングメモリサブエージェントのトランスクリプトをディスク上に保持したい場合は、永続化を明示的に有効にしてください。
```json5
{
@ -465,9 +465,9 @@ message < recent < full
}
```
有効にすると、アクティブメモリはトランスクリプトを、メインのユーザー会話トランスクリプトパスではなく、対象エージェントのセッションフォルダー配下の別ディレクトリに保存します。
有効にすると、アクティブメモリは、対象エージェントのセッションフォルダー配下の別ディレクトリにトランスクリプトを保存し、メインのユーザー会話トランスクリプトのパスには保存しません。
デフォルトのレイアウトは概念的には次のとおりです。
既定のレイアウトは概念的には次のとおりです。
```text
agents/<agent>/sessions/active-memory/<blocking-memory-sub-agent-session-id>.jsonl
@ -478,12 +478,12 @@ agents/<agent>/sessions/active-memory/<blocking-memory-sub-agent-session-id>.jso
これは慎重に使用してください。
- ブロッキングメモリサブエージェントのトランスクリプトは、セッションが多忙だとすぐに蓄積する可能性があります
- `full` クエリモードでは大量の会話コンテキストが重複する可能性があります
- これらのトランスクリプトには、非表示のプロンプトコンテキストと想起されたメモリが含まれます
- `full` クエリモードでは、大量の会話コンテキストが重複する可能性があります
- これらのトランスクリプトには、非表示のプロンプトコンテキストとリコールされたメモリが含まれます
## 設定
アクティブメモリの設定はすべて次の配下にあります。
すべてのアクティブメモリ設定は次の配下にあります。
```text
plugins.entries.active-memory
@ -494,33 +494,33 @@ plugins.entries.active-memory
| Key | Type | 意味 |
| --------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `enabled` | `boolean` | プラグイン自体を有効にします |
| `config.agents` | `string[]` | アクティブメモリを使用できるエージェントID |
| `config.model` | `string` | オプションのブロッキングメモリサブエージェントモデル参照。未設定時、アクティブメモリは現在のセッションモデルを使用します |
| `config.agents` | `string[]` | アクティブメモリを使用できるエージェントID |
| `config.model` | `string` | オプションのブロッキングメモリサブエージェントモデル参照。未設定の場合、アクティブメモリは現在のセッションモデルを使用します |
| `config.queryMode` | `"message" \| "recent" \| "full"` | ブロッキングメモリサブエージェントがどれだけ会話を参照するかを制御します |
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | メモリを返すかどうかを判断するときの、ブロッキングメモリサブエージェントの積極性または厳格さを制御します |
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | ブロッキングメモリサブエージェント向けの高度な thinking 上書き。速度重視のためデフォルトは `off` |
| `config.promptOverride` | `string` | 高度な完全プロンプト置換。通常の使用には非推奨 |
| `config.promptAppend` | `string` | デフォルトまたは上書きされたプロンプトに追加される高度な追加指示 |
| `config.promptStyle` | `"balanced" \| "strict" \| "contextual" \| "recall-heavy" \| "precision-heavy" \| "preference-only"` | ブロッキングメモリサブエージェントがメモリを返すべきか判断する際に、どれだけ積極的または厳格になるかを制御します |
| `config.thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high" \| "xhigh" \| "adaptive"` | ブロッキングメモリサブエージェント向けの高度な thinking 上書き。速度のため既定は `off` |
| `config.promptOverride` | `string` | 高度な完全プロンプト置換。通常の用途には推奨されません |
| `config.promptAppend` | `string` | 既定または上書きされたプロンプトに追加される高度な追加指示 |
| `config.timeoutMs` | `number` | ブロッキングメモリサブエージェントのハードタイムアウト |
| `config.maxSummaryChars` | `number` | active-memory 要約で許可される総文字数の最大値 |
| `config.maxSummaryChars` | `number` | active-memory 要約で許可される合計最大文字数 |
| `config.logging` | `boolean` | 調整中にアクティブメモリのログを出力します |
| `config.persistTranscripts` | `boolean` | 一時ファイルを削除せず、ブロッキングメモリサブエージェントのトランスクリプトをディスク上に保持します |
| `config.transcriptDir` | `string` | エージェントのセッションフォルダー配下の、ブロッキングメモリサブエージェント用相対トランスクリプトディレクトリ |
| `config.persistTranscripts` | `boolean` | 一時ファイルを削除せず、ブロッキングメモリサブエージェントのトランスクリプトをディスクに保持します |
| `config.transcriptDir` | `string` | エージェントのセッションフォルダー配下に置かれる、相対的なブロッキングメモリサブエージェント用トランスクリプトディレクトリ |
便利な調整用フィールド:
| Key | Type | 意味 |
| ----------------------------- | -------- | ----------------------------------------------------------------- |
| `config.maxSummaryChars` | `number` | active-memory 要約で許可される総文字数の最大値 |
| `config.recentUserTurns` | `number` | `queryMode` が `recent` のときに含める過去のユーザーターン数 |
| `config.recentAssistantTurns` | `number` | `queryMode` が `recent` のときに含める過去のアシスタントターン数 |
| `config.recentUserChars` | `number` | 各最近のユーザーターンあたりの最大文字数 |
| `config.recentAssistantChars` | `number` | 各最近のアシスタントターンあたりの最大文字数 |
| `config.cacheTtlMs` | `number` | 同一クエリの繰り返しに対するキャッシュ再利用 |
| Key | Type | 意味 |
| ----------------------------- | -------- | --------------------------------------------------------------- |
| `config.maxSummaryChars` | `number` | active-memory 要約で許可される合計最大文字数 |
| `config.recentUserTurns` | `number` | `queryMode` が `recent` のときに含める直前のユーザーターン数 |
| `config.recentAssistantTurns` | `number` | `queryMode` が `recent` のときに含める直前のアシスタントターン数 |
| `config.recentUserChars` | `number` | 各最近のユーザーターンあたりの最大文字数 |
| `config.recentAssistantChars` | `number` | 各最近のアシスタントターンあたりの最大文字数 |
| `config.cacheTtlMs` | `number` | 同一クエリの繰り返しに対するキャッシュ再利用 |
## 推奨設定
`recent` から始めてください。
まずは `recent` から始めてください。
```json5
{
@ -542,28 +542,28 @@ plugins.entries.active-memory
}
```
調整中にライブの挙動を確認したい場合は、別の active-memory デバッグコマンドを探すのではなく、セッション内で `/verbose on` を使用してください。
調整中にライブの動作を確認したい場合は、別個の active-memory デバッグコマンドを探すのではなく、セッションで `/verbose on` を使ってください。
その後、次に移行します。
その後、次のように移行します。
- より低いレイテンシがほしい場合は `message`
- 追加のコンテキストが、より遅いブロッキングメモリサブエージェントに見合うと判断した場合は `full`
- レイテンシを下げたい場合は `message`
- 追加コンテキストにより、より遅いブロッキングメモリサブエージェントでも価値があると判断した場合は `full`
## デバッグ
アクティブメモリが想定した場所で表示されない場合:
期待した場所でアクティブメモリが表示されない場合:
1. `plugins.entries.active-memory.enabled` でプラグインが有効になっていることを確認します。
2. 現在のエージェントIDが `config.agents` に含まれていることを確認します。
3. 対話型の永続チャットセッション経由でテストしていることを確認します。
4. `config.logging: true` を有効にして、Gatewayログを確認します。
5. `openclaw memory status --deep` でメモリ検索自体が動作していることを確認します。
5. `openclaw memory status --deep` でメモリ検索自体が機能していることを検証します。
メモリヒットのノイズが多い場合は、次を厳しくします。
- `maxSummaryChars`
アクティブメモリが遅すぎる場合:
アクティブメモリが遅すぎる場合は、次を検討します。
- `queryMode` を下げる
- `timeoutMs` を下げる