Claw Diary is an always-on activity recorder that transforms raw agent logs into narrative summaries, visual timelines, and first-person AI journals.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install claw-diary
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install claw-diary using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Claw Diary?
Claw Diary acts as a digital dashcam for your AI assistant, providing a comprehensive record of every action and decision made during a session. This tool is essential for users of Openclaw Skills who need transparency into their agent's behavior, token consumption, and task execution. By converting technical logs into human-readable narratives, it bridges the gap between complex AI operations and actionable insights.
Beyond simple logging, the skill introduces a unique reflective layer. It generates a first-person journal where the AI reflects on its daily activities based on a customizable persona. This helps developers and power users understand the narrative arc of their agent's work, making it easier to audit performance and refine agent interactions over time.
Claw Diary Use Cases
- Auditing AI agent decision-making processes through narrative daily summaries.
- Monitoring and analyzing token usage and costs across different models and tools.
- Debugging complex multi-step workflows using the interactive visual timeline replay.
- Generating automated weekly reports to track productivity trends and recurring tasks.
- Maintaining a reflective AI-written journal to capture insights and observations from the agent's perspective.
How Claw Diary Works
- The skill automatically captures every agent event and tool call, saving them into local JSONL files daily.
- When a user executes a slash command like /diary, the CLI parses the raw event data to generate a markdown-formatted summary.
- For visual debugging, the replay command spins up a local web server to display an interactive, color-coded timeline of all activities.
- The AI journaling feature reads the day's events and combines them with a stored persona file to write a reflective first-person account.
- All data is managed locally within a specific directory, ensuring privacy while allowing for easy search and data export.
Claw Diary Setup
To begin using this skill, ensure you have the CLI tool installed on your system. Run the following command in your terminal:
which claw-diary || npm install -g claw-diary
Once installed, the agent will begin recording activities automatically. You can verify the installation by running claw-diary --version to ensure you are compatible with the latest Openclaw Skills features.
Claw Diary Data Schema & Taxonomy
Claw Diary stores all information locally to maintain privacy and speed. The data is organized as follows:
| Directory/File | Format | Purpose |
|---|---|---|
~/.claw-diary/events/ |
JSONL | Stores raw daily activity logs and event nodes. |
~/.claw-diary/journal/ |
Markdown | Contains the AI's first-person daily reflections. |
~/.claw-diary/persona.md |
Markdown | Defines the AI's voice, traits, and evolving observations. |
~/.claw-diary/config.json |
JSON | Stores optional user-defined configuration settings. |
Claw Diary Advanced Features
- Interactive Visual Timeline: A browser-based replay tool with color-coded nodes and click-to-expand cost details.
- Evolving AI Persona: The agent automatically appends new observations about its own behavior to its persona file.
- Granular Cost Analytics: Detailed breakdown of token usage by model, tool, and session for precise budget tracking.
- Flexible Data Export: Support for exporting diary entries and logs into MD, HTML, or JSON formats for external auditing.
- Deep History Search: A specialized search command to find specific historical events across the entire archive.
SKILL.md
Loading
Related Openclaw Skills
Excalidraw Canvas
A visualization skill that enables AI agents to programmatically create, render, and share editable Excalidraw diagrams as PNG images.
Sameer Gupta - DevOps & Cloud Infrastructure Expert
A professional-grade skill set for managing cloud-native infrastructure, Kubernetes orchestration, and immutable system design.
Game Light Tracker
A smart home automation skill that changes Philips Hue light colors in real-time based on live sports score leads.
Open WebUI API Integration
A comprehensive API integration for managing LLMs, RAG workflows, and Ollama operations through an Open WebUI instance.
MegaETH Developer
A specialized development playbook for building high-performance, real-time decentralized applications on the MegaETH network.
First 1000 Users: Reddit Seeding Agent
An AI-powered Reddit seeding agent designed to help founders find their first users through personalized community outreach and thread discovery.
METADATA
Featured*
