← Back to Skills Marketplace
707
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install clawkeeper
Description
Tasks and habits that live in a plain markdown file on your machine. Free, private, and claw-native.
README (SKILL.md)
ClawKeeper CLI
Manage the user's tasks and habits via the ClawKeeper CLI. All data is stored as markdown at the path set by CLAWKEEPER_DIR (defaults to ~/.clawkeeper/).
clawkeeper \x3Centity> \x3Ccommand> [--flags]
If CLAWKEEPER_DIR is set in your environment, the CLI reads and writes data there. This allows multiple agents to share the same task list.
Tasks
clawkeeper task list
clawkeeper task add --text "Buy groceries"
clawkeeper task add --text "Buy groceries" --due-date 2026-03-15
clawkeeper task add-subtask --parent-text "Buy groceries" --text "Milk"
clawkeeper task complete --id \x3Cid>
clawkeeper task complete --text "Buy groceries"
clawkeeper task uncomplete --id \x3Cid>
clawkeeper task edit --text "Old name" --new-text "New name"
clawkeeper task edit --text "Old name" --due-date 2026-04-01
clawkeeper task set-due-date --text "Buy groceries" --due-date 2026-03-15
clawkeeper task set-due-date --text "Buy groceries" --due-date none
clawkeeper task delete --text "Buy groceries"
clawkeeper task add-note --text "Buy groceries" --note "Check prices first"
clawkeeper task edit-note --text "Buy groceries" --note "Check prices first" --new-note "Compare at two stores"
clawkeeper task delete-note --text "Buy groceries" --note "Check prices first"
Habits
clawkeeper habit list
clawkeeper habit add --text "Meditate" --interval 24
clawkeeper habit edit --text "Meditate" --new-text "Morning meditation" --interval 12
clawkeeper habit delete --text "Meditate"
clawkeeper habit complete --text "Meditate"
clawkeeper habit add-note --text "Meditate" --note "Felt calm today"
clawkeeper habit edit-note --text "Meditate" --note "Felt calm today" --new-note "Felt calm, 10 min session"
clawkeeper habit delete-note --text "Meditate" --note "Felt calm today"
State
clawkeeper state show
Proactive Checks (Heartbeat)
When running periodic checks, use clawkeeper state show to review the user's habits and tasks:
- Missed habits: If a habit hasn't been completed for more than 2x its interval, ask about it gently. People forget — a nudge helps more than a lecture.
- Building streaks: When a habit's completion count is climbing, acknowledge the momentum briefly.
- Recent notes: If the user added reflections or notes recently, reference them for continuity. It shows you're paying attention.
- Stale tasks: Tasks sitting open for a long time might need to be broken down, re-prioritized, or dropped.
Tone: supportive collaborator, not drill sergeant. If nothing needs attention, reply HEARTBEAT_OK.
Notes
- All commands return JSON:
{"ok": true, "data": ...}on success,{"ok": false, "error": "..."}on failure. - IDs are stable across invocations. Use
--idfor precise lookups or--textfor fuzzy substring matching. - When adding a task, the response includes the new task's
idfor subsequent operations.
Usage Guidance
This appears to be a straightforward CLI-driven task manager. Before installing: (1) verify the npm package source and maintainers (npm packages can run code during install); (2) ensure CLAWKEEPER_DIR is set to a directory you control (not /, /etc, your home dir root, or any sensitive path) and give it appropriate permissions; (3) consider running the npm install in a sandbox or review the package code if you need higher assurance; (4) be aware that if multiple agents share the same CLAWKEEPER_DIR, they will read/write the same data which may affect privacy.
Capability Analysis
Type: OpenClaw Skill
Name: clawkeeper
Version: 0.2.2
The skill bundle describes a local task and habit management tool, `clawkeeper`. It uses `npm` for installation, a standard package manager. Data is explicitly stated to be stored locally in markdown files at `CLAWKEEPER_DIR`. The instructions in `SKILL.md` for 'Proactive Checks' guide the agent to interact with the user based on the local task/habit data, but do not instruct the agent to perform any unauthorized actions, exfiltrate data, or bypass security. There is no evidence of malicious intent, obfuscation, or exploitation attempts.
Capability Assessment
Purpose & Capability
Name/description (local markdown task/habit manager) align with the declared requirements: it needs a 'clawkeeper' CLI and a directory (CLAWKEEPER_DIR) where markdown data is stored. Asking for CLAWKEEPER_DIR as the primaryEnv is slightly unusual (it's a path, not a secret) but not incoherent.
Instruction Scope
SKILL.md only instructs the agent to run the clawkeeper CLI against the directory in CLAWKEEPER_DIR and to perform periodic 'heartbeat' checks on tasks/habits. This stays within the skill's stated purpose. Note: because the CLI reads and writes whatever is under CLAWKEEPER_DIR, an attacker or misconfiguration that sets CLAWKEEPER_DIR to a sensitive location could expose or overwrite unrelated files. The instructions do not reference other env vars, system paths, or external endpoints.
Install Mechanism
Install is via the npm package 'clawkeeper' which creates the 'clawkeeper' binary. Using npm for a CLI is reasonable; npm packages carry the usual supply-chain risk (packages can execute arbitrary code during install). There is no direct download from an unknown URL in the spec.
Credentials
Only CLAWKEEPER_DIR is required, which is proportionate to a local file-backed CLI. However, treating a path as the primary credential is odd; confirm you trust the directory value. If CLAWKEEPER_DIR points to a shared or sensitive folder, the skill (and the CLI it runs) could read/modify unrelated files.
Persistence & Privilege
always is false and the skill does not request system-wide changes or persistent/always-on inclusion. Model invocation is allowed (the platform default), which is expected for a usable skill. The skill does not claim to modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clawkeeper - After installation, invoke the skill by name or use
/clawkeeper - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.2
Update skill description
v0.2.1
Update skill title
v0.2.0
Add optional due dates to tasks with color-coded urgency badges
v0.1.0
Initial release of clawkeeper: command-line tool for managing tasks and habits.
- Add, complete, edit, and delete tasks and habits with subcommands
- Manage subtasks and notes for both tasks and habits
- View current state and trigger proactive check-ins (heartbeat)
- All data stored in markdown at `CLAWKEEPER_DIR`
- Commands return JSON responses for easy parsing and automation
- Supports sharing of task and habit lists across agents via environment variable
Metadata
Frequently Asked Questions
What is ClawKeeper — Tasks & habits in a plain markdown file?
Tasks and habits that live in a plain markdown file on your machine. Free, private, and claw-native. It is an AI Agent Skill for Claude Code / OpenClaw, with 707 downloads so far.
How do I install ClawKeeper — Tasks & habits in a plain markdown file?
Run "/install clawkeeper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ClawKeeper — Tasks & habits in a plain markdown file free?
Yes, ClawKeeper — Tasks & habits in a plain markdown file is completely free (open-source). You can download, install and use it at no cost.
Which platforms does ClawKeeper — Tasks & habits in a plain markdown file support?
ClawKeeper — Tasks & habits in a plain markdown file is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ClawKeeper — Tasks & habits in a plain markdown file?
It is built and maintained by tallhamn (@tallhamn); the current version is v0.2.2.
More Skills