A local, markdown-driven task and habit tracker that allows AI agents to manage your personal productivity and consistency.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawkeeper
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 clawkeeper 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 ClawKeeper?
ClawKeeper is a privacy-focused command-line interface designed to bridge the gap between AI agents and personal task management. By storing all data in plain markdown files on your local machine, it ensures that your productivity data remains under your control. This tool is a core component for users building custom workflows with Openclaw Skills, offering a claw-native way to handle to-do lists and habit formation without relying on third-party cloud services.
The skill enables an AI agent to act as a supportive collaborator. By interacting with the CLI, the agent can maintain a task list, track habit intervals, and even provide proactive nudges based on your activity patterns. Because it relies on a shared directory via environment variables, multiple agents can coordinate their efforts using the same underlying data source.
ClawKeeper Use Cases
- Tracking professional project milestones and subtasks through an AI-assisted interface.
- Maintaining daily personal habits like exercise or meditation with automated agent reminders.
- Syncing task lists across different AI agents using a shared local markdown repository.
- Archiving reflections and notes on task progress for long-term productivity analysis.
How ClawKeeper Works
- The skill identifies the storage path via the CLAWKEEPER_DIR environment variable to locate the markdown data files.
- The user or agent issues CLI commands to add, edit, or list tasks and habits using the clawkeeper binary.
- The CLI processes the request and returns a structured JSON object indicating success or failure.
- During periodic heartbeat checks, the agent reviews the state of tasks and habits to identify missed deadlines or building streaks.
- The agent provides feedback or updates the markdown files based on user interactions and completion status.
ClawKeeper Setup
To integrate this tool into your Openclaw Skills environment, install the package via npm and define your storage directory.
npm install -g clawkeeper
# Set your data directory in your shell profile
export CLAWKEEPER_DIR="~/.clawkeeper/"
ClawKeeper Data Schema & Taxonomy
ClawKeeper uses a structured approach to manage information, ensuring that Openclaw Skills can easily parse and manipulate data. All outputs are returned as JSON objects for high reliability.
| Feature | Description | Key Attributes |
|---|---|---|
| Tasks | Individual to-do items | id, text, due-date, notes, parent-id |
| Habits | Recurring activities | id, text, interval, notes, completion-count |
| State | Global snapshot | status, active-tasks, habit-streaks |
| Storage | Markdown files | Local file system hierarchy |
ClawKeeper Advanced Features
- Fuzzy substring matching for task operations to simplify user commands without requiring exact IDs.
- Recursive subtask management allowing complex projects to be broken down into manageable units.
- Intelligent heartbeat monitoring that differentiates between building momentum and the need for gentle nudges.
- Environment-based configuration enabling seamless data sharing between different AI agent instances using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Webhook Robot
A universal communication skill designed to send automated messages to webhook-integrated platforms like WeCom, DingTalk, and Feishu.
Pasteclaw Agent
An agent-optimized tool for publishing, updating, and managing code snippets and UI prototypes via the Pasteclaw.com API.
QA Patrol
A local-first automated QA testing skill that performs everything from basic smoke tests to complex auth and payment flow verification.
SoulForge
SoulForge automatically evolves your AI agent's identity by analyzing your real-world interactions and updating your SOUL.md file to match your actual behavior.
Wrike
A comprehensive CLI tool for managing Wrike tasks, projects, and folders with seamless JSON integration.
LNbits Wallet Manager
A secure integration for AI agents to manage Bitcoin Lightning Network wallets via the LNbits API.
METADATA
Featured*
