clawmonitor 1.0.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/README.md +20 -39
  2. package/README.zh-CN.md +26 -45
  3. package/README.zh-TW.md +25 -44
  4. package/bin/clawmonitor.js +734 -0
  5. package/package.json +4 -6
  6. package/bin/clawmonitor.sh +0 -449
package/README.md CHANGED
@@ -4,7 +4,17 @@
4
4
 
5
5
  # ClawMonitor
6
6
 
7
- Real-time OpenClaw tool call monitor. Watch all agent sessions with readable names and sorted output.
7
+ Real-time OpenClaw tool call monitor.
8
+
9
+ ## Why?
10
+
11
+ OpenClaw is a powerful personal AI assistant, but it lacks a built-in way to observe what your agents are actually doing in real time. When debugging prompts, optimizing tool usage, or just understanding agent behavior, you're left guessing.
12
+
13
+ **ClawMonitor fills that gap.** It gives you a live, unified view of every tool call across all agents and sessions — something OpenClaw should have but doesn't.
14
+
15
+ - OpenClaw shows you the final response, but not the tool calls behind it
16
+ - OpenClaw's session logs exist, but they're raw JSONL — hard to read and not real-time
17
+ - ClawMonitor makes agent behavior transparent: what tools are called, with what arguments, across which sessions, all sorted chronologically
8
18
 
9
19
  ## Install
10
20
 
@@ -12,54 +22,33 @@ Real-time OpenClaw tool call monitor. Watch all agent sessions with readable nam
12
22
  # Run without installing
13
23
  npx clawmonitor
14
24
 
15
- # Install globally
25
+ # Or install globally
16
26
  npm install -g clawmonitor
17
27
  clawmonitor
18
28
  ```
19
29
 
20
30
  ## Features
21
31
 
22
- - 🔧 Real-time monitoring of all OpenClaw agent tool calls
23
- - 📜 Shows last 10 history entries on startup (cross-session, sorted by time)
24
- - 📋 Readable session names (auto-parsed from conversation_label)
25
- - 🔄 Auto-tracks newly created sessions
26
- - 🎨 Colored terminal output (respects `NO_COLOR`)
27
- - 🖥️ Cross-platform: Linux, macOS, Windows (Git Bash / WSL)
32
+ - 🔧 Real-time monitoring of all agent tool calls across all sessions
33
+ - 🎨 Modern TUI with card layout and JSON syntax highlighting
34
+ - 📜 History on startup — last N entries, cross-session, sorted by time
35
+ - 🔄 Auto-discovers new sessions as they're created
36
+ - 📋 Readable session names parsed from labels
37
+ - 🖥️ Cross-platform — works on Linux, macOS, Windows
38
+ - 📦 Zero dependencies — only needs Node.js 18+
28
39
 
29
40
  ## Usage
30
41
 
31
42
  ```
32
43
  clawmonitor [options]
33
44
 
34
- Options:
35
45
  --all Monitor all sessions (no time filter)
36
46
  --compact Compact one-line output
37
47
  --history N Show last N history entries (default: 10)
48
+ --full Show full input/output (no truncation)
38
49
  --help Show help
39
50
  ```
40
51
 
41
- ## Examples
42
-
43
- ```bash
44
- # Default: last 30 min sessions + 10 history
45
- clawmonitor
46
-
47
- # Compact mode with 20 history entries
48
- clawmonitor --compact --history 20
49
-
50
- # Monitor all sessions regardless of time
51
- clawmonitor --all
52
- ```
53
-
54
- ## Requirements
55
-
56
- - **jq** — the only external dependency
57
- - Linux: `sudo apt install jq`
58
- - macOS: `brew install jq`
59
- - Windows: `pacman -S jq` (Git Bash) or use WSL
60
-
61
- Everything else (`tail`, `date`, `bash`) comes pre-installed.
62
-
63
52
  ## Environment Variables
64
53
 
65
54
  | Variable | Description |
@@ -67,14 +56,6 @@ Everything else (`tail`, `date`, `bash`) comes pre-installed.
67
56
  | `OPENCLAW_HOME` | Custom OpenClaw data directory |
68
57
  | `NO_COLOR` | Disable colored output |
69
58
 
70
- ## Development
71
-
72
- ```bash
73
- git clone https://github.com/reopenpilot/clawmonitor.git
74
- cd clawmonitor
75
- bash bin/clawmonitor.sh --help
76
- ```
77
-
78
59
  ## License
79
60
 
80
61
  MIT
package/README.zh-CN.md CHANGED
@@ -1,65 +1,54 @@
1
- [English](README.md) · **[简体中文](README.zh-CN.md)** · [繁體中文](README.zh-TW.md)
1
+ [English](README.md) · **简体中文** · [繁體中文](README.zh-TW.md)
2
2
 
3
3
  ---
4
4
 
5
5
  # ClawMonitor
6
6
 
7
- 实时监控 OpenClaw 所有 agent 的 tool calls，跨 session、按时间排序。
7
+ 实时 OpenClaw tool call 监控器。
8
+
9
+ ## 为什么需要？
10
+
11
+ OpenClaw 是强大的个人 AI 助手，但缺乏内置方式实时观察 agent 实际在做什么。调试 prompt、优化工具使用、理解 agent 行为时，只能凭猜测。
12
+
13
+ **ClawMonitor 补足了这个缺口。** 实时、统一地呈现所有 agent 和 session 的 tool call。
14
+
15
+ - OpenClaw 只显示最终回应，看不到背后的 tool calls
16
+ - Session logs 是原始 JSONL — 难读且非实时
17
+ - ClawMonitor 让 agent 行为透明化：哪些工具被调用、带什么参数、跨哪些 session，按时间排序
8
18
 
9
19
  ## 安装
10
20
 
11
21
  ```bash
