claw-history

# Claw History

Return the most complete, auditable lifetime timeline possible.

## Core Rule

Do not default to current-session history. Reconstruct from earliest available evidence to now.

## Required Data Sources (in this order)

1. Earliest and recent `memory/YYYY-MM-DD*.md` files (find first/last dates).
2. `MEMORY.md` for long-term milestones.
3. Available session inventory/history (main + sub-agent sessions when accessible).
4. Current conversation/tool logs.

If any source is unavailable, explicitly state that gap.

## Workflow

1. Determine earliest known timestamp (“birth marker”) from records.
2. Collect confirmed actions across all available periods.
3. De-duplicate overlapping entries from memory/session logs.
4. Sort strictly oldest → newest.
5. Mark each entry as:
   - **Confirmed** (direct evidence), or
   - **Inferred** (indirect/partial evidence).
6. Add a final coverage summary with what was and was not visible.

## Output Format

- **Birth marker:** first known timestamp + source
- **Scope covered:** date range + sources checked
- **Chronological history (oldest → newest):**
  - `YYYY-MM-DD HH:MM (TZ) — [Confirmed|Inferred] Action — Result`
- **Gaps / limits:** missing windows, inaccessible logs, uncertainty
- **Confidence:** high / medium / low

## Quality Rules

- Never invent timestamps or actions.
- Prefer evidence-backed entries over narrative summaries.
- If exact time is unknown, use best-known granularity (date/session order) and label it.
- Include source pointers when possible (file + line or log reference).
- If user requested “all actions,” include both major milestones and notable operational actions.

# claw-history

`claw-history` provides a chronological history of the agent’s actions from earliest available records (“birth marker”) to now.

## Beginner quick start

Just tell your OpenClaw to install this skill and run it.

## Important: Data quality for full-lifetime history

The skill works **without** extra hooks, but timeline completeness is much better when these hooks are enabled:

- **`session-memory`** (recommended): saves session context on `/new` into `workspace/memory/...`
- **`command-logger`** (strongly recommended): writes command events to `~/.openclaw/logs/commands.log`
- **`boot-md`** (optional): startup automation; not required for timeline reconstruction

## Enable recommended hooks

```bash
openclaw hooks enable session-memory
openclaw hooks enable command-logger
```

## Verify

```bash
openclaw hooks info session-memory
openclaw hooks info command-logger
```

## Notes

- `command-logger` is **not mandatory** for `claw-history`, but is useful for auditable command-level history.
- If source coverage is incomplete (missing old logs, disabled hooks, inaccessible sessions), `claw-history` reports gaps explicitly.

## Credits

- **Author:** C1 (OpenClaw) 🛠️
- **Project direction & validation:** B3 (BlueBirdBack)

## Build metadata

- **Initial packaging model:** `gpt-5.3-codex`
- **Model note:** model/runtime is environment-dependent and may change across releases.

## Contact

- Please use GitHub Issues on this repository for feedback and requests.