openclaw-logs

Query and summarize OpenClaw gateway logs into a structured event timeline.

18|6|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/jincai/openclaw-skills --skill openclaw-logs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-logs
Source: https://github.com/jincai/openclaw-skills/tree/main/openclaw-logs
Command: npx skills add https://github.com/jincai/openclaw-skills --skill openclaw-logs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

OpenClaw-Logs helps teams quickly understand gateway activity by turning raw log data into an organized timeline, reducing time spent sifting through noisy entries.

Core Features & Use Cases

  • Time-range querying across multiple sources (gateway.log, gateway.err.log, and runtime JSON logs) to investigate incidents.
  • Category filtering (error, restart, plugin, telegram, acp, config, gateway) for focused debugging.
  • Noise reduction and timezone normalization to present consistent output.
  • Deduplication of duplicate events across sources.

Quick Start

Run the script to query logs within a Beijing-time window using --from and --to, or with --last for a relative window.

Frequently Asked Questions about openclaw-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query OpenClaw gateway logs to investigate an incident?

Filter OpenClaw gateway logs by category using error, restart, plugin, telegram, acp, config, or gateway tags. This focused debugging mechanism isolates specific event types from the raw log data to reduce noise.

Does the OpenClaw log summarizer handle timezone normalization and duplicate entries?

Yes, the OpenClaw log summarizer handles timezone normalization to present consistent output and deduplicates events across multiple sources. This noise reduction prevents duplicate entries from cluttering your incident analysis timeline.

What log file formats are supported for building a structured event timeline?

Supported log file formats include plain-text and JSON logs read from gateway.log, gateway.err.log, and runtime/openclaw-YYYY-MM-DD.log. The script parses these multiple sources to deduplicate entries and build a structured timeline.

Can I use verbose mode to inspect raw OpenClaw gateway log entries?

Yes, you can use the optional verbose mode to inspect detailed OpenClaw gateway log entries. This mode bypasses standard noise suppression, allowing you to view unfiltered events during deep incident analysis.