12
- # 无需安装直接运行
22
+ # 不安装直接运行
13
23
  npx clawmonitor
14
24
 
15
- # 全局安装
25
+ # 或全局安装
16
26
  npm install -g clawmonitor
17
27
  clawmonitor
18
28
  ```
19
29
 
20
30
  ## 功能
21
31
 
22
- - 🔧 实时监控所有 OpenClaw agent 的 tool calls
23
- - 📜 启动时显示最近 10 条历史记录（跨 session，按时间排序）
24
- - 📋 可读的 session 名称（自动解析 conversation_label）
25
- - 🔄 自动追踪新建的 session
26
- - 🎨 彩色终端输出（支持 `NO_COLOR` 环境变量）
27
- - 🖥️ 跨平台：Linux、macOS、Windows（Git Bash / WSL）
32
+ - 🔧 实时监控所有 session 的 tool calls
33
+ - 🎨 现代化 TUI 卡片布局 + JSON 语法高亮
34
+ - 📜 启动时显示最近历史，跨 session 按时间排序
35
+ - 🔄 自动发现新建的 session
36
+ - 📋 自动解析可读的 session 名称
37
+ - 🖥️ 跨平台 — Linux、macOS、Windows
38
+ - 📦 零依赖 — 只需 Node.js 18+
28
39
 
29
- ## 使用方法
40
+ ## 使用
30
41
 
31
42
  ```
32
- clawmonitor [选项]
43
+ clawmonitor [options]
33
44
 
34
- 选项:
35
45
  --all 监控所有 session（不限时间）
36
46
  --compact 精简一行输出
37
- --history N 显示最近 N 条历史记录（默认 10）
47
+ --history N 显示最近 N 条历史（默认：10）
48
+ --full 完整显示输入输出（不截断）
38
49
  --help 显示帮助
39
50
  ```
40
51
 
41
- ## 示例
42
-
43
- ```bash
44
- # 默认：最近 30 分钟的 session + 10 条历史
45
- clawmonitor
46
-
47
- # 精简模式，显示 20 条历史
48
- clawmonitor --compact --history 20
49
-
50
- # 监控所有 session（不限时间）
51
- clawmonitor --all
52
- ```
53
-
54
- ## 依赖
55
-
56
- - **jq** — 唯一的外部依赖
57
- - Linux: `sudo apt install jq`
58
- - macOS: `brew install jq`
59
- - Windows: `pacman -S jq`（Git Bash）或使用 WSL
60
-
61
- 其他（`tail`、`date`、`bash`）系统自带。
62
-
63
52
  ## 环境变量
64
53
 
65
54
  | 变量 | 说明 |
@@ -67,14 +56,6 @@ clawmonitor --all
67
56
  | `OPENCLAW_HOME` | 自定义 OpenClaw 数据目录 |
68
57
  | `NO_COLOR` | 禁用彩色输出 |
69
58
 
70
- ## 开发
71
-
72
- ```bash
73
- git clone https://github.com/reopenpilot/clawmonitor.git
74
- cd clawmonitor
75
- bash bin/clawmonitor.sh --help
76
- ```
77
-
78
- ## 许可证
59
+ ## 许可
79
60
 
80
61
  MIT
package/README.zh-TW.md CHANGED
@@ -1,65 +1,54 @@
1
- [English](README.md) · [简体中文](README.zh-CN.md) · **[繁體中文](README.zh-TW.md)**
1
+ [English](README.md) · [简体中文](README.zh-CN.md) · **繁體中文**
2
2
 
3
3
  ---
4
4
 
5
5
  # ClawMonitor
6
6
 
7
- 即時監控 OpenClaw 所有 agent 的 tool calls，跨 session、按時間排序。
7
+ 即時 OpenClaw tool call 監控器。
8
+
9
+ ## 為什麼需要？
10
+
11
+ OpenClaw 是強大的個人 AI 助手，但缺乏內建方式即時觀察 agent 實際在做什麼。除錯 prompt、優化工具使用、理解 agent 行為時，只能憑猜測。
12
+
13
+ **ClawMonitor 補足了這個缺口。** 即時、統一地呈現所有 agent 和 session 的 tool call。
14
+
15
+ - OpenClaw 只顯示最終回應，看不到背後的 tool calls
16
+ - Session logs 是原始 JSONL — 難讀且非即時
17
+ - ClawMonitor 讓 agent 行為透明化：哪些工具被呼叫、帶什麼參數、跨哪些 session，按時間排序
8
18
 
9
19
  ## 安裝
10
20
 
11
21
  ```bash
