clawmonitor 1.0.1 → 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 +10 -39
  2. package/README.zh-CN.md +22 -51
  3. package/README.zh-TW.md +21 -50
  4. package/bin/clawmonitor.js +734 -0
  5. package/package.json +4 -6
  6. package/bin/clawmonitor.sh +0 -466
package/README.md CHANGED
@@ -4,7 +4,7 @@
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
8
 
9
9
  ## Why?
10
10
 
@@ -22,54 +22,33 @@ OpenClaw is a powerful personal AI assistant, but it lacks a built-in way to obs
22
22
  # Run without installing
23
23
  npx clawmonitor
24
24
 
25
- # Install globally
25
+ # Or install globally
26
26
  npm install -g clawmonitor
27
27
  clawmonitor
28
28
  ```
29
29
 
30
30
  ## Features
31
31
 
32
- - 🔧 Real-time monitoring of all OpenClaw agent tool calls
33
- - 📜 Shows last 10 history entries on startup (cross-session, sorted by time)
34
- - 📋 Readable session names (auto-parsed from conversation_label)
35
- - 🔄 Auto-tracks newly created sessions
36
- - 🎨 Colored terminal output (respects `NO_COLOR`)
37
- - 🖥️ 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+
38
39
 
39
40
  ## Usage
40
41
 
41
42
  ```
42
43
  clawmonitor [options]
43
44
 
44
- Options:
45
45
  --all Monitor all sessions (no time filter)
46
46
  --compact Compact one-line output
47
47
  --history N Show last N history entries (default: 10)
48
+ --full Show full input/output (no truncation)
48
49
  --help Show help
49
50
  ```
50
51
 
51
- ## Examples
52
-
53
- ```bash
54
- # Default: last 30 min sessions + 10 history
55
- clawmonitor
56
-
57
- # Compact mode with 20 history entries
58
- clawmonitor --compact --history 20
59
-
60
- # Monitor all sessions regardless of time
61
- clawmonitor --all
62
- ```
63
-
64
- ## Requirements
65
-
66
- - **jq** — the only external dependency
67
- - Linux: `sudo apt install jq`
68
- - macOS: `brew install jq`
69
- - Windows: `pacman -S jq` (Git Bash) or use WSL
70
-
71
- Everything else (`tail`, `date`, `bash`) comes pre-installed.
72
-
73
52
  ## Environment Variables
74
53
 
75
54
  | Variable | Description |
@@ -77,14 +56,6 @@ Everything else (`tail`, `date`, `bash`) comes pre-installed.
77
56
  | `OPENCLAW_HOME` | Custom OpenClaw data directory |
78
57
  | `NO_COLOR` | Disable colored output |
79
58
 
80
- ## Development
81
-
82
- ```bash
83
- git clone https://github.com/reopenpilot/clawmonitor.git
84
- cd clawmonitor
85
- bash bin/clawmonitor.sh --help
86
- ```
87
-
88
59
  ## License
89
60
 
90
61
  MIT
package/README.zh-CN.md CHANGED
@@ -1,75 +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
8
 
9
- ## 为什么需要它？
9
+ ## 为什么需要？
10
10
 
11
- OpenClaw 是强大的个人 AI 助手，但缺少一个关键功能：**实时观察 agent 在做什么**。调试提示词、优化工具使用、理解 agent 行为时，你只能猜测。
11
+ OpenClaw 是强大的个人 AI 助手，但缺乏内置方式实时观察 agent 实际在做什么。调试 prompt、优化工具使用、理解 agent 行为时，只能凭猜测。
12
12
 
13
- **ClawMonitor 填补了这个空白。** 它提供跨所有 agent 和 session 的实时工具调用视图——这是 OpenClaw 应该有却没有的功能。
13
+ **ClawMonitor 补足了这个缺口。** 实时、统一地呈现所有 agent 和 session 的 tool call。
14
14
 
15
- - OpenClaw 只显示最终回复，看不到背后的工具调用过程
16
- - OpenClaw 的 session 日志是原始 JSONL，难以阅读，也不是实时的
17
- - ClawMonitor 让 agent 行为透明化：调用了什么工具、传了什么参数、来自哪个 session，按时间排序一目了然
15
+ - OpenClaw 只显示最终回应，看不到背后的 tool calls
16
+ - Session logs 是原始 JSONL — 难读且非实时
17
+ - ClawMonitor 让 agent 行为透明化：哪些工具被调用、带什么参数、跨哪些 session，按时间排序
18
18
 
19
19
  ## 安装
20
20
 
21
21
  ```bash
