← Back to Skills Marketplace
1546
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install karakeep-save
Description
Save bookmarks to Karakeep (self-hosted bookmark manager). Use when the user wants to save a URL, bookmark a link, or add something to their reading list.
README (SKILL.md)
Karakeep
Save bookmarks to a self-hosted Karakeep instance.
Setup
Set these environment variables (in your shell profile or Clawdbot config):
export KARAKEEP_URL="https://your-karakeep-instance.com"
export KARAKEEP_API_KEY="your-api-key"
To get your API key: Karakeep → Settings → API Keys → Create new key.
Save a bookmark
{baseDir}/scripts/save.sh "\x3CURL>" ["optional note"]
Examples:
{baseDir}/scripts/save.sh "https://example.com/article"
{baseDir}/scripts/save.sh "https://github.com/repo" "Interesting project to check out"
API Details
- Endpoint:
POST {KARAKEEP_URL}/api/v1/bookmarks - Auth: Bearer token
- Body:
{"type": "link", "url": "...", "note": "..."}
Response
Returns JSON with bookmark ID. Tags will be auto-generated by Karakeep's AI.
Usage Guidance
This skill appears to do what it says (POST a bookmark to your Karakeep server) but the package metadata omits important runtime requirements. Before installing: 1) Inspect scripts/save.sh yourself — it will send the URL and optional note to KARAKEEP_URL using KARAKEEP_API_KEY. 2) Ensure you have curl and jq installed (the script depends on them). 3) Store KARAKEEP_API_KEY securely (environment or secret store) and confirm KARAKEEP_URL is the correct HTTPS endpoint. 4) Because the owner and homepage are unknown, prefer running the script in a sandbox or local review first; ask the publisher to update metadata to declare required env vars and binaries so automated checks and users are not misled.
Capability Analysis
Type: OpenClaw Skill
Name: karakeep-save
Version: 1.0.0
The skill is designed to save bookmarks to a user's self-hosted Karakeep instance. It requires the user to provide `KARAKEEP_URL` and `KARAKEEP_API_KEY` environment variables, which are then used by the `scripts/save.sh` script to make an authenticated `curl` request to the specified endpoint. Input sanitization for the JSON body is handled safely using `jq`. There is no evidence of data exfiltration beyond the intended API interaction, malicious execution, persistence mechanisms, or prompt injection attempts against the agent in SKILL.md. All actions are directly aligned with the stated purpose.
Capability Assessment
Purpose & Capability
The skill's name and description match the included script: it POSTs a bookmark to a Karakeep instance. However, the registry metadata declares no required environment variables or binaries, while the SKILL.md and scripts/save.sh clearly require KARAKEEP_URL and KARAKEEP_API_KEY and use external tools (curl and jq). This mismatch between declared requirements and actual runtime needs is a coherence problem.
Instruction Scope
SKILL.md instructs the agent to call scripts/save.sh with a URL and optional note and to set two environment variables. The instructions are narrowly scoped to saving bookmarks and do not request reading unrelated files or other credentials. The script only sends the bookmark data (url, note) to the configured Karakeep API.
Install Mechanism
There is no install spec (instruction-only), which minimizes install-time risk. However, the runtime script depends on common CLI tools (curl and jq) that are not declared in the metadata; the skill does not install them or verify their presence beyond failing if they're absent. This omission should be corrected or documented.
Credentials
The environment variables the skill needs (KARAKEEP_URL and KARAKEEP_API_KEY) are appropriate and proportionate for a bookmark-saving skill. The concern is that the metadata lists no required env vars, so a user or automated installer may not realize these secrets are needed or where they'll be used. The script will send the API key as a Bearer token to the configured URL (expected for the stated purpose).
Persistence & Privilege
The skill does not request persistent/global privileges: always is false, and it does not modify other skills or system-wide configuration. It performs a single network request to the user-supplied Karakeep instance when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install karakeep-save - After installation, invoke the skill by name or use
/karakeep-save - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - save bookmarks to self-hosted Karakeep instance
Metadata
Frequently Asked Questions
What is Karakeep Save?
Save bookmarks to Karakeep (self-hosted bookmark manager). Use when the user wants to save a URL, bookmark a link, or add something to their reading list. It is an AI Agent Skill for Claude Code / OpenClaw, with 1546 downloads so far.
How do I install Karakeep Save?
Run "/install karakeep-save" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Karakeep Save free?
Yes, Karakeep Save is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Karakeep Save support?
Karakeep Save is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Karakeep Save?
It is built and maintained by nickian (@nickian); the current version is v1.0.0.
More Skills