@43world/llm-logger-openclaw-plugin 0.0.3 → 0.0.4

package/README.md

@@ -13,6 +13,12 @@ OpenClaw 插件。
 
 ## 安装
 
+直接走npm包安装
+```bash
+openclaw plugins install @43world/llm-logger-openclaw-plugin
+```
+
+源码目录安装
 ```bash
 openclaw plugins install -l /root/projects/llm-logger-openclaw-plugin
 openclaw plugins enable llm-logger-openclaw-plugin
@@ -45,18 +51,18 @@ openclaw plugins enable llm-logger-openclaw-plugin
 如果不指定 `logFile`，默认按会话和日期写到：
 
 ```text
-<OPENCLAW_STATE_DIR>/logs/<session_id>/llm-logger-openclaw-plugin-YYYY-MM-DD.jsonl
+<OPENCLAW_STATE_DIR>/logs/<session_key>/llm-logger-openclaw-plugin-YYYY-MM-DD.jsonl
 ```
 
 其中：
 
-- `<session_id>` 来自 OpenClaw 会话；若缺失会写到 `_unknown_session` 目录
+- `<session_key>` 来自 OpenClaw 会话；若缺失会写到 `_unknown_session_key` 目录
 - `YYYY-MM-DD` 为当天日期后缀，用于每日滚动记录
 
 如果指定了 `logFile`（例如 `/tmp/openclaw-llm.jsonl`），会将其作为基准路径与基准文件名，最终写入：
 
 ```text
-/tmp/<session_id>/openclaw-llm-YYYY-MM-DD.jsonl
+/tmp/<session_key>/openclaw-llm-YYYY-MM-DD.jsonl
 ```
 
 ## 日志格式

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "llm-logger-openclaw-plugin",
   "name": "LLM Logger OpenClaw Plugin",
   "description": "Logs OpenClaw LLM request payloads and responses to a JSONL file.",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@43world/llm-logger-openclaw-plugin",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "OpenClaw plugin that logs LLM request payloads and responses to JSONL.",
   "type": "module",
   "openclaw": {

package/src/manager.ts

@@ -91,7 +91,7 @@ const GLOBAL_KEY = Symbol.for("llm-logger-openclaw-plugin.manager");
 const WEBSOCKET_CALL_CONTEXT = Symbol.for("llm-logger-openclaw-plugin.wsCallContext");
 const OBSERVED_WS_PATHS = ["/v1/responses"];
 const TURN_METADATA_TTL_MS = 5 * 60 * 1000;
-const UNKNOWN_SESSION_DIR = "_unknown_session";
+const UNKNOWN_SESSION_DIR = "_unknown_session_key";
 
 type PatchHandles = {
   restore: () => void;
@@ -479,21 +479,22 @@ class PluginManager {
       ts: new Date().toISOString(),
       plugin: state.pluginId,
       sessionId: this.#currentCallContext()?.sessionId,
+      sessionKey: this.#currentCallContext()?.sessionKey,
       ...record,
     };
-    const sessionId =
-      typeof event.sessionId === "string" && event.sessionId.trim().length > 0
-        ? event.sessionId
+    const sessionKey =
+      typeof event.sessionKey === "string" && event.sessionKey.trim().length > 0
+        ? event.sessionKey
         : undefined;
-    const writer = this.#getWriterForEvent(state, sessionId, new Date());
+    const writer = this.#getWriterForEvent(state, sessionKey, new Date());
 
     void writer.write(event).catch((error) => {
       this.#logger().warn(`[${state.pluginId}] failed to write log entry: ${this.#formatError(error)}`);
     });
   }
 
-  #getWriterForEvent(state: ActiveState, sessionId: string | undefined, now: Date): JsonlWriter {
-    const sessionDir = this.#sanitizeSessionDirName(sessionId);
+  #getWriterForEvent(state: ActiveState, sessionKey: string | undefined, now: Date): JsonlWriter {
+    const sessionDir = this.#sanitizeSessionDirName(sessionKey);
     const dateSuffix = this.#formatDateSuffix(now);
     const key = `${sessionDir}|${dateSuffix}`;
     const cachedWriter = state.writers.get(key);
@@ -515,11 +516,11 @@ class PluginManager {
     return path.join(parsed.dir, sessionDir, filename);
   }
 
-  #sanitizeSessionDirName(sessionId: string | undefined): string {
-    if (!sessionId) {
+  #sanitizeSessionDirName(sessionKey: string | undefined): string {
+    if (!sessionKey) {
       return UNKNOWN_SESSION_DIR;
     }
-    const normalized = sessionId.trim();
+    const normalized = sessionKey.trim();
     if (!normalized) {
       return UNKNOWN_SESSION_DIR;
     }