{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clawd-docs-v2",
    "name": "Clawd Docs V2",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/aranej/clawd-docs-v2",
    "canonicalUrl": "https://clawhub.ai/aranej/clawd-docs-v2",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clawd-docs-v2",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawd-docs-v2",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clawd-docs-v2"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/clawd-docs-v2",
    "agentPageUrl": "https://openagent3.xyz/skills/clawd-docs-v2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawd-docs-v2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawd-docs-v2/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Clawd-Docs v2.0 - Smart Documentation Access",
        "body": "This skill provides intelligent access to ClawdBot documentation with:\n\nLocal search index - instant keyword lookup (0 tokens)\nCached snippets - pre-fetched common answers (~300-500 tokens)\nOn-demand fetch - full page when needed (~8-12k tokens)\nFreshness tracking - TTL per page type"
      },
      {
        "title": "Step 1: Check Golden Snippets First",
        "body": "Before fetching anything, check if a Golden Snippet exists:\n\nls ~/clawd/data/docs-snippets/\n\nAvailable snippets (check cache first!):\n\nSnippetQuery matchestelegram-setup.md\"ako nastaviť telegram\", \"telegram setup\"telegram-allowfrom.md\"allowFrom\", \"kto mi môže písať\", \"access control\"oauth-troubleshoot.md\"token expired\", \"oauth error\", \"credentials\"update-procedure.md\"ako updatnuť\", \"update clawdbot\"restart-gateway.md\"restart\", \"reštart\", \"stop/start\"config-basics.md\"config\", \"nastavenie\", \"konfigurácia\"config-providers.md\"pridať provider\", \"discord setup\", \"nový kanál\"memory-search.md\"memory\", \"vector search\", \"pamäť\", \"embeddings\"\n\nRead snippet:\n\ncat ~/clawd/data/docs-snippets/telegram-setup.md"
      },
      {
        "title": "Step 2: Search Index (if snippet doesn't exist)",
        "body": "Check ~/clawd/data/docs-index.json for page suggestions.\n\nKeyword matching:\n\n\"telegram\" → channels/telegram\n\"oauth\" → concepts/oauth, gateway/troubleshooting\n\"update\" → install/updating\n\"config\" → gateway/configuration"
      },
      {
        "title": "Step 3: Check Full Page Cache",
        "body": "BEFORE fetching via brightdata, check if the page is already cached:\n\n# Convert path: concepts/memory → concepts_memory.md\nls ~/clawd/data/docs-cache/ | grep \"concepts_memory\"\n\nIf exists, read locally (0 tokens!):\n\ncat ~/clawd/data/docs-cache/concepts_memory.md"
      },
      {
        "title": "Step 4: Fetch Page (only if NOT in cache)",
        "body": "Use native web_fetch tool (part of Clawdbot core - FREE and fast!):\n\nweb_fetch({ url: \"https://docs.clawd.bot/{path}\", extractMode: \"markdown\" })\n\nExample:\n\nweb_fetch({ url: \"https://docs.clawd.bot/tools/skills\", extractMode: \"markdown\" })\n\nweb_fetch advantages:\n\nweb_fetchbrightdataCost$0 (free!)~$0.003/callSpeed~400ms2-5sQualityMarkdown ✅Markdown ✅"
      },
      {
        "title": "Search Index Structure",
        "body": "Location: ~/clawd/data/docs-index.json\n\n{\n  \"pages\": [\n    {\n      \"path\": \"channels/telegram\",\n      \"ttl_days\": 7,\n      \"keywords\": [\"telegram\", \"tg\", \"bot\", \"allowfrom\"]\n    }\n  ],\n  \"synonyms\": {\n    \"telegram\": [\"tg\", \"telegrambot\"],\n    \"configuration\": [\"config\", \"nastavenie\", \"settings\"]\n  }\n}\n\nUse synonyms for fuzzy matching."
      },
      {
        "title": "TTL Strategy (Freshness)",
        "body": "Page CategoryTTLWhyinstall/updating1 dayAlways current!gateway/*7 daysConfig changeschannels/*7 daysProvider updatestools/*7 daysFeatures addedconcepts/*14 daysRarely changesreference/*30 daysStable templates\n\nCheck snippet expiry:\n\nhead -10 ~/clawd/data/docs-snippets/telegram-setup.md | grep expires"
      },
      {
        "title": "\"Ako nastaviť Telegram?\"",
        "body": "✅ Read ~/clawd/data/docs-snippets/telegram-setup.md"
      },
      {
        "title": "\"allowFrom nefunguje\"",
        "body": "✅ Read ~/clawd/data/docs-snippets/telegram-allowfrom.md"
      },
      {
        "title": "\"Token expired / oauth error\"",
        "body": "✅ Read ~/clawd/data/docs-snippets/oauth-troubleshoot.md"
      },
      {
        "title": "\"Ako updatnúť ClawdBot?\"",
        "body": "✅ Read ~/clawd/data/docs-snippets/update-procedure.md"
      },
      {
        "title": "\"Ako pridať nový skill?\" (nie je snippet)",
        "body": "Search index → tools/skills\nFetch: web_fetch({ url: \"https://docs.clawd.bot/tools/skills\", extractMode: \"markdown\" })"
      },
      {
        "title": "\"Multi-agent routing\"",
        "body": "Search index → concepts/multi-agent\nFetch: web_fetch({ url: \"https://docs.clawd.bot/concepts/multi-agent\", extractMode: \"markdown\" })"
      },
      {
        "title": "Fallback: Full Index Refresh",
        "body": "If you can't find what you need:\n\nweb_fetch({ url: \"https://docs.clawd.bot/llms.txt\", extractMode: \"markdown\" })\n\nReturns complete list of all documentation pages."
      },
      {
        "title": "Token Efficiency Guide",
        "body": "MethodTokensWhen to useGolden Snippet~300-500✅ Always first!Search Index0Keyword lookupFull Page Fetch~8-12kLast resortBatch Fetch~20-30kMultiple related topics\n\n80-90% of queries should be answered from snippets!"
      },
      {
        "title": "Data Locations",
        "body": "~/clawd/data/\n├── docs-index.json       # Search index\n├── docs-stats.json       # Usage tracking\n├── docs-snippets/        # Cached Golden Snippets\n│   ├── telegram-setup.md\n│   ├── telegram-allowfrom.md\n│   ├── oauth-troubleshoot.md\n│   ├── update-procedure.md\n│   ├── restart-gateway.md\n│   └── config-basics.md\n└── docs-cache/           # Full page cache (future)"
      },
      {
        "title": "Version Info",
        "body": "ItemValueSkill version2.1.0Created2026-01-14Updated2026-01-26AuthorsClaude Code + Clawd (collaborative)Sourcehttps://docs.clawd.bot/Dependenciesweb_fetch (Clawdbot core tool)Index pages~50 core pagesGolden snippets7 pre-cached"
      },
      {
        "title": "v2.2.0 (2026-01-26)",
        "body": "Migration to web_fetch - replaced brightdata MCP with native Clawdbot tool\nBenefits: FREE ($0), faster (~400ms vs 2-5s)\nNo external dependencies (mcporter no longer required)\nCollaborative work: Claude Code 🦞 implementation, Clawd 🐾 review"
      },
      {
        "title": "v2.1.3 (2026-01-25) - ClawdHub",
        "body": "Documentation fix: check vs refresh clarification"
      },
      {
        "title": "v2.0.0 (2026-01-14)",
        "body": "3-layer architecture: Search Index → Snippets → On-demand Fetch\nGolden Snippets pre-cached for common queries\nTTL-based freshness tracking\nSynonym support for fuzzy matching\n80-90% token reduction for common queries"
      },
      {
        "title": "v1.0.0 (2026-01-08)",
        "body": "Initial release with brightdata fetch only\n\nThis skill provides smart documentation access - always cached snippets first, fetch only when necessary."
      }
    ],
    "body": "Clawd-Docs v2.0 - Smart Documentation Access\n\nThis skill provides intelligent access to ClawdBot documentation with:\n\nLocal search index - instant keyword lookup (0 tokens)\nCached snippets - pre-fetched common answers (~300-500 tokens)\nOn-demand fetch - full page when needed (~8-12k tokens)\nFreshness tracking - TTL per page type\nQuick Start\nStep 1: Check Golden Snippets First\n\nBefore fetching anything, check if a Golden Snippet exists:\n\nls ~/clawd/data/docs-snippets/\n\n\nAvailable snippets (check cache first!):\n\nSnippet\tQuery matches\ntelegram-setup.md\t\"ako nastaviť telegram\", \"telegram setup\"\ntelegram-allowfrom.md\t\"allowFrom\", \"kto mi môže písať\", \"access control\"\noauth-troubleshoot.md\t\"token expired\", \"oauth error\", \"credentials\"\nupdate-procedure.md\t\"ako updatnuť\", \"update clawdbot\"\nrestart-gateway.md\t\"restart\", \"reštart\", \"stop/start\"\nconfig-basics.md\t\"config\", \"nastavenie\", \"konfigurácia\"\nconfig-providers.md\t\"pridať provider\", \"discord setup\", \"nový kanál\"\nmemory-search.md\t\"memory\", \"vector search\", \"pamäť\", \"embeddings\"\n\nRead snippet:\n\ncat ~/clawd/data/docs-snippets/telegram-setup.md\n\nStep 2: Search Index (if snippet doesn't exist)\n\nCheck ~/clawd/data/docs-index.json for page suggestions.\n\nKeyword matching:\n\n\"telegram\" → channels/telegram\n\"oauth\" → concepts/oauth, gateway/troubleshooting\n\"update\" → install/updating\n\"config\" → gateway/configuration\nStep 3: Check Full Page Cache\n\nBEFORE fetching via brightdata, check if the page is already cached:\n\n# Convert path: concepts/memory → concepts_memory.md\nls ~/clawd/data/docs-cache/ | grep \"concepts_memory\"\n\n\nIf exists, read locally (0 tokens!):\n\ncat ~/clawd/data/docs-cache/concepts_memory.md\n\nStep 4: Fetch Page (only if NOT in cache)\n\nUse native web_fetch tool (part of Clawdbot core - FREE and fast!):\n\nweb_fetch({ url: \"https://docs.clawd.bot/{path}\", extractMode: \"markdown\" })\n\n\nExample:\n\nweb_fetch({ url: \"https://docs.clawd.bot/tools/skills\", extractMode: \"markdown\" })\n\n\nweb_fetch advantages:\n\n\tweb_fetch\tbrightdata\nCost\t$0 (free!)\t~$0.003/call\nSpeed\t~400ms\t2-5s\nQuality\tMarkdown ✅\tMarkdown ✅\nSearch Index Structure\n\nLocation: ~/clawd/data/docs-index.json\n\n{\n  \"pages\": [\n    {\n      \"path\": \"channels/telegram\",\n      \"ttl_days\": 7,\n      \"keywords\": [\"telegram\", \"tg\", \"bot\", \"allowfrom\"]\n    }\n  ],\n  \"synonyms\": {\n    \"telegram\": [\"tg\", \"telegrambot\"],\n    \"configuration\": [\"config\", \"nastavenie\", \"settings\"]\n  }\n}\n\n\nUse synonyms for fuzzy matching.\n\nTTL Strategy (Freshness)\nPage Category\tTTL\tWhy\ninstall/updating\t1 day\tAlways current!\ngateway/*\t7 days\tConfig changes\nchannels/*\t7 days\tProvider updates\ntools/*\t7 days\tFeatures added\nconcepts/*\t14 days\tRarely changes\nreference/*\t30 days\tStable templates\n\nCheck snippet expiry:\n\nhead -10 ~/clawd/data/docs-snippets/telegram-setup.md | grep expires\n\nCommon Scenarios\n\"Ako nastaviť Telegram?\"\n✅ Read ~/clawd/data/docs-snippets/telegram-setup.md\n\"allowFrom nefunguje\"\n✅ Read ~/clawd/data/docs-snippets/telegram-allowfrom.md\n\"Token expired / oauth error\"\n✅ Read ~/clawd/data/docs-snippets/oauth-troubleshoot.md\n\"Ako updatnúť ClawdBot?\"\n✅ Read ~/clawd/data/docs-snippets/update-procedure.md\n\"Ako pridať nový skill?\" (nie je snippet)\nSearch index → tools/skills\nFetch: web_fetch({ url: \"https://docs.clawd.bot/tools/skills\", extractMode: \"markdown\" })\n\"Multi-agent routing\"\nSearch index → concepts/multi-agent\nFetch: web_fetch({ url: \"https://docs.clawd.bot/concepts/multi-agent\", extractMode: \"markdown\" })\nFallback: Full Index Refresh\n\nIf you can't find what you need:\n\nweb_fetch({ url: \"https://docs.clawd.bot/llms.txt\", extractMode: \"markdown\" })\n\n\nReturns complete list of all documentation pages.\n\nToken Efficiency Guide\nMethod\tTokens\tWhen to use\nGolden Snippet\t~300-500\t✅ Always first!\nSearch Index\t0\tKeyword lookup\nFull Page Fetch\t~8-12k\tLast resort\nBatch Fetch\t~20-30k\tMultiple related topics\n\n80-90% of queries should be answered from snippets!\n\nData Locations\n~/clawd/data/\n├── docs-index.json       # Search index\n├── docs-stats.json       # Usage tracking\n├── docs-snippets/        # Cached Golden Snippets\n│   ├── telegram-setup.md\n│   ├── telegram-allowfrom.md\n│   ├── oauth-troubleshoot.md\n│   ├── update-procedure.md\n│   ├── restart-gateway.md\n│   └── config-basics.md\n└── docs-cache/           # Full page cache (future)\n\nVersion Info\nItem\tValue\nSkill version\t2.1.0\nCreated\t2026-01-14\nUpdated\t2026-01-26\nAuthors\tClaude Code + Clawd (collaborative)\nSource\thttps://docs.clawd.bot/\nDependencies\tweb_fetch (Clawdbot core tool)\nIndex pages\t~50 core pages\nGolden snippets\t7 pre-cached\nChangelog\nv2.2.0 (2026-01-26)\nMigration to web_fetch - replaced brightdata MCP with native Clawdbot tool\nBenefits: FREE ($0), faster (~400ms vs 2-5s)\nNo external dependencies (mcporter no longer required)\nCollaborative work: Claude Code 🦞 implementation, Clawd 🐾 review\nv2.1.3 (2026-01-25) - ClawdHub\nDocumentation fix: check vs refresh clarification\nv2.0.0 (2026-01-14)\n3-layer architecture: Search Index → Snippets → On-demand Fetch\nGolden Snippets pre-cached for common queries\nTTL-based freshness tracking\nSynonym support for fuzzy matching\n80-90% token reduction for common queries\nv1.0.0 (2026-01-08)\nInitial release with brightdata fetch only\n\nThis skill provides smart documentation access - always cached snippets first, fetch only when necessary."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/aranej/clawd-docs-v2",
    "publisherUrl": "https://clawhub.ai/aranej/clawd-docs-v2",
    "owner": "aranej",
    "version": "2.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clawd-docs-v2",
    "downloadUrl": "https://openagent3.xyz/downloads/clawd-docs-v2",
    "agentUrl": "https://openagent3.xyz/skills/clawd-docs-v2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawd-docs-v2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawd-docs-v2/agent.md"
  }
}