22
- # 无需安装直接运行
22
+ # 不安装直接运行
23
23
  npx clawmonitor
24
24
 
25
- # 全局安装
25
+ # 或全局安装
26
26
  npm install -g clawmonitor
27
27
  clawmonitor
28
28
  ```
29
29
 
30
30
  ## 功能
31
31
 
32
- - 🔧 实时监控所有 OpenClaw agent 的 tool calls
33
- - 📜 启动时显示最近 10 条历史记录（跨 session，按时间排序）
34
- - 📋 可读的 session 名称（自动解析 conversation_label）
35
- - 🔄 自动追踪新建的 session
36
- - 🎨 彩色终端输出（支持 `NO_COLOR` 环境变量）
37
- - 🖥️ 跨平台：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+
38
39
 
39
- ## 使用方法
40
+ ## 使用
40
41
 
41
42
  ```
42
- clawmonitor [选项]
43
+ clawmonitor [options]
43
44
 
44
- 选项:
45
45
  --all 监控所有 session（不限时间）
46
46
  --compact 精简一行输出
47
- --history N 显示最近 N 条历史记录（默认 10）
47
+ --history N 显示最近 N 条历史（默认：10）
48
+ --full 完整显示输入输出（不截断）
48
49
  --help 显示帮助
49
50
  ```
50
51
 
51
- ## 示例
52
-
53
- ```bash
54
- # 默认：最近 30 分钟的 session + 10 条历史
55
- clawmonitor
56
-
57
- # 精简模式，显示 20 条历史
58
- clawmonitor --compact --history 20
59
-
60
- # 监控所有 session（不限时间）
61
- clawmonitor --all
62
- ```
63
-
64
- ## 依赖
65
-
66
- - **jq** — 唯一的外部依赖
67
- - Linux: `sudo apt install jq`
68
- - macOS: `brew install jq`
69
- - Windows: `pacman -S jq`（Git Bash）或使用 WSL
70
-
71
- 其他（`tail`、`date`、`bash`）系统自带。
72
-
73
52
  ## 环境变量
74
53
 
75
54
  | 变量 | 说明 |
@@ -77,14 +56,6 @@ clawmonitor --all
77
56
  | `OPENCLAW_HOME` | 自定义 OpenClaw 数据目录 |
78
57
  | `NO_COLOR` | 禁用彩色输出 |
79
58
 
80
- ## 开发
81
-
82
- ```bash
83
- git clone https://github.com/reopenpilot/clawmonitor.git
84
- cd clawmonitor
85
- bash bin/clawmonitor.sh --help
86
- ```
87
-
88
- ## 许可证
59
+ ## 许可
89
60
 
90
61
  MIT
package/README.zh-TW.md CHANGED
@@ -1,75 +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
8
 
9
- ## 為什麼需要它？
9
+ ## 為什麼需要？
10
10
 
11
- OpenClaw 是強大的個人 AI 助手，但缺少一個關鍵功能：**即時觀察 agent 在做什麼**。除錯提示詞、最佳化工具使用、理解 agent 行為時，你只能猜測。
11
+ OpenClaw 是強大的個人 AI 助手，但缺乏內建方式即時觀察 agent 實際在做什麼。除錯 prompt、優化工具使用、理解 agent 行為時，只能憑猜測。
12
12
 
13
- **ClawMonitor 填補了這個空白。** 它提供跨所有 agent 和 session 的即時工具呼叫檢視——這是 OpenClaw 應該有卻沒有的功能。
13
+ **ClawMonitor 補足了這個缺口。** 即時、統一地呈現所有 agent 和 session 的 tool call。
14
14
 
15
- - OpenClaw 只顯示最終回覆，看不到背後的工具呼叫過程
16
- - OpenClaw 的 session 日誌是原始 JSONL，難以閱讀，也不是即時的
17
- - ClawMonitor 讓 agent 行為透明化：呼叫了什麼工具、傳了什麼參數、來自哪個 session，按時間排序一目瞭然
15
+ - OpenClaw 只顯示最終回應，看不到背後的 tool calls
16
+ - Session logs 是原始 JSONL — 難讀且非即時
17
+ - ClawMonitor 讓 agent 行為透明化：哪些工具被呼叫、帶什麼參數、跨哪些 session，按時間排序
18
18
 
19
19
  ## 安裝
20
20
 
21
21
  ```bash
