{"_id":"@ellawu2211/aidr-xclaw-security-sentinel","_rev":"2-1fc67fd9a85fbc018f4b036568558e44","name":"@ellawu2211/aidr-xclaw-security-sentinel","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@ellawu2211/aidr-xclaw-security-sentinel","version":"1.0.0","keywords":["openclaw","activity","monitoring","dashboard","security","sentinel"],"author":{"name":"ellawu2211"},"license":"MIT","_id":"@ellawu2211/aidr-xclaw-security-sentinel@1.0.0","maintainers":[{"name":"ellawu2211","email":"ellawur@foxmail.com"}],"dist":{"shasum":"9176043a8492f891df611ac68c7021edbbd8746a","tarball":"https://registry.npmjs.org/@ellawu2211/aidr-xclaw-security-sentinel/-/aidr-xclaw-security-sentinel-1.0.0.tgz","fileCount":21,"integrity":"sha512-ruWSySEF4wDAlm3dQIAkXp3fRnzLJgi3JcyLEXcZ+VpHqDBYF/BlwKKPUHZNHz3iJFAYdgcqSXnWVclKW8WjdA==","signatures":[{"sig":"MEQCIEe0QEmswbHYAH9SyvUWvAZ0uMZNJSOmSvxJtMa0QYF4AiAGaVErqFhu1teHVS/xr3/rwxajTSJkN3M3AlOKWLv9HA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":273833},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=22.12.0"},"scripts":{"dev":"npx tsc --watch","build":"npx tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"ellawu2211","email":"ellawur@foxmail.com"},"openclaw":{"extensions":["./dist/index.js"]},"_npmVersion":"10.9.0","description":"AIDR-XClaw-Security-Sentinel — real-time activity tracking and visualization for OpenClaw agents","directories":{},"_nodeVersion":"22.10.0","dependencies":{"undici":"^7.16.0","express":"^4.18.2","better-sqlite3":"11.7.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^22.0.0","@types/express":"^4.17.21","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/aidr-xclaw-security-sentinel_1.0.0_1776680302759_0.6779564985478435","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ellawu2211/aidr-xclaw-security-sentinel","version":"1.0.1","description":"AIDR-XClaw-Security-Sentinel — real-time activity tracking and visualization for OpenClaw agents","type":"module","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"npx tsc","dev":"npx tsc --watch","prepublishOnly":"npm run build"},"openclaw":{"extensions":["./dist/index.js"]},"keywords":["openclaw","activity","monitoring","dashboard","security","sentinel"],"author":{"name":"ellawu2211"},"license":"MIT","dependencies":{"express":"^4.18.2","sql.js":"^1.13.0","undici":"^7.16.0"},"devDependencies":{"@types/express":"^4.17.21","@types/node":"^22.0.0","@types/sql.js":"^1.4.11","typescript":"^5.3.3"},"engines":{"node":">=22.12.0"},"_id":"@ellawu2211/aidr-xclaw-security-sentinel@1.0.1","_nodeVersion":"22.10.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-mcb5xVszE8gc4UtK1tUNkHXxheHPoTzpbbyw36Mya6fvAWRIA47LlIoYCqqZnvCGIdgNDUKwVIN4KY6MJyf72A==","shasum":"83a25fe0a2e361ffebba07bef9ec728005a9d726","tarball":"https://registry.npmjs.org/@ellawu2211/aidr-xclaw-security-sentinel/-/aidr-xclaw-security-sentinel-1.0.1.tgz","fileCount":23,"unpackedSize":278164,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCpwB1vnAGMumD1BL5KgMP7OnRkQz2Dkfa94IhjdV89kgIgf01rGIvnaH7KEX4inwF7xmAnTJGxPw38qTMomLutJcU="}]},"_npmUser":{"name":"ellawu2211","email":"ellawur@foxmail.com"},"directories":{},"maintainers":[{"name":"ellawu2211","email":"ellawur@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aidr-xclaw-security-sentinel_1.0.1_1776682597880_0.3511208573971045"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-20T10:18:22.654Z","modified":"2026-04-20T10:56:38.162Z","1.0.0":"2026-04-20T10:18:22.898Z","1.0.1":"2026-04-20T10:56:38.034Z"},"author":{"name":"ellawu2211"},"license":"MIT","keywords":["openclaw","activity","monitoring","dashboard","security","sentinel"],"description":"AIDR-XClaw-Security-Sentinel — real-time activity tracking and visualization for OpenClaw agents","maintainers":[{"name":"ellawu2211","email":"ellawur@foxmail.com"}],"readme":"# AIDR-XClaw-Security-Sentinel\r\n\r\nAIDR-XClaw-Security-Sentinel 是一款面向 OpenClaw 的本地可观测插件：在网关进程内订阅 Agent 生命周期事件，把多轮 ReAct（`LLM → TOOL → …`）整理成可读的 Trace 与 Dashboard——包括每轮 LLM 输入输出、工具调用、用量与耗时汇总；数据默认落在本机 SQLite，便于在内网或离线环境自查。\r\n\r\n插件随 OpenClaw Gateway 同一进程 加载；若网关在远程主机上运行，请在该主机上安装并配置本插件。\r\n\r\n## 安装与运行\r\n\r\n### Prerequisites\r\n\r\n- **OpenClaw** >= 2026.3.31  \r\n- **Node.js** >= 22.12.0  \r\n- **npm** >= 10  \r\n\r\n### 1. 通过 OpenClaw 安装（推荐）\r\n\r\n```bash\r\nopenclaw plugins install @ellawu2211/aidr-xclaw-security-sentinel\r\n```\r\n\r\n若 Gateway 已在运行，安装后请 **重启网关**（例如 `openclaw gateway restart`），再执行后续验证。\r\n\r\n### 2. 通过 npm 源码目录安装（开发或离线包）\r\n\r\n```bash\r\nnpm install @ellawu2211/aidr-xclaw-security-sentinel\r\ncd npm/node_modules/@ellawu2211/aidr-xclaw-security-sentinel\r\nnpm run build\r\nopenclaw plugins install -l .\r\n```\r\n\r\n安装或更新插件后，若 Gateway 已在运行，请 **重启** 再测。\r\n\r\n### 3. 确认本机 Dashboard 服务\r\n\r\n插件通过 PI Guard 校验并成功启动后，会在本机监听 Dashboard（默认 `18796`）。\r\n\r\n```bash\r\nopenclaw aidr-xclaw-security-sentinel status\r\n```\r\n\r\n`status` 输出中应能看到端口与运行状态；\r\n\r\n### 4. 发送测试会话并打开面板\r\n\r\n1. 打开 **OpenClaw Control UI**，向 Agent 发送：`hello from openclaw`。  \r\n2. 浏览器访问 **http://localhost:18796**，在 Dashboard / Trace 中应能看到对应活动与 Trace 记录。\r\n\r\n### 常用命令与健康检查\r\n\r\n```bash\r\n# CLI（需在 PATH 中能调用 openclaw）\r\nopenclaw aidr-xclaw-security-sentinel setup\r\nopenclaw aidr-xclaw-security-sentinel status\r\nopenclaw aidr-xclaw-security-sentinel dashboard\r\nopenclaw aidr-xclaw-security-sentinel start\r\nopenclaw aidr-xclaw-security-sentinel stop\r\nopenclaw aidr-xclaw-security-sentinel clean --days 30\r\n\r\n# HTTP 探活（无需浏览器）\r\ncurl -sS http://127.0.0.1:18796/health\r\n# 完整运行时指标（可选）\r\ncurl -sS http://127.0.0.1:18796/runtime\r\n```\r\n\r\n## 运行与配置\r\n\r\n### 初始化（端口与数据库）\r\n\r\n```bash\r\nopenclaw aidr-xclaw-security-sentinel setup\r\n```\r\n\r\n默认写入 `~/.openclaw/aidr-xclaw-security-sentinel/config.json`：\r\n\r\n- `port`：Dashboard 端口（默认 **18796**）  \r\n- `dbPath`：SQLite 路径（默认 `~/.openclaw/aidr-xclaw-security-sentinel/activities.db`）  \r\n\r\n修改配置后：\r\n\r\n```bash\r\nopenclaw gateway restart\r\n```\r\n\r\n### 打开 Dashboard\r\n\r\n```bash\r\nopenclaw aidr-xclaw-security-sentinel dashboard\r\n```\r\n\r\n或直接访问：`http://localhost:18796`（端口以配置为准）。\r\n\r\n","readmeFilename":"README.md"}