X Bookmark Archiver

What This Skill Does

The X Bookmark Archiver is a sophisticated utility designed to bridge the gap between ephemeral social media consumption and structured knowledge management. By automating the extraction of your X (Twitter) bookmarks, this skill transforms scattered URLs into a neatly organized, searchable library of markdown files located within your OpenClaw workspace. It goes beyond simple link-saving by leveraging AI to generate summaries, ensuring that you can recall the core value of a bookmark without needing to re-visit the live platform. The archival process categorizes content into pre-defined directories (such as tools, articles, videos, research, or news) based on URL signatures, facilitating efficient information retrieval and long-term knowledge retention for power users and researchers alike.

Installation

To begin, ensure you have Node.js 18 or higher installed on your system. You must first install the bird CLI tool from its official GitHub repository and complete the authentication process to allow the skill to access your account bookmarks. Once bird is ready, you can add this skill using the command: clawhub install openclaw/skills/skills/iamadig/x-bookmark-archiver. If you desire AI-powered content summaries, generate an API key from OpenAI and export it to your environment via export OPENAI_API_KEY="sk-...". Finally, verify your configuration by running the fetch command provided in the documentation to ensure your bookmarks are correctly syncing to your local machine.

Use Cases

This skill is ideal for researchers, developers, and tech enthusiasts who frequently save deep-dive articles or technical documentation from X. It is particularly effective for those maintaining a "Second Brain" system, as it offloads manual bookmark management to an automated process. Use it to build a local knowledge base of software development tools, track academic papers mentioned in niche scientific threads, or archive video tutorials before they disappear from your timeline feed.

Example Prompts

1. "OpenClaw, run the X Bookmark Archiver to catch up on all the new links I've saved since last week."
2. "Please process my pending X bookmarks and ensure all the latest technical articles have AI-generated summaries."
3. "Fetch my current X bookmarks and archive them into their proper categories in the OpenClaw workspace."

Tips & Limitations

To maximize the utility of the X Bookmark Archiver, ensure your OPENAI_API_KEY is always active to avoid skipped summary generation. Be aware that the tool relies on the bird CLI; if X updates its internal API or platform structure, the bird tool might require updates before the skill can resume syncing. If you encounter issues with file organization, verify your OPENCLAW_WORKSPACE path, as misconfigured directory permissions can prevent the skill from writing markdown files. Finally, remember that the tool functions best when running regularly; use a cron job or a periodic manual trigger to keep your local archive in sync with your active account usage.