Files

William Valentin 5900a51f3d Include all credentials and runtime config

Remove secret exclusions from .gitignore (local-only repo).
Add openclaw runtime state: credentials, identity, devices,
hooks, telegram, secrets, agent configs.
Exclude noisy/binary data: sessions, sqlite, media, temp files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-12 12:20:33 -07:00

2.7 KiB

Executable File

Raw Blame History

name, description, homepage, metadata

name

description

homepage

metadata

command-logger

Log all command events to a centralized audit file

https://docs.openclaw.ai/automation/hooks#command-logger

openclaw

emoji

events

install

📝

command

id	kind	label
bundled	bundled	Bundled with OpenClaw

Command Logger Hook

Logs all command events (/new, /reset, /stop, etc.) to a centralized audit log file for debugging and monitoring purposes.

What It Does

Every time you issue a command to the agent:

Captures event details - Command action, timestamp, session key, sender ID, source
Appends to log file - Writes a JSON line to ~/.openclaw/logs/commands.log
Silent operation - Runs in the background without user notifications

Output Format

Log entries are written in JSONL (JSON Lines) format:

{"timestamp":"2026-01-16T14:30:00.000Z","action":"new","sessionKey":"agent:main:main","senderId":"+1234567890","source":"telegram"}
{"timestamp":"2026-01-16T15:45:22.000Z","action":"stop","sessionKey":"agent:main:main","senderId":"user@example.com","source":"whatsapp"}

Use Cases

Debugging: Track when commands were issued and from which source
Auditing: Monitor command usage across different channels
Analytics: Analyze command patterns and frequency
Troubleshooting: Investigate issues by reviewing command history

Log File Location

~/.openclaw/logs/commands.log

Requirements

No requirements - this hook works out of the box on all platforms.

Configuration

No configuration needed. The hook automatically:

Creates the log directory if it doesn't exist
Appends to the log file (doesn't overwrite)
Handles errors silently without disrupting command execution

Disabling

To disable this hook:

openclaw hooks disable command-logger

Or via config:

{
  "hooks": {
    "internal": {
      "entries": {
        "command-logger": { "enabled": false }
      }
    }
  }
}

Log Rotation

The hook does not automatically rotate logs. To manage log size, you can:

Manual rotation:

mv ~/.openclaw/logs/commands.log ~/.openclaw/logs/commands.log.old

Use logrotate (Linux): Create /etc/logrotate.d/openclaw:

/home/username/.openclaw/logs/commands.log {
    weekly
    rotate 4
    compress
    missingok
    notifempty
}

Viewing Logs

View recent commands:

tail -n 20 ~/.openclaw/logs/commands.log

Pretty-print with jq:

cat ~/.openclaw/logs/commands.log | jq .

Filter by action:

grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .

2.7 KiB Executable File Raw Blame History