| name | openclaw-logs |
| description | 查询和分析 OpenClaw gateway 日志。当用户提到「查日志」「openclaw 发生了什么」「openclaw 日志」「gateway 日志」「查看最近的错误」「openclaw 最近怎么了」「openclaw 报错」或询问 OpenClaw 在某个时间段内的运行情况时，使用此技能。支持时间范围查询、按类别过滤（error/restart/telegram/plugin/acp/config 等）、自动去噪、时区转换，输出结构化的事件时间线。 |
OpenClaw Log Query
查询 OpenClaw gateway 日志，生成结构化的事件时间线。
Quick Start
运行脚本获取日志数据，然后基于输出为用户分析：
python3 ~/.claude/skills/openclaw-logs/scripts/query_logs.py --from "19:20" --to "20:00"
python3 ~/.claude/skills/openclaw-logs/scripts/query_logs.py --last 30m
python3 ~/.claude/skills/openclaw-logs/scripts/query_logs.py --last 2h
python3 ~/.claude/skills/openclaw-logs/scripts/query_logs.py --from "19:00" --to "20:00" --category error
python3 ~/.claude/skills/openclaw-logs/scripts/query_logs.py --last 1h --category restart
python3 ~/.claude/skills/openclaw-logs/scripts/query_logs.py --from "2026-03-03 22:00" --to "2026-03-04 02:00"
python3 ~/.claude/skills/openclaw-logs/scripts/query_logs.py --last 1h --verbose
Parameters
| Parameter | Description | Example |
|---|
--from | Start time (HH:MM or YYYY-MM-DD HH:MM), Beijing time | "19:20", "2026-03-04 19:20" |
--to | End time, Beijing time | "20:00" |
--last | Relative time window from now | 30m, 2h |
--date | Override date for HH:MM times (default: today) | 2026-03-03 |
--category / -c | Filter by event category | error, restart, plugin, telegram, acp, config, agent, gateway |
--verbose / -v | Include normally-filtered noise (cron heartbeats etc) | |
Categories
The script auto-categorizes each log entry:
- ERROR - Failures, rate limits, authentication errors
- RESTART - SIGTERM/SIGUSR1, draining, shutdown/startup
- PLUGIN - Plugin install, load, acpx backend
- TELEGRAM - Message sends, bot command issues
- ACP - ACP identity reconcile, agent dispatch
- CONFIG - Config changes, reload, provider updates
- WS - WebSocket connections (webchat UI)
- HEALTH - Health monitor checks and restarts
- AGENT - Agent model info, embedded run results
- GATEWAY - Listener, canvas, heartbeat, browser control
- CRON - Cron job triggers
Log Sources
The script reads from multiple sources and deduplicates:
~/.openclaw/logs/gateway.log - Plain text, mixed UTC/+08:00 timestamps~/.openclaw/logs/gateway.err.log - Plain text, errors and warnings/tmp/openclaw/openclaw-YYYY-MM-DD.log - Structured JSON (one file per day)
All timestamps are normalized to Beijing time (UTC+8) in the output.
Workflow
- Run the script with the user's time range
- Read the output - it includes a Summary (category counts), Errors (highlighted), and Timeline (chronological)
- Provide analysis to the user: what happened, what's concerning, and any suggested actions
- If the user asks about a specific issue, use
--category to drill down
When the user's question is vague (like "openclaw 怎么了"), start with --last 30m to see recent activity, then narrow down based on what you find.
