claw-diary

What This Skill Does

Claw Diary is an advanced observability and reflective tool for AI agents, functioning as an "always-on" dashcam for your digital assistant. It continuously logs every interaction, tool execution, and decision point, storing them in a structured local format. Beyond raw logs, the skill processes this data to generate human-readable daily and weekly narrative summaries. It provides a visual timeline for debugging workflows, an analytics engine to track token spending, and an introspective module where the AI maintains a first-person journal based on its daily experiences.

Installation

To integrate this skill into your environment, use the OpenClaw hub command: clawhub install openclaw/skills/skills/0xbeekeeper/claw-diary

Ensure you have the required CLI tool installed globally on your system: which claw-diary || npm install -g claw-diary

Use Cases

• Agent Auditing: Review past sessions to identify where an agent went off-track during complex tasks.
• Cost Governance: Monitor token consumption patterns to prevent budget overruns in automated pipelines.
• Agent Alignment: Use the /diary:persona and /diary:thoughts features to maintain consistent behavior and monitor how the AI characterizes its own goal-oriented development.
• Project Documentation: Generate weekly reports of agent activities to serve as a high-level changelog for developer teams.

Example Prompts

1. "/diary:stats - Can you give me a breakdown of how much I spent on GPT-4 models this week compared to last week?"
2. "/diary:search refactor database schema - Show me the specific tool calls and outputs when the agent attempted to modify the migrations."
3. "/diary:thoughts - How did you feel about the complexity of the task you completed earlier today?"

Tips & Limitations

• Security: Since this skill stores all agent history in ~/.claw-diary/, ensure you are aware that this data is stored locally in plain text/JSON. Use /diary:clear regularly if you are working with sensitive data.
• Performance: For long-running agents, the JSONL history files can grow large. Regularly export your data and clear the logs to maintain peak performance.
• Context: The thoughts feature relies on a persona file. Customizing ~/.claw-diary/persona.md significantly improves the quality and relevance of the AI's journal entries.