openclaw memory

セマンティックメモリのインデックスと検索を管理します。 アクティブなメモリプラグイン(デフォルト: memory-coreplugins.slots.memory = "none" で無効化可能)が提供するコマンドです。

関連ドキュメント:

使用例

openclaw memory status
openclaw memory status --deep
openclaw memory index --force
openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20
openclaw memory status --json
openclaw memory status --deep --index
openclaw memory status --deep --index --verbose
openclaw memory status --agent main
openclaw memory index --agent main --verbose

オプション

memory statusmemory index:

  • --agent <id>: 単一のエージェントにスコープを限定します。省略すると、設定済みの全エージェントに対して実行されます。エージェントリストが未設定の場合はデフォルトエージェントにフォールバックします。
  • --verbose: プローブおよびインデックス中の詳細ログを出力します。

memory status:

  • --deep: ベクトルストアとエンベディングの可用性をプローブします。
  • --index: ストアがダーティな場合にリインデックスを実行します(--deep を暗黙的に含みます)。
  • --json: JSON形式で出力します。

memory index:

  • --force: 完全なリインデックスを強制します。

memory search:

  • クエリ入力: 位置引数 [query] または --query <text> のいずれかを指定します。
  • 両方指定した場合は --query が優先されます。
  • どちらも指定しない場合はエラーで終了します。
  • --agent <id>: 単一のエージェントにスコープを限定します(デフォルト: デフォルトエージェント)。
  • --max-results <n>: 返される結果の最大数を制限します。
  • --min-score <n>: スコアの低いマッチを除外します。
  • --json: JSON形式で結果を出力します。

補足:

  • memory index --verbose はフェーズごとの詳細(プロバイダ、モデル、ソース、バッチ処理状況)を表示します。
  • memory statusmemorySearch.extraPaths で設定された追加パスも含みます。
  • アクティブなメモリリモートAPIキーフィールドがSecretRefとして設定されている場合、コマンドはアクティブなゲートウェイスナップショットからそれらの値を解決します。ゲートウェイが利用できない場合、コマンドは即座に失敗します。
  • ゲートウェイバージョンの互換性に関する注意: このコマンドパスは secrets.resolve をサポートするゲートウェイが必要です。古いゲートウェイでは unknown-method エラーが返されます。