← 返回 Skills 市场
157
总下载
1
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install karakeep-app
功能描述
Official skill for how to use karakeep (the bookmark manager) and interact with it programmatically.
使用说明 (SKILL.md)
Karakeep
Karakeep is an open source self-hosted bookmark manager for collecting, organizing, and searching content. This skill covers the core concepts and how to interact with Karakeep via the CLI.
When to use
Use this skill when the user wants to interact with their Karakeep instance (adding bookmarks, managing lists/tags, searching, etc.).
Core Concepts
Bookmarks
- Bookmarks: Core entity in Karakeep. Can be one of links, text or media.
- Links: Save URLs — Karakeep auto-fetches title, description, image, screenshot, and full-page archive.
- Text: Quick notes or text snippets stored as bookmarks.
- Media: Images and PDFs uploaded directly.
- Favorites: Star bookmarks for quick access.
- Archiving: Hide bookmarks from the homepage while keeping them searchable.
- Notes: Attach personal context notes to any bookmark.
- Highlights: Save quotes, summaries, or TODOs while reading — searchable across all bookmarks.
Lists
- Manual lists: Curated collections organized by project or topic. Can be private or public.
- Smart lists: Auto-updating lists powered by search queries (e.g.,
#ai -archived). - Collaboration: Invite editors (can add bookmarks) or viewers (read-only) to a list.
Tags
Lightweight labels for any bookmark (topics, sources, workflow states). Multiple tags per bookmark, tags travel with bookmarks across lists. AI can auto-generate tags when configured.
Search Query Language
Karakeep has a powerful search query language for finding the right bookmarks. It supports full-text search, boolean logic, qualifiers, and more.
Basic Syntax
- Spaces between conditions act as implicit AND.
- Use
and/orkeywords for explicit boolean logic. - Prefix any qualifier with
-or!to negate it (e.g.,-is:archived,!is:fav). - Use parentheses
()for grouping (note: groups themselves can't be negated). - Any text not part of a qualifier is treated as full-text search (e.g.,
machine learning is:fav).
Qualifiers
| Qualifier | Description | Example |
|---|---|---|
is:fav |
Favorited bookmarks | is:fav |
is:archived |
Archived bookmarks | -is:archived |
is:tagged |
Bookmarks with one or more tags | is:tagged |
is:inlist |
Bookmarks in one or more lists | is:inlist |
is:link |
Link bookmarks | is:link |
is:text |
Text/note bookmarks | is:text |
is:media |
Media bookmarks (images/PDFs) | is:media |
is:broken |
Bookmarks with failed crawls or non-2xx status codes | is:broken |
url:\x3Cvalue> |
Match URL substring | url:github.com |
title:\x3Cvalue> |
Match title substring (supports quoted strings) | title:rust, title:"my title" |
#\x3Ctag> or tag:\x3Ctag> |
Match bookmarks with specific tag (supports quoted strings) | #important, tag:"work in progress" |
list:\x3Cname> |
Match bookmarks in a specific list (supports quoted strings) | list:reading, list:"to review" |
after:\x3Cdate> |
Created on or after date (YYYY-MM-DD) | after:2024-01-01 |
before:\x3Cdate> |
Created on or before date (YYYY-MM-DD) | before:2024-12-31 |
age:\x3Ctime-range> |
Filter by creation age. Use \x3C / > for max/min age. Units: d (days), w (weeks), m (months), y (years) |
age:\x3C1d, age:>2w, age:\x3C6m |
feed:\x3Cname> |
Bookmarks imported from a specific RSS feed | feed:Hackernews |
source:\x3Cvalue> |
Match by capture source. Values: api, web, cli, mobile, extension, singlefile, rss, import |
source:rss, -source:web |
Examples
# Favorited bookmarks from 2024 tagged "important"
is:fav after:2024-01-01 before:2024-12-31 #important
# Archived bookmarks in "reading" list or tagged "work"
is:archived and (list:reading or #work)
# Untagged or unorganized bookmarks
-is:tagged or -is:inlist
# Recent bookmarks from the last week
age:\x3C1w
# Full-text search combined with qualifiers
machine learning is:fav -is:archived
RSS Feeds
Karakeep can also be used to consume RSS feeds, but also can itself act as an RSS feed publisher.
- Publishing: Export any list as an RSS feed with a unique token.
- Consuming: Auto-monitor external RSS feeds and create bookmarks from new items (hourly, with duplicate detection).
Automation
- Rule Engine: If-this-then-that rules to auto-tag, favorite, or route bookmarks to lists.
- Webhooks: Subscribe to bookmark events (add/update/archive).
Interacting with Karakeep via the CLI
Installation
npm install -g @karakeep/cli
Or via Docker:
docker run --rm ghcr.io/karakeep-app/karakeep-cli:release --help
Authentication
The CLI requires an API key and server address. Get the API key from your Karakeep instance's settings page.
Option 1 — Environment variables (recommended):
export KARAKEEP_API_KEY="your-api-key"
# If self-hosted, pass the server address as well. It defaults to the cloud instance if not set:
export KARAKEEP_SERVER_ADDR="https://cloud.karakeep.com"
Option 2 — CLI flags:
karakeep --api-key \x3Ckey> --server-addr \x3Caddr> \x3Ccommand>
Verify authentication:
karakeep whoami
Bookmark Commands
Run karakeep --help to see all available commands, but the most important ones are:
# Add a link bookmark
karakeep bookmarks add --link "https://example.com"
# Add a link with tags and to a specific list
karakeep bookmarks add --link "https://example.com" --tag-name "reading" --list-id \x3Clist-id>
# Add a text bookmark
karakeep bookmarks add --note "Remember to review the PR"
# Get bookmark details
karakeep bookmarks get \x3Cbookmark-id>
karakeep bookmarks get \x3Cbookmark-id> --include-content
# Update a bookmark
karakeep bookmarks update \x3Cbookmark-id> --title "New Title"
karakeep bookmarks update \x3Cbookmark-id> --archive
karakeep bookmarks update \x3Cbookmark-id> --favourite
karakeep bookmarks update-tags \x3Cbookmark-id> --add-tag "important"
karakeep bookmarks update-tags \x3Cbookmark-id> --remove-tag "old-tag"
# List management
karakeep lists list
karakeep lists get --list \x3Clist-id>
karakeep lists add-bookmark --list \x3Clist-id> --bookmark \x3Cbookmark-id>
karakeep lists remove-bookmark --list \x3Clist-id> --bookmark \x3Cbookmark-id>
karakeep lists delete \x3Clist-id>
# List all bookmarks
karakeep bookmarks list
# Search bookmarks
karakeep bookmarks search "is:fav #work"
karakeep bookmarks search "rust" --limit 10 --sort-order relevance
karakeep bookmarks search "is:tagged" --all # paginate through all results
# Delete a bookmark
karakeep bookmarks delete \x3Cbookmark-id>
You can always pass --json to get raw JSON output instead of pretty-printed output.
安全使用建议
This skill looks coherent for controlling a Karakeep instance: it needs the karakeep CLI and your Karakeep API key (and optionally the server address). Before installing, verify the npm package and Docker image come from the official Karakeep project (check the repository link and publisher), and prefer the Docker image or a vetted package provider if you don't fully trust the npm supply chain. Only provide an API key with the minimum necessary scope; if possible create a scoped or revocable token. Note the small metadata mismatch about whether the server address is required — double-check configuration when you install. If you have high security requirements, inspect the package source code or run installation in an isolated environment (container/VM) and review the repository at https://github.com/karakeep-app/karakeep before handing over credentials.
功能分析
Type: OpenClaw Skill
Name: karakeep-app
Version: 1.0.3
The skill bundle provides a legitimate interface for the Karakeep bookmark manager via its official CLI (@karakeep/cli). It defines standard environment variables for authentication and provides comprehensive documentation for bookmark management without any signs of malicious intent, data exfiltration, or prompt injection.
能力标签
能力评估
Purpose & Capability
Name/description, required binary (karakeep), and required env vars (KARAKEEP_API_KEY, optional KARAKEEP_SERVER_ADDR) all match the stated purpose of interacting with a Karakeep instance. The install spec (npm @karakeep/cli) produces the karakeep binary declared as required.
Instruction Scope
SKILL.md instructs installing the CLI, setting the API key/server address, and using the CLI to manage bookmarks. The visible instructions do not ask the agent to read unrelated files, secrets, or system config. (Note: the provided excerpt included a truncation marker; the visible content contains only expected CLI usage.)
Install Mechanism
Install uses an npm package (@karakeep/cli) which is a reasonable way to provide a CLI but carries the normal npm supply-chain risk (postinstall scripts, arbitrary code at install-time). The SKILL.md also references an official Docker image (ghcr.io) which is a standard distribution. No suspicious download URLs or extract-from-arbitrary-URL installs were found.
Credentials
Required env vars are limited to the API key and server address for the Karakeep service — proportional to the stated functionality. Minor metadata inconsistency: SKILL.md marks KARAKEEP_SERVER_ADDR as optional but the registry 'requires.env' lists both env vars; this is likely a small metadata mismatch rather than a substantive risk.
Persistence & Privilege
Skill is not marked always:true and does not request permanent elevated privileges or modifications to other skills. Autonomous invocation is allowed (platform default) but not combined with other concerning indicators.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install karakeep-app - 安装完成后，直接呼叫该 Skill 的名称或使用
/karakeep-app触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.3
- Added detailed OpenClaw metadata for environment variables, binaries, installation, homepage, and documentation links.
- Updated the description to clarify this is the official skill and added additional context in metadata.
- No changes to user-facing usage documentation or CLI examples.
- No functional changes to skill logic or content.
v1.0.1
- Added metadata tags for improved discoverability: "bookmark manager", "2nd brain", and "productivity".
- No functional changes to usage or CLI instructions.
v1.0.0
- Updated documentation to describe the new official Karakeep CLI, including installation and usage instructions.
- Expanded and clarified coverage of Karakeep core concepts such as bookmarks, lists, tags, and the advanced search query language.
- Added instructions for authentication, bookmark management, list management, and automation using the new CLI.
- Documentation now reflects all bookmark management operations available via the new CLI, with examples.
元数据
常见问题
Karakeep 是什么？
Official skill for how to use karakeep (the bookmark manager) and interact with it programmatically. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 157 次。
如何安装 Karakeep？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install karakeep-app」即可一键安装，无需额外配置。
Karakeep 是免费的吗？
是的，Karakeep 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Karakeep 支持哪些平台？
Karakeep 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Karakeep？
由 Karakeep（@karakeep）开发并维护，当前版本 v1.0.3。
推荐 Skills