12
- # 不用安裝直接跑
22
+ # 不安裝直接跑
13
23
  npx clawmonitor
14
24
 
15
- # 全域安裝
25
+ # 或全域安裝
16
26
  npm install -g clawmonitor
17
27
  clawmonitor
18
28
  ```
19
29
 
20
30
  ## 功能
21
31
 
22
- - 🔧 即時監控所有 OpenClaw agent 的 tool calls
23
- - 📜 啟動時顯示最近 10 筆歷史記錄（跨 session，按時間排序）
24
- - 📋 可讀的 session 名稱（自動解析 conversation_label）
25
- - 🔄 自動追蹤新建的 session
26
- - 🎨 彩色終端機輸出（支援 `NO_COLOR` 環境變數）
27
- - 🖥️ 跨平台：Linux、macOS、Windows（Git Bash / WSL）
32
+ - 🔧 即時監控所有 session 的 tool calls
33
+ - 🎨 現代化 TUI 卡片佈局 + JSON 語法高亮
34
+ - 📜 啟動時顯示最近歷史，跨 session 按時間排序
35
+ - 🔄 自動發現新建的 session
36
+ - 📋 自動解析可讀的 session 名稱
37
+ - 🖥️ 跨平台 — Linux、macOS、Windows
38
+ - 📦 零依賴 — 只需 Node.js 18+
28
39
 
29
- ## 使用方式
40
+ ## 使用
30
41
 
31
42
  ```
32
- clawmonitor [選項]
43
+ clawmonitor [options]
33
44
 
34
- 選項:
35
45
  --all 監控所有 session（不限時間）
36
46
  --compact 精簡一行輸出
37
- --history N 顯示最近 N 筆歷史記錄（預設 10）
47
+ --history N 顯示最近 N 筆歷史（預設：10）
48
+ --full 完整顯示輸入輸出（不截斷）
38
49
  --help 顯示說明
39
50
  ```
40
51
 
41
- ## 範例
42
-
43
- ```bash
44
- # 預設：最近 30 分鐘的 session + 10 筆歷史
45
- clawmonitor
46
-
47
- # 精簡模式，顯示 20 筆歷史
48
- clawmonitor --compact --history 20
49
-
50
- # 監控所有 session（不限時間）
51
- clawmonitor --all
52
- ```
53
-
54
- ## 依賴
55
-
56
- - **jq** — 唯一的外部依賴
57
- - Linux: `sudo apt install jq`
58
- - macOS: `brew install jq`
59
- - Windows: `pacman -S jq`（Git Bash）或使用 WSL
60
-
61
- 其他（`tail`、`date`、`bash`）系統內建。
62
-
63
52
  ## 環境變數
64
53
 
65
54
  | 變數 | 說明 |
@@ -67,14 +56,6 @@ clawmonitor --all
67
56
  | `OPENCLAW_HOME` | 自訂 OpenClaw 資料目錄 |
68
57
  | `NO_COLOR` | 停用彩色輸出 |
69
58
 
70
- ## 開發
71
-
72
- ```bash
73
- git clone https://github.com/reopenpilot/clawmonitor.git
74
- cd clawmonitor
75
- bash bin/clawmonitor.sh --help
76
- ```
77
-
78
59
  ## 授權
79
60
 
80
61
  MIT