@joshuaswarren/openclaw-engram 9.3.16 → 9.3.18

package/openclaw.plugin.json

@@ -1,9 +1,23 @@
 {
   "id": "openclaw-engram",
   "name": "Remnic OpenClaw Plugin",
-  "version": "9.3.16",
+  "version": "9.3.18",
   "kind": "memory",
-  "description": "Local semantic memory for OpenClaw. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
+  "description": "Local semantic memory for OpenClaw with bundled Remnic core runtime. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
+  "setup": {
+    "providers": [
+      {
+        "id": "openai",
+        "authMethods": [
+          "api-key"
+        ],
+        "envVars": [
+          "OPENAI_API_KEY"
+        ]
+      }
+    ],
+    "requiresRuntime": false
+  },
   "providerAuthEnvVars": {
     "openai": [
       "OPENAI_API_KEY"
@@ -14,19 +28,39 @@
       "provider": "openai",
       "method": "api-key",
       "choiceId": "remnic-openai-api-key",
-      "choiceLabel": "OpenAI API key for Remnic memory extraction",
-      "choiceHint": "Remnic sends memory extraction, consolidation, and embedding requests to OpenAI or the configured OpenAI-compatible endpoint unless you route those tasks through OpenClaw gateway/local LLM settings.",
+      "choiceLabel": "Optional OpenAI API key for Remnic plugin-mode extraction",
+      "choiceHint": "Not needed when Remnic uses the OpenClaw gateway model source. Set only if you intentionally use plugin mode with OpenAI or an OpenAI-compatible endpoint.",
       "groupId": "remnic-memory",
       "groupLabel": "Remnic memory",
       "optionKey": "openaiApiKey",
       "cliFlag": "--openai-api-key",
       "cliOption": "--openai-api-key <key>",
-      "cliDescription": "OpenAI API key used by Remnic memory extraction, consolidation, and embedding flows.",
+      "cliDescription": "Optional OpenAI API key used by Remnic plugin-mode extraction, consolidation, and embedding flows.",
       "onboardingScopes": [
         "text-inference"
       ]
     }
   ],
+  "securityDisclosure": {
+    "conversationAccess": "As a memory-slot plugin, Remnic hooks can observe conversation turns, tool-use metadata, LLM output metadata, and local memory files so they can be indexed, summarized, recalled, and exposed through memory tools.",
+    "modelProviderCredentials": {
+      "recommendedMode": "Use modelSource=gateway to route LLM-backed memory work through OpenClaw gateway agents instead of a Remnic-owned API key.",
+      "dynamicCredentialSources": [
+        "OpenClaw runtime auth resolver for configured model providers",
+        "~/.openclaw/agents/main/agent/models.json provider entries",
+        "provider-specific environment variables such as <PROVIDER>_API_KEY and <PROVIDER>_TOKEN"
+      ],
+      "providerModeData": [
+        "conversation excerpts",
+        "memory excerpts",
+        "summaries",
+        "embedding inputs",
+        "active-recall query inputs",
+        "benchmark and evaluation inputs"
+      ],
+      "externalProviderGuidance": "Do not set openaiApiKey or provider environment variables for Remnic if all LLM-backed memory operations should stay on the OpenClaw gateway path. When plugin/provider mode is configured, selected conversation and memory excerpts may be sent to the configured provider for extraction, consolidation, summarization, embeddings, active recall, or benchmark judging."
+    }
+  },
   "supports": {
     "memorySlot": true,
     "dreamingSlot": true,
@@ -36,6 +70,34 @@
     "beforeReset": true
   },
   "contracts": {
+    "commands": [
+      "remnic"
+    ],
+    "hooks": [
+      "before_prompt_build",
+      "before_agent_start",
+      "agent_end",
+      "before_compaction",
+      "after_compaction",
+      "before_reset",
+      "session_start",
+      "session_end",
+      "before_tool_call",
+      "after_tool_call",
+      "llm_output",
+      "subagent_spawning",
+      "subagent_ended",
+      "commands.list"
+    ],
+    "memoryCapabilities": [
+      "openclaw-remnic"
+    ],
+    "memoryPromptSections": [
+      "engram-memory"
+    ],
+    "services": [
+      "openclaw-remnic"
+    ],
     "tools": [
       "compounding_promote_candidate",
       "compounding_weekly_synthesize",
@@ -93,11 +155,11 @@
     "properties": {
       "openaiApiKey": {
         "type": "string",
-        "description": "OpenAI API key (or set OPENAI_API_KEY env var). Remnic may send conversation and memory content to OpenAI or the configured OpenAI-compatible endpoint for extraction, consolidation, summarization, and embeddings."
+        "description": "Optional OpenAI API key for plugin mode (or set OPENAI_API_KEY env var). Ignored by default gateway-mode installs; in plugin mode, Remnic may send conversation and memory content to OpenAI or the configured OpenAI-compatible endpoint for extraction, consolidation, summarization, and embeddings."
       },
       "openaiBaseUrl": {
         "type": "string",
-        "description": "Override the OpenAI API base URL for OpenAI-compatible providers (Scryr, Together, OpenRouter, etc.)"
+        "description": "Set the OpenAI API base URL for OpenAI-compatible providers (Scryr, Together, OpenRouter, etc.)"
       },
       "model": {
         "type": "string",
@@ -180,7 +242,7 @@
       "maxMemoryTokens": {
         "type": "number",
         "default": 2000,
-        "description": "Max tokens injected per turn"
+        "description": "Max memory-context tokens per turn"
       },
       "memoryOsPreset": {
         "type": "string",
@@ -191,7 +253,7 @@
           "research-max",
           "local-llm-heavy"
         ],
-        "description": "Optional named preset that seeds Engram's advanced config surface before explicit per-setting overrides are applied. `research` is accepted as a backward-compatible alias for `research-max`."
+        "description": "Optional named preset that seeds Engram's advanced config surface before explicit per-setting settings are applied. `research` is accepted as a backward-compatible alias for `research-max`."
       },
       "qmdEnabled": {
         "type": "boolean",
@@ -283,7 +345,7 @@
       },
       "entitySchemas": {
         "type": "object",
-        "description": "Optional per-entity-type structured section schema overrides.",
+        "description": "Optional per-entity-type structured section schema customizations.",
         "additionalProperties": {
           "type": "object",
           "additionalProperties": false,
@@ -624,7 +686,7 @@
             "minimum": 1,
             "maximum": 10,
             "default": 2,
-            "description": "Maximum procedure memories to inject on task-initiation recall."
+            "description": "Maximum procedure memories to add on task-initiation recall."
           },
           "proceduralMiningCronAutoRegister": {
             "type": "boolean",
@@ -712,7 +774,7 @@
       "recallTranscriptsEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Write JSONL recall audit transcripts for runtime-surface injections."
+        "description": "Write JSONL recall audit transcripts for runtime recall-context assembly."
       },
       "recallTranscriptRetentionDays": {
         "type": "integer",
@@ -729,7 +791,7 @@
       "activeRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Enable the OpenClaw active-recall prompt surface."
+        "description": "Enable the OpenClaw active-recall context surface."
       },
       "activeRecallAgents": {
         "type": "array",
@@ -776,15 +838,15 @@
           "preference-only"
         ],
         "default": "balanced",
-        "description": "Prompt assembly style for the active-recall surface."
+        "description": "Context assembly style for the active-recall surface."
       },
-      "activeRecallPromptOverride": {
+      "activeRecallCustomInstruction": {
         "type": "string",
-        "description": "Optional full prompt override for the active-recall surface."
+        "description": "Optional custom guidance for the active-recall builder."
       },
       "activeRecallPromptAppend": {
         "type": "string",
-        "description": "Optional prompt suffix appended to the active-recall system prompt."
+        "description": "Optional additional guidance for the active-recall builder."
       },
       "activeRecallMaxSummaryChars": {
         "type": "integer",
@@ -850,7 +912,7 @@
       },
       "activeRecallModel": {
         "type": "string",
-        "description": "Optional model override for active recall."
+        "description": "Optional model selection for active recall."
       },
       "activeRecallModelFallbackPolicy": {
         "type": "string",
@@ -1166,7 +1228,7 @@
       "memoryExtensionsEnabled": {
         "type": "boolean",
         "default": true,
-        "description": "Whether third-party memory extensions are discovered and injected into consolidation prompts."
+        "description": "Whether third-party memory extensions are discovered and included in consolidation instructions."
       },
       "memoryExtensionsRoot": {
         "type": "string",
@@ -1250,12 +1312,12 @@
           "full"
         ],
         "default": "recovery_only",
-        "description": "Controls when identity continuity context is injected into recall assembly"
+        "description": "Controls when identity continuity context is added to recall assembly"
       },
       "identityMaxInjectChars": {
         "type": "number",
         "default": 1200,
-        "description": "Maximum characters allowed for identity continuity context injection"
+        "description": "Maximum characters allowed for identity continuity context"
       },
       "continuityIncidentLoggingEnabled": {
         "type": "boolean",
@@ -1320,7 +1382,7 @@
       "injectQuestions": {
         "type": "boolean",
         "default": false,
-        "description": "Inject the most relevant open question into the system prompt"
+        "description": "Include the most relevant open question in generated memory context"
       },
       "commitmentDecayDays": {
         "type": "number",
@@ -1456,12 +1518,12 @@
           "maxResults": {
             "type": "number",
             "default": 4,
-            "description": "Maximum native knowledge chunks to inject into recall."
+            "description": "Maximum native knowledge chunks to add to recall."
           },
           "maxChars": {
             "type": "number",
             "default": 2400,
-            "description": "Maximum total characters to inject from native knowledge recall."
+            "description": "Maximum total characters to add from native knowledge recall."
           },
           "stateDir": {
             "type": "string",
@@ -1735,7 +1797,7 @@
       "recordEmptyRecallImpressions": {
         "type": "boolean",
         "default": false,
-        "description": "Record recall impressions with empty memoryIds when no memory context is injected."
+        "description": "Record recall impressions with empty memoryIds when no memory context is added."
       },
       "recallPlannerEnabled": {
         "type": "boolean",
@@ -1810,7 +1872,7 @@
       "verbatimArtifactsMaxRecall": {
         "type": "number",
         "default": 5,
-        "description": "Maximum artifact anchors injected per recall."
+        "description": "Maximum artifact anchors added per recall."
       },
       "verbatimArtifactCategories": {
         "type": "array",
@@ -1876,7 +1938,7 @@
       "boxRecallDays": {
         "type": "number",
         "default": 3,
-        "description": "Number of recent days of boxes to inject during recall."
+        "description": "Number of recent days of boxes to add during recall."
       },
       "episodeNoteModeEnabled": {
         "type": "boolean",
@@ -1941,7 +2003,7 @@
       "tagRecallMaxMatches": {
         "type": "number",
         "default": 10,
-        "description": "Maximum number of tag-matched memories injected per recall."
+        "description": "Maximum number of tag-matched memories added per recall."
       },
       "multiGraphMemoryEnabled": {
         "type": "boolean",
@@ -1971,7 +2033,7 @@
       "graphRecallShadowEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Run graph recall in shadow mode — evaluate but do not inject results."
+        "description": "Run graph recall in shadow mode - evaluate but do not add results."
       },
       "graphRecallSnapshotEnabled": {
         "type": "boolean",
@@ -2085,12 +2147,12 @@
       "graphRecallEntityHintMax": {
         "type": "number",
         "default": 3,
-        "description": "Maximum number of entity hints injected per graph recall result."
+        "description": "Maximum number of entity hints added per graph recall result."
       },
       "graphRecallEntityHintMaxChars": {
         "type": "number",
         "default": 200,
-        "description": "Maximum characters per entity hint injected during graph recall."
+        "description": "Maximum characters per entity hint added during graph recall."
       },
       "graphRecallSnapshotDir": {
         "type": "string",
@@ -2119,7 +2181,7 @@
       "graphAssistShadowEvalEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "In full mode, compute graph assist for comparison telemetry and snapshots but keep injected recall output baseline-identical."
+        "description": "In full mode, compute graph assist for comparison telemetry and snapshots but keep recall output baseline-identical."
       },
       "graphAssistMinSeedResults": {
         "type": "number",
@@ -2197,12 +2259,12 @@
       "recallConfidenceGateEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Synapse-inspired confidence gate: skip memory injection when top recall score is below threshold"
+        "description": "Synapse-inspired confidence gate: skip memory context when top recall score is below threshold"
       },
       "recallConfidenceGateThreshold": {
         "type": "number",
         "default": 0.12,
-        "description": "Minimum top recall score to inject memories (0-1). Below this, memories are rejected as too uncertain"
+        "description": "Minimum top recall score to include memories (0-1). Below this, memories are rejected as too uncertain"
       },
       "causalRuleExtractionEnabled": {
         "type": "boolean",
@@ -2808,12 +2870,12 @@
       "maxTranscriptTurns": {
         "type": "number",
         "default": 50,
-        "description": "Maximum transcript turns to inject"
+        "description": "Maximum transcript turns to include"
       },
       "maxTranscriptTokens": {
         "type": "number",
         "default": 1000,
-        "description": "Maximum tokens for transcript injection"
+        "description": "Maximum tokens for transcript context"
       },
       "checkpointEnabled": {
         "type": "boolean",
@@ -2828,7 +2890,7 @@
       "compactionResetEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Trigger session reset after compaction with BOOT.md injection (requires OC fork with api.resetSession)"
+        "description": "Trigger session reset after compaction with BOOT.md recovery context (requires OC fork with api.resetSession)"
       },
       "hourlySummariesEnabled": {
         "type": "boolean",
@@ -2848,7 +2910,7 @@
       "maxSummaryCount": {
         "type": "number",
         "default": 6,
-        "description": "Maximum number of summaries to inject"
+        "description": "Maximum number of summaries to include"
       },
       "summaryModel": {
         "type": "string",
@@ -2860,8 +2922,8 @@
           "plugin",
           "gateway"
         ],
-        "default": "plugin",
-        "description": "LLM source: 'plugin' uses Engram's own openai/localLlm config; 'gateway' delegates to a gateway agent's model chain (agents.list[])."
+        "default": "gateway",
+        "description": "LLM source: 'gateway' delegates to a gateway agent's model chain (agents.list[]); 'plugin' uses Engram's own openai/localLlm config."
       },
       "gatewayAgentId": {
         "type": "string",
@@ -2939,7 +3001,7 @@
       "traceRecallContent": {
         "type": "boolean",
         "default": false,
-        "description": "If true, include the full recalled memory text in RecallTraceEvent.recalledContent emitted to __openclawEngramTrace subscribers (e.g. Langfuse). Disabled by default — only enable when you want external trace collectors to capture injected memory context."
+        "description": "If true, include the full recalled memory text in RecallTraceEvent.recalledContent emitted to __openclawEngramTrace subscribers (e.g. Langfuse). Disabled by default - only enable when you want external trace collectors to capture memory context."
       },
       "profilingEnabled": {
         "type": "boolean",
@@ -3156,7 +3218,7 @@
       "localLlmDisableThinking": {
         "type": "boolean",
         "default": true,
-        "description": "When true (default), request chain-of-thought / thinking-mode suppression on the main local LLM (issue #548). The `chat_template_kwargs: { enable_thinking: false }` field is only injected when the detected backend is known to support it (LM Studio, vLLM); strict OpenAI-compat backends fail open to avoid the 400-cooldown path. Structured-output tasks like extraction and consolidation gain nothing from reasoning tokens and thinking-capable models (Qwen 3.5, Gemma 4, DeepSeek) often blow the 60s timeout before emitting content. Set to false to restore thinking for narrative tasks. The fast-tier client always disables thinking and is not affected by this flag."
+        "description": "When true (default), request chain-of-thought / thinking-mode suppression on the main local LLM (issue #548). The `chat_template_kwargs: { enable_thinking: false }` field is sent only when the detected backend is known to support it (LM Studio, vLLM); strict OpenAI-compat backends fail open to avoid the 400-cooldown path. Structured-output tasks like extraction and consolidation gain nothing from reasoning tokens and thinking-capable models (Qwen 3.5, Gemma 4, DeepSeek) often blow the 60s timeout before emitting content. Set to false to restore thinking for narrative tasks. The fast-tier client always disables thinking and is not affected by this flag."
       },
       "hourlySummaryCronAutoRegister": {
         "type": "boolean",
@@ -3270,12 +3332,12 @@
       "conversationRecallTopK": {
         "type": "number",
         "default": 3,
-        "description": "Top-K conversation chunks to inject."
+        "description": "Top-K conversation chunks to include."
       },
       "conversationRecallMaxChars": {
         "type": "number",
         "default": 2500,
-        "description": "Max characters of semantic conversation recall to inject."
+        "description": "Max characters of semantic conversation recall to include."
       },
       "conversationRecallTimeoutMs": {
         "type": "number",
@@ -3324,7 +3386,7 @@
       "objectiveStateRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Inject prompt-relevant objective-state snapshots into recall context."
+        "description": "Add recall-relevant objective-state snapshots to recall context."
       },
       "objectiveStateStoreDir": {
         "type": "string",
@@ -3342,7 +3404,7 @@
       "causalTrajectoryRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Inject prompt-relevant causal trajectories into recall context."
+        "description": "Add recall-relevant causal trajectories to recall context."
       },
       "trustZonesEnabled": {
         "type": "boolean",
@@ -3361,7 +3423,7 @@
       "trustZoneRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Inject prompt-relevant working and trusted trust-zone records into recall context."
+        "description": "Add recall-relevant working and trusted trust-zone records to recall context."
       },
       "memoryPoisoningDefenseEnabled": {
         "type": "boolean",
@@ -3376,7 +3438,7 @@
       "harmonicRetrievalEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Enable harmonic retrieval blending over abstraction nodes and cue anchors, including recall-section injection and harmonic-search diagnostics."
+        "description": "Enable harmonic retrieval blending over abstraction nodes and cue anchors, including recall-section assembly and harmonic-search diagnostics."
       },
       "abstractionAnchorsEnabled": {
         "type": "boolean",
@@ -3390,7 +3452,7 @@
       "verifiedRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Inject prompt-relevant memory boxes only when their cited source memories verify as non-archived episodes."
+        "description": "Add recall-relevant memory boxes only when their cited source memories verify as non-archived episodes."
       },
       "semanticRulePromotionEnabled": {
         "type": "boolean",
@@ -3447,7 +3509,7 @@
       "operatorAwareConsolidationEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Opt in to operator-aware consolidation prompts so the LLM returns structured {operator, output} JSON and SPLIT/MERGE/UPDATE is recorded on derived_via. When disabled (default), derived_via still populates via the cluster-shape heuristic."
+        "description": "Opt in to operator-aware consolidation instructions so the LLM returns structured {operator, output} JSON and SPLIT/MERGE/UPDATE is recorded on derived_via. When disabled (default), derived_via still populates via the cluster-shape heuristic."
       },
       "peerProfileReasonerEnabled": {
         "type": "boolean",
@@ -3474,13 +3536,13 @@
       "peerProfileRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "When true, inject the active peer's profile fields into the recall context as a '## Peer Profile' section (issue #679 PR 3/5). Requires the session's peer ID to be registered before recall. Default off (opt-in)."
+        "description": "When true, add the active peer's profile fields to the recall context as a '## Peer Profile' section (issue #679 PR 3/5). Requires the session's peer ID to be registered before recall. Default off (opt-in)."
       },
       "peerProfileRecallMaxFields": {
         "type": "number",
         "default": 5,
         "minimum": 0,
-        "description": "Maximum number of peer profile fields to inject per recall call. Only the most-recently-updated N fields are included. Set to 0 to disable field injection even when peerProfileRecallEnabled is true."
+        "description": "Maximum number of peer profile fields to add per recall call. Only the most-recently-updated N fields are included. Set to 0 to disable field inclusion even when peerProfileRecallEnabled is true."
       },
       "creationMemoryEnabled": {
         "type": "boolean",
@@ -3528,7 +3590,7 @@
       "workProductRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Inject prompt-relevant work-product ledger entries into recall context and expose artifact-recovery search tooling."
+        "description": "Add recall-relevant work-product ledger entries to recall context and expose artifact-recovery search tooling."
       },
       "workProductLedgerDir": {
         "type": "string",
@@ -3768,7 +3830,7 @@
       "sharedContextEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Enable shared-context injection + tools (v4.0). Default off."
+        "description": "Enable shared-context assembly and tools (v4.0). Default off."
       },
       "sharedContextDir": {
         "type": "string",
@@ -3777,7 +3839,7 @@
       "sharedContextMaxInjectChars": {
         "type": "number",
         "default": 4000,
-        "description": "Max characters of shared-context to inject into each prompt."
+        "description": "Max characters of shared-context to include in each recall context."
       },
       "crossSignalsSemanticEnabled": {
         "type": "boolean",
@@ -4050,17 +4112,17 @@
       "calibrationEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Enable recall calibration rules injection (v9.0, default off)."
+        "description": "Enable recall calibration rules (v9.0, default off)."
       },
       "calibrationMaxRulesPerRecall": {
         "type": "number",
         "default": 10,
-        "description": "Maximum number of calibration rules to inject per recall pass."
+        "description": "Maximum number of calibration rules to include per recall pass."
       },
       "calibrationMaxChars": {
         "type": "number",
         "default": 1200,
-        "description": "Maximum characters of calibration content to inject per recall pass."
+        "description": "Maximum characters of calibration content to include per recall pass."
       },
       "lancedbEnabled": {
         "type": "boolean",
@@ -4225,7 +4287,7 @@
       },
       "recallBudgetChars": {
         "type": "number",
-        "description": "Hard character cap for total recall injection. Defaults to maxMemoryTokens * 4."
+        "description": "Hard character cap for total recall context. Defaults to maxMemoryTokens * 4."
       },
       "recallOuterTimeoutMs": {
         "type": "number",
@@ -4245,7 +4307,7 @@
       "recallMmrEnabled": {
         "type": "boolean",
         "default": true,
-        "description": "Apply Maximal Marginal Relevance to the final recall selection per-section so one redundant cluster cannot dominate the injected context."
+        "description": "Apply Maximal Marginal Relevance to the final recall selection per-section so one redundant cluster cannot dominate the included context."
       },
       "recallMmrLambda": {
         "type": "number",
@@ -4386,7 +4448,7 @@
       "messagePartsRecallMaxResults": {
         "type": "number",
         "default": 6,
-        "description": "Maximum structured message-part matches to inject into recall when messagePartsEnabled is true."
+        "description": "Maximum structured message-part matches to include in recall when messagePartsEnabled is true."
       },
       "ircEnabled": {
         "type": "boolean",
@@ -4396,7 +4458,7 @@
       "ircMaxPreferences": {
         "type": "number",
         "default": 20,
-        "description": "Maximum number of preferences to include in IRC rule injection."
+        "description": "Maximum number of preferences to include in IRC rules."
       },
       "ircIncludeCorrections": {
         "type": "boolean",
@@ -4451,7 +4513,7 @@
       "cmcRetrievalEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Enable CMC retrieval injection at recall time (default off)."
+        "description": "Enable CMC retrieval at recall time (default off)."
       },
       "cmcRetrievalMaxDepth": {
         "type": "number",
@@ -4461,7 +4523,7 @@
       "cmcRetrievalMaxChars": {
         "type": "number",
         "default": 800,
-        "description": "Maximum characters of CMC content injected per recall pass."
+        "description": "Maximum characters of CMC content included per recall pass."
       },
       "cmcRetrievalCounterfactualBoost": {
         "type": "number",
@@ -4596,7 +4658,7 @@
       "label": "OpenAI API Key",
       "sensitive": true,
       "placeholder": "sk-...",
-      "help": "API key for OpenAI (or use ${OPENAI_API_KEY})"
+      "help": "Optional API key for plugin mode only. Not needed when Model Source is gateway."
     },
     "openaiBaseUrl": {
       "label": "OpenAI Base URL",
@@ -4737,13 +4799,13 @@
       "help": "Enable identity continuity workflows (anchor, incidents, audits)"
     },
     "identityInjectionMode": {
-      "label": "Identity Injection Mode",
+      "label": "Identity Context Mode",
       "advanced": true,
       "placeholder": "recovery_only",
-      "help": "When to inject identity continuity context: recovery_only, minimal, or full"
+      "help": "When to add identity continuity context: recovery_only, minimal, or full"
     },
     "identityMaxInjectChars": {
-      "label": "Identity Max Inject Chars",
+      "label": "Identity Max Context Chars",
       "advanced": true,
       "placeholder": "1200"
     },
@@ -4774,7 +4836,7 @@
     },
     "injectQuestions": {
       "label": "Inject Questions",
-      "help": "Include the most relevant open question in the system prompt"
+      "help": "Include the most relevant open question in generated memory context"
     },
     "commitmentDecayDays": {
       "label": "Commitment Decay (days)",
@@ -5020,7 +5082,7 @@
     },
     "compactionResetEnabled": {
       "label": "Compaction Reset",
-      "help": "Reset session after compaction and inject BOOT.md for recovery",
+      "help": "Reset session after compaction and add BOOT.md recovery context",
       "advanced": true
     },
     "hourlySummariesEnabled": {
@@ -5044,7 +5106,7 @@
     },
     "modelSource": {
       "label": "Model Source",
-      "help": "Route LLM calls through the gateway's agent model chain instead of Engram's own config. When set to 'gateway', localLlm and openai settings are ignored."
+      "help": "Route LLM calls through the gateway's agent model chain instead of Engram's own config. Default for OpenClaw installs. When set to 'gateway', localLlm and openai settings are ignored."
     },
     "gatewayAgentId": {
       "label": "Gateway Agent ID",
@@ -5182,7 +5244,7 @@
     "objectiveStateRecallEnabled": {
       "label": "Objective-State Recall",
       "advanced": true,
-      "help": "Inject prompt-relevant objective-state snapshots into recall context."
+      "help": "Add recall-relevant objective-state snapshots to recall context."
     },
     "objectiveStateStoreDir": {
       "label": "Objective-State Store Directory",
@@ -5203,7 +5265,7 @@
     "causalTrajectoryRecallEnabled": {
       "label": "Causal Trajectory Recall",
       "advanced": true,
-      "help": "Inject prompt-relevant causal trajectories into recall context."
+      "help": "Add recall-relevant causal trajectories to recall context."
     },
     "trustZonesEnabled": {
       "label": "Trust Zones",
@@ -5223,7 +5285,7 @@
     "trustZoneRecallEnabled": {
       "label": "Trust-Zone Recall",
       "advanced": true,
-      "help": "Inject prompt-relevant working and trusted trust-zone records into recall context."
+      "help": "Add recall-relevant working and trusted trust-zone records to recall context."
     },
     "memoryPoisoningDefenseEnabled": {
       "label": "Memory Poisoning Defense",
@@ -5237,7 +5299,7 @@
     },
     "harmonicRetrievalEnabled": {
       "label": "Harmonic Retrieval",
-      "help": "Enable harmonic retrieval blending over abstraction nodes and cue anchors, including recall-section injection and harmonic-search diagnostics."
+      "help": "Enable harmonic retrieval blending over abstraction nodes and cue anchors, including recall-section assembly and harmonic-search diagnostics."
     },
     "abstractionAnchorsEnabled": {
       "label": "Abstraction Anchors",
@@ -5252,7 +5314,7 @@
     },
     "verifiedRecallEnabled": {
       "label": "Verified Recall",
-      "help": "Inject prompt-relevant memory boxes only when their cited source memories verify as non-archived episodes."
+      "help": "Add recall-relevant memory boxes only when their cited source memories verify as non-archived episodes."
     },
     "semanticRulePromotionEnabled": {
       "label": "Semantic Rule Promotion",
@@ -5300,9 +5362,9 @@
       "help": "Max memories to consolidate per run to limit LLM cost."
     },
     "operatorAwareConsolidationEnabled": {
-      "label": "Operator-Aware Consolidation Prompt",
+      "label": "Operator-Aware Consolidation",
       "advanced": true,
-      "help": "Opt in to operator-aware consolidation prompts (default off). When enabled, the LLM returns structured {operator, output} JSON and we record SPLIT/MERGE/UPDATE on derived_via. When disabled (default), derived_via still populates via the cluster-shape heuristic."
+      "help": "Opt in to operator-aware consolidation instructions (default off). When enabled, the LLM returns structured {operator, output} JSON and we record SPLIT/MERGE/UPDATE on derived_via. When disabled (default), derived_via still populates via the cluster-shape heuristic."
     },
     "peerProfileReasonerEnabled": {
       "label": "Peer Profile Reasoner",
@@ -5325,14 +5387,14 @@
       "help": "Hard cap on the total number of profile fields the reasoner will apply across all peers in a single run. Set to 0 to disable applying any fields."
     },
     "peerProfileRecallEnabled": {
-      "label": "Peer Profile Recall Injection",
+      "label": "Peer Profile Recall",
       "advanced": true,
-      "help": "When enabled, injects the active peer's profile fields into recall context as a '## Peer Profile' section. Requires the session peer ID to be registered. Default off."
+      "help": "When enabled, adds the active peer's profile fields to recall context as a '## Peer Profile' section. Requires the session peer ID to be registered. Default off."
     },
     "peerProfileRecallMaxFields": {
       "label": "Peer Profile Recall Max Fields",
       "advanced": true,
-      "help": "Maximum number of peer profile fields to inject per recall. Only the most-recently-updated N fields are included. Set to 0 to disable injection."
+      "help": "Maximum number of peer profile fields to add per recall. Only the most-recently-updated N fields are included. Set to 0 to disable this feature."
     },
     "creationMemoryEnabled": {
       "label": "Creation Memory",
@@ -5384,7 +5446,7 @@
     "workProductRecallEnabled": {
       "label": "Work-Product Recall",
       "advanced": true,
-      "help": "Inject prompt-relevant work-product ledger entries into recall context and expose artifact-recovery search tooling."
+      "help": "Add recall-relevant work-product ledger entries to recall context and expose artifact-recovery search tooling."
     },
     "workProductLedgerDir": {
       "label": "Work-Product Ledger Directory",
@@ -5650,5 +5712,21 @@
       "advanced": true,
       "help": "Promote stored reasoning_trace memories to the top of recall results when the incoming query reads like a problem-solving ask. Default off; enable after benchmarking (issue #564)."
     }
+  },
+  "commandAliases": [
+    {
+      "name": "remnic",
+      "kind": "runtime-slash",
+      "cliCommand": "remnic"
+    }
+  ],
+  "activation": {
+    "onCommands": [
+      "remnic"
+    ],
+    "onCapabilities": [
+      "tool",
+      "hook"
+    ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshuaswarren/openclaw-engram",
-  "version": "9.3.16",
+  "version": "9.3.18",
   "description": "Deprecated compatibility shim for Engram installs. Re-exports @remnic/plugin-openclaw and forwards engram-access to @remnic/core.",
   "type": "module",
   "main": "dist/index.js",
@@ -31,8 +31,8 @@
     ]
   },
   "dependencies": {
-    "@remnic/plugin-openclaw": "^1.0.20",
-    "@remnic/core": "^1.1.8"
+    "@remnic/core": "^1.1.9",
+    "@remnic/plugin-openclaw": "^1.0.32"
   },
   "peerDependencies": {
     "openclaw": ">=2026.4.8"