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).

> Get API Key → · More Skills →

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):

> 1. Get your free API key: https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper

> 2. 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 https://example.com/interesting-article

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

1. Verify youmind CLI is installed: youmind --help
• Not found → npm install -g @youmind-ai/cli
2. 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
3. Validate input is a URL (must start with http:// or https://)
• 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/?material-id=&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:

Comparison with Other Approaches

References

• YouMind API: youmind search / youmind info
• YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-web-clipper
• Publishing: shared/PUBLISHING.md