@remnic/plugin-openclaw 1.0.29 → 1.0.31

package/README.md

@@ -99,6 +99,23 @@ Credential and model-provider behavior is explicit:
 - Plugin/provider modes may read configured model credentials from the OpenClaw auth resolver, OpenClaw's materialized provider config at `~/.openclaw/agents/main/agent/models.json`, or provider-specific environment variables such as `<PROVIDER>_API_KEY` and `<PROVIDER>_TOKEN`.
 - Do not set `openaiApiKey` or provider environment variables for Remnic if you want all LLM-backed memory work routed through the gateway.
 
+The npm package also declares this surface in `package.json` under
+`openclaw.environment` so ClawHub and other registries can show the optional
+provider env vars, config path, and external-model routing behavior before
+installation.
+
+## Privacy Boundary
+
+OpenClaw hook runtime metadata such as authorization headers, API keys, provider
+credential objects, and bearer tokens is operational metadata. Remnic does not
+persist those fields to transcripts, extraction buffers, recall audit entries,
+logs, or memory content.
+
+User-authored message text is different: Remnic is a memory plugin, so message
+content can be stored, extracted, summarized, embedded, or recalled according to
+the configured memory policy. Do not paste secrets into chat when you do not
+want them treated as conversation content.
+
 ## Plugin Inspection
 
 Run the OpenClaw plugin inspector with:
@@ -114,6 +131,24 @@ guarded in the adapter, including `registerMemoryCapability`, `registerCli`,
 and `registerCommand`; keep runtime capture coverage for those surfaces in a
 separate adapter test slice.
 
+Run the deterministic OpenClaw adapter scenario suite with:
+
+```bash
+npm run test:openclaw-scenarios
+```
+
+The suite covers the registered memory tools and lifecycle hooks without live
+OpenClaw, LLM credentials, or network calls.
+
+Run the OpenClaw hook privacy suite with:
+
+```bash
+npm run test:openclaw-privacy
+```
+
+The suite guards against runtime auth metadata leaking into persisted memory,
+transcript, recall-audit, or debug-log surfaces.
+
 ## SDK Surface Drift Check
 
 The adapter keeps a conservative OpenClaw SDK surface snapshot at

package/dist/index.js