22
- # 不用安裝直接跑
22
+ # 不安裝直接跑
23
23
  npx clawmonitor
24
24
 
25
- # 全域安裝
25
+ # 或全域安裝
26
26
  npm install -g clawmonitor
27
27
  clawmonitor
28
28
  ```
29
29
 
30
30
  ## 功能
31
31
 
32
- - 🔧 即時監控所有 OpenClaw agent 的 tool calls
33
- - 📜 啟動時顯示最近 10 筆歷史記錄（跨 session，按時間排序）
34
- - 📋 可讀的 session 名稱（自動解析 conversation_label）
35
- - 🔄 自動追蹤新建的 session
36
- - 🎨 彩色終端機輸出（支援 `NO_COLOR` 環境變數）
37
- - 🖥️ 跨平台：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+
38
39
 
39
- ## 使用方式
40
+ ## 使用
40
41
 
41
42
  ```
42
- clawmonitor [選項]
43
+ clawmonitor [options]
43
44
 
44
- 選項:
45
45
  --all 監控所有 session（不限時間）
46
46
  --compact 精簡一行輸出
47
- --history N 顯示最近 N 筆歷史記錄（預設 10）
47
+ --history N 顯示最近 N 筆歷史（預設：10）
48
+ --full 完整顯示輸入輸出（不截斷）
48
49
  --help 顯示說明
49
50
  ```
50
51
 
51
- ## 範例
52
-
53
- ```bash
54
- # 預設：最近 30 分鐘的 session + 10 筆歷史
55
- clawmonitor
56
-
57
- # 精簡模式，顯示 20 筆歷史
58
- clawmonitor --compact --history 20
59
-
60
- # 監控所有 session（不限時間）
61
- clawmonitor --all
62
- ```
63
-
64
- ## 依賴
65
-
66
- - **jq** — 唯一的外部依賴
67
- - Linux: `sudo apt install jq`
68
- - macOS: `brew install jq`
69
- - Windows: `pacman -S jq`（Git Bash）或使用 WSL
70
-
71
- 其他（`tail`、`date`、`bash`）系統內建。
72
-
73
52
  ## 環境變數
74
53
 
75
54
  | 變數 | 說明 |
@@ -77,14 +56,6 @@ clawmonitor --all
77
56
  | `OPENCLAW_HOME` | 自訂 OpenClaw 資料目錄 |
78
57
  | `NO_COLOR` | 停用彩色輸出 |
79
58
 
80
- ## 開發
81
-
82
- ```bash
83
- git clone https://github.com/reopenpilot/clawmonitor.git
84
- cd clawmonitor
85
- bash bin/clawmonitor.sh --help
86
- ```
87
-
88
59
  ## 授權
89
60
 
90
61
  MIT