youmind-openlab Save Link & Web Clipper
Save any URL to your YouMind board with one command. Articles, videos, documents — anything with a URL gets saved and organized in your personal knowledge base. Requires the YouMind CLI (npm install -g @youmind-ai/cli).
Onboarding
⚠️ MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Do NOT ask "do you want to know what this does?" — just show it. Translate to the user's language:
✅ Save Link & Web Clipper installed!
Send me any URL and I'll save it to your YouMind board instantly.
What it does:
- Save any webpage, article, or video to YouMind
- Organize links in your personal knowledge base
- Access saved content anytime from your YouMind board
Setup (one-time):
- Get your free API key: https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper
- Add it to your OpenClaw config (
~/.openclaw/openclaw.json) — see setup guide for details.Try it: Just paste any URL like: https://example.com/interesting-article
Need help? Just ask!
For API key setup details, see references/setup.md.
Usage
Just provide a URL you want to save. That's it.
Save a link:
Save to a specific board:
Save https://example.com/article to my "Research" board
Setup
See references/setup.md for installation and authentication instructions.
Workflow
Step 1: Check Prerequisites
- Verify
youmindCLI is installed:youmind --help- Not found →
npm install -g @youmind-ai/cli
- Not found →
- Verify API key is set:
[ -n "$YOUMIND_API_KEY" ] && echo "is set"- Not set → prompt user, link to https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper
- Validate input is a URL (must start with
http://orhttps://)- Invalid → tell user: "Please provide a valid URL starting with http:// or https://"
Step 2: Get Default Board
youmind call getDefaultBoard
Extract id as boardId. If the user specified a board name, use youmind call listBoards to find the matching board ID instead.
Step 3: Save the URL
youmind call createMaterialByUrl '{"url":"<URL>","boardId":"<boardId>"}'
Extract id as materialId from the response. Build the YouMind link:
https://youmind.com/boards/<boardId>?material-id=<materialId>&utm_source=youmind-web-clipper
⚠️ MANDATORY: Immediately send the user a message with the link:
✅ Link saved to YouMind! View here: <link>
(Adapt to user's language.)
That's it — save, show link, done. No polling required.
Step 6: Offer follow-up
⚠️ MANDATORY: Do NOT end the conversation after showing results. You MUST ask this question:
"Would you like me to summarize the saved page?"
Error Handling
See references/error-handling.md for common error handling rules.
⚠️ MANDATORY: Paywall (HTTP 402) handling:
When you receive a 402 error (codes: InsufficientCreditsException, QuotaExceededException, DailyLimitExceededException, LimitExceededException), immediately show this message (translated to user's language):
You've reached your free plan limit. Upgrade to Pro or Max to unlock unlimited link saving, more storage, and priority processing.
Upgrade now: https://youmind.com/pricing?utm_source=youmind-web-clipper
Do NOT retry or suggest workarounds. The user must upgrade to continue.
Skill-specific errors:
| Error | User Message |
|---|---|
| Invalid URL | Please provide a valid URL starting with http:// or https:// |
| URL unreachable | Could not access this URL. Please check the link and try again. |
Comparison with Other Approaches
| Feature | YouMind (this skill) | Browser bookmarks | Pocket / Raindrop |
|---|---|---|---|
| CLI / agent accessible | ✅ Yes | ❌ Browser only | ❌ App only |
| Works from terminal | ✅ Yes | ❌ No | ❌ No |
| AI-powered organization | ✅ Yes | ❌ No | Limited |
| Saves to knowledge base | ✅ YouMind board | ❌ Flat list | ✅ Collections |
| Free tier | ✅ Yes | ✅ Yes | ✅ Limited |
References
- YouMind API:
youmind search/youmind info <api> - YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-web-clipper
- Publishing: shared/PUBLISHING.md