← 返回 Skills 市场

ClawKeeper — Tasks & habits in a plain markdown file

Name: ClawKeeper — Tasks & habits in a plain markdown file
Author: tallhamn

作者 tallhamn · GitHub ↗ · v0.2.2

cross-platform ✓ 安全检测通过

707

总下载

当前安装

版本数

在 OpenClaw 中安装

/install clawkeeper

功能描述

Tasks and habits that live in a plain markdown file on your machine. Free, private, and claw-native.

使用说明 (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 --id for precise lookups or --text for fuzzy substring matching.
When adding a task, the response includes the new task's id for subsequent operations.

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install clawkeeper
安装完成后，直接呼叫该 Skill 的名称或使用 /clawkeeper 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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

元数据

Slug clawkeeper

版本 0.2.2

许可证 —

累计安装 1

当前安装数 1

历史版本数 4

常见问题