Karakeep Note Capture lets Openclaw save durable, human-readable notes into Karakeep for later discovery outside chat and local memory.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install karakeep-note-capture
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 karakeep-note-capture 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 Karakeep Note Capture?
Karakeep Note Capture is an Openclaw Skills workflow for persisting useful findings, setup details, source links, and project notes into Ryan's Karakeep knowledge base. It is designed for information that should be rediscoverable later by a human, not just retained transiently inside a conversation.
This skill bridges agent work and personal knowledge management by turning high-value discoveries into tagged, searchable Karakeep entries. It helps keep durable context out of noisy session transcripts while still preserving important artifacts like URLs, hostnames, file paths, and implementation summaries.
Karakeep Note Capture Use Cases
- Recording homelab discoveries, service URLs, admin findings, and operational notes.
- Capturing research references, browse-later sources, and useful background material.
- Saving project notes that behave more like bookmarks or knowledge-base entries than ephemeral memory.
- Documenting completed setup work in a human-facing archive.
- Preserving information that should remain discoverable by Ryan and future agents.
- Storing both Karakeep notes and local memory when the fact matters for continuity and for later browsing.
How Karakeep Note Capture Works
- Evaluate whether the information is durable and useful enough to store in Karakeep.
- Filter out secrets, private messages, credentials, and noisy raw logs.
- Write a concise, recognizable title that Ryan can quickly understand later.
- Put the substantive note content in the body, including helpful context like URLs, hostnames, IDs, or file paths when relevant.
- Add one or more project or domain tags using repeated
--tagflags. - Run the
karakeep-notehelper and confirm it returns a JSON object containing anid. - If the note also matters for future agent continuity, update the appropriate local memory file as well.
Karakeep Note Capture Setup
- Ensure the Karakeep helper and secrets are present in the OpenClaw workspace.
- Verify the API token file exists at
/root/.openclaw/secrets/karakeep-openclaw-api-tokenand is permissioned securely with mode0600. - Use the workspace helper to create notes in the
OpenClaw Noteslist. - Pass a title plus one or more tags; the default tags are
openclawandkevin. - Confirm the helper returns a JSON response with a note
id.
/root/.openclaw/workspace/bin/karakeep-note --title "Useful finding" --tag project-name <<'EOF'
Body text to save.
EOF
chmod 0600 /root/.openclaw/secrets/karakeep-openclaw-api-token
Example capture:
printf '%s\n' 'Zabbix dashboard sync lives in /root/.openclaw/workspace/zabbix-proxmox-services and updates host-a/host-b service status.' \
| /root/.openclaw/workspace/bin/karakeep-note --title 'Zabbix Proxmox service dashboard notes' --tag zabbix --tag proxmox
Karakeep Note Capture Data Schema & Taxonomy
Karakeep Note Capture does not define a local database schema; instead, it organizes captured knowledge through note metadata and list membership.
| Field / Concept | Purpose | Notes |
|---|---|---|
| Title | Human-readable summary | Should be concise and recognizable later |
| Body | Durable note content | Include useful context, avoid credentials |
| Tags | Retrieval and categorization | Supports repeated --tag flags for project/domain classification |
| List | Archive destination | Defaults to OpenClaw Notes |
| Default tags | Baseline taxonomy | openclaw, kevin |
| API token scope | Authentication and permissions | Scoped as openclaw-notes with bookmark/list/tag read-write permissions |
| Return payload | Capture confirmation | Helper returns JSON containing an id |
Recommended content taxonomy:
- Operational: service names, hostnames, URLs, infrastructure notes.
- Research: references, sources, and browse-later findings.
- Project: setup summaries and implementation notes.
- Context: IDs, file paths, and navigation hints that improve rediscovery.
Karakeep Note Capture Advanced Features
- Supports structured tagging with repeated
--tagflags for multi-dimensional retrieval. - Produces a machine-readable JSON response with a persistent note
idfor automation pipelines. - Integrates directly with Openclaw Skills workflows using a lightweight CLI helper.
- Can be paired with local memory updates for dual-purpose persistence: human browsing plus agent continuity.
- Uses a dedicated token scope and secret file workflow for controlled access to Karakeep.
- Designed to capture durable knowledge without polluting chat transcripts or ephemeral session state.
- Encourages clean knowledge hygiene by separating sensitive data from rediscoverable notes.
SKILL.md
Loading
Related Openclaw Skills
PriceWin Hotel Price Comparison
PriceWin Hotel Price Comparison helps Openclaw Skills agents compare live hotel rates across major OTAs and OpenTravel to find the cheapest bookable option.
PriceWin Flight Search
Openclaw Skills for PriceWin Flight Search lets agents compare live flight fares across major OTAs with a strict polling workflow and booking links.
PriceWin Hotel Deal Finder
PriceWin Hotel Deal Finder uses Openclaw Skills to compare live hotel prices across major OTAs and return the cheapest, best-value, and quality picks in one command.
Vox
Vox is an Openclaw Skills-powered CLI transcription workflow for securely converting one explicitly provided URL or local audio/video file into transcripts and subtitle formats.
Agent KB
Openclaw Skills for Agent KB helps you create, maintain, validate, and optimize a repository-local knowledge base for coding agents.
Xueshu Search
Xueshu Search is an Openclaw Skills academic search workflow for multilingual paper discovery, citation tracing, DOI lookup, BibTeX export, and AI summaries.
Featured*
