LinkHut#

Manage bookmarks from chat -- save links, organize with tags, search your collection, and maintain a reading list. Powered by ClawLink for hosted OAuth.

Setup in 3 Steps#

Step 1: InstallStep 2: Pair AccountStep 3: Connect LinkHut_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect LinkHut

How It Works#

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  LinkHut API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install#

bash

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start#

javascript

// 1. Save a bookmark
clawlink_call_tool({ tool: "linkhut_add_bookmark", parameters: { url: "https://example.com/article", tags: "reading tech" } })

// 2. Search your bookmarks
clawlink_call_tool({ tool: "linkhut_get_bookmarks", parameters: { tag: "tech" } })

// 3. List all tags
clawlink_call_tool({ tool: "linkhut_get_all_tags", parameters: {} })

Authentication#

ClawLink handles OAuth with LinkHut. No API keys needed. Connect at claw-link.dev/dashboard?add=linkhut.

Connection Management#

javascript

// List connections
clawlink_list_integrations()

// Verify by listing bookmarks
clawlink_call_tool({ tool: "linkhut_get_bookmarks", parameters: {} })

Security & Permissions#

• Read tools are safe and require no confirmation
• Write tools require confirmation before execution
• Bookmark deletion is high-impact and irreversible

Tool Reference#

Bookmark Operations#

ToolDescriptionModelinkhut_add_bookmarkSave a new bookmark with tags, notes, and privacy settingsWritelinkhut_get_bookmarksRetrieve bookmarks with filtering by tag, date, or URLReadlinkhut_update_bookmarkUpdate bookmark metadata (title, description, tags)Writelinkhut_delete_bookmarkDelete a bookmark by URLWrite

Tag Operations#

ToolDescriptionModelinkhut_get_all_tagsList all tags with usage countsRead

Code Examples#

Example 1: Save and organize bookmarks#

javascript

// Save a bookmark with tags and notes
await clawlink_call_tool({
  tool: "linkhut_add_bookmark",
  parameters: {
    url: "https://example.com/great-article",
    tags: "reading ai machine-learning",
    extended: "Great overview of transformer architectures",
    toread: true
  }
});

// Find bookmarks tagged "ai"
const bookmarks = await clawlink_call_tool({
  tool: "linkhut_get_bookmarks",
  parameters: { tag: "ai" }
});

Example 2: Search and manage#

javascript

// Get a specific bookmark by URL
const bookmark = await clawlink_call_tool({
  tool: "linkhut_get_bookmarks",
  parameters: { url: "https://example.com/specific-page" }
});

// Update bookmark tags
await clawlink_call_tool({
  tool: "linkhut_update_bookmark",
  parameters: {
    url: "https://example.com/specific-page",
    tags: "updated-tag new-tag"
  }
});

Example 3: Tag overview#

javascript

// List all tags and their counts
const tags = await clawlink_call_tool({
  tool: "linkhut_get_all_tags",
  parameters: {}
});

// Get bookmarks from a specific date
const dailyBookmarks = await clawlink_call_tool({
  tool: "linkhut_get_bookmarks",
  parameters: { date: "2026-06-08" }
});

Discovery Workflow#

1. Call clawlink_list_integrations to confirm linkhut is connected.
2. Call clawlink_list_tools --integration linkhut to see the live catalog.
3. Use clawlink_search_tools({ query: "bookmark", integration: "linkhut" }) to find specific tools.

Execution Workflow#

text

READ (safe):     get_bookmarks → get_all_tags
WRITE (confirm): add_bookmark → update_bookmark
DELETE (high):   delete_bookmark

Notes#

• Tags are space-separated when specifying multiple tags
• Bookmarks can be marked as private (not shared) or read/unread ( toread)
• Delete requires the exact URL of the bookmark
• Update is idempotent -- repeated calls produce the same result

Error Handling#

Status / ErrorMeaning401 UnauthorizedOAuth token expired -- reconnect at dashboard404 Not FoundBookmark with that URL does not exist409 ConflictBookmark with that URL already exists (use update instead)422 UnprocessableMissing required URL parameter

Troubleshooting#

Tools Not Visible#

• Start a fresh OpenClaw chat to reload plugin catalog
• Call clawlink_list_integrations to confirm pairing

Bookmark Already Exists#

• Use linkhut_update_bookmark instead of linkhut_add_bookmark
• Use linkhut_get_bookmarks with the URL to check if it exists first

Resources#

• LinkHut: https://linkhut.org/
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=linkhut
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw