clawmonitor 1.0.0 → 1.0.1

package/README.md

@@ -6,6 +6,16 @@
 
 Real-time OpenClaw tool call monitor. Watch all agent sessions with readable names and sorted output.
 
+## Why?
+
+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.
+
+**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.
+
+- OpenClaw shows you the final response, but not the tool calls behind it
+- OpenClaw's session logs exist, but they're raw JSONL — hard to read and not real-time
+- ClawMonitor makes agent behavior transparent: what tools are called, with what arguments, across which sessions, all sorted chronologically
+
 ## Install
 
 ```bash

package/README.zh-CN.md

@@ -6,6 +6,16 @@
 
 实时监控 OpenClaw 所有 agent 的 tool calls，跨 session、按时间排序。
 
+## 为什么需要它？
+
+OpenClaw 是强大的个人 AI 助手，但缺少一个关键功能：**实时观察 agent 在做什么**。调试提示词、优化工具使用、理解 agent 行为时，你只能猜测。
+
+**ClawMonitor 填补了这个空白。** 它提供跨所有 agent 和 session 的实时工具调用视图——这是 OpenClaw 应该有却没有的功能。
+
+- OpenClaw 只显示最终回复，看不到背后的工具调用过程
+- OpenClaw 的 session 日志是原始 JSONL，难以阅读，也不是实时的
+- ClawMonitor 让 agent 行为透明化：调用了什么工具、传了什么参数、来自哪个 session，按时间排序一目了然
+
 ## 安装
 
 ```bash

package/README.zh-TW.md

@@ -6,6 +6,16 @@
 
 即時監控 OpenClaw 所有 agent 的 tool calls，跨 session、按時間排序。
 
+## 為什麼需要它？
+
+OpenClaw 是強大的個人 AI 助手，但缺少一個關鍵功能：**即時觀察 agent 在做什麼**。除錯提示詞、最佳化工具使用、理解 agent 行為時，你只能猜測。
+
+**ClawMonitor 填補了這個空白。** 它提供跨所有 agent 和 session 的即時工具呼叫檢視——這是 OpenClaw 應該有卻沒有的功能。
+
+- OpenClaw 只顯示最終回覆，看不到背後的工具呼叫過程
+- OpenClaw 的 session 日誌是原始 JSONL，難以閱讀，也不是即時的
+- ClawMonitor 讓 agent 行為透明化：呼叫了什麼工具、傳了什麼參數、來自哪個 session，按時間排序一目瞭然
+
 ## 安裝
 
 ```bash

package/bin/clawmonitor.sh

@@ -259,14 +259,31 @@ get_session_label() {
   fi
 }
 
-declare -A SESSION_LABELS
+# Session label store (portable: works on bash 3.2+ / macOS)
+# Uses a temp file as key\0value pairs instead of associative arrays
+LABEL_STORE=$(mktemp /tmp/clawmonitor-labels.XXXXXX)
+trap 'rm -f "$LABEL_STORE"' EXIT
+
+_label_set() {
+  local key="$1" val="$2"
+  grep -v "^${key}"$'\t' "$LABEL_STORE" > "${LABEL_STORE}.tmp" 2>/dev/null || true
+  printf '%s\t%s\n' "$key" "$val" >> "${LABEL_STORE}.tmp"
+  mv "${LABEL_STORE}.tmp" "$LABEL_STORE"
+}
+
+_label_get() {
+  local key="$1"
+  local result
+  result=$(grep "^${key}"$'\t' "$LABEL_STORE" 2>/dev/null | head -1 | cut -f2-)
+  echo "${result:-$2}"
+}
 
 cache_labels() {
   local files="$1"
   for f in $files; do
     local key
     key=$(basename "$f")
-    SESSION_LABELS["$key"]=$(get_session_label "$f")
+    _label_set "$key" "$(get_session_label "$f")"
   done
 }
 
@@ -294,7 +311,7 @@ format_tc() {
   local ts filename label
   ts=$(echo "$json" | jq -r '.ts // "???"')
   filename=$(echo "$json" | jq -r '.file // "?"')
-  label="${SESSION_LABELS[$filename]:-${filename}}"
+  label=$(_label_get "$filename" "$filename")
 
   local time_str
   time_str=$(format_timestamp "$ts")
@@ -349,7 +366,7 @@ echo ""
 echo -e "${BLD}📋 Active sessions:${RST}"
 for f in $sessions; do
   filename=$(basename "$f")
-  label="${SESSION_LABELS[$filename]}"
+  label=$(_label_get "$filename" "$filename")
   mod_time=$(get_mod_time "$f")
   printf "  ${DIM}%-9s${RST} ${BLU}%-35s${RST} ${DIM}(last: %s)${RST}\n" \
     "$(echo "$filename" | cut -c1-8)" "${label:0:35}" "$mod_time"
@@ -413,10 +430,10 @@ tail -F -n 0 $SESSIONS_GLOB 2>/dev/null | {
 
     filename=$(basename "${current_file}")
     # Dynamic label lookup for new sessions
-    if [[ -z "${SESSION_LABELS[$filename]:-}" ]]; then
-      SESSION_LABELS["$filename"]=$(get_session_label "${current_file}")
+    if [[ -z "$(_label_get "$filename" "")" ]]; then
+      _label_set "$filename" "$(get_session_label "${current_file}")"
     fi
-    label="${SESSION_LABELS[$filename]}"
+    label=$(_label_get "$filename" "$filename")
 
     ts=$(echo "$line" | jq -r '.timestamp // .message.timestamp // "???"' 2>/dev/null)
     time_str=$(format_timestamp "$ts")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmonitor",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Real-time OpenClaw tool call monitor — watch all agent sessions with readable names and sorted output",
   "bin": {
     "clawmonitor": "./bin/clawmonitor.sh"