什么是 Karakeep？

Karakeep 技能是专为 Openclaw Skills 设计的专业工具，可实现与 Karakeep 实例的无缝集成。它允许用户收集链接、组织数字资源，并通过高级搜索查询检索信息。通过利用该技能，开发人员和研究人员可以维护一个结构化的 URL 库，使 AI 代理在复杂工作流中更轻松地交互和引用外部 Web 内容。

下载入口:https://github.com/openclaw/skills/tree/main/skills/jayphen/karakeep

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

Karakeep 应用场景

• 在研究时保存感兴趣的文章或文档。
• 在个人知识库中搜索特定的技术参考资料。
• 在 AI 驱动的竞品分析过程中自动化收集链接。
• 使用特定的标签和过滤器组织项目相关的资源。

1. AI 代理检测到类似“保存到 Karakeep”或“搜索我的书签”的触发短语。
2. 该技能使用 uv Python 工具执行 Karakeep CLI 脚本。
3. 对于保存操作，URL 将通过 API 发送到配置的 Karakeep 实例。
4. 对于搜索操作，该技能解析查询语法（例如标签或标题）并检索匹配的记录。
5. 结果返回到代理上下文以供立即使用。

Karakeep 配置指南

要在 Openclaw Skills 中开始使用此技能，请先配置您的实例和 API 凭据：

uv run --with requests skills/karakeep/scripts/karakeep-cli.py login --url  

确保您的系统中已安装 uv，因为运行带有必要依赖项的脚本需要它。您还可以在 ~/.config/karakeep/config.json 文件中手动验证配置。

Karakeep 数据架构与分类体系

该技能通过 CLI 桥接器与 Karakeep 数据进行交互。配置存储在本地，而书签元数据由 Karakeep 服务器管理。

name: karakeep
description: Manage bookmarks and links in a Karakeep instance. Use when the user wants to save links, list recent bookmarks, or search their collection. Triggers on phrases like "hoard this link", "save to karakeep", or "search my bookmarks".
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["uv"]}}}

Karakeep Skill

Save and search bookmarks in a Karakeep instance.

Setup

First, configure your instance URL and API key:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py login --url  

Commands

Save a Link

Add a URL to your collection:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py add 

List Bookmarks

Show the most recent bookmarks:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py list --limit 10

Search Bookmarks

Find bookmarks matching a query. Supports complex syntax like is:fav, title:word, #tag, after:YYYY-MM-DD, etc.:

uv run --with requests skills/karakeep/scripts/karakeep-cli.py list --search "title:react is:fav"

Troubleshooting

• Ensure KARAKEEP_API_KEY (or HOARDER_API_KEY) is set or run login.
• Verify the instance URL is correct in the script or config (~/.config/karakeep/config.json).