aw-openclaw-connect

Query and export cleaned ActivityWatch events via the aw-connect CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Query and export cleaned ActivityWatch events through the formal aw-connect CLI. Use when an agent needs to inspect recent user activity, sync what the user was doing after a pause, recover what happened during an absence window, or turn ActivityWatch logs into natural-language memory entries. For OpenClaw-style agents, use this proactively after a gap of 30+ minutes, when the user asks what happened during a time range, or when periodic memory backfill is due.

Core Features & Use Cases

  • Unified CLI for query and export
  • AFK cleanup option with robust watcher compatibility
  • Cross-device consolidation and memory backfill scenarios
  • Output in agent-friendly CSV for downstream reasoning

Quick Start

Install the package and run aw-connect to start querying or exporting.

Frequently Asked Questions about aw-openclaw-connect

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

FAQPage Schema
How do I export cleaned ActivityWatch events to CSV for agent reasoning?

You can export cleaned ActivityWatch events to CSV by running the aw-connect CLI, which loads events, applies AFK slicing, clips to time windows, and merges multi-device data into an agent-friendly CSV output.

What is AFK cleanup and how does it work with ActivityWatch data?

AFK cleanup removes idle periods from ActivityWatch logs by slicing events based on away-from-keyboard watcher data, ensuring the exported timeline only reflects active user sessions for accurate downstream memory backfill.

Can I query ActivityWatch events across multiple devices into a unified timeline?

Yes, the aw-connect CLI consolidates multi-device ActivityWatch data by discovering buckets, loading events, and merging them into coherent cross-device timelines with optional device and watcher filters.

How do I backfill user activity gaps after a 30 minute pause in OpenClaw?

To backfill activity gaps after a 30 minute pause, query the specific time range using relative minute parameters in aw-connect to recover and export what happened during the absence window.

Does aw-connect support relative minute queries for recent ActivityWatch activity?

Yes, aw-connect supports both explicit time range queries and relative minute queries, allowing you to inspect recent user activity dynamically without calculating exact timestamps for event export.

What are the limitations of exporting ActivityWatch logs through a Python package?

The Python package relies on local ActivityWatch bucket discovery and watcher compatibility for AFK slicing, meaning it requires a running local instance and robust watcher data to produce coherent merged timelines.