@@ -7104,7 +7104,7 @@ Consolidate the new memories against existing ones.`
       return { items: [], profileUpdates: [], entityUpdates: [] };
     }
     try {
-      const systemPrompt = `You are a memory consolidation system. Compare new memories against existing ones and decide what to do with each.
+      const instructionText = `You are a memory consolidation system. Compare new memories against existing ones and decide what to do with each.
 
 Actions:
 - ADD: Keep the new memory as-is (no duplicate exists)
@@ -7132,7 +7132,7 @@ ${CONSOLIDATION_RESPONSE_SCHEMA}`;
       const response = await this.client.chat.completions.create({
         model: this.config.model,
         messages: [
-          { role: "system", content: systemPrompt },
+          { role: "system", content: instructionText },
           { role: "user", content: "Consolidate the new memories against existing ones." }
         ],
         ...this.config.reasoningEffort !== "none" ? { reasoning_effort: this.config.reasoningEffort } : {},
@@ -7321,7 +7321,7 @@ The output should be the COMPLETE consolidated profile as valid markdown, starti
       return null;
     }
     try {
-      const systemPrompt = `You are a profile consolidation system. You are given a behavioral profile (markdown) that has grown too large. Your job is to produce a CONSOLIDATED version that:
+      const instructionText = `You are a profile consolidation system. You are given a behavioral profile (markdown) that has grown too large. Your job is to produce a CONSOLIDATED version that:
 
 1. PRESERVES all ## section headers and their structure
 2. MERGES duplicate or near-duplicate bullet points into single, clear statements
@@ -7342,7 +7342,7 @@ Respond with valid JSON matching this schema:
       const response = await this.client.chat.completions.create({
         model: this.config.model,
         messages: [
-          { role: "system", content: systemPrompt },
+          { role: "system", content: instructionText },
           { role: "user", content: fullProfileContent }
         ],
         ...this.config.reasoningEffort !== "none" ? { reasoning_effort: this.config.reasoningEffort } : {},
@@ -7523,7 +7523,7 @@ The goal is to reduce a bloated file to a compact, high-signal set of learned pa
       return null;
     }
     try {
-      const systemPrompt = `You are an identity consolidation system. You are given the full contents of an IDENTITY.md file that contains many individual reflection entries. Your job is to:
+      const instructionText = `You are an identity consolidation system. You are given the full contents of an IDENTITY.md file that contains many individual reflection entries. Your job is to:
 
 1. Read all the reflection entries (sections starting with "## Reflection")
 2. Extract the most important, durable behavioral patterns and lessons learned
@@ -7542,7 +7542,7 @@ Respond with valid JSON matching this schema:
       const response = await this.client.chat.completions.create({
         model: this.config.model,
         messages: [
-          { role: "system", content: systemPrompt },
+          { role: "system", content: instructionText },
           { role: "user", content: fullIdentityContent }
         ],
         ...this.config.reasoningEffort !== "none" ? { reasoning_effort: this.config.reasoningEffort } : {},
@@ -7671,7 +7671,7 @@ Memory 2 (new):
 Category: ${newMemory.category}
 Content: ${newMemory.content}`;
     try {
-      const systemPrompt = `You are a contradiction detection system. Analyze whether two memories contradict each other.
+      const instructionText = `You are a contradiction detection system. Analyze whether two memories contradict each other.
 
 IMPORTANT: Not all similar memories are contradictions!
 - "User likes TypeScript" and "User likes Python" are NOT contradictions (preferences can coexist)
@@ -7697,7 +7697,7 @@ Respond with valid JSON matching this schema:
         try {
           const localResponse = await this.localLlm.chatCompletion(
             [
-              { role: "system", content: systemPrompt },
+              { role: "system", content: instructionText },
               { role: "user", content: input }
             ],
             {
@@ -7730,7 +7730,7 @@ Respond with valid JSON matching this schema:
       if (!this.shouldUseDirectClient) {
         const fallbackResponse = await this.fallbackLlm.chatCompletion(
           [
-            { role: "system", content: systemPrompt },
+            { role: "system", content: instructionText },
             { role: "user", content: input }
           ],
           this.withGatewayAgent({ temperature: 0.3, maxTokens: 2048 })
@@ -7750,7 +7750,7 @@ Respond with valid JSON matching this schema:
       const response = await this.client.chat.completions.create({
         model: this.config.model,
         messages: [
-          { role: "system", content: systemPrompt },
+          { role: "system", content: instructionText },
           { role: "user", content: input }
         ],
         ...buildChatCompletionTokenLimit(this.config.model, 2048, {
@@ -7790,7 +7790,7 @@ Content: ${newMemory.content}
 Candidate memories to link to:
 ${candidateList}`;
     try {
-      const systemPrompt = `You are a memory linking system. Analyze the new memory and suggest relationships to existing memories.
+      const instructionText = `You are a memory linking system. Analyze the new memory and suggest relationships to existing memories.
 
 Link types:
 - follows: This memory is a continuation or next step (e.g., decision follows discussion)
@@ -7813,7 +7813,7 @@ Respond with valid JSON matching this schema:
         try {
           const localResponse = await this.localLlm.chatCompletion(
             [
-              { role: "system", content: systemPrompt },
+              { role: "system", content: instructionText },
               { role: "user", content: input }
             ],
             {
@@ -7842,7 +7842,7 @@ Respond with valid JSON matching this schema:
       if (!this.shouldUseDirectClient) {
         const fallbackResponse = await this.fallbackLlm.chatCompletion(
           [
-            { role: "system", content: systemPrompt },
+            { role: "system", content: instructionText },
             { role: "user", content: input }
           ],
           this.withGatewayAgent({ temperature: 0.3, maxTokens: 2048 })
@@ -7858,7 +7858,7 @@ Respond with valid JSON matching this schema:
       const response = await this.client.chat.completions.create({
         model: this.config.model,
         messages: [
-          { role: "system", content: systemPrompt },
+          { role: "system", content: instructionText },
           { role: "user", content: input }
         ],
         ...buildChatCompletionTokenLimit(this.config.model, 2048, {
@@ -7885,7 +7885,7 @@ Respond with valid JSON matching this schema:
     }
     const memoryContext = formatDaySummaryMemories(memories);
     if (memoryContext.length === 0) return null;
-    const systemPrompt = await loadDaySummaryPrompt();
+    const instructionText = await loadDaySummaryPrompt();
     let extensionsFooter = "";
     try {
       extensionsFooter = await buildExtensionsFooterForSummary(this.config);
@@ -7903,7 +7903,7 @@ ${extensionsFooter}` : ""}`;
       try {
         const localResponse = await this.localLlm.chatCompletion(
           [
-            { role: "system", content: `${systemPrompt}
+            { role: "system", content: `${instructionText}
 
 Return valid JSON only.` },
             { role: "user", content: userPrompt }
@@ -7940,7 +7940,7 @@ Return valid JSON only.` },
       startedAt,
       DaySummaryResultSchema,
       [
-        { role: "system", content: `${systemPrompt}
+        { role: "system", content: `${instructionText}
 
 Return valid JSON only.` },
         { role: "user", content: userPrompt }
@@ -7958,7 +7958,7 @@ Return valid JSON only.` },
       try {
         const response = await this.client.responses.create({
           model: this.config.model,
-          instructions: `${systemPrompt}
+          instructions: `${instructionText}
 
 Return valid JSON only.`,
           input: userPrompt,
@@ -7988,7 +7988,7 @@ Return valid JSON only.`,
     const memoryList = memories.map((m) => `[${m.id}] (${m.category}, ${m.created.slice(0, 10)})
 ${m.content}`).join("\n\n");
     try {
-      const systemPrompt = `You are a memory summarization system. You are given a batch of old memories that need to be compressed into a summary.
+      const instructionText = `You are a memory summarization system. You are given a batch of old memories that need to be compressed into a summary.
 
 Your task:
 1. Write a concise summary paragraph (2-4 sentences) capturing the essence of these memories
@@ -8011,7 +8011,7 @@ Respond with valid JSON matching this schema:
         try {
           const localResponse = await this.localLlm.chatCompletion(
             [
-              { role: "system", content: systemPrompt },
+              { role: "system", content: instructionText },
               { role: "user", content: `Summarize these ${memories.length} memories:
 
 ${memoryList}` }
@@ -8044,7 +8044,7 @@ ${memoryList}` }
       if (!this.shouldUseDirectClient) {
         const fallbackResponse = await this.fallbackLlm.chatCompletion(
           [
-            { role: "system", content: systemPrompt },
+            { role: "system", content: instructionText },
             { role: "user", content: `Summarize these ${memories.length} memories:
 
 ${memoryList}` }
@@ -8062,7 +8062,7 @@ ${memoryList}` }
       const response = await this.client.chat.completions.create({
         model: this.config.model,
         messages: [
-          { role: "system", content: systemPrompt },
+          { role: "system", content: instructionText },
           { role: "user", content: `Summarize these ${memories.length} memories:
 
 ${memoryList}` }
@@ -34245,11 +34245,11 @@ var Orchestrator = class _Orchestrator {
     });
     if (config.lcmEnabled) {
       const summarizeFn = async (text, targetTokens, aggressive) => {
-        const systemPrompt = aggressive ? `Compress the following into bullet points. One bullet per distinct fact or decision. Maximum ${targetTokens} tokens total. No prose.` : `Compress the following conversation segment into a dense summary. Preserve: decisions made, code artifacts mentioned, errors encountered, open questions, and any commitments or next-steps. Omit: pleasantries, restatements, and anything the agent would not need to recall later. Output a single paragraph, maximum ${targetTokens} tokens.`;
+        const instructionText = aggressive ? `Compress the following into bullet points. One bullet per distinct fact or decision. Maximum ${targetTokens} tokens total. No prose.` : `Compress the following conversation segment into a dense summary. Preserve: decisions made, code artifacts mentioned, errors encountered, open questions, and any commitments or next-steps. Omit: pleasantries, restatements, and anything the agent would not need to recall later. Output a single paragraph, maximum ${targetTokens} tokens.`;
         try {
           const result = await this.localLlm.chatCompletion(
             [
-              { role: "system", content: systemPrompt },
+              { role: "system", content: instructionText },
               { role: "user", content: text.slice(0, 12e3) }
             ],
             {

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-remnic",
   "name": "Remnic OpenClaw Plugin",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "kind": "memory",
   "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": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/plugin-openclaw",
-  "version": "1.0.29",
+  "version": "1.0.31",
   "description": "OpenClaw adapter for Remnic memory with bundled @remnic/core runtime",
   "type": "module",
   "main": "dist/index.js",
@@ -31,6 +31,34 @@
     },
     "install": {
       "minHostVersion": ">=2026.4.8"
+    },
+    "environment": {
+      "externalServices": [
+        "openclaw-gateway-models",
+        "configured-llm-providers"
+      ],
+      "optionalEnv": [
+        "OPENAI_API_KEY",
+        "<PROVIDER>_API_KEY",
+        "<PROVIDER>_TOKEN"
+      ],
+      "configPaths": [
+        "~/.openclaw/agents/main/agent/models.json"
+      ],
+      "credentialSources": [
+        "OpenClaw runtime auth resolver",
+        "OpenClaw materialized provider model config",
+        "provider-specific environment variables"
+      ],
+      "dataSentToProviders": [
+        "conversation excerpts",
+        "memory excerpts",
+        "summaries",
+        "embedding inputs",
+        "active-recall query inputs",
+        "benchmark and evaluation inputs"
+      ],
+      "recommendedMode": "modelSource=gateway"
     }
   },
   "dependencies": {