什么是 Karakeep 书签管理器？

Karakeep 技能是专为需要对书签进行高级控制的开发人员和高级用户设计的强大集成。它提供了一个功能齐全的 REST API 接口，使用户能够轻松管理链接、文本片段和媒体项目。通过在 Openclaw Skills 生态系统中使用此技能，用户可以自动化其知识管理，并简化保存和检索信息的方式。

该技能支持丰富的元数据，包括笔记、标签和自定义列表，使其成为个人知识管理的必备工具。它弥合了简单浏览器书签与结构化、可搜索的数字资产数据库之间的差距，所有内容均可通过命令行或集成代理访问。

下载入口:https://github.com/openclaw/skills/tree/main/skills/vandeefeng/karakeep-sh

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Karakeep 书签管理器 应用场景

• 使用自定义笔记和标签保存技术文章或研究论文。
• 通过 CLI 将项目相关资源组织到专用列表中。
• 使用日期、类型或标签等特定限定符对存档内容进行高级搜索。
• 自动化从 Openclaw Skills 中的其他工具添加新书签。
• 管理文本片段和媒体链接的集中知识库。

1. 用户配置环境变量以连接到其 Karakeep 服务器实例。
2. 通过 CLI 使用提供的 kb- 脚本函数发布命令。
3. 该技能与 Karakeep REST API 通信以执行创建、更新或删除等操作。
4. 使用 MeiliSearch 后端处理搜索查询，实现基于限定符的高速检索。
5. 响应以结构化 JSON 格式返回，允许在 Openclaw Skills 中进行进一步处理或自动化。

Karakeep 书签管理器 配置指南

要初始化此技能，请确保您有一个正在运行且可访问的 Karakeep 实例。在您的 shell 配置中配置环境变量：

export KARAKEEP_SERVER_URL="https://your-karakeep-instance.com"
export KARAKEEP_API_KEY="your_secret_api_key"

然后，利用提供的脚本启用 CLI 操作：

source scripts/karakeep-script.sh

Karakeep 书签管理器 数据架构与分类体系

Karakeep 技能通过几个核心实体管理数据。所有操作都返回 JSON 对象以便于解析。以下是主要结构：

搜索操作允许按日期（晚于/早于）、状态（is:fav, is:archived）和内容类型进行过滤。

name: karakeep
description: Karakeep bookmark manager with full API support including notes, updates, and deletion. Requires KARAKEEP_SERVER_URL and KARAKEEP_API_KEY environment variables.

Karakeep Skill

Advanced Karakeep bookmark management with full REST API support.

Complete Function Reference

Use this script karakeep-script.sh

We have the functions below:

Available Operations

Create Bookmark with Note

# Link bookmark with note
kb-create link "https://example.com" "Example Site" "My analysis and notes here..."

# Text bookmark with note
kb-create text "Text content here" "My Note" "Additional notes..."

Update Bookmark Note

kb-update-note "bookmark_id" "Updated note content..."

Delete Bookmark

kb-delete "bookmark_id"

Get Bookmark

kb-get "bookmark_id"

Search Operations

# Search with qualifiers (uses MeiliSearch backend)
kb-search "is:fav after:2023-01-01 #important"
kb-search "machine learning is:tagged"
kb-search "list:reading #work"

# Search with custom limit and sort order
kb-search "python" 50 "desc"  # 50 results, descending order

# Available qualifiers:
# - is:fav, is:archived, is:tagged, is:inlist
# - is:link, is:text, is:media
# - url:, #, list:
# - after:, before:

# Sort options: relevance (default), asc, desc

API Parameters:

• q (required): Search query string with qualifiers
• limit (optional): Results per page (default: server-controlled)
• sortOrder (optional): asc | desc | relevance (default)
• cursor (optional): Pagination cursor
• includeContent (optional): Include full content (default: true)

List Management

# List all lists
kb-lists

# Create new list
kb-create-list "Reading List" "??"

# Add bookmark to list
kb-add-to-list "bookmark_id" "list_id"

# Remove bookmark from list
kb-remove-from-list "bookmark_id" "list_id"

Tag Management

# Attach tags
kb-attach-tags "bookmark_id" "important" "todo" "work"

# Detach tags
kb-detach-tags "bookmark_id" "oldtag" "anotherold"

Notes

• All responses are in JSON format
• Bookmark IDs are returned in creation responses
• Use jq for pretty-printing JSON responses
• API rate limits may apply