clinkding

What This Skill Does

The clinkding skill serves as a robust bridge between the OpenClaw AI agent and your self-hosted Linkding bookmarking service. It empowers your agent to act as a personal librarian, handling the storage, organization, and retrieval of your digital reading list. By leveraging the power of Linkding, this skill allows for full-text searching of saved URLs, metadata management (titles, descriptions), and efficient tag-based organization. Instead of manually bookmarking pages, you can offload this task to your agent, ensuring your bookmarks are always categorized, labeled, and archived without you having to leave your current workflow. It is designed for users who prioritize privacy and self-hosting while wanting the convenience of an intelligent assistant to manage their content.

Installation

To integrate clinkding into your OpenClaw environment, ensure you have the OpenClaw CLI installed, then run the following command: clawhub install openclaw/skills/skills/daveonkels/clinkding. After installation, initialize the configuration by running clinkding config init or manually setting your linkding instance URL and API token in the ~/.config/clinkding/config.yaml file. You may also opt to set the environment variables LINKDING_URL and LINKDING_TOKEN for seamless integration in shell-based workflows.

Use Cases

This skill is perfect for researchers, developers, and knowledge workers who frequently bookmark resources. Use it to automatically save documentation pages while coding, organize reading lists by topic using tags, or search through your entire archive to find a specific article you saved months ago. It is particularly effective at clearing 'unread' queues by filtering your library to show only items that need your attention.

Example Prompts

1. "Search my bookmarks for anything tagged with 'golang' and 'tutorial' and show me the most recent results."
2. "Save this URL https://example.com/api-docs and tag it as 'programming' and 'reference'."
3. "Find all my unread bookmarks that are related to 'artificial intelligence' and list their titles."

Tips & Limitations

To get the most out of clinkding, maintain a consistent tagging strategy. Because it relies on a local or self-hosted Linkding instance, ensure your server is reachable and your API token is secure. Note that performance is subject to your network latency to the bookmarking server. Avoid using extremely broad tags to maintain search precision.