Llm Logger Openclaw

Name: Llm Logger Openclaw
Rating: 3.5 (1 reviews)
Author: joglea

By joglea 👁 4 views ▲ 0 votes

llm logger plugin for openclaw

GitHub

Install

openclaw plugins install @43world/llm-logger-openclaw-plugin

Configuration Example

{
  "plugins": {
    "entries": {
      "llm-logger-openclaw-plugin": {
        "enabled": true,
        "config": {
          "logFile": "/tmp/openclaw-llm.jsonl",
          "maxBodyBytes": 262144,
          "redactAuthorization": true,
          "includeHooks": true,
          "includeHttp": true,
          "includeWebSocket": true
        }
      }
    }
  }
}

README

# llm-logger-openclaw-plugin

OpenClaw 插件。

启用后会把 OpenClaw 对话链路中的底层 LLM 调用请求参数和响应数据写入 JSONL 日志文件。

## 功能

- 记录 provider 请求 payload
- 记录 HTTP 请求与响应
- 记录 OpenAI Responses WebSocket 收发帧
- 记录 OpenClaw 的 `llm_input` / `llm_output` 摘要事件

## 安装

直接走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
```

## 配置

在 OpenClaw 配置中加入：

```json
{
  "plugins": {
    "entries": {
      "llm-logger-openclaw-plugin": {
        "enabled": true,
        "config": {
          "logFile": "/tmp/openclaw-llm.jsonl",
          "maxBodyBytes": 262144,
          "redactAuthorization": true,
          "includeHooks": true,
          "includeHttp": true,
          "includeWebSocket": true
        }
      }
    }
  }
}
```

如果不指定 `logFile`，默认按会话和日期写到：

```text
<OPENCLAW_STATE_DIR>/logs/<session_key>/llm-logger-openclaw-plugin-YYYY-MM-DD.jsonl
```

其中：

- `<session_key>` 来自 OpenClaw 会话；若缺失会写到 `_unknown_session_key` 目录
- `YYYY-MM-DD` 为当天日期后缀，用于每日滚动记录

如果指定了 `logFile`（例如 `/tmp/openclaw-llm.jsonl`），会将其作为基准路径与基准文件名，最终写入：

```text
/tmp/<session_key>/openclaw-llm-YYYY-MM-DD.jsonl
```

## 日志格式

日志为 JSON Lines。

常见事件类型：

- `llm_input`
- `provider_request_payload`
- `http_request`
- `http_response`
- `ws_send`
- `ws_message`
- `llm_output`

## 说明

- 日志默认会对常见认证字段做脱敏
- 请求/响应 body 默认按 `maxBodyBytes` 截断
- WebSocket 路径按帧记录，不强制拼装成单一完整响